Auto-map SOAP activity output variables

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura

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

    Antes de Iniciar

    Role required: web_service_admin, activity_admin, activity_creator

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    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.

    Procedimento

    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.

    Antes de Iniciar

    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.

    Procedimento

    1. Navigate to All > 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.
      Figura 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.
        Figura 2. Override basic auth credentials
        Override basic auth credentials