Debug scenarios with the Adobe Workfront Fusion DevTool

The Adobe Workfront Fusion DevTool allows you to understand and troubleshoot scenarios. The DevTool adds an extra panel to the Chrome Developer Tools. Using this debugger panel, 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.

Access requirements

You must have the following access to use the functionality in this article:

Adobe Workfront plan*

Pro or higher

Adobe Workfront license*

Plan, Work

Adobe Workfront Fusion license**

Workfront Fusion for Work Automation and Integration

Workfront Fusion for Work Automation

Product Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

*To find out what plan, license type, or access you have, contact your Workfront administrator.

**For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses

Install the Chrome DevTool extension

To use the Workfront Fusion DevTool, you first need to install it.

  1. Click this link to download the extension.

  2. When the files have downloaded, extract them to a folder of your choice.

  3. Open a tab in Chrome

  4. In the search bar of the tab, enter chrome://extensions.

  5. Click the Developer mode toggle at the upper-right of the screen to enable Developer mode. If the toggle to the right, developer mode is enabled.

  6. Click Load unpacked.

  7. Select the folder containing the DevTool (where you extracted the files in step 2).

    Once unpacked, the DevTool appears among your other Chrome extensions.

Locate the Workfront Fusion DevTool

To use the Workfront Fusion DevTool, you must add the Workfront Fusion DevTool extension to your Chrome browser, as described in Install the Chrome DevTool extension.

  1. Open your Workfront Fusion scenario.

  2. Open Chrome Developer Tools:

    Mac Command + Option + I
    Windows

    Control + Shift + I

    Or

    F12

    TIP

    We recommend docking the Chrome Developer Console to the bottom to maintain a better view of your modules.

  3. Click the Workfront Fusion tab in Chrome Dev Tools.

Use the Workfront Fusion DevTool

Workfront Fusion DevTool is divided into 3 main sections. 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 to open the Live Stream section.

  2. Do any of the following:

    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 requests and responses

    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.

    Remove 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.

    Enable Console Logging

    Click the computer icon in the top-right corner of the DevTool's left panel.

    Logging in the console is enabled when the computer icon is green.

    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

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 to open the Scenario Debugger.
  2. (Optional) Enter the search term (name or module ID) in the search field in the left pane of Workfront Fusion DevTool in the Scenario Debugger section.
  3. Double-click the module’s name to open its settings in the scenario editor.
  4. View request details by clicking the desired operation.

Tools

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

  1. Click the Tools icon to open the Tools.
  2. Select the tool you want to use
  3. Configure the fields as detailed below.
  4. Click Run.

Tools and their fields:

Focus a Module

Opens settings of the specified module by ID.

Module ID Enter the ID of the module for which you want to open 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.

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 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 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 module in which you want to replace the variable. If no module is selected, the variable will be replaced in the entire scenario.

Swap App

Replaces the selected app version in your scenario with another app version.

This can be used, for example, to upgrade Gmail and Email apps’ modules to the latest version.

App to be Replaced

Select the app that you want to replace.

Replace with

Select the app that you want to replace it with.

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.

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.

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.

Highlight App

Highlights modules of the specified app in your scenario.

App to be Highlighted

Select the app you want to be highlighted in your scenario.

Version

Select the version of the app you want to be highlighted.

Highlight Color

Enter the color hex you want to use for highlighting modules.

Migrate GS

This tool is made especially to upgrade Google Sheets (legacy) modules to the latest Google Sheets version. It adds a new version of the module just after the legacy version of the module in the scenario route.

This module does not require that you set any parameters.

On this page