The scenario editor

The scenario editor allows you to create and edit scenarios in a visual interface.

The new scenario editor experience:

New scenario editor

The classic scenario editor experience

Scenario editor

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.

New and classic experiences

Workfront Fusion is transitioning the scenario editor to a new experience. During this transition, both the classic and new experiences are available, and you can switch between them at any time. We recommend using the new experience.

The new experience includes:

  • A redesigned canvas, with card-style modules, a minimap, and zoom controls.
  • New scenario editor controls, including Find and replace, Snippets, and Undo/Redo.
  • An Ask AI button.
  • An updated connector picker with category navigation and the ability to mark favorites inline.
  • A dark mode that follows your appearance setting.
  • The ability to fold a router to hide its routes.
  • Live Trail, a panel that shows a scenario run as it happens.
  • Several Developer Tools that are now built into the scenario editor.
  • Temporary debug logs, which you can turn on in the scenario settings.
  • A Search that finds module names, mapped values, module settings, and filter conditions, and keyboard shortcuts for common panel actions.

To switch between the classic and new experiences:

  1. In the scenario editor, locate the Try the new design toggle in the upper-right corner.
  2. Click the toggle to switch to the new experience.
  3. To return to the classic experience, click the toggle again.

The scenario reloads when you switch. Your choice is saved for your user, so it does not change the experience that your teammates see. Switching does not change the scenario itself.

If you do not see the toggle, the new experience might not be available to your organization yet. Contact your Workfront Fusion administrator.

Open the scenario editor and add a module:

  1. Click Scenarios Scenarios icon in the left panel.

  2. Click the placeholder module to open the list of apps and services.

  3. Select the app or service that you want to start with:

    • Browse by category using the panel on the left (Favorites, All apps, Adobe Workfront, Adobe Firefly Services, Adobe Creative & Content, Adobe Cloud Services, Generative AI, or Built-in).
    • Enter a term in the search box to filter the list.
    • To add a connector to your favorites, hover over the connecter, then click the star icon next the connector.

    For detailed information about configuring a module, see Configure a module.

Available scenario editor actions

Editing actions

These actions are available at the top of the screen, rather than in the bottom toolbar.

Top of the screen

Action
Details
Scenario name
The scenario’s name is shown at the top-left of the screen. To rename the scenario, click on the name and enter a new one.
Compact view
Toggle a view where modules on the canvas shrink to small tiles, the grid tightens, and long module names wrap instead of being cut off. Switching views does not reload the scenario.
Feedback
Send feedback about the new experience. This button is in the upper-right corner of the scenario editor, next to the Compact view toggle.
Undo
Undo icon
Undo the most recent actions, most recent first. You can undo actions from the current session only.
Redo
Redo icon
Redo recent actions. You can redo actions from the current session only.
History
Edit history icon
View a history of changes made in this session. You can also undo all session changes.

Scheduling

scheduling panel

Action
Details
Run once
Run once is icon-only in the new design. Hover over the icon to see the Run once tooltip. Here, you can test run the scenario and verify that the it runs as you expect before you activate it
Activation toggle
Activate or deactivate your scenario. After you activate it, the scenario will execute according to its schedule.
Schedule the scenario
By default, a scenario with a polling trigger runs every 15 minutes. You can change this by defining when and how often an activated scenario runs. Polled fusion scenarios can be scheduled to run as often as every 5 minutes. For more information, see Schedule a scenario.

Controls

You may need to click on the three-dot icon in the Controls area to view some of these controls.

controls panel

Action
Details

Save

Save icon

After saving your scenario, a new version will be available under the three-dot menu in case you need to access it in the future. Previously saved scenario versions are available for 60 days after the next scenario version is created.

To retain scenario version history beyond 60 days for audit purposes, we recommend saving and archiving a blueprint of the scenario in another location.

Scenario settings

Scenario settings icon

The scenario settings panel contains advanced settings for the scenario. For more information about the settings available, see Configure scenario settings. Request and response details are not kept for every run. To collect them for the scenario’s regular runs, turn on Temporary debug logs. For more information, see Temporary debug logs.

Notes

Notes icon

Make notes about the scenario. Other users can view these notes when they are in the scenario. For more information, see Add notes to a scenario.

Auto-align

Auto-align icon

Auto-align the modules in your scenario.

Search

Search icon

Open Search (press Ctrl + K on Windows or ⌘ K on Mac). Search finds modules by name or ID. It also finds every mapped value, every module setting, and every filter condition in the scenario. Each result shows where the match was found, for example Mapper · Approval ID, with the matching text highlighted. Filters are listed in their own section. To find every place that uses a value, paste a reference such as {{1.name}}. Search finds exactly that reference, but not {{21.name}} or {{1.names}}. Click a result to open the module or filter. The matching field is briefly highlighted and scrolled into view. As you move through filter results with the arrow keys, the canvas shows the filter and the two modules that it connects.

Find and replace

Find and replace icon

Search for and replace variables, mapped value sources, or connections across the scenario’s modules. Use the tabs to:

  • Replace a mapped variable across the whole scenario or in one module.
  • Remap references from one source module to another.
  • Copy a connection to one or all compatible modules from the same app.

The panel previews the modules that will be affected before you make the change. Select a row in the preview to go to that module on the canvas.

For more information, see Find and replace variables, sources, and connections in a scenario.

Snippets

Snippets icon

Snippets are scenario sections that are saved as a unit. To create one, select modules and save them as a snippet. In the Snippets panel, you can search, tag, preview, pin, sort, and drag and drop snippets, and import and export them. You can share snippets with teams or organizations, or send a copy directly to another user. Shared snippets display on their own tab.

For more information, see Save and reuse scenario sections with snippets.

Explain flow

Explain flow icon

View an animation where moving dots show how data flows through the scenario.

Export Blueprint

Export Blueprint icon

Export a blueprint of the current scenario. For more information, see Copy modules or scenarios.

Export as headless template

Export as headless template icon

Export the scenario as a headless template.

Import Blueprint

Import Blueprint icon

Import a previously exported scenario blueprint. For more information, see Copy modules or scenarios.

DevTool

DevTool icon

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. For more information, see Debug a scenario.

Previous Versions

Previous version icon

View previous versions of this scenario. For more information, see View and manage scenario versions.

Tools

tools panel

Action
Details
Flow control
Configure settings to control the way data flows through the scenario. For more information, see Flow control.
Tools
The tools section contains several useful modules that can enhance your scenarios. For more information, see Tools.
Text parser
Use the Text parser tool to parse text for use in other scenario modules. For more information, see Text parser.

Favorites

Favorites panel

You can use the Favorites icon to add modules you use often.

Action
Details
Your favorite connectors
The connectors you’ve marked as favorites are shown here.
Add favorite icon
Click this icon to select another connector to add to the favorites section.
Overflow icon
If you have more favorites than can fit in the toolbar, an overflow (three-dot) icon displays so you can access the rest.

Ask AI

Ask AI button

Click Ask AI to open Adobe’s AI Assistant. This option may not be available based on your organization’s AI settings.

Canvas navigation

Canvas navigation controls

Action
Details
Zoom in / zoom out
Zoom the canvas view in or out.
Focus
Return to a view that fits your whole scenario on the screen.
Minimap
View a thumbnail overview of the entire scenario. The minimap shows your current viewport. Click within it, or click and drag, to move around the canvas.

Canvas display

The new canvas also changes how scenarios look as you work.

Feature
Details
Module cards
Each module is a horizontal card that shows the app icon, module name, description, and module ID. Routers display as a compact branch tile, and directives display as small accent cards.
Links
Links between modules are curved and end in arrowheads that show direction. Error handler links are dashed.
Module status
Green, yellow, and red indicators show the status of each module.
Zoom detail
Card details display as you zoom in. When you zoom out, modules simplify to icons so that you can still see the whole scenario.
Fold a router
In edit mode, you can fold a router to hide its routes. For more information, see Fold a router.
Dark mode
The canvas follows your dark appearance setting under your Adobe preferences, including module cards, links, panels, controls, and status information.
Open module or filter
When you open a module, the canvas no longer moves. Instead, the module gets a moving dashed outline. When you open a filter, its label on the connection gets the same outline. The outline color matches the module’s color and adjusts automatically so that it stays visible in light and dark mode.
Right-side panel
Module setup, module inspection, the module browser, Find and replace, Snippets, Live Trail, and request and response details open in the same panel on the right side of the canvas.
To resize the panel, drag its left edge to make it wider or narrower, or double-click the edge to return to the default width. Your width is remembered, including when you sign in from another browser. On a smaller screen, the panel automatically fits the window. While a panel is maximized, you can’t change its width.

Keyboard shortcuts

These shortcuts help you work in panels without moving the mouse.

Shortcut (Mac / Windows)
What it does
⌘ Enter / Ctrl + Enter
Confirms the open panel (same as OK). Works while you type. With no panel open, runs the scenario once.
Esc
Closes the open panel without saving. If the mapping panel is open, closes only that panel.
⌥ ← / ⌥ → (Mac), Alt + ← / Alt + → (Windows)
Confirms the panel and opens the previous or next module. Also available as the ‹ › buttons in the panel header. Works when the cursor is not in a text field.
⌘ Shift + Enter / Ctrl + Shift + Enter
Confirms the open panel and runs the scenario once. Nothing runs if the panel has errors.
⌘ K / Ctrl + K
Opens Search.
?
Shows the list of all scenario designer shortcuts. Also available from the three-dot menu, under Keyboard shortcuts.
  • Wide panels show a reminder of the confirm and cancel shortcuts at the bottom.
  • The Run once and Save buttons show their shortcuts in their tooltips.
  • When you move to the next or previous module and it is hidden behind the panel or off-screen, the canvas moves just enough to show it.

Use the scenario editor in the classic experience

Open the scenario editor and add a module: (Classic)

  1. Click Scenarios Scenarios icon in the left panel.
  2. Click the question mark icon question icon , then find and click the app or service that you want to start with. For detailed information about configuring a module, see Configure a module.

Available scenario editor actions (Classic)

Run your scenario (Classic)

run scenario button

Action
Details
Test-run the scenario
Verify that the scenario runs as you expect before you activate it. Once activated, the scenario will execute according to its schedule. If everything does not run as expected, see Add error handling to learn how to handle errors.

Scheduling (Classic)

scheduling panel

Action
Details
Schedule the scenario
By default, a scenario runs every 15 minutes. You can change this by defining when and how often an activated scenario runs. Fusion scenarios can be scheduled to run as often as every 5 minutes. For more information, see Schedule a scenario.

Controls (Classic)

You may need to click on the three-dot icon in the Controls area to view some of these controls.

controls panel

Action
Details

Save

Save icon

After saving your scenario, a new version will be available under the three-dot menu in case you need to access it in the future. Previously saved scenario versions are available for 60 days after the next scenario version is created.

To retain scenario version history beyond 60 days for audit purposes, we recommend saving and archiving a blueprint of the scenario in another location.

Scenario settings

Scenario settings icon

The scenario settings panel contains advanced settings for the scenario. For more information about the settings available, see Configure scenario settings.

Notes

Notes icon

Make notes about the scenario. Other users can view these notes when they are in the scenario.

Auto-align

Auto-align icon

Auto-align the modules in your scenario.

Search modules

Search modules

Enter a search term to locate a module, then click the search results to be taken to that module. You can search by module name, ID, type, or application.

Explain flow

Explain Flow icon

View an animation where moving dots show how data flows through the scenario.

DevTool

DevTool icon

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. For more information, see Debug a scenario.

Export Blueprint

Export Blueprint icon

Export a blueprint of the current scenario.

Export as headless template

Export as headless template icon

Export the scenario as a headless template.

Import Blueprint

Import Blueprint icon

Import a previously exported scenario blueprint.

Previous Version

Previous version icon

View previous versions of this scenario.

Tools (Classic)

tools panel

Action
Details
Flow control
Configure settings to control the way data flows through it. For more information, see Flow control.
Tools
The tools section contains several useful modules that can enhance your scenarios. For more information, see Tools.
Text parser
Use the Text parser tool to parse text for use in other scenario modules. The Text parser does not require a connection. For more information, see Text parser.

Favorites (Classic)

Favorites panel

You can use the Favorites icon to add modules you use often.

recommendation-more-help
workfront-fusion-help-workfront-fusion