Qore SalesforceSoapClient Module Reference  1.4
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:Internal 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:Internal 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
namethe name of the connection
descriptionconnection description
urlconnection URL (potentially with password info)
attributesvarious attributes. See below
optionsconnection options

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

Exceptions
SALESFORCE-SOAP-ERRORmissing one or more of the required options: "username", "password", or "token"

◆ getImpl()

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

returns a SalesforceSoapClient object

Parameters
connectif True, then SalesforceSoapClient::login() is called
rtoptsan 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:internal

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

Parameters
urlthe URL of the WSDL
Returns
a WSDL::WebService object corresponding to the WSDL URL