Export Consumption workflows to a Standard logic app
Standard logic app workflows, which run in single-tenant Azure Logic Apps, offer many new and improved capabilities. For example, you get compute isolation, virtual network integration, and private endpoints along with App Services Environment hosting, local development and debugging using Visual Studio Code, low latency with stateless workflows, and more.
If you want the benefits from Standard workflows, but your workflows run in multitenant Azure Logic Apps, you can now move your Consumption workflows to single-tenant Azure Logic Apps. This switch makes sense in scenarios that require some of the Standard capabilities such as isolation and network integration, lower latency or better predictability of costs.
You can now export Consumption logic apps to a Standard logic app. Using Visual Studio Code and the latest Azure Logic Apps (Standard) extension, you export your logic apps as stateful workflows to a Standard logic app project. You can then locally update, test, and debug your workflows to get them ready for redeployment. When you're ready, you can deploy either directly from Visual Studio Code or through your own DevOps process.
Note
The export capability doesn't migrate your workflows. Instead, this tool replicates artifacts, such as workflow definitions, connections, integration account artifacts, and others. Your source logic app resources, workflows, trigger history, run history, and other data stay intact.
You control the export process and your migration journey. You can test and validate your exported workflows to your satisfaction with the destination environment. You choose when to disable or delete your source logic apps.
This article provides information about the export process and shows how to export your logic app workflows from a Consumption workflow to a local Standard logic app project in Visual Studio Code.
Known issues and limitations
The export tool doesn't export any infrastructure information, such as integration account settings.
The export tool can export logic app workflows with triggers that have concurrency settings. However, single-tenant Azure Logic Apps ignores these settings.
Logic apps must exist in the same region if you want to export them within the same Standard logic app project.
By default, connection credentials aren't cloned from source logic app workflows. Before your logic app workflows can run, you'll have to reauthenticate these connections after export.
By default, if an Azure connector has a built-in connector version, the export tool automatically converts the Azure connector to the built-in connector. No option exists to opt out from this behavior.
Exportable operation types
Operation | JSON type |
---|---|
Trigger | Built-in: Http , HttpWebhook , Recurrence , manual (Request) Managed: ApiConnection ApiConnectionNotification , ApiConnectionWebhook |
Action | Built-in: AppendToArrayVariable , AppendToStringVariable , Compose , DecrementVariable , Foreach , Http , HttpWebhook , If , IncrementVariable , InitializeVariable , JavaScriptCode , Join , ParseJson , Response , Scope , Select , SetVariable , Switch , Table , Terminate , Until , Wait - Managed: ApiConnection , ApiConnectionWebhook |
Prerequisites
One or more logic apps to deploy to the same subscription and Azure region, for example, East US 2.
Azure reader subscription-level access to the subscription where the logic apps are currently deployed.
Azure contributor resource group-level access, if you select the option for Deploy managed connectors.
Review and meet the requirements for how to set up Visual Studio Code with the Azure Logic Apps (Standard) extension.
Note
Make sure to install version 2.0.16 or higher for the Azure Logic Apps (Standard) extension for Visual Studio Code. Some conversion scenarios require the latest workflow designer, which is available with this version.
Group logic apps for export
With the Azure Logic Apps (Standard) extension, you can combine multiple Consumption logic app workflows into a single Standard logic app project. In single-tenant Azure Logic Apps, one Standard logic app resource can have multiple workflows. With this approach, you can pre-validate your workflows so that you don't miss any dependencies when you select logic apps for export.
Consider the following recommendations when you select logic apps for export:
Group logic apps where workflows share the same resources, such as integration account artifacts, maps, and schemas, or use resources through a chain of processes.
For the organization and number of workflows per logic app, review Best practices and recommendations.
Export Consumption workflows to a local project
Select logic apps for export
In Visual Studio Code, sign in to Azure, if you haven't already.
On the Visual Studio Code Activity Bar, select Azure to open the Azure window (Shift + Alt + A).
On the Workspace section toolbar, from the Azure Logic Apps menu, select Export logic app.
After the Export tab opens, select your Azure subscription and region, and then select Next.
Select the logic apps to export. Each selected logic app appears on the Selected logic apps list to the side.
Tip
You can also search for logic apps and filter on resource group.
The export tool starts to validate whether your selected logic apps are eligible for export.
In the Advanced options section, you can select the following options:
Option Default Description Generate Infrastructure Template On The export process creates infrastructure templates, which include one ARM template for the Standard logic app and one ARM template for each exported Azure-managed connection. Clone Connection Credentials Off The export process clones credentials from the original Azure-managed connection to the new Azure-managed connection created in Azure, as part of deployment. Works only in cases where the exported connection remains an Azure-managed connection, for example, an Office 365 Outlook connection.
Important: Carefully use this option. By default, two new connections will point at the same resource, which can potentially create race conditions.Default to integration account as source for transformations and validation Off Either reference map and schema files locally or in an integration account. If enabled, don't copy maps and schemas to the destination project. Requires that you add a reference to an integration account in the app setting for your logic app. By default, the Transform XML and XML Validation actions use the integration account as the source. Export custom connectors as API Management actions Off If enabled, custom connectors are created as API Management actions, rather than HTTP actions, so that you can implement custom actions as API operations in API Management. For more information, see Azure Logic Apps Standard options for connecting to customer services or APIs. When you're done, select Next.
Review export validation results
After export validation completes, review the results by expanding the entry for each logic app.
Logic apps that have errors are ineligible for export. You must remove these logic apps from the export list until you fix them at the source. To remove a logic app from the list, select Back.
For example, SourceLogicApp2 has an error and can't be exported until fixed:
Logic apps that pass validation with or without warnings are still eligible for export. To continue, select Export if all apps validate successfully, or select Export with warnings if apps have warnings.
For example, SourceLogicApp3 has a warning, but you can still continue to export:
The following table provides more information about each validation icon and status:
Validation icon Validation status Item passed validation, so export can continue without problems to resolve. Item failed validation, so export can't continue.
The validation entry for the failed item automatically appears expanded and provides information about the validation failure.Item passed validation with a warning, but export can continue with required post-export resolution.
The validation entry for the item with a warning automatically appears expanded and provides information about the warning and required post-export remediation.After the Finish export section appears, for Export location, browse and select a local folder for your new Standard logic app project.
If your workflow has managed connections that you want to deploy, which is only recommended for non-production environments, select Deploy managed connections, which shows existing resource groups in your Azure subscription. Select the resource group where you want to deploy the managed connections.
Under After export steps, review any required post-export steps, for example:
Based on your scenario, select Export and finish or Export with warnings and finish.
The export tool downloads your project to your selected folder location, expands the project in Visual Studio Code, and deploys any managed connections, if you selected that option.
After this process completes, Visual Studio Code opens a new workspace. You can now safely close the export window.
From your Standard logic app project, open and review the README.md file for the required post-export steps.
Post-export steps
Remediation steps
Some exported logic app workflows require post-export remediation steps to run on the Standard platform.
From your Standard logic app project, open the README.md file, and review the remediation steps for your exported workflows. The export tool generates the README.md file, which contains all the required post-export steps.
Before you make any changes to your source logic app workflow, make sure to test your new Standard logic app resource and workflows.
Integration account actions and settings
If you export actions that depend on an integration account, you have to manually set up your Standard logic app with a reference link to the integration account that contains the required artifacts. For more information, review Link integration account to a Standard logic app.
Batch actions and settings
If you export actions that use Batch actions with multiple configurations stored in an integration account, you have to manually configure your Batch actions with the correct values after export. For more information, review Send, receive, and batch process messages in Azure Logic Apps.
Project folder structure
After the export process finishes, your Standard logic app project contains new folders and files alongside most others in a typical Standard logic app project.
The following table describes these new folders and files added by the export process:
Folder | File | Description |
---|---|---|
.development\deployment | LogicAppStandardConnections.parameters.json | Azure Resource Manager template parameters file for deploying managed connectors |
LogicAppStandardConnections.template.json | Azure Resource Manager template definition for deploying managed connectors | |
LogicAppStandardInfrastructure.parameters.json | Azure Resource Manager template parameters file for deploying Standard logic app resource | |
LogicAppStandardInfrastructure.template.json | Azure Resource Manager template definition for deploying Standard logic app resource | |
.logs\export | exportReport.json | Export report summary raw file, which includes all the steps required for post-export remediation |
exportValidation.json | Validation report raw file, which includes the validation results for each exported logic app | |
README.md | Markdown file with export results summary, including the created logic apps and all the required next steps |