Merge pull request #208070 from ecfan/schema

Azure Logic Apps: Freshness and refactor - connectors-schema-migration.md

Author: Stacyrch140

.openpublishing.redirection.json

@@ -18308,6 +18308,11 @@
   "redirect_url": "/connectors/twilio",
   "redirect_document_id": false
 },
+{
+  "source_path_from_root":  "/articles/connectors/connectors-schema-migration.md",
+  "redirect_url":  "/azure/logic-apps/update-consumption-workflow-schema",
+  "redirect_document_id":  false
+},
 {
     "source_path_from_root":  "/articles/logic-apps/logic-apps-scenario-error-and-exception-handling.md",
     "redirect_url":  "/azure/logic-apps/logic-apps-exception-handling",

articles/connectors/connectors-schema-migration.md

@@ -384,8 +384,8 @@
       href: plan-manage-costs.md
     - name: Move logic app resources
       href: move-logic-app-resources.md
-    - name: Migrate to latest schema
-      href: ../connectors/connectors-schema-migration.md
+    - name: Update schema for Consumption workflows
+      href: update-consumption-workflow-schema.md
   - name: Test
     items:
     - name: Test logic apps with mock data

articles/connectors/media/connectors-schema-migration/update-schema.png

@@ -0,0 +1,45 @@
+---
+title: Update Consumption workflows to latest workflow schema
+description: Update Consumption logic app workflows to the latest Workflow Definition Language schema in Azure Logic Apps.
+services: logic-apps
+ms.suite: integration
+ms.reviewer: estfan, azla
+ms.topic: how-to
+ms.date: 08/15/2022
+---
+
+# Update Consumption logic app workflows to latest Workflow Definition Language schema version in Azure Logic Apps
+
+If you have a Consumption logic app workflow that uses an older Workflow Definition Language schema, you can update your workflow to use the newest schema. This capability applies only to Consumption logic app workflows.
+
+## Best practices
+
+The following list includes some best practices for updating your logic app workflows to the latest schema:
+
+* Don't overwrite your original workflow until after you finish your testing and confirm that your updated workflow works as expected.
+
+* Copy the updated script to a new logic app workflow.
+
+* Test your workflow *before* you deploy to production.
+
+* After you finish and confirm a successful migration, update your logic app workflows to use the latest [managed connectors for Azure Logic Apps](/connectors/connector-reference/connector-reference-logicapps-connectors) where possible. For example, replace older versions of the Dropbox connector with the latest version.
+
+## Update workflow schema
+
+When you select the option to update the schema, Azure Logic Apps automatically runs the migration steps and provides the code output for you. You can use this output to update your workflow definition. However, before you update your workflow definition using this output, make sure that you review and follow the best practices as described in the [Best practices](#best-practices) section.
+
+1. In the [Azure portal](https://portal.azure.com), open your logic app resource.
+
+1. On your logic app's navigation menu, select **Overview**. On the toolbar, select **Update Schema**.
+
+   > [!NOTE]
+   >
+   > If the **Update Schema** command is unavailable, your workflow already uses the current schema.
+
+   ![Screenshot showing Azure portal, Consumption logic app resource with "Overview" pane open, and "Update Schema" selected.](./media/update-consumption-workflow-schema/update-schema.png)
+
+   The **Update Schema** pane opens to show a link to a document that describes the improvements in the new schema.
+
+## Next steps
+
+* [Review Workflow Definition Language schema updates - June 1, 2016](../logic-apps/logic-apps-schema-2016-04-01.md)