使用 Azure 逻辑应用添加架构以用于工作流

适用范围:Azure 逻辑应用(消耗型 + 标准型)

平面文件和 XML 验证等工作流操作需要架构来执行其任务。 例如,XML 验证操作需要 XML 架构来检查文档是否使用有效的 XML,并具有预定义格式的预期数据。 此架构是一个使用 XML 架构定义 (XSD) 语言的 XML 文档,文件扩展名为 .xsd。 平面文件操作使用架构对 XML 内容进行编码和解码。

本文介绍如何将架构添加到集成帐户。 如果使用标准逻辑应用工作流,还可以直接将架构添加到逻辑应用资源。

先决条件

  • Azure 帐户和订阅。 如果还没有订阅,请注册 Azure 帐户

  • 要添加的架构文件。 若要创建架构,可以使用 Visual Studio 2019 和 Azure 逻辑应用企业集成工具扩展

    备注

    不要将此扩展与 BizTalk Server 扩展一起安装。 同时具有这两个扩展可能会导致意外行为。 请确保只安装其中一个扩展。

    在高分辨率监视器上,可能会在 Visual Studio 中遇到地图设计器显示问题。 若要解决此显示问题,请在 DPI 无感知模式下重启 Visual Studio 或添加 DPIUNAWARE 注册表值

  • 根据你使用的是消耗型还是标准型逻辑应用工作流,需要集成帐户资源。 通常,当你想要定义和存储项目以将其用于企业集成和 B2B 工作流时,你需要此资源。

    重要

    若要协同工作,集成帐户和逻辑应用资源必须存在于同一 Azure 订阅和 Azure 区域中。

    • 如果使用消耗型逻辑应用工作流,则需要链接到逻辑应用资源的集成帐户

    • 如果使用标准型逻辑应用工作流,则可以根据以下情况将集成帐户链接到逻辑应用资源和/或直接将架构上传到逻辑应用资源:

      • 如果你已经有一个包含所需项目或要使用的项目的集成帐户,可以将该集成帐户链接到要在其中使用项目的多个标准型逻辑应用资源。 这样,就不必将架构上传到每个单独的逻辑应用。 有关详细信息,请查看将逻辑应用资源链接到集成帐户

      • 通过平面文件内置连接器,可选择以前上传到逻辑应用资源或链接集成帐户的架构,但不能同时上传到这两者。 然后,可以在同一逻辑应用资源中跨多个子工作流使用此项目。

      因此,如果你没有集成帐户,或者你不需要集成帐户,可以使用上传选项。 否则,可以使用链接选项。 采用上述任一方式,都可以在同一逻辑应用资源中跨所有子工作流使用这些项目。

限制

  • 限制适用于每个集成帐户的项目数,例如架构。 有关详细信息,请查看 Azure 逻辑应用的限制和配置信息

  • 根据你使用的是消耗型还是标准型逻辑应用工作流,可能存在架构文件大小限制。

    • 如果使用的是标准型工作流,则架构文件大小没有限制。

    • 如果使用的是消耗型工作流,则适用以下限制:

  • 通常,当将集成帐户与工作流结合使用时,可以将架构添加到该帐户。 但是,如果要引用或导入未在集成帐户中的架构,则在使用 xsd:redefine 元素时可能会收到以下错误:

    An error occurred while processing the XML schemas: ''SchemaLocation' must successfully resolve if <redefine> contains any child other than <annotation>.'.

    要解决此错误,需要使用元素 xsd:importxsd:include,而不是 xsd:redefine,或使用 URI。

添加架构时的注意事项

  • 如果使用的是消耗型工作流,则必须将架构添加到链接集成帐户。

  • 如果使用的是标准型工作流,则有以下选项:

    • 将架构添加到链接集成帐户。 可以在多个标准型逻辑应用资源及其子工作流之间共享架构和集成帐户。

    • 将架构直接添加到逻辑应用资源。 但是,只能在同一逻辑应用资源中的子工作流之间共享该架构。

将架构添加到集成帐户

  1. Azure 门户中,使用 Azure 帐户凭据登录。

  2. 在 Azure 主搜索框中,输入“集成帐户”,然后选择“集成帐户”。

  3. 选择要将架构添加到的集成帐户。

  4. 在集成帐户菜单中的“设置”下,选择“架构” 。

  5. 在“架构”窗格工具栏中选择“添加” 。

向逻辑应用添加架构

对于标准逻辑应用资源,仅当想要将架构直接添加到资源时,以下步骤才适用。 否则,请将架构添加到集成帐户

Azure 门户

  1. 在逻辑应用资源菜单中的“设置”下,选择“架构” 。

  2. 在“架构”窗格工具栏中选择“添加” 。

  3. 在“添加架构”窗格中,输入架构的唯一名称。

  4. 选择“架构”框旁边的文件夹图标。 选择要上传的架构。

  5. 完成后,请选择“确定”。

    完成架构文件上传后,该架构将显示在“架构”列表中。 在集成帐户“概述”页的“项目”下,也会显示上传的架构 。

Visual Studio Code

  1. 在逻辑应用项目的结构中打开“项目”文件夹,然后打开“架构”文件夹 。

  2. 在“架构”文件夹中添加你的架构。

编辑架构

若要更新现有的架构,必须上传一个新的架构文件,其中包含所要做出的更改。 但是,可以先下载现有的架构进行编辑。

仅当要更新添加到逻辑应用资源的架构时,以下步骤才适用。 否则,请按照消耗型工作流对应的步骤更新集成帐户中的架构。

  1. Azure 门户中打开你的逻辑应用资源(如果尚未打开)。

  2. 在逻辑应用资源菜单中的“设置”下,选择“架构” 。

  3. “架构”窗格打开后,选择你的架构。 若要先下载并编辑架构,请在“架构”窗格工具栏中选择“下载”,然后保存架构 。

  4. 在“架构”窗格工具栏中选择“添加” 。

  5. 在“添加架构”窗格中,输入架构的唯一名称。

  6. 选择“架构”框旁边的文件夹图标。 选择要上传的架构。

  7. 完成后,请选择“确定”。

    完成架构文件的上传后,更新的架构将显示在“架构”列表中。

删除架构

仅当要删除添加到逻辑应用资源的架构时,以下步骤才适用。 否则,请按照消耗型工作流对应的步骤删除集成帐户中的架构。

  1. Azure 门户中打开你的逻辑应用资源(如果尚未打开)。

  2. 在逻辑应用资源菜单中的“设置”下,选择“架构” 。

  3. “架构”窗格打开后,请选择你的架构,然后选择“删除” 。

  4. 若要确认删除该架构,请选择“是”。

后续步骤