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.
For a video introduction and walkthrough of the Fusion Devtool, see
Access requirements
You must have the following access to use the functionality 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.
Access the Workfront Fusion Devtool
Accessing the Devtool differs based on whether you are using Fusion in the Adobe Unified Experience.
Access the Devtool in the Adobe Unified Experience
If you use Fusion in the Adobe Unified Shell, you can access the Dev Tool from the Scenario editor.
-
Go to the Scenario editor for the scenario you want to debug.
To locate the Scenario editor, see Scenario editor.
-
Right click in an empty area of the page (not on a module).
-
Select Open Devtool.
Access the Devtool in the classic Fusion experience
To use the Devtool in the classic Fusion experience, you must install a Chrome extension. You can then use this extension from the Chrome Developer Tools.
Install the Chrome Devtool extension
You can add the Workfront Fusion Devtool to Chrome through the Chrome Web Store.
- Click this link to go to the Workfront Fusion Devtool on the Chrome Web Store.
- Click Add to Chrome.
- In the window that opens, examine permissions. If you agree with the permissions, click Add Extension.
The Workfront Fusion Devtool extension is added to your 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.
-
Open your Workfront Fusion scenario.
-
Open Chrome Developer Tools:
table 0-row-2 1-row-2 layout-auto html-authored no-header Mac Command + Option + I Windows Control + Shift + I
Or
F12
note tip TIP We recommend docking the Chrome Developer Console to the bottom to maintain a better view of your modules. -
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.
-
Click the Live Stream icon to open the Live Stream section.
-
Do any of the following:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-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 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.
- Click the Scenario Debugger icon to open the Scenario Debugger.
- (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.
- Double-click the module’s name to open its settings in the scenario editor.
- View request details by clicking the desired operation.
Tools
The Workfront Fusion Devtool features tools that make setting up your scenario easier.
- Click the Tools icon to open the Tools.
- Select the tool you want to use
- Configure the fields as detailed below.
- Click Run.
Tools and their fields:
Focus a Module
Opens settings of the specified module by ID.
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.
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.
Copy Mapping
Copies values from the source module to the target module.
Copy Filter
Copies the filter settings from the source module to the target module.
Swap Connection
Duplicates a connection from the source module to every module in the scenario of the same app.
Swap Variable
Searches for specified variables in the scenario and replaces them with a new variable.
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.
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.
Copy Module Name
Copies the name of the selected module to your clipboard.
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.
Highlight App
Highlights modules of the specified app in your scenario.
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.