Debug a scenario

The Adobe Workfront Fusion Devtool helps you to understand and troubleshoot scenarios. Using the Devtool, you can check all the manual runs of your scenario, review all the performed operations, and see the details of every API call performed. You can see which module, operation, or single response caused the error, and use that knowledge to refine your scenario.

NOTE
Logging in the debugger panel will be limited or unavailable for confidential scenarios, automatic executions, and successful operations.
NOTE
In the new experience, several DevTool tools are built into the scenario editor, so you can use them without opening the DevTool:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
Tool Where to find it in the new experience
Get app metadata Right-click a module and select App metadata.
Copy mapping Right-click the source module, select Copy mapping, then paste it on a compatible module.
Copy filter Right-click the filtered link, select Copy filter, then paste it on another link.
Copy module name Right-click a module and select Copy module name or Paste module name.
Swap connection Open Find and replace, then use the Connection tab.
Swap variable Open Find and replace, then use the Variable tab.
Remap source Open Find and replace, then use the Source tab.
These tools are also still available on the Tools tab of the DevTool, along with Focus a module, Find modules by mapping, and Base 64. You can also use the base64() and binary-conversion functions in mappings.
You can also view request and response details directly from Live Trail and execution history in the scenario editor. For more information about Find and replace, see Find and replace variables, sources, and connections in a scenario.

For a video introduction and walkthrough of the Fusion Devtool, see

Access requirements

Expand to view access requirements for the functionality in this article.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront package

Any Adobe Workfront Workflow package and any Adobe Workfront Automation and Integration package

Workfront Ultimate

Workfront Prime and Select packages, with an additional purchase of Workfront Fusion.

Adobe Workfront licenses

Standard

Work or higher

Product If your organization has a Select or Prime Workfront package that does not include Workfront Automation and Integration, your organization must purchase Adobe Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

Access the Devtool

If you use Fusion in the Adobe Unified Shell, or have updated to the new Fusion experience, you can access the Devtool from the Scenario editor.

Access the Devtool in the new experience

  1. Go to the Scenario editor for the scenario you want to debug.

    To locate the Scenario editor, see The scenario editor.

  2. Click the three-dot icon in the Controls area, then select DevTool.

Or:

  1. Go to the Scenario editor for the scenario you want to debug.
  2. Right-click in an empty area of the page (not on a module).
  3. Select Open Devtool.

The DevTool opens in a panel below the canvas.

Access the Devtool in the classic experience

  1. Click the Helper tools Helper tools icon near the bottom of the screen.

Or:

  1. Go to the Scenario editor for the scenario you want to debug.

    To locate the Scenario editor, see The scenario editor.

  2. Right click in an empty area of the page (not on a module).

  3. Select Open Devtool.

Use the Workfront Fusion Devtool

Workfront Fusion Devtool is divided into 3 main sections, plus a help link. You can find these in the left panel of your Devtool window.

Live Stream

Live Stream displays what is happening in the background when you click Run once in your scenario.

  1. Click the Live Stream icon Live stream icon to open the Live Stream section.

  2. Do any of the following:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto
    Action Instructions
    View request information

    You can view the following information for each module in your scenario

    • Request Headers (API endpoint URL, http method, time and date the request was called, request headers, and query string)

    • Request Body

    • Response Headers

    • Response Body

    To view this information, click the appropriate tab in the right panel of the Workfront Fusion Devtool.

    Search events by content Enter the search term into the search field in the left panel of the Workfront Fusion Devtool to display only requests that contain the search term.
    Clear list of requests Click the trash bin icon in the top-right corner of the Devtool's left panel to clear the list of requests recorded by the Workfront Fusion Devtool.
    Retrieve the Request in the Raw JSON Format or cURL
    • Raw JSON

      Click Copy RAW in the upper-right corner of the Devtool's right pane.

    • cURL

      Click Copy cURL in the upper-right corner of the Devtool's right pane.

Scenario Debugger

NOTE
To quickly go to the debugger from a scenario that has errored out, you can click Get details in the error message in the module output.
Get details in module output

The Scenario Debugger is useful for more complex scenarios. It displays the history of the scenario runs and enables you to search modules by their name or ID.

  1. Click the Scenario Debugger icon Debugger icon to open the Scenario Debugger.

    The Scenario Debugger lists the modules in your scenario. Each module shows its name, the app and action, and a numbered badge with the module ID.

  2. (Optional) Enter the search term (name or module ID) in the Search modules by Name or ID field.

  3. Click the module name.

    The cycles of the module’s most recent run are listed next to the module list. If the module has no run data, the Scenario Debugger displays No Result found.

  4. Expand a cycle, then click an operation.

    Each operation shows whether it succeeded and how long it took, for example Operation 1 with a duration of 0 ms.

  5. Review the details of the request. Use the tabs to view:

    • Request Headers: The API endpoint URL, the HTTP method, when the request was called, and the request headers.
    • Request Body
    • Response Headers
    • Response Body
  6. (Optional) To copy the request, click Copy RAW or Copy cURL.

Tools

The Workfront Fusion Devtool features tools that make setting up your scenario easier.

  1. Click the Tools icon Console tools icon to open the Tools.
  2. (Optional) To find a tool, enter its name in the Search tool by name field.
  3. Select the tool you want to use
  4. Configure the fields as detailed below.
  5. Click Run.

Until you select a tool, the right side of the panel prompts you to select one. A link at the bottom of the Tools tab takes you to the article about the DevTool.

Tools and their fields:

Focus a Module

Opens settings of the specified module by ID.

Module ID
Enter the ID of the module to open its settings.

Find Modules by Mapping

Allows you to search modules’ values for a specified term. The output contains IDs of modules that contain the term you have searched for.

Keyword
Enter the term you want to search for.
Use Only Values

Enable this option to only search in module fields' values.

Disable this option to also search in module fields' names.

The search is performed through the name and label parameters.

Get App Metadata

Retrieves metadata of the app by the app’s module name or ID. This is useful, for example, when you need to know the version of the app used in your scenario.

Source Module
Select the module for which you want to retrieve metadata.

Copy Mapping

Copies values from the source module to the target module.

CAUTION
Make sure you set the correct source and target modules. If you select a different type of module, values in the target module will be deleted.
Source Module
Select the module or enter the ID of the module from which you want to copy field values.
Target Module

Select the module or enter the ID of the module into which you want to insert the source module values.

Important: Values in the target module will be overwritten.

Copy Filter

Copies the filter settings from the source module to the target module.

NOTE
The copy action is performed on the filter placed on the left side of the selected module.
Source Module
Select the module or enter the ID of the module from which you want to copy filter values.
Target Module

Select the module or enter the ID of the module into which you want to insert the filter values from the source module.

Important: Values in the target module will be overwritten.

Preserve Fallback Route setting
The source filter is set as the fallback route. Enable this option to also set the the target filter is set as the fallback route.

Copy Module Name

Copies the name of the selected module to your clipboard.

Module
Select the module that you want to copy the name of.

Swap Connection

Duplicates a connection from the source module to every module in the scenario of the same app.

Source Module
Select the module or enter the ID of the module from which you want to duplicate the connection.

Swap Variable

Searches for specified variables in the scenario and replaces them with a new variable.

Variable to Find
Locate the variable pill that you want to replace from the variable module in your scenario and copy it to this (Variable to Find) field. In the field, it appears with double curly brackets. Example: {{5.value}}.
Replace With
Locate the variable pill that you want to replace the variable with from the variables module in your scenario and copy it to this (Variable to Find) field. In the field, it appears with double curly brackets. Example: {{5.value}}.
Module
Select the variables module in which you want to replace the variable. If no module is selected, the variable will be replaced in the entire scenario.

Base 64

Allows you to encode the entered data to Base64 or to decode Base64. Some requests are encoded to Base64. This tool can be useful when you want to search for particular data in the encoded request.

Operation
Select whether you want to encode the data from the Raw Data field to Base64 or decode Base64 to Raw Data.
Raw Data
Enter the data you want to encode to Base64, or Base64 if you want to decode to raw data, depending on the option selected in the Operation field above.

Remap Source

Allows you to change the mapping source from one module to another.

You must first add the module you want to use as a source module to the route in your scenario.

Source Module
Select the module you want to be replaced as the mapping source for other modules in your scenario.
Target Module
Select the module you want to use as a new mapping source.
Module to Edit
Select the module you want to change the mapping for if you don't want to change the mapping in the entire scenario.
recommendation-more-help
workfront-fusion-help-workfront-fusion