Call web service

Nintex external platform is required for this feature. For details, see Enable Nintex external platform features.

Calls a SOAP web service method.

Action Settings

URL

A mandatory field that represents the full 'URL to the WSDL definition of the SOAP web service to call'. Once a URL has been entered, click the Refresh button on the Web method to select from the available Web methods. References can also be inserted using the Inserting reference fields feature.

Username

The username (including domain) used when authenticating against the web service. This is an optional setting, however if left blank the web service must be open to anonymous access.

Password

The password for the username above when authenticating against the web service. If left blank, the web service must be open to anonymous access.

Web Method

The web methods that are available for the web service.

Editor mode

The Editor mode defines the values to be sent to the web service. The message configuration depends on the parameters required by the selected web service method.

• SOAP Builder: Use the SOAP Builder if the web service method only required parameters of 'simple' data types. An input form is displayed to allow these values to be provided. Note: If the web service method requires complex parameters, the SOAP Builder form cannot be dispalyed and a single text box to edit the XML of the SOAP message directly is provided.
• SOAP Editor: Use the SOAP Editor to directly edit the XML message when the selected web service method requires complex data types.
  Note: Editing the SOAP message manually requires some advanced knowledge of web services.

To pass the byte array of the document under workflow, type [FileData] into any input field. At runtime Nintex Workflow will base64 encode the file and pass that as the value.

For more information on the SOAP standard please refer to http://www.w3.org/TR/soap12-part0.

Web service input

Encode inserted tokens

Specifies whether inserted tokens (workflow variables, list item properties, etc) should be encoded to ensure they are valid for sending to the web service.

Web service output

Default value

The default value can be used for a single return value from a web service method.

• Store result in
  This list contains the workflow variables that can be used to store the simple type result of the call.
• Result processing
  Force top level XML node: Determines whether the result should be wrapped in a top level XML element called <xml>. This is useful if the result from the web service is not XML or is an XML fragment with no root node.
  XML Transform: Allows an XSL transform to be defined. This transform will be applied to the web service results before they are stored in the workflow variable.

Specify elements

Allow the workflow to store specific values from a web service response.

To specify an element:

1. Click on Select element to browse the response format and select a value. Click Apply.

2. Specify a workflow variable to store the value of the element selected.

Related information

Find, add, and configure actions