Edit

Share via


Navigate the Standard workflow designer in single-tenant Azure Logic Apps

Applies to: Azure Logic Apps (Standard)

This guide summarizes common tasks for using the designer to create, edit, and run Standard workflows in the Azure portal. You can also find highlights and key changes between the classic designer and preview designer.

For example, the preview designer has the following key changes:

  • The designer now shows and saves your workflow as a draft version, not the production version.

  • The designer toolbar options are now consolidated. The workflow sidebar no longer exists.

    Instead, commonly used options now appear at the designer top and bottom. Other options appear in the vertical ellipsis menu (), next to the Publish button.

For more detailed changes, see Differences in the preview designer.

Prerequisites

Differences in the preview designer

To help you quickly learn the preview designer layout, this section summarizes the key differences from classic designer.

  • By default, the designer now shows and saves your workflow as a draft version, not the production version.

  • Your production workflow stays unchanged until you publish your draft workflow.

  • When you run the workflow from the designer, the draft workflow runs, not the production workflow.

  • To view the production workflow, in the designer upper-right corner, open the vertical ellipsis menu (), and select Switch to published version.

    The production workflow opens in read-only view.

  • The preview designer moves many familiar actions to new locations:

    • To open different views for your workflow, at the designer top, on the view selector, select Workflow, Code, or Run history.

    • To run your draft workflow, use the Run and Run with payload options at the designer bottom.

    • In the designer upper-right corner, the new vertical ellipsis menu () appears next to the new Publish button. This menu contains other actions that appeared on the workflow sidebar and workflow toolbar.

  • The workflow assistant is available only in the classic designer.

Open the workflow designer

Follow these steps to open the workflow designer.

  1. In the Azure portal, open your Standard logic app resource.

  2. On the logic app sidebar, under Workflows, select Workflows.

    From here, you can create a new workflow or open an existing workflow in the designer.

Create a new workflow

Follow these steps to create a new workflow in your logic app.

  1. On the Workflows page toolbar, select + Create.

    The Create workflow pane appears and shows the available workflow types.

  2. For Workflow name, enter a name for your workflow.

  3. Select from the following workflow types:

    Workflow type Description
    Autonomous agents Stateful workflows that use AI agents to complete tasks. They can start with any trigger, such as an event, schedule, or API call.
    Conversational agents Stateful workflows that use AI agents to complete tasks through chat interactions.
    Stateful Workflows that include run history. You can add agents to build intelligent automation integrations.
    Stateless Workflows that don't include run history. Optimized for speed and ideal for request-response and processing IoT events.
  4. When you're done, select Create.

    The designer opens and shows an empty workflow or a partial workflow, based on your selection. In most cases, the workflow includes a prompt to add a trigger.

Open an existing workflow in the designer

Follow these steps to open an existing workflow in your logic app.

  1. In the Azure portal, open your Standard logic app resource.

  2. On the logic app sidebar, under Workflows, select Workflows.

  3. On the Workflows page, select your workflow.

    The designer opens and shows the selected workflow so that you can edit the steps, run the draft workflow, view the workflow run history, view the JSON workflow definition in code view, or other tasks.

Add a trigger or action to a workflow

The designer provides a visual way to add, edit, and delete steps in your workflow. As the first step, always start by adding a trigger to start your workflow. You can then continue building the workflow by adding one or multiple actions that run after the trigger fires.

To add a trigger or an action to your Standard workflow, see Build a workflow with a trigger or action in Azure Logic Apps. Then, configure your trigger or action as needed.

  • Required parameters show a red asterisk (*) next to the parameter name.

  • Some triggers and actions might require you to create a connection for a service or product. You might need to sign in to an account, or enter user credentials. For example, to use the Office 365 Outlook connector action for sending an email, you need to authorize your Outlook email account.

  • Some trigger or action parameters let you provide expressions or dynamic content, which are outputs from previous steps, rather than hardcoded or static values.

Save your changes

You must manually save your changes. On the designer toolbar, select Save.

If validation errors happen when save operations, the designer shows validation messages.

Switch between designer, code, and run history views

On the workflow sidebar, under Tools, you can choose from the following views: Workflow, Code, and Run history.

  • To build, edit, and run your workflow, select Workflow.

  • To edit the workflow definition in JSON, select Code.

    Tip

    Code view is an easy way to find and copy the workflow definition, rather than use Azure CLI or other methods.

  • To view your workflow run history, chronological execution, operation status, inputs, and outputs, select Run history.

Run workflow

To run your workflow, on the designer toolbar, select Run or Run with payload.

Validate changes and deploy to production

When you save your workflow, the Azure portal automatically validates and publishes your changes to production.

Return to classic designer

To go back to using the classic designer, in the preview designer upper-right corner, from the vertical ellipsis menu (), select Revert to previous experience.

Other tasks

You can perform other tasks on your workflow. You'll find the options for these tasks in different locations, based on the classic designer or preview designer.

You can find other actions either on the workflow toolbar or workflow sidebar.

The workflow toolbar includes these additional options:

Options Description
Discard Discard changes since the last manual save.
Parameters Create workflow parameters across environments. See Create cross-environment parameters for workflow inputs.
Connections View connections in your workflow.
Errors View workflow validation errors.
AI > Assistant Open the workflow assistant. See Get AI-powered help about Standard workflows in Azure Logic Apps.
AI > Download workflow summary Generate a Markdown file that summaries the workflow's purpose and tasks.
Info > File a bug Create a bug in the GitHub issues for Azure Logic Apps.

The workflow sidebar includes these options under Configuration:

Options Description
Access keys View or regenerate workflow access keys.
Settings View workflow state or change the state between Enabled and Disabled.
Properties View workflow health, version, and other information.