通过

从 Azure 逻辑应用中的工作流连接到本地文件系统

  • 项目

适用范围：Azure 逻辑应用（消耗型 + 标准型）

本操作指南介绍如何使用文件系统连接器从 Azure 逻辑应用中的工作流访问本地文件共享。 然后，可以创建由文件共享或其他系统中的事件触发后运行的自动化工作流，并运行操作来管理文件。 该连接器提供以下功能：

  • 创建、获取、追加、更新和删除文件。
  • 列出文件夹或根文件夹中的文件。
  • 获取文件内容和元数据。

在此操作指南中，示例方案演示了以下任务：

  • 在创建文件或将文件添加到文件共享时触发工作流，然后发送一封电子邮件。
  • 在将文件从 Dropbox 帐户复制到文件共享时触发工作流，然后发送一封电子邮件。

限制和已知问题

  • 文件系统连接器目前只支持 Windows 操作系统上的 Windows 文件系统。
  • 不支持映射网络驱动器。

连接器技术参考

文件系统连接器具有不同的版本，具体取决于逻辑应用类型和主机环境。

逻辑应用 环境 连接器版本
消耗 多租户 Azure 逻辑应用 托管连接器，该连接器显示在连接器库中“运行时”>“共享”下。 有关详细信息，请查看以下文档：

- 文件系统托管连接器参考
- Azure 逻辑应用中的托管连接器
标准 单租户 Azure 逻辑应用和应用服务环境 v3（仅限 Windows 计划） 托管连接器显示在连接器库中的“运行时”>“共享”下，而内置连接器显示在连接器库中的“运行时”>“应用内”下，并且是基于服务提供商的。 内置连接器在以下方面有所不同：

- 内置连接器仅支持在应用服务环境 v3（仅限 Windows 计划）中运行的标准逻辑应用。

- 内置版本可以直接连接到文件共享，并使用连接字符串访问 Azure 虚拟网络，无需本地数据网关。

有关详细信息，请查看以下文档：

- 文件系统托管连接器参考
- 文件系统内置连接器参考
- Azure 逻辑应用中的内置连接器

先决条件

  • Azure 帐户和订阅。 如果没有 Azure 订阅，请注册试用版 Azure 订阅。

  • 若要连接到文件共享，不同的逻辑应用和宿主环境有不同的要求：

    • 消耗型逻辑应用工作流

      • 在多租户 Azure 逻辑应用中，需要满足以下要求（如果尚未满足）：

        1. 在本地计算机上安装本地数据网关。

          文件系统托管连接器要求网关安装和文件系统服务器必须位于同一个 Windows 域中。

        2. 在 Azure 中创建本地数据网关资源。

        3. 将文件系统托管连接器触发器或操作添加到工作流后，选择之前创建的数据网关资源，以便可以连接到文件系统。

    • 标准逻辑应用工作流

      可以使用文件系统内置连接器，也可以使用托管连接器。

      • 若要使用文件系统托管连接器，请遵循与多租户 Azure 逻辑应用中的消耗型逻辑应用工作流相同的要求。

      • 若要使用文件系统内置连接器，标准逻辑应用工作流必须在应用服务环境 v3 中运行，但不需要数据网关资源。

  • 访问特定的计算机，其中的文件系统是你需要使用的。 例如，如果在与文件系统相同的计算机上安装数据网关，则需要该计算机的帐户凭据。

  • 若要遵循本操作指南中的示例方案，需要 Azure 逻辑应用支持的提供商（例如 Office 365 Outlook、Outlook.com 或 Gmail）提供的电子邮件帐户。 对于其他提供商，请查看其他受支持的电子邮件连接器。 此示例通过工作或学校帐户使用 Office 365 Outlook 连接器。 如果使用其他电子邮件帐户，整个步骤仍然是相同的，但 UI 可能稍有不同。

  • 对于文件系统操作方案示例，需要使用 Dropbox 帐户，你可以免费注册一个。

  • 要在其中访问文件共享的逻辑应用工作流。 若要使用文件系统触发器启动工作流，必须从空白工作流开始。 若要添加文件系统操作，可使用任何触发器启动工作流。

添加文件系统触发器

  1. 在 Azure 门户中，在设计器中打开空白逻辑应用工作流。

  2. 在设计器中，按照这些常规步骤将所需的文件系统触发器添加到工作流。

    有关详细信息，请参阅文件系统触发器。 此示例使用名为“当创建文件时”的触发器继续操作。

  3. 在连接信息框中按需提供以下信息：

    属性 需要 值 说明
    连接名称 是 <connection-name> 要为你的连接使用的名称
    根文件夹 是 <root-folder-name> 文件系统的根文件夹，通常是主要的父文件夹，是用于处理文件的所有触发器的相对路径的文件夹。

    例如，如果安装了本地数据网关，请使用计算机上的本地文件夹进行数据网关安装。 或者使用计算机可以访问的网络共享文件夹，例如 \\PublicShare\\MyFileSystem。
    身份验证类型 否 <auth-type> 文件系统服务器使用的身份验证类型，即“Windows”
    用户名 是 <domain-and-username> 拥有文件系统的计算机的域和用户名

    对于托管文件系统连接器，结合使用以下值之一和反斜杠 (\)：

    - <domain>\<username>
    - <local-computer>\<username>

    例如，如果文件系统文件夹与本地数据网关安装在同一台计算机上，则可使用 <local-computer>\<username>。
    密码 是 <password> 拥有文件系统的计算机密码
    gateway 否 - <Azure 订阅>
    - <gateway-resource-name>    		 本部分仅适用于托管文件系统连接器：

    - 订阅：与数据网关资源关联的 Azure 订阅
    - 连接网关：数据网关资源

    以下示例显示文件系统托管连接器触发器的连接信息：

    屏幕截图显示了消耗型工作流设计器和文件系统托管连接器触发器的连接信息。

  4. 完成操作后，选择“创建”。

    Azure 逻辑应用会创建和测试连接，以确保连接正常运行。 如果连接设置正确，则会显示所选触发器的设置选项。

  5. 继续构建工作流。

    1. 提供触发器的所需信息。

      对于此示例，请选择文件系统服务器上的文件夹路径以检查新创建的文件。 指定要返回的文件数以及自己需要的检查频率。

      显示消耗工作流设计器以及名为“创建文件时”的触发器的屏幕截图。

    2. 若要测试工作流，请添加一个 Outlook 操作：当在指定文件夹中的文件系统上创建文件时发送电子邮件。 输入电子邮件收件人、主题和正文。 若要测试，可以使用自己的电子邮件地址。

      屏幕截图显示了消耗工作流设计器、名为“创建文件时”的托管连接器触发器，以及名为“发送电子邮件”的操作。.

      提示

      要添加工作流中前几步的输出，请在触发器的编辑框内进行选择。 显示动态内容列表时，请从可用输出中进行选择。

  6. 完成后，保存工作流。

  7. 要测试工作流，请上传文件以触发工作流。

如果成功，工作流会发送有关新文件的电子邮件。

添加文件系统操作

示例逻辑应用工作流一开始使用 Dropbox 触发器，但你也可以使用所需的任何触发器。

  1. 在 Azure 门户中，在设计器中打开逻辑应用。

  2. 在设计器中，按照这些常规步骤将所需的文件系统操作添加到工作流。

    有关详细信息，请参阅文件系统触发器。 此示例继续执行名为“创建文件”的操作。

  3. 在连接信息框中按需提供以下信息：

    属性 需要 值 说明
    连接名称 是 <connection-name> 要为你的连接使用的名称
    根文件夹 是 <root-folder-name> 文件系统的根文件夹，通常是主要的父文件夹，是用于处理文件的所有触发器的相对路径的文件夹。

    例如，如果安装了本地数据网关，请使用计算机上的本地文件夹进行数据网关安装。 或者使用计算机可以访问的网络共享文件夹，例如 \\PublicShare\\MyFileSystem。
    身份验证类型 否 <auth-type> 文件系统服务器使用的身份验证类型，即“Windows”
    用户名 是 <domain-and-username> 拥有文件系统的计算机的域和用户名

    对于托管文件系统连接器，结合使用以下值之一和反斜杠 (\)：

    - <domain>\<username>
    - <local-computer>\<username>

    例如，如果文件系统文件夹与本地数据网关安装在同一台计算机上，则可使用 <local-computer>\<username>。
    密码 是 <password> 拥有文件系统的计算机密码
    gateway 否 - <Azure 订阅>
    - <gateway-resource-name>    		 本部分仅适用于托管文件系统连接器：

    - 订阅：与数据网关资源关联的 Azure 订阅
    - 连接网关：数据网关资源

    以下示例显示文件系统托管连接器操作的连接信息：

    屏幕截图显示了文件系统托管连接器操作的连接信息。

  4. 完成操作后，选择“创建”。

    Azure 逻辑应用会创建和测试连接，以确保连接正常运行。 如果连接设置正确，则会显示所选操作的设置选项。

  5. 继续构建工作流。

    1. 提供操作的所需信息。

      对于此示例，请选择要使用的文件系统服务器上的文件夹路径，此处为根文件夹。 根据上传到 Dropbox 的文件输入文件名和内容。

      屏幕截图显示了消耗工作流设计器和名为“创建文件”的文件系统托管连接器操作。

      提示

      要添加工作流中前几步的输出，请在操作的编辑框内进行选择。 显示动态内容列表时，请从可用输出中进行选择。

    2. 若要测试工作流，请添加一个Outlook 操作：在文件系统操作创建文件时向你发送电子邮件。 输入电子邮件收件人、主题和正文。 若要测试，可以使用自己的电子邮件地址。

      屏幕截图显示了消耗型工作流设计器、托管连接器“创建文件”操作和“发送电子邮件”操作。

  6. 完成后，保存工作流。

  7. 要测试工作流，请上传文件以触发工作流。

如果成功，工作流会基于 DropBox 中上传的文件在文件系统服务器上创建文件，并发送有关所创建文件的电子邮件。

后续步骤