Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview


This web service allows a caller to initiate an import from a Salesforce-like environment. In the standard Projector-Salesforce integration, Projector pulls data from Salesforce. In a web-services based import, this service provides a means to push data into Projector. This service allows one to send XML data to Projector, which Projector then processes by transforming via a pre-configured mapping template. The transformed result is then stored in a staging table which functions like a queue. Later, Projector can read from this queue to create the actual, desired Projector entities.

...

Element

Data Type

Description

Sample Data

Messages

PwsMessage[]

 The web service response status and message. Click here for more information.


ResponseId

Int32

 Click here for more information


Status

RequestStatus

 Click here for more information


ServerTimestampUtc

DateTime

 Click here for more information


ProjectorEntityData

String

A block of XML that represents the Projector entities that will be eventually created in Projector.

<ops:Engagement action="delete" closeIfInUse="true" closedEngagementStageName="Closed Lost" xmlns:ops="ops.projectorpsa.com" />

SfaStatus

String

The status of the SFA integration.

R - Running

P - Pending

I - Idle

D - Disabled

T - Pending Test

R

SfaStatusMessage

String

The error, if there was one, that occurred while applying the pre-configured mapping template to the input data. The same status message will be seen from the Projecto



Response Usage Example(s)


Code Block
languagexml
titleExample 01 - Pushing entity data
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsInitiateSfaImportResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsInitiateSfaImportResult xmlns:a="http://projectorpsa.com/DataContracts/Responses/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/" />
            <ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2021-02-10T20:13:03.8884569Z</ServerTimestampUtc>
            <a:ProjectorEntityData><![CDATA[<?xml version="1.0" encoding="utf-16"?><ops:Import xmlns:ops="urn:ops.projectorpsa.com" xmlns:sf="urn:sobject.partner.soap.sforce.com"><ops:Engagement action="addupdate" xmlns:ops="ops.projectorpsa.com"><ops:engagementName></ops:engagementName><ops:clientName></ops:clientName><ops:costCenterName></ops:costCenterName><ops:engagementTypeName></ops:engagementTypeName><ops:engagementMgrUserDisplayName></ops:engagementMgrUserDisplayName><ops:engagementStageShortName>Open</ops:engagementStageShortName><ops:currencyCode>USD</ops:currencyCode></ops:Engagement></ops:Import>]]></a:ProjectorEntityData>
            <a:SfaStatus>I</a:SfaStatus>
            <a:SfaStatusMessage i:nil="true"/>
         </PwsInitiateSfaImportResult>
      </PwsInitiateSfaImportResponse>
   </s:Body>
</s:Envelope>


PwsInitiateSfaImport - Common Errors and Warnings

...