Asynchronous Web Services

Asynchronous web services are used to represent third-party web services as Jobs. The Job will trigger a web service in a remote system and reach status Running. The web service updates the status in RunMyJobs once the web service Job has finished.

Prerequisites

The following requirements must be met:

  • A free slot in WebServices.OutboundServer.limit and ProcessServerService.External.limit for a Credential to the third-party web service. The number of soap Credentials for a given endpoint you can create is limited by the WebServices.OutboundServer.limit and ProcessServerService.External.limit license keys. If you have both license keys, the most restrictive applies. Note that the ProcessServerService.External.limit license key is also used by other Job Server types such as Platform Agents and SAP Connectors.
  • A Credential for the third-party web service
  • The web service must implement the ServerAddress and JobId Parameters.
  • A callback to UpdateJob1 web service at ServerAddress with JobId and FinalStatus as Out parameters.
  • Basic authentication.
  • Completion strategy must be set to External.

Tip: You can remove the Parameters from the Parameters tab, because they cannot be set or changed by end users.

Example

Setting the Completion Strategy to External:

Copy 
//[...]

SOAPRequest req = SOAP.createSOAPRequestFromJob();
//Set completion strategy to external
jcsJobContext.setCompletionStrategy(CompletionStrategyType.External);

//[...]

See Also