Qore xml Module 1.8.1
Loading...
Searching...
No Matches
SalesforceSoapClient::SalesforceSoapConnection Class Reference

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

#include <SalesforceSoapClient.qm.dox.h>

Inheritance diagram for SalesforceSoapClient::SalesforceSoapConnection:
SoapConnection

Public Member Methods

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

Public Attributes

const ConnectionScheme
 Connection entry info.
 
- Public Attributes inherited from SoapConnection

Private Member Methods

SalesforceSoapClient getImpl (bool connect=True, *hash< auto > rtopts)
 returns a SalesforceSoapClient object
 
WSDL::WebService getWsdl (string url)
 returns a WSDL::WebService object for the given URL using a cache for local files
 
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 Member Methods inherited from SoapConnection

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
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

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

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

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