Session ID management

The session ID and endpoint address of the BMC Remedyforce web service are obtained by logging on to the Salesforce web service. This session ID is used to perform all the subsequent operations on the BMC Remedyforce application.

The login details specified in the adapter configuration are used to make a call to the Salesforce web service. The session ID and the Remedyforce web service endpoint received in the web service response are stored in the actor adapter. A timer is set and the session ID is renewed at intervals specified in the <time-to-live> element.

The adapter enters into a fault state if the session ID is not retrieved with the details specified in the adapter configuration.

Sample SOAP request to log in to Salesforce and retrieve the session ID

 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body>
   <urn:login xmlns:urn="urn:partner.soap.sforce.com">
   <urn:username>harshad_sukhtankar@21bmcremedyforce.com</urn:username>
   <urn:password>bmcao@12345</urn:password>
   </urn:login>
   </soapenv:Body>
 </soapenv:Envelope>
</soap-message> 

Sample SOAP response that contains the BMC Remedyforce web service endpoint and session ID

  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="urn:partner.soap.sforce.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Body>
      <loginResponse>
        <result>
          <metadataServerUrl>https://ap1-api.salesforce.com/services/Soap/m/24.0/00D90000000HqPi</metadataServerUrl>
          <passwordExpired>false</passwordExpired>
          <sandbox>false</sandbox>
          <serverUrl>https://ap1-api.salesforce.com/services/Soap/u/24.0/00D90000000HqPi</serverUrl>   <sessionId>00D90000000HqPi!AQcAQODVQ8_J5bpUBlrV4DgL_
5hLqxPAgQAP1qzJ75yI7lNrYTtLx8ocbrfYaFTIMiBu72EwDCrcLAR.zBHAziw5OgA.ukys</sessionId>
          <userId>00590000000YWEKAA4</userId>
          <userInfo>
            <accessibilityMode>false</accessibilityMode>
            <currencySymbol>$</currencySymbol>
            <orgAttachmentFileSizeLimit>5242880</orgAttachmentFileSizeLimit>
            <orgDefaultCurrencyIsoCode>USD</orgDefaultCurrencyIsoCode>
            <orgDisallowHtmlAttachments>false</orgDisallowHtmlAttachments>
            <orgHasPersonAccounts>false</orgHasPersonAccounts>
            <organizationId>00D90000000HqPiEAK</organizationId>
            <organizationMultiCurrency>false</organizationMultiCurrency>
            <organizationName>BMCPUNE</organizationName>
            <profileId>00e90000000ZrL2AAK</profileId>
            <roleId>00E90000000Uto1EAC</roleId>
            <sessionSecondsValid>7200</sessionSecondsValid>
            <userDefaultCurrencyIsoCode xsi:nil="true" />
            <userEmail>samir_sood@bmc.com</userEmail>
            <userFullName>samir sood</userFullName>
            <userId>00590000000YWEKAA4</userId>
            <userLanguage>en_US</userLanguage>
            <userLocale>en_US</userLocale>
            <userName>samir@bmc.com</userName>
            <userTimeZone>Asia/Calcutta</userTimeZone>
            <userType>Standard</userType>
            <userUiSkin>Theme3</userUiSkin>
          </userInfo>
        </result>
      </loginResponse>
    </soapenv:Body>
  </soapenv:Envelope>