Add and configure Send Web Request

The Send Web Request step allows you to send requests to REST endpoints to get data or post updates. If 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.

The step can be finished by clicking the Complete Step button .

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. Type 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 in the 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 your request.
   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 substeps a through d 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 to add custom header key-value pairs to your request.
    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 substeps a through d to add more key-value pairs.
13. Optionally, click the Body tab to add data to your 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 Arcade expression to retrieve user-defined settings or provide a dynamic values 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 be used as inputs for other steps throughout the workflow. If an output value is not configured for the step, the HTTP status code is stored as the step's output value. To configure the step's output settings, do the following:

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, click 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, perform these steps to configure the attachment name and folder in which it will be stored:
   1. Provide the name of the folder in which the attachment will be stored in the Folder Name text box.

      The folder name can't contain special characters.

      Note:

      If a folder name isn't provided, a folder named General is automatically created.

   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, perform these steps to configure custom output values for the REST endpoint's response:
   1. Click 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:

      $.access_token

      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 values	Description
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:

Output	Description	ArcGIS Arcade expression syntax
Status	Returns the HTTP response code if an output value isn't configured for the step.	jobOutputValue($job, '<step_id>', 'Status')
<CustomOutputValue>	Returns the custom output value you configured for the step.	jobOutputValue($job, '<step_id>', '<custom_output_value_name>')