Azure Logic Apps のワークフローで B2B 成果物を検索するためのメタデータを追加する

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

ワークフローで実行時に使用する正しいビジネス間 (B2B) 成果物をすばやく見つけられるように、取引先、契約、スキーマ、マップなどの成果物にキーと値のペアとしてカスタム メタデータを追加できます。 成果物のカスタム メタデータは、次の目標またはタスクを達成するのに役立ちます。

• 名前付け規則を適用します。
• 再利用をサポートし、定義の重複を回避します。
• ペイロードを適切なエンコードまたはデコード手順にルーティングします。
• 開発、テスト、運用を通じて成果物の移動をより詳細に制御できます。
• ハードコーディングされたロジックを使用せずに、正しい検証または変換を適用します。
• 追跡、追跡可能性、ガバナンス、監査を容易にします。
• BizTalk Server から Azure Logic Apps への移行を容易にします。

次の一覧では、成果物の種類に基づいて有用なメタデータの例を示します。

B2B 追跡テーブルまたはダッシュボードの追跡とフィードのために、便利なメタデータには、インターチェンジ番号、グループ番号、トランザクション セット ID、ワークフロー実行 ID、パートナー ID、契約 ID、状態、タイムスタンプなどの関連付けプロパティが含まれます。

このガイドでは、統合アカウントの成果物にメタデータを追加し、統合アカウントのアーティファクト参照という名前の統合アカウント組み込みアクションを使用してアーティファクトを検索し、ワークフロー内の成果物メタデータを参照する方法について説明します。

[前提条件]

• Azure アカウントとサブスクリプション。 無料の Azure アカウントを取得します。

• アーティファクト メタデータを取得して使用するロジック アプリのリソースとワークフロー。

  ワークフローは任意のトリガーから開始でき、取得後にメタデータで動作するアクションが必要です。 この例では、HTTP 要求を受信したときにという名前の要求トリガーを使用します。このトリガーは、受信 HTTPS 要求から成果物名を動的に渡すことができます。

  詳細については、以下を参照してください。

  • Azure Logic Apps で従量課金ワークフローを作成する

  • Azure Logic Apps で標準ワークフローを作成する

• メタデータを追加するアーティファクト含む統合アカウント リソース。

  カスタム メタデータは、次の成果物に追加できます。

  • パートナー
  • 契約
  • [スキーマ]
  • 地図

  このガイドの例では、 TradingPartner1 という名前のパートナー成果物を使用します。

  • 統合アカウントとロジック アプリ リソースの両方が、同じ Azure サブスクリプションおよび Azure リージョンに存在する必要があります。

  • 統合アカウント成果物照会アクションの操作を開始する前に、消費型ロジック アプリをリンクするか、標準ロジック アプリをリンクして統合アカウントに接続する必要があります。 統合アカウントを複数の従量課金プランまたは標準ロジック アプリ リソースにリンクして、同じアーティファクトを共有できます。

成果物にメタデータを追加する

統合アカウントに B2B アーティファクトのカスタム メタデータを追加するには、次の手順に従います。

1. Azure portal で、統合アカウント リソースに移動します。

2. リソース サイドバーの [設定] で、成果物カテゴリを選択します。

   この例では取引先成果物にメタデータを追加するため、このシナリオではパートナーを選択 します。

3. 成果物カテゴリ ページで、成果物を選択し、[ 編集] を選択します。

   次の例は、 TradingPartner1 という名前のパートナー成果物の編集ページを示しています。

   

4. [ メタデータ] の [ キー ] 列と [値] 列に、カスタム メタデータをキーと値のペアとして入力します。 完了したら、OK を選択します。

   次の例は、キーと値のペアとしてのサンプル メタデータを示しています。

   

5. アーティファクトの JavaScript Object Notation (JSON) 定義でこのメタデータを表示するには、[ 編集] の横にある [ JSON として編集] を選択します。

   

成果物を検索する

次の手順に従って、統合アカウントで成果物と関連付けられているメタデータを見つけます。 この例では、特定の取引先成果物を検索します。

1. Azure portal で、ロジック アプリ リソースを開きます。 デザイナーでワークフローを開きます。

2. デザイナーで、次の一般的な手順に従って、統合アカウントのアーティファクト検索という名前の統合アカウント組み込みアクションを追加します。これにより、指定した成果物とメタデータが検索されます。

3. ワークフローの種類に基づいて、成果物に関する次の情報を指定します。

   パラメーター	必須	価値	Description
   消費: artifactName - Standard: アーティファクト名	イエス	< artifact-name>	アーティファクト名。ハードコードされた名前として、またはワークフロー内のトリガーまたは前のアクションからの動的出力として入力できます。
   - Consumption: artifactType - Standard: 成果物の種類	イエス	契約、 マップ、 パートナー、または スキーマ	アーティファクトのタイプ。

   1. トリガーまたは前のアクションからの出力として成果物名を指定するには、次の手順に従います。

      1. artifactName または Artifact name ボックス内を選択し、Lightning アイコンを選択して動的コンテンツ リストを開きます。

      2. 動的リストのトリガー名またはアクション名で、成果物名を指定する出力を選択します。

   2. artifactType または Artifact 型の場合は、成果物の種類を選択します。 この例では、種類は Partner です。

      

4. ワークフローを保存します。

ワークフロー内の成果物メタデータを参照する

ワークフローで取得した成果物メタデータを使用するには、次の手順に従います。 この例では、前のセクションで取得した成果物のメタデータを参照します。

1. デザイナーの 統合アカウント成果物参照 アクションで、次の 一般的な手順 に従って、必要なアクションを追加します。

   この例では、ワークフローから指定した宛先に HTTP 要求を送信する HTTP 組み込みアクションを続行します。

2. 操作ウィンドウで、成果物メタデータの使用方法に関する情報を指定します。

   この例では、HTTP 要求の送信先として routingUrl メタデータを使用します。 次の表に、この例の HTTP アクションのサンプル値を示します。

   パラメーター	必須	価値	Description	値の例
   URI	イエス	< destination-URL>	要求を送信するエンドポイント URL。	パートナーの routingUrl メタデータを参照するには、次の手順に従います。 1. [URI ] ボックス内を選択します。 2. 関数アイコンを選択して式エディターを開きます。 3. エディターで、ワークフローの種類に基づいて、次の例のような式を入力します。 消費 outputs('Integration_Account_Artifact_Lookup')?['properties']?['metadata']['routingUrl'] 標準 outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl'] 4. 完了したら、[ 追加] を選択します。
   方式	イエス	< HTTP メソッド>	実行する HTTP 操作。	この例では 、GET 操作を使用します。
   Headers	いいえ	< 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. 動的コンテンツの一覧の [Integration Account Artifact Lookup] で、[ プロパティ] を選択します。

   この例のシナリオでは、 HTTP アクションでは次のサンプル値が使用されます。

   

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

   ワークフローの基になる JSON 定義が表示されます。次に例を示します。

   

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

   デザイナーで入力した式は、次のように解決済みになります。

   

関連コンテンツ

• パートナー間で契約を追加する