Software AG Products 10.5 | Using CentraSite | Policy Management | Built-In Design/Change-Time Actions Reference | Call Web Service
 
Call Web Service
Submits a given SOAP message to a specified web service. You can use this action to notify external systems, through a SOAP message, of changes that occur in the registry.
If the web service returns a response, the response message is recorded to the policy log.
If the web service produces a SOAP fault or the service cannot be successfully performed for other reasons (for example, a network failure occurs), the policy action fails, and thus the policy itself fails. If the policy had been executed on a pre operation event (for example, Pre-Create, Pre-Delete), the requested operation is not executed.
Event Scope
Pre-Create
Post-Create
Pre-Update
Post-Update
Pre-Delete
Post-Delete
Pre-State Change
Post-State Change
OnTrigger
Object Scope
This action can be enforced on any object type that the policy engine supports.
Input Parameters
Service Endpoint
(String). The URL of the web service that you want to call. Supported protocols are HTTP and HTTPS.
Example:
http://myServer:53307/wsstack/myService
Note:
If the web service that you want to invoke is registered in CentraSite, you can use the Browse button to select its URL.
HTTP Basic Auth Enabled
(Boolean). Specifies whether the service is secured by Basic HTTP authentication.
If you enable this option, you can optionally specify the user ID and password that CentraSite is to submit when it invokes the service in the following parameters. If you leave these parameters empty, CentraSite submits the credentials belonging to the user who triggered this policy action.
HTTP Basic Auth Username
The user ID that you want CentraSite to submit for HTTP basic authentication (if you do not want CentraSite to submit the user ID of the user who triggered the policy).
HTTP Basic Auth Password
The password associated with the user ID specified in HTTP Basic Auth Username.
SOAP Request Message
(String). The SOAP message that CentraSite is to submit to the web service. This message can include substitution tokens, if you want to insert run-time data into it. For available tokens, see the list of Substitution Tokens shown in the Send Email Notification action.
<env:Envelope
xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<env:Body>
<m:keylogger
xmlns:m=" http://mycompany.example.org/key ">
<serviceName>${entity.name}</serviceName>
<assetType>${entity.type}</assetType>
<key>${entity.attribute.Key}</key>
</m:keylogger>
</env:Body>
</env:Envelope>
SOAP Action
(String). The SOAP action that CentraSite sets in the message. If you do not set this parameter, CentraSite sets the SOAP action to the empty string.
Connection Timeout (in milliseconds)
(String). The length of time in milliseconds that CentraSite will wait for a response from the remote machine. If the timeout limit is exceeded, the policy action fails.
Content Type
(String). The value that CentraSite is to assign to the Content-Type header in the SOAP request that it submits to the service.
Example:
application/soap+xml; charset=utf-8
If you do not specify Content Type, the value, application/soap+xml, is assigned to the SOAP request.