Back to Top

Add and configure Send Web Request

In this topic

  1. Configure the step
  2. Configure output settings
  3. Return value
  4. Output value

The Send Web Request step allows you to send requests to REST endpoints to get data or post updates. If ArcGIS Workflow Manager is licensed with the ArcGIS Workflow Manager Server Advanced role, you can configure the REST endpoint's response as custom output values, save it as a file, and attach it to the job. The custom output values can be used to retrieve tokens for subsequent REST calls, determine the path the workflow follows, or be used as inputs for other steps throughout the workflow.

When the step is run, the web request is sent to the REST endpoint defined in the step and the following actions can be performed:

  • Refresh Step —If you are assigned to the step or have the adminAdvanced or adminBasic privilege, re–check the status of the step if the connection to the server was disrupted.
  • Complete Step Complete Step—Finish the step.

Configure the step

To configure the step, do the following:

Caution:

To reduce security vulnerabilities, only configure the Send Web Request step for trusted web pages and web apps.

  1. Create or edit a workflow diagram to access the Step Library panel.
  2. Drag Send Web Request from the Step Library panel to a connection arrow of a step on the workflow canvas.

    Learn more about adding steps to a workflow diagram

    The Step Details panel appears.

  3. Provide a name for the step in the Step Name text box.
  4. In the Arguments section, click Edit.
  5. Click the URL drop-down arrow and choose the type of request you want to send.
  6. Provide the URL of the REST endpoint in the URL text box.
  7. Optionally, add path variables to the URL using the following syntax:
    https://gisserver.domain.com/webadaptorname/apps/workflowmanager/:pathVariable/

    Path variables appear in the Path Variables section.

  8. If you added path variables to the URL, provide a value for each variable in the Path Variables section.
  9. Optionally, add query parameters to the web request by doing the following:
    1. Click Add Key & Value in the Query Parameters section.
    2. Provide a key in the Key text box.
    3. Provide a value in the Value text box.
    4. Leave the Enabled check box checked.
    5. Repeat these substeps to add more key-value pairs.
  10. Click the Authorization tab.
  11. Choose the REST endpoint's authentication method, and provide authentication information as necessary.
    Caution:

    Authentication information you provide in the step is not encrypted. To secure the information, add an encrypted user-defined setting to store the information and reference it in the step using dynamic job properties.

  12. Optionally, click the Headers tab, and add custom header key-value pairs to the web request by doing the following:
    1. Click Add Key & Value in the Custom Headers section.
    2. Provide a key in the Key text box.
    3. Provide a value in the Value text box.
    4. Leave the Enabled check box checked.
    5. Repeat these substeps to add more key-value pairs.
  13. Optionally, click the Body tab to add data to the web request.

    The request body supports form data key-value pairs, URL encoded key-value pairs, and raw data in JSON or plain text format.

    Tip:

    You can also use an ArcGIS Arcade expression to retrieve user-defined settings or provide a dynamic value in the body text.

  14. Optionally, if you have a license for ArcGIS Workflow Manager Server Advanced, configure the step's output settings.
  15. Click Save to close the Configure Web Request dialog box.
  16. Click the Options tab.
  17. Configure Step Options as necessary.
    • Manual—Run the step manually.
      • Optional—Allow the step to be finished without being run.
    • Automatic—Run the step as soon as it becomes active.
      Note:

      If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.

    • Run on a Schedule—Run the step according to a schedule you set.

      Learn more about scheduling options

  18. Optionally, provide help text for the step in the Step Help text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    
'For further assistance, please contact ' + jobCreator($job) + '.'
  19. Optionally, click the Style tab to change the shape and color of the step.
  20. Optionally, click the About tab and provide a description for the step in the Step Description text box.
    Note:

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.

Configure output settings

License:

This functionality requires a license for the ArcGIS Workflow Manager Server Advanced role.

The ArcGIS Workflow Manager Server Advanced role allows you to save the REST endpoint's response as a file, attach it to the job, and configure it as custom output values. The output values can be used to determine the path the workflow follows or used as inputs for other steps throughout the workflow. If no output value is configured for the step, the HTTP status code is stored as the step's output value.

To configure the step's output settings, complete the following steps:

  1. Click the Output tab on the Configure Web Request dialog box.

    If the Configure Web Request dialog box isn't available, click the Send Web Request step on the workflow canvas, and click Edit in the Arguments section of the Step Details panel.

  2. Optionally, turn on the Enabled toggle button in the Attach Response section to save the REST endpoint's response as a file and attach it to the job.
  3. Optionally, configure the attachment name and folder where the response will be stored by doing the following:
    1. Provide the name of the folder where the attachment will be stored in the Folder Name text box.

      The folder name can't contain special characters.

      Note:

      A folder named General is automatically created if no folder name is provided.

    2. Choose one of the following Attachment Name options:
      • Autogenerated—Automatically names the attachment using the following syntax: <StepName>_<RunDate>_<RunTime>
      • Custom—Allows a custom attachment name to be provided
  4. Optionally, configure custom output values for the REST endpoint's response by doing the following:
    1. Turn on the Test Mode toggle button in the Output Values section.
    2. Paste an example of the REST endpoint's response in the Sample Response text box.

      Example response in JSON format:

      {"access_token": "",
"expires_in":7199,
"spatialReference": {
  "wkid": 4326,
  "latestWkid": 4326
},
"locations": [
  {
    "name": "380 New York Street",
    "extent": {
      "xmin": -117.196701,
      "ymin": 34.055489
    }
  }
]}
    3. Click Add Output & Path.
    4. Provide a name for the output value in the Output Value text box.

      This is the value name that is used to obtain the custom output value.

    5. Provide a JSONPath expression in dot notation or bracket notation for the value that you want to store in the Extraction Path text box.

      Example JSONPath in dot notation:

      $.locations.0.name

      Example JSONPath in bracket notation:

      $['locations'][0]['name']

      The value appears in the Sample Result column.

    6. Optionally, repeat substeps c through e to add more custom output values.
  5. Click Save to close the Configure Web Request dialog box.

Return value

When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:

Return valuesDescription

S000001

The step completed successfully.

F000001

The step failed to complete successfully.

Output value

License:

This functionality requires a license for the ArcGIS Workflow Manager Server Advanced role.

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:

OutputDescriptionArcGIS Arcade expression syntax

Status

Returns the HTTP response code if no output value is configured for the step.

jobOutputValue($job, '<step_id>', 'Status')

<CustomOutputValue>

Returns the custom output value configured for the step.

jobOutputValue($job, '<step_id>', '<custom_output_value_name>')

Related topics

  • Create and manage workflow diagrams
  • Step templates
  • Evaluate the results of steps
  • Configure paths
  • Dynamic job properties
  • Test dynamic job properties

Feedback on this topic?

In this topic
  1. Configure the step
  2. Configure output settings
  3. Return value
  4. Output value