新增中繼資料以在 Azure Logic Apps 的工作流程中尋找 B2B 成品

適用於:Azure Logic Apps (使用量 + 標準)

為了協助工作流程在執行階段快速找到正確的企業對企業 (B2B) 成品,您可以將自訂中繼資料以鍵值對形式新增至成品,例如交易夥伴、協議、結構與地圖。 工件的自訂元資料幫助你達成以下目標或任務:

  • 執行命名規則。
  • 支持重複使用並避免重複定義。
  • 將有效負載路由到正確的編碼或解碼步驟。
  • 提供更多對產物移動的控制,涵蓋開發、測試與生產階段。
  • 套用正確的驗證或轉換,避免硬編碼邏輯。
  • 促進追蹤、可追溯性、治理與稽核。
  • 簡化從 BizTalk Server 遷移到 Azure Logic Apps 的過程。

以下列表描述了基於工件類型的有用元資料範例:

成品 後設資料
合作夥伴 - 商業識別碼,如 AS2、X12 或 EDIFACT
- 商業名稱
- 聯絡及支援資訊
- 證書指紋
- 允許的協定
- 預期的確認回應,如 MDN、TA1 或 997
Agreement - 主辦與來賓夥伴
- 加密或簽章政策
- 重試與超時規則
- 內容類型
- 批次設定
- 確認行為
結構與地圖 - 訊息類型
- 版本
- 命名空間
- 原始碼控制網址
- 變更記錄
- 相容性矩陣以了解哪些協議或工作流程涉及這些產物

為了追蹤並提供 B2B 追蹤資料表或儀表板,有用的中繼資料包括關聯屬性,例如交換號碼、群組號碼、交易集合 ID,以及工作流程執行 ID、夥伴與協議 ID、狀態與時間戳記。

本指南說明如何在整合帳號中新增產物,使用整合 帳號 內建的動作「 整合帳號產物查詢」找到產物,並在工作流程中參考產物元資料。

先決條件

為產物新增元資料

請依照以下步驟,為您的整合帳戶中新增 B2B 項目的自訂元資料。

  1. 在 Azure 入口網站中,前往您的整合帳戶資源。

  2. 在資源側邊欄的 設定中,選擇工件類別。

    此範例為交易夥伴產物新增元資料,因此在此情境中,範例選擇 合作夥伴。

  3. 在產物分類頁面,選擇產物,然後選擇 編輯。

    以下範例展示了名為 TradingPartner1 的合作夥伴產物的編輯頁面。

    截圖顯示 Azure 入口網站、整合帳戶和合作夥伴頁面,並選擇了 TradingPartner1 和編輯按鈕。

  4. 在「 元資料」欄位的 「鍵 」和 「值 」欄位中,輸入你自訂的元資料作為鍵值對。 完成後,選取 [確定]。

    以下範例以鍵值對形式展示範例元資料:

    截圖顯示 TradingPartner1 的編輯窗格,標示出三對鍵值並選擇確定。

  5. 若要在 JavaScript 物件符號(JSON)定義中查看此中繼資料,在「 編輯」旁邊,請選擇「 編輯為 JSON 」。

    截圖顯示 TradingPartner1 的 JSON 程式碼,並標示出三對鍵值。

找到神器

請遵循以下步驟,在整合帳戶中找到成品及相關中繼資料。 範例會查找一個特定的貿易夥伴產物。

  1. 在 Azure 入口網站中,開啟您的邏輯應用程式資源。 在設計器裡開啟工作流程。

  2. 在設計器中,依照 以下一般步驟 加入整合 帳號 內建的動作,名為 「整合帳號工件查詢」,該動作會找到指定的工件與元資料。

  3. 根據你的工作流程類型,提供以下工件資訊:

    參數 為必填項目 價值觀 Description
    - 使用量:artifactName

    - 標準: 神器名稱
    Yes < 構件名稱> 成品名稱,您可以將其作為硬編碼名稱輸入,或使用工作流程中觸發程序或先前動作的動態輸出。
    - 消費: 工件類型

    - 標準: 工件類型
    Yes 協議、 地圖、 夥伴或 架構 成品類型。
    1. 若要將成品名稱作為觸發程序或先前動作的輸出提供,請遵循以下步驟:

      1. 在 artifactName 或 Artifact 名稱框 中選擇,然後點選閃電圖示以開啟動態內容清單。

      2. 在動態清單中,在觸發器或動作名稱下方,選擇指定工件名稱的輸出。

    2. 對於 artifactType 或 Artifact Type,選擇 artifact 類型。 在這個例子中,類型是 夥伴。

      截圖顯示整合帳號工件查詢操作,並標示工件類型與工件名稱參數。

  4. 儲存您的工作流程。

工作流程中的參考產物元資料

請依照以下步驟在工作流程中使用擷取的工件元資料。 範例參考了前一節取回的產物的元資料。

  1. 在設計器中,於整合帳戶成品查詢動作下,遵循一般步驟新增您想要的動作。

    此範例繼續使用 HTTP 內建動作,將HTTP請求從工作流程傳送至指定目的地。

  2. 在動作面板中,提供你想如何使用工件元資料的資訊。

    此範例使用 routingUrl 元資料作為 HTTP 請求目的地。 下表指定了此範例中 HTTP 動作的範例值:

    參數 為必填項目 價值觀 Description 範例值
    URI Yes < 目的地網址> 那是你想傳送請求的端點網址。 要參考合作夥伴的 routingUrl 元資料,請遵循以下步驟:

    1. 在 URI 欄位內選擇。

    2. 選擇函式圖示以開啟表達式編輯器。

    3. 在編輯器中,根據你的工作流程類型輸入如下範例的表達式:

    消費

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

    Standard

    outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl']

    4. 完成後,選擇 新增。
    方法 Yes < HTTP-方法> 執行 HTTP 操作。 此範例使用 GET 運算。
    標題 否 < 標頭值> 從觸發程序傳遞至 HTTP 動作的任何標頭輸出。 要從觸發標頭傳入Content-Type值,在標頭下,請依據第一列的步驟操作:

    1. 在第一列中,輸入 Content-Type 作為標題名稱。

    2. 在第二欄中,使用運算式編輯器輸入下列運算式作為標頭值:

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

    要將Host值從觸發標頭傳入,請在標頭下按照第二列的步驟進行操作:

    1. 在第一列中,輸入 Host 作為標題名稱。

    2. 在第二欄中,使用運算式編輯器輸入下列運算式作為標頭值:

    triggeroutputs()?['headers']['Host']
    身體 否 < 正文內容> 任何其他內容都必須通過 HTTP 動作的 body 屬性。 要將產物 properties 的值傳遞給 HTTP 動作,請遵循以下步驟:

    1. 在 Body 框中選取,然後選擇閃電圖示以開啟動態內容清單。 若未顯示輸出,請選擇 「查看更多」。

    2. 在「整合帳戶成品查閱」的動態內容清單下,選取「屬性」。

    以範例情境來說, HTTP 動作使用以下範例值:

    截圖顯示設計器、HTTP 動作及 HTTP 動作資訊窗格,並標示範例值。

  3. 要確認 HTTP 動作中的資訊,請查看你工作流程底層的 JSON 定義。 在設計工具工具列上,選取 [ 程式碼檢視]。

    工作流程底層的 JSON 定義如下:

    截圖顯示 HTTP 動作的 JSON 定義,並標示了主體、標頭、方法和 URI 屬性。

  4. 返回設計工具。 在程式碼檢視工具列上,選取 [設計工具]。

    你在設計器中輸入的任何表達式現在看起來都已解決,例如:

    設計器截圖,URI、標頭和 Body 表達式已解析完畢。