SalesforceSoapClient::SalesforceSoapConnection Class Reference

class for SOAP connections to the Salesforce.com SOAP API; returns an object of class SalesforceSoapClient More...

Inherits SoapConnection.

Public Member Methods
	constructor (string name, string description, string url, hash< auto > attributes={}, hash< auto > options={})
	creates the SalesforceSoapConnection object More...
string	getType ()
	returns "sfsoap"
*hash< auto >	getRuntimeOptions ()
	returns runtime options More...

Public Attributes
const	ConnectionScheme
	Connection entry info.

Private Member Methods
SalesforceSoapClient	getImpl (bool connect=True, *hash< auto > rtopts)
	returns a SalesforceSoapClient object More...
WSDL::WebService	getWsdl (string url)
	returns a WSDL::WebService object for the given URL using a cache for local files More...
synchronized WSDL::WebService	getWsdlFromCache (string path)
	returns a WSDL::WebService object for the given path from the cache if possible, otherwise creates the object and populates the cache
WSDL::WebService	getWebService (string url)
	returns a WSDL::WebService object from the given URL
hash< ConnectionSchemeInfo >	getConnectionSchemeInfoImpl ()
	Returns the ConnectionSchemeInfo hash for this object.

Private Attributes
hash	cache
	cache of WebService objects keyed by file location

Detailed Description

class for SOAP connections to the Salesforce.com SOAP API; returns an object of class SalesforceSoapClient

supports all SoapConnection options plus the following static initialization options:

• "force_logout": forces a logout when the SalesforceSoapClient object is destroyed; this should normally be False to allow for the session to remain valid
• "password": Salesforce.com password
• "token": Salesforce.com user API token
• "username": Salesforce.com username

See also

SalesforceSoapClient::constructor(hash) for more information on the above options

Note

• additionally supports the following runtime options in getImpl() for connection logging:
  • "log": a closure accepting a single string for logging
  • "dbglog": a closure taking a single string for detailed technical connection logging
• the following options are required:
  • "username": (required) Salesforce.com username
  • "password": (required) Salesforce.com password
  • "token": (required) Salesforce.com user API token

Member Function Documentation

constructor()

SalesforceSoapClient::SalesforceSoapConnection::constructor	(	string	name,
		string	description,
		string	url,
		hash< auto >	attributes = {},
		hash< auto >	options = {}
	)

creates the SalesforceSoapConnection object

Parameters

name	the name of the connection
description	connection description
url	connection URL (potentially with password info)
attributes	various attributes. See below
options	connection options

See AbstractConnection::constructor() for attributes and options reference.

Exceptions

SALESFORCE-SOAP-ERROR

missing one or more of the required options: "username", "password", or "token"

getImpl()

SalesforceSoapClient SalesforceSoapClient::SalesforceSoapConnection::getImpl ( bool  connect = True, *hash< auto >  rtopts  )

private

returns a SalesforceSoapClient object

Parameters

connect	if True, then SalesforceSoapClient::login() is called
rtopts	an optional hash providing two runtime options for connection logging: "log": a closure accepting a single string for logging "dbglog": a closure taking a single string for detailed technical connection logging

Returns

a SalesforceSoapClient object

getRuntimeOptions()

*hash<auto> SalesforceSoapClient::SalesforceSoapConnection::getRuntimeOptions

(

)

returns runtime options

Returns

a hash with the following keys reflecting support for the corresponding runtime options in getImpl() for connection logging:

• "log": a closure accepting a single string for logging
• "dbglog": a closure taking a single string for detailed technical connection logging

getWsdl()

WSDL::WebService SalesforceSoapClient::SalesforceSoapConnection::getWsdl ( string  url )

private

returns a WSDL::WebService object for the given URL using a cache for local files

Parameters

url	the URL of the WSDL

Returns

a WSDL::WebService object corresponding to the WSDL URL

---

The documentation for this class was generated from the following file:

• doxygen/qlib/SalesforceSoapClient/SalesforceSoapClient.qm.dox.h