Forms › The Form Designer › Form Element Functions › Form Elements › REST Methods › ca_pam_postRESTData(url, body, contentType, doNotValidateCert, headers, callBack)

ca_pam_postRESTData(url, body, contentType, doNotValidateCert, headers, callBack)

Uses the HTTP post method to start the REST service.You can use this method with the following signatures:

ca_pam_postRESTData (url, callBack)
ca_pam_postRESTData (url, body, callBack)
ca_pam_postRESTData (url, body, contentType, callBack)
ca_pam_postRESTData (url, body, contentType, doNotValidateCert, callBack)

Note: The dataset expressions are supported in the ca_pam_postRESTData function.

Input Parameters

url (string)

Defines the URL of the HTTP request. The URL starts with http:// or https://.

body (string)

Defines the data to send in the HTTP request.

contentType (string)

Defines the type of content that comprises the HTTP request body. This value is sent as a header (content-type) in the HTTP request.

doNotValidateCert (boolean)

Specifies whether a valid SSL certificate is found. This field is relevant when querying an HTTPS URL.

• false - Validates the SSL certificate and fails the operation if the certificate is invalid.
• true - Accepts the SSL certificate even if it is invalid and continues to make the HTTP call.

headers (object)

Defines a list of key/value pairs that sets headers in the request.

callBack (object)

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

Return Value

When the function retrieves the data, either the onSuccess(result) or onFailure(caught) callBack function runs. The function itself does not return any value.

Example

The dataset expressions are supported in the ca_pam_postRESTData function as shown in the following example:

ca_pam_postRESTData('Datasets["/Forms/RestDataset"].posturl',ca_pam_getTextFieldValue('Form.Var_0'),contentType,callBack);

Note: You need to provide an absolute path of the dataset.