CentraSite Documentation : CentraSite Developer’s Guide : Built-In Design/Change-Time Actions Reference : Built-In Actions for Design/Change-Time Policies : 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, via 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 (e.g., 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 (e.g., PreCreate, PreDelete), the requested operation is not executed.
Event Scope
PreCreate
PostCreate
PreUpdate
PostUpdate
PreDelete
PostDelete
PreStateChange
PostStateChange
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 will submit 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 will set in the message. If you do not set this parameter, CentraSite will set the SOAP action to the empty string.
Connection Timeout (in milliseconds)
Number 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.
Copyright © Software AG, Darmstadt, Germany.
Product LogoContact Support   |   Community   |   Feedback