快速入门：通过多租户 Azure 逻辑应用和 Visual Studio Code 创建和管理逻辑应用工作流定义

项目
04/08/2024

适用于：Azure 逻辑应用（消耗）

本快速入门介绍如何创建和管理逻辑应用工作流，这些工作流可帮助你通过使用多租户 Azure 逻辑应用和 Visual Studio Code 跨组织和企业自动实现集成应用、数据、系统和服务的任务和流程。你可以通过基于代码的体验为逻辑应用创建和编辑底层工作流定义，这些定义使用 JavaScript 对象表示法 (JSON)。也可以使用已部署到 Azure 的现有逻辑应用。有关多租户与单租户模型的详细信息，请查看单租户与多租户。

尽管可以在 Azure 门户和 Visual Studio 中执行这些相同的任务，但是当你已熟悉逻辑应用程序定义并想要直接使用代码时，可以在 Visual Studio Code 更快地开始使用。例如，你可以禁用、启用、删除和刷新已创建的逻辑应用。此外，还可以从运行 Visual Studio Code 的任何开发平台（如 Linux、Windows 和 Mac）处理逻辑应用和集成帐户。

对于本文，可以创建此快速入门提供的同一逻辑应用，重点介绍基本概念。还可了解如何在 Visual Studio 中创建示例应用，并了解如何通过 Azure CLI 创建和管理应用。在 Visual Studio Code 中，逻辑应用看起来如下例所示：

示例逻辑应用工作流定义

先决条件

在开始之前，请确保做好以下各项准备：

如果没有 Azure 帐户和订阅，请注册一个 Azure 帐户。
有关逻辑应用工作流定义及其使用 JSON 描述的结构的基本知识

如果不熟悉 Azure 逻辑应用，请尝试此快速入门，了解如何在 Azure 门户中创建第一个逻辑应用工作流，重点了解基本概念。
用于登录到 Azure 和 Azure 订阅的 Web 的访问权限
下载并安装以下工具（如果没有）：
- Visual Studio Code 版本 1.25.1 或更高版本，免费提供
- 适用于 Azure 逻辑应用的 Visual Studio Code 扩展
  
  可以从 Visual Studio Marketplace 或直接从 Visual Studio Code 内部下载并安装此扩展。请确保在安装后重新加载 Visual Studio Code。
  
  若要检查扩展是否已正确安装，请选择在 Visual Studio Code 工具栏中显示的 Azure 图标。
  
  有关详细信息，请参阅扩展市场。若要为此扩展的开源版本贡献内容，请访问 GitHub 上适用于 Visual Studio Code 的 Azure 逻辑应用扩展。
如果逻辑应用需要通过仅限流量流经特定 IP 地址的防火墙进行通信，则该防火墙需要允许访问该逻辑应用所在的 Azure 区域中的 Azure 逻辑应用或运行时使用的入站和出站 IP 地址。如果逻辑应用还使用托管连接器（例如 Office 365 Outlook 连接器或 SQL 连接器），或者还使用自定义连接器，则防火墙还需要允许访问该逻辑应用所在的 Azure 区域中的所有托管连接器出站 IP 地址。

从 Visual Studio Code 访问 Azure

打开 Visual Studio Code。在 Visual Studio Code 工具栏上，选择 Azure 图标。
在 Azure 窗口中的“逻辑应用”下，选择“登录到 Azure”。当 Microsoft 登录页面出现提示时，请使用 Azure 帐户登录。
1. 如果登录花的时间比平时长，Visual Studio Code 会为你提供设备代码，提示你通过 Microsoft 身份验证网站登录。若要改为使用代码登录，请选择“使用设备代码”。
2. 若要复制代码，请选择“复制并打开”。
3. 若要打开新的浏览器窗口并继续访问身份验证网站，请选择“打开链接”。
4. 在“登录到你的帐户”页上，输入验证码，然后选择“下一步” 。
选择你的 Azure 帐户。登录后，可以关闭浏览器，然后返回到 Visual Studio Code。

在 Azure 窗格中，“逻辑应用”和“集成帐户”部分现在显示与帐户关联的 Azure 订阅。但是，如果未看到所需的订阅，或者各部分显示的订阅过多，请执行以下步骤：
1. 将指针移到“逻辑应用”标签上。显示工具栏后，选择“选择订阅”（筛选器图标）。
2. 从出现的列表中，选择要显示的订阅。
在“逻辑应用”下，选择所需的订阅。订阅节点将展开并显示该订阅中存在的任何逻辑应用。

提示

在“集成帐户”下，选择订阅将显示该订阅中存在的任何集成帐户。

创建新的逻辑应用

如果你尚未从 Visual Studio Code 内登录到 Azure 订阅，请按照前面的步骤操作，以立即登录。
在 Visual Studio Code 中的“逻辑应用”下，打开订阅的快捷菜单，然后选择“创建逻辑应用” 。

将出现一个列表，显示订阅中的所有 Azure 资源组。
从资源组列表中，选择“创建新的资源组”或选择现有资源组。对于本示例，请创建新的资源组。
提供 Azure 资源组的名称，然后按 Enter。
选择要在其中保存逻辑应用元数据的 Azure 区域。

提供逻辑应用的名称，然后按 Enter。

提供逻辑应用的名称

在 Azure 窗口中，你的 Azure 订阅下将显示新的空白逻辑应用。 Visual Studio Code 还会打开一个 JSON (.logicapp.json) 文件，其中包含逻辑应用的主干工作流定义。现在，可以开始在此 JSON 文件中手动创作逻辑应用的工作流定义。有关工作流定义的结构和语法的技术参考，请参阅适用于 Azure 逻辑应用的工作流定义语言架构。

空逻辑应用工作流定义 JSON 文件

例如，下面是一个示例逻辑应用工作流定义，该定义以 RSS 触发器和 Office 365 Outlook 操作开头。通常情况下，JSON 元素在每个部分按字母顺序显示。但是，此示例大致以逻辑应用的步骤在设计器中显示的顺序来显示这些元素。

重要

若要重用此示例逻辑应用定义，需要使用组织帐户，例如 @fabrikam.com。请确保将虚拟电子邮件地址替换为你自己的电子邮件地址。若要使用其他电子邮件连接器（如 Outlook.com），请将 Send_an_email_action 操作替换为 Azure 逻辑应用支持的电子邮件连接器提供的类似操作。

{
   "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
      "$connections": {
         "defaultValue": {},
         "type": "Object"
      }
   },
   "triggers": {
      "When_a_feed_item_is_published": {
         "recurrence": {
            "frequency": "Minute",
            "interval": 1
         },
         "splitOn": "@triggerBody()?['value']",
         "type": "ApiConnection",
         "inputs": {
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['rss']['connectionId']"
               }
            },
            "method": "get",
            "path": "/OnNewFeed",
            "queries": {
               "feedUrl": "http://feeds.reuters.com/reuters/topNews"
            }
         }
      }
   },
   "actions": {
      "Send_an_email_(V2)": {
         "runAfter": {},
         "type": "ApiConnection",
         "inputs": {
            "body": {
               "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
               "Subject": "RSS item: @{triggerBody()?['title']}",
               "To": "sophia-owen@fabrikam.com"
            },
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['office365']['connectionId']"
               }
            },
            "method": "post",
            "path": "/v2/Mail"
         }
      }
   },
   "outputs": {}
}

完成后，保存逻辑应用的工作流定义。（“文件”菜单 >“保存”，或按 Ctrl+S）
如果系统提示将逻辑应用上传到 Azure 订阅，请选择“上传”。

此步骤将逻辑应用发布到 Azure 门户，从而使逻辑能够在 Azure 中活动和运行。

在设计器中查看逻辑应用

在 Visual Studio Code 中，可以在只读设计视图中打开逻辑应用。尽管无法在设计器中编辑逻辑应用，但可通过使用设计器视图，直观查看逻辑应用的工作流。

在 Azure 窗口中“逻辑应用”下，打开逻辑应用的快捷菜单，并选择“在设计器中打开” 。

只读设计器将在单独的窗口中打开并显示逻辑应用的工作流，例如：

在只读设计器中查看逻辑应用

在 Azure 门户中查看

若要在 Azure 门户中查看逻辑应用，请执行以下步骤：

使用与逻辑应用关联的 Azure 帐户和订阅登录到 Azure 门户。
在 Azure 门户的搜索框中，输入逻辑应用的名称。从结果列表中，选择逻辑应用。

编辑已部署的逻辑应用

在 Visual Studio Code 中，可以打开和编辑 Azure 中已部署的逻辑应用的工作流定义。

重要

在编辑生产环境中正在运行的逻辑应用前，请首先禁用逻辑应用以避免使该逻辑应用中断的风险，并最大程度地减少干扰。

如果你尚未从 Visual Studio Code 内登录到 Azure 订阅，请按照前面的步骤操作，以立即登录。
在 Azure 窗口中的“逻辑应用”下，展开 Azure 订阅，然后选择想要使用的逻辑应用。
打开逻辑应用菜单，选择“在编辑器中打开”。或者，选择逻辑应用名称旁的编辑图标。

Visual Studio Code 将在本地临时文件夹中打开 .logicapp.json 文件，以便你查看逻辑应用的工作流定义。
在逻辑应用的工作流定义中进行更改。
完成后，保存所做的更改。（“文件”菜单 >“保存”，或按 Ctrl+S）
如果系统提示上传更改并覆盖 Azure 门户中的现有逻辑应用，请选择“上传”。

此步骤会将更新发布到 Azure 门户中的逻辑应用。

查看或提升其他版本

在 Visual Studio Code 中，可以打开和查看早期版本的逻辑应用。还可以将早期版本提升到当前版本。

重要

在更改生产环境中正在运行的逻辑应用前，请首先禁用逻辑应用以避免使该逻辑应用中断的风险，并最大程度地减少干扰。

在 Azure 窗口中的“逻辑应用”下，展开 Azure 订阅，以便查看该订阅中的所有逻辑应用。
在订阅下，展开逻辑应用，然后展开“版本”。

“版本”列表显示了逻辑应用的早期版本（如果存在）。
若要查看早期版本，请选择以下任一步骤：
- 若要查看 JSON 定义，请在“版本”下选择该定义的版本号。或者，打开该版本的快捷菜单，然后选择“在编辑器中打开”。
  
  将在本地计算机上打开一个新文件，并显示该版本的 JSON 定义。
- 若要在只读设计器视图中查看版本，请打开该版本的快捷菜单，然后选择“在设计器中打开”。
若要将早期版本提升到当前版本，请执行以下步骤：
1. 在“版本”下，打开早期版本的快捷菜单，然后选择“提升” 。
2. 若要在 Visual Studio 代码提示进行确认后继续，请选择“是”。
  
  Visual Studio Code 会将所选版本提升到当前版本，并为提升后的版本分配一个新编号。原当前版本现在显示在提升后的版本之下。

禁用或启用逻辑应用

在 Visual Studio Code 中，如果对已发布的逻辑应用进行编辑并保存更改，则将覆盖已部署的应用。为避免中断生产中的逻辑应用并最大程度地减少干扰，请先禁用逻辑应用。然后，在确认逻辑应用仍可正常工作后，可重新激活逻辑应用。

Azure 逻辑应用会继续所有正在进行和挂起的运行，直到完成为止。根据卷或积压工作 (backlog)，此过程可能需要一些时间才能完成。
Azure 逻辑应用不会创建或运行新的工作流实例。
下一次满足触发器的条件时，触发器不会触发。
触发器状态会记住逻辑应用的停止位置。因此，如果重新激活逻辑应用，触发器将会针对自上次运行以来未处理的所有项触发。

若要阻止触发器针对自上次运行以来未处理的项触发，请在重新激活逻辑应用之前清除触发器的状态：
1. 在逻辑应用中，编辑工作流触发器的任何部分。
2. 保存所做更改。此步骤会重置触发器的当前状态。
3. 重新激活逻辑应用。
在禁用了工作流时，仍可以重新提交运行。

如果你尚未从 Visual Studio Code 内登录到 Azure 订阅，请按照前面的步骤操作，以立即登录。
在 Azure 窗口中的“逻辑应用”下，展开 Azure 订阅，以便查看该订阅中的所有逻辑应用。
1. 若要禁用所需的逻辑应用，请打开逻辑应用菜单，并选择“禁用”。
2. 如果已准备好重新激活逻辑应用，请打开逻辑应用菜单，并选择“启用”。

删除逻辑应用

删除逻辑应用会以下列方式方式影响工作流实例：

Azure 逻辑应用会尽力取消任何正在进行的和挂起的运行。

即使使用较大的卷或积压工作 (backlog)，大多数运行在完成或开始之前都将被取消。但是，取消过程可能需要一些时间才能完成。同时，在服务执行取消过程中，可能会选取某些运行来执行。
Azure 逻辑应用不会创建或运行新的工作流实例。
如果删除工作流，然后重新创建相同的工作流，则重新创建的工作流不会具有与删除的工作流相同的元数据。必须重新保存任何调用删除工作流的工作流。这样，调用方就可获取重新创建的工作流的正确信息。否则，对重新创建的工作流的调用将失败并显示 Unauthorized 错误。此行为也适用于在集成帐户中使用项目的工作流和调用 Azure 函数的工作流。

如果你尚未从 Visual Studio Code 内登录到 Azure 订阅，请按照前面的步骤操作，以立即登录。
在 Azure 窗口中的“逻辑应用”下，展开 Azure 订阅，以便查看该订阅中的所有逻辑应用。
找到要删除的逻辑应用，打开逻辑应用菜单，然后选择“删除”。

后续步骤

在 Visual Studio Code 中创建基于单租户的逻辑应用工作流