次の方法で共有


Azure Logic Apps の統合アカウントでアーティファクト メタデータを管理する

適用対象: Azure Logic Apps (従量課金)

統合アカウント内でアーティファクトのカスタム メタデータを定義し、ロジック アプリ ワークフローを使用する目的で実行時にそのメタデータを取得できます。 たとえば、アーティファクトに対して、パートナー、契約、スキーマ、マップなどのメタデータを指定できます。 これらすべてのアーティファクトの種類では、キーと値のペアとしてメタデータが保存されます。

このハウツー ガイドでは、統合アカウント アーティファクトにメタデータを追加する方法を示します。 その後、ワークフローのアクションを使用して、メタデータ値を取得して使用できます。

前提条件

アーティファクトにメタデータを追加する

  1. Azure portal で統合アカウントに移動します。

  2. メタデータを追加するアーティファクトを選択し、[編集] を選択します。

    Screenshot of Azure portal, integration account, and 'Partners' page with 'TradingPartner1' and 'Edit' button selected.

  3. [編集] ウィンドウで、そのアーティファクトのメタデータの詳細を入力し、[OK] を選択します。 次のスクリーンショットは、3 つのメタデータのキーと値のペアを示しています。

    Screenshot of the 'Edit' pane for 'TradingPartner1'. Under 'Metadata', three key-value pairs are highlighted and 'OK' is selected.

  4. 統合アカウントの JavaScript Object Notation (JSON) 定義でこのメタデータを表示するには、[JSON として編集] を選択し、JSON エディターを開きます。

    Screenshot of the JSON code that contains information about 'TradingPartner1'. In the 'metadata' object, three key-value pairs are highlighted.

アーティファクト メタデータを取得する

  1. Azure portal で、目的の統合アカウントにリンクされているロジック アプリ リソースを開きます。

  2. ロジック アプリのナビゲーション メニューで [ロジック アプリ デザイナー] を選択します。

  3. デザイナーで、[統合アカウントのアーティファクトの検索] アクションを追加してメタデータを取得します。

    1. トリガーまたは既存のアクションで、[新しいステップ] を選択します。

    2. [操作を選択してください] の検索ボックスで、[組み込み] を選びます。 検索ボックスに「integration account」と入力します。

    3. アクションの一覧から、[統合アカウントのアーティファクトの検索] という名前のアクションを選択します。

    Screenshot of the designer for a Consumption logic app workflow with the 'Integration Account Artifact Lookup' action selected.

  4. 検索するアーティファクトに関する情報を指定します。

    プロパティ 必要 説明
    アーティファクトの種類 はい スキーママップパートナー契約、カスタム型 目的のアーティファクトの種類
    アーティファクトの名前 はい <artifact-name> 目的のアーティファクトの名前

    この例では、次の手順に従って取引先アーティファクトのメタデータを取得します。

    1. [アーティファクトの種類] で、[パートナー] を選択します。

    2. [アーティファクトの名前] で、編集ボックス内をクリックします。 動的コンテンツ リストが表示されたら、トリガーから [名前] 出力を選択します。

    Screenshot of the 'Integration Account Artifact Lookup' action with the 'Artifact Type' and 'Artifact Name' properties highlighted.

  5. 次に、メタデータの使用に使用するアクションを追加します。 この例では、組み込みの HTTP アクションで続行します。

    Screenshot of the designer search box with 'http' entered, the 'Built-in' tab highlighted, and the HTTP action selected.

  6. HTTP アクションで使用するアーティファクトのメタデータに関する次の情報を指定します。

    たとえば、前に追加した routingUrl メタデータを取得するとします。 次のようなプロパティ値を指定します。

    プロパティ 必要 説明 値の例
    方法 はい <operation-to-run> アーティファクトで実行する HTTP 操作。 この HTTP アクションには GET メソッドを使用します。
    URI はい <metadata-location> 外向き要求を送信するエンドポイント。 取得した routingUrl 成果物からメタデータ値を参照するには、次の手順に従います。

    1. URI ボックス内をクリックします。

    2. 動的なコンテンツの一覧が表示されたら、[式] を選択します。

    3. 式エディターで、次の例のような式を入力します。

    outputs('Integration_Account_Artifact_Lookup')['properties']['metadata']['routingUrl']

    4. 終了したら、[OK] を選択します。
    ヘッダー いいえ <header-values> HTTP アクションに渡すトリガーからのヘッダー出力。 トリガー ヘッダーから値をContent-Type渡すには、[ヘッダー] の最初の行に対して次の手順に従います。

    1. 最初の列に、ヘッダー名として Content-Type を入力します。

    2. 2 番目の列で、式エディターを使用して、ヘッダー値として次の式を入力します。

    triggeroutputs()['headers']['Content-Type']

    トリガー ヘッダーから値をHost渡すには、[ヘッダー] の下の 2 番目の行に対して次の手順に従います。

    1. 最初の列に、ヘッダー名として Host を入力します。

    2. 2 番目の列で、式エディターを使用して、ヘッダー値として次の式を入力します。

    triggeroutputs()['headers']['Host']
    本文​​ いいえ <body-content> HTTP アクションの body プロパティに渡すその他の内容。 アーティファクト properties の値を HTTP アクションに渡すには:

    1. [本文] ボックス内をクリックして、動的コンテンツ リストを開きます。 プロパティが表示されていない場合、[さらに表示する] を選択します。

    2. 動的コンテンツ リストの [統合アカウントのアーティファクトの検索][プロパティ] を選択します。

    次のスクリーンショットは値の例を示しています。

    Screenshot of the designer with an HTTP action. Some property values are highlighted. The dynamic content list is open with 'Properties' highlighted.

  7. HTTP アクションに指定した情報を確認したい場合は、ワークフローの JSON 定義を表示できます。 デザイナーのツール バーで、[コード ビュー] を選択します。

    次の例に示すように、ワークフローの JSON 定義が表示されます。

    Screenshot of the HTTP action's JSON definition with the 'body', 'headers', 'method', and 'URI' properties highlighted.

  8. コード ビューのツール バーで、[デザイナー] を選択します。

    デザイナーで入力したすべての式が解決済みとして表示されます。

    Screenshot of the designer with the 'URI', 'Headers', and 'Body' expressions now resolved.

次のステップ