使用 Azure 逻辑应用和 Enterprise Integration Pack 管理集成帐户中的项目元数据Manage artifact metadata in integration accounts with Azure Logic Apps and Enterprise Integration Pack

可以在集成帐户中定义项目的自定义元数据,并且在运行时获取该元数据供逻辑应用使用。You can define custom metadata for artifacts in integration accounts and get that metadata during runtime for your logic app to use. 例如,可以提供项目的元数据(例如合作伙伴、协议、架构和映射)- 所有使用键值对的存储元数据。For example, you can provide metadata for artifacts, such as partners, agreements, schemas, and maps - all store metadata using key-value pairs.

先决条件Prerequisites

将元数据添加到项目Add metadata to artifacts

  1. 使用 Azure 帐户凭据登录到 Azure 门户Sign in to the Azure portal with your Azure account credentials. 找到并打开你的集成帐户。Find and open your integration account.

  2. 选择要在其中添加元数据的项目,然后选择“编辑”。 Select the artifact where you want to add metadata, and choose Edit . 输入该项目的元数据详细信息,例如:Enter the metadata details for that artifact, for example:

    输入元数据

  3. 完成后,选择“确定” 。When you're done, choose OK .

  4. 若要在集成帐户的 JavaScript 对象表示法 (JSON) 定义中查看此元数据,请选择“作为 JSON 编辑”以打开 JSON 编辑器: To view this metadata in the JavaScript Object Notation (JSON) definition for the integration account, choose Edit as JSON so that the JSON editor opens:

    合作伙伴元数据的 JSON

获取项目元数据Get artifact metadata

  1. 在 Azure 门户中,打开已链接到所需集成帐户的逻辑应用。In the Azure portal, open the logic app that's linked to the integration account you want.

  2. 在逻辑应用设计器中,若要在工作流中的触发器或最后一个操作下添加用于获取元数据的步骤,请选择“新建步骤” > “添加操作”。 In the Logic App Designer, if you're adding the step for getting metadata under the trigger or last action in the workflow, choose New step > Add an action .

  3. 在搜索框中,输入“集成帐户”。In the search box, enter "integration account". 在搜索框下,选择“所有” 。Under the search box, choose All . 在操作列表中选择此操作: 集成帐户项目查找 - 集成帐户From the actions list, select this action: Integration Account Artifact Lookup - Integration Account

    选择“集成帐户项目查找”

  4. 提供要查找的项目的以下信息:Provide this information for the artifact you want to find:

    属性Property 必须Required ValueValue 说明Description
    项目类型Artifact Type Yes “架构”、“映射”、“合作伙伴”、“协议”或自定义类型 Schema , Map , Partner , Agreement , or a custom type 所需项目的类型The type for the artifact you want
    项目名称Artifact Name Yes <artifact-name><artifact-name> 所需项目的名称The name for the artifact you want

    例如,假设你要获取某个参与方项目的元数据:For example, suppose you want to get the metadata for a trading partner artifact:

    选择项目类型并输入项目名称

  5. 添加用于处理该元数据的操作,例如:Add the action that you want for handling that metadata, for example:

    1. 在“集成帐户项目查找”操作下选择“下一步”,然后选择“添加操作”。 Under the Integration Account Artifact Lookup action, choose Next step , and select Add an action .

    2. 在搜索框中输入“http”。In the search box, enter "http". 在搜索框中选择“内置”,然后选择以下操作: HTTP - HTTPUnder the search box, choose Built-ins , and select this action: HTTP - HTTP

      添加 HTTP 操作

    3. 提供要管理的项目元数据的信息。Provide information for the artifact metadata you want to manage.

      例如,假设你要获取在本主题中前面添加的 routingUrl 元数据。For example, suppose you want to get the routingUrl metadata that's added earlier in this topic. 下面是可以指定的属性值:Here are the property values you might specify:

      属性Property 必须Required ValueValue 说明Description
      方法Method Yes <operation-to-run><operation-to-run> 要针对项目运行的 HTTP 操作。The HTTP operation to run on the artifact. 例如,此 HTTP 操作使用 GET 方法。For example, this HTTP action uses the GET method.
      URIURI Yes <metadata-location><metadata-location> 若要访问检索的项目中的 routingUrl 元数据值,可以使用表达式,例如:To access the routingUrl metadata value from the artifact you retrieved, you can use an expression, for example:

      @{outputs('Integration_Account_Artifact_Lookup')['properties']['metadata']['routingUrl']}

      标头Headers No <header-values><header-values> 触发器中的、要传入到 HTTP 操作的所有标头输出。Any header outputs from the trigger you want to pass into the HTTP action. 例如,若要传入触发器的 headers 属性值,可以使用表达式,如下所示:For example, to pass in the trigger's headers property value: you can use an expression, for example:

      @triggeroutputs()['headers']

      正文Body No <body-content> 要通过 HTTP 操作的 body 属性传递的其他任何内容。Any other content you want to pass through the HTTP action's body property. 此示例将项目的 properties 值传入 HTTP 操作:This example passes the artifact's properties values into the HTTP action:

      1.在“正文”属性中单击,以显示动态内容列表。 1. Click inside the Body property so the dynamic content list appears. 如果未显示任何属性,请选择“查看更多”。 If no properties appear, choose See more .
      2.在动态内容列表中的“集成帐户项目查找”下,选择“属性”。 2. From the dynamic content list, under Integration Account Artifact Lookup , select Properties .

      例如:For example:

      指定 HTTP 操作的值和表达式

    4. 若要检查为 HTTP 操作提供的信息,请查看逻辑应用的 JSON 定义。To check the information you provided for the HTTP action, view your logic app's JSON definition. 在逻辑应用设计器工具栏上,选择“代码视图”以显示应用的 JSON 定义,例如: On the Logic App Designer toolbar, choose Code view so the app's JSON definition appears, for example:

      逻辑应用 JSON 定义

      切换回到逻辑应用设计器后,使用的所有表达式现在会显示为已求解,例如:After you switch back to the Logic App Designer, any expressions you used now appear resolved, for example:

      逻辑应用设计器中已求解的表达式

后续步骤Next steps