Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Auto-map SOAP activity output variables

Auto-map SOAP activity output variables

The ServiceNow activity designer allows you to map parameter values in a SOAP test payload to variables in the Outputs stage automatically.

Before you begin

Role required: web_service_admin, activity_admin, activity_creator

About this task

Note: You can test input variables from any stage in the activity designer if you have provided enough information for Orchestration to contact the endpoint and return data. Typically, the Execution Command stage is the point at which your inputs are ready for testing.

Procedure

  1. In the activity designer, proceed to the Execution Command stage.
  2. Define an appropriate MID Server, if requested.
    The test fails if the MID Server cannot be found or if it cannot connect to the target.
  3. Click Test Activity to test the input parameters.
    If you added actual values for the parameters and fields, the system runs those values against the specified target and returns the resulting payload. If you mapped input variables to fields and parameters, the system displays a dialog box for assigning test values to those variables.
  4. Provide test values, if requested, and click OK to display the payload.
    The entire payload appears in the Raw Output tab of the Response form.
    Auto-mapping controls
  5. Select one of these auto-mapping options.
    • Auto-Map to Local: Directly maps values to a local variable for use within the activity.
    • Auto-Map to Output: Directly maps values to the output variable to pass to other activities in the workflow. Auto-mapping to an output variable creates an array of objects, each of which contains the column names from the query result.

Provide credentials to access a SOAP message WSDL

If the SOAP WSDL you are requesting in a test payload requires authentication, you must provide basic auth credentials in either the SOAP message or the SOAP activity.

Before you begin

Role required: web_service_admin, activity_admin, activity_creator

The ServiceNow instance only supports basic auth credentials for accessing a WSDL. If the SOAP function or the SOAP message does not provide these credentials, you must configure them in the SOAP activity template. Orchestration uses these priorities for deciding which basic authentication credentials to use:
  • SOAP message: Credentials for a SOAP message are used if no other credentials are defined.
  • SOAP function: Credentials for a SOAP function override the credentials configured for the SOAP message.
  • SOAP activity template: Credentials for a SOAP activity template override both the SOAP function and SOAP message credentials.

Procedure

  1. Navigate to System Web Services > Outbound > SOAP Message.
  2. Select the SOAP message you want the activity to use.
  3. In the SOAP Message record, select the Download WSDL check box.
  4. In the Authentication type field, select Basic.
    The Basic auth profile field appears.
  5. Select the basic auth profile to use with this SOAP message.
    Figure 1. Basic authentication for a SOAP message
    Basic authentication for a SOAP message
  6. Alternately, you can configure basic authentication credentials in Configure the SOAP execution command.
    1. In the Authentication field, select Override with Basic Authentication credentials.
      The Credentials field appears.
    2. Select the basic auth credentials to use to access the WSDL.
      This setting overrides any credentials configured in the SOAP message.
      Figure 2. Override basic auth credentials
      Override basic auth credentials