Forms › The Form Designer › Form Element Functions › Form Elements › SOAP Methods › ca_pam_getSOAPData(serviceURL, methodName, inlineText, soapVersion, stripXMLNamespacesFromResponse, callBack)

ca_pam_getSOAPData(serviceURL, methodName, inlineText, soapVersion, stripXMLNamespacesFromResponse, callBack)

Makes a Web service call and converts the resulting XML into a JavaScript object.

This method is an overloaded method. ca_pam_getSOAPData can be invoked without providing the SOAP version and/or stripXMLNamespacesFromResponse parameter. If you do not provide these parameters, then the SOAP version is considered SOAP_1_1, and stripXMLNamespacesFromResponse is considered true.

The following are the overloaded method signatures:

• ca_pam_getSOAPData (serviceURL,methodName, inlineText,callBack)
• ca_pam_getSOAPData (serviceURL,methodName, inlineText,soapVersion, callBack)

Input Parameters

serviceURL (string)

Specifies the URL for the SOAP service. The URL is typically accessed over HTTP or HTTPS. The URL is an entry point for one or more methods.

methodName (string)

Specifies the method or function to run. The function passes the method to the SOAP service as a MIME SOAPAction header.

inlineText (string)

Specifies the source for the SOAP service input request. This parameter includes an XML message, which can include a SOAP envelope.

soapVersion (string)

Specifies the version of the SOAP server on which the call is made. Possible values include SOAP_1_1 or SOAP_1_2. The default is SOAP _1_1.

stripXMLNamespacesFromResponse (boolean)

Specifies whether the response Name Spaces are removed from the XML response (true). The default is true.

callBack (object)

Defines a reference to the function object to call after retrieving the data, including its onSuccess and onFailure methods.

The ca_pam_getSOAPData function calls the callBack method asynchronously on the server. When the function retrieves the data, either the onSuccess(result) or onFailure(caught) callBack function runs. If the function returns a SOAP fault, it calls the onFault(faultString) method and the result is an XML string.

If you do not provide the SOAP version and stripXMLNameSpacesFromResponse parameters, their default values are substituted and the response is returned to the callBack object in the onSuccess(result).

Return Value

When the function retrieves the data, either the onSuccess(result) or onFailure(caught) callBack function runs. If the function returns a SOAP fault, it calls the onFault(faultString) method and the result is an XML string. The function itself does not return any value.

Note: You can find this function in the out-of-the-box content in CA Process Automation.

1. On the Home page, click Browse Out-of-the-Box Content.
2. Navigate to the User Interaction Forms folder, then 08 Populate Table SOAP WS: Populate Table SOAP WS.