使用結構描述在 Azure Logic Apps 的 B2B 工作流程中驗證 XML

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

在企業整合的企業對企業(B2B)情境中,基於協議進行溝通的貿易夥伴,必須確保訊息有效,才能開始任何資料處理。

本指南說明你的邏輯應用程式工作流程如何利用預先定義的 結構 以及驗證 XML 的 XML 操作 來驗證 XML 訊息與文件。

先決條件

  • Azure 帳戶和訂用帳戶。 申請一個免費的 Azure 帳號。

  • 您要在其上驗證 XML 的邏輯應用程式資源和工作流程。

    你的工作流程必須從觸發器開始,但你可以使用任何適合你情境的觸發條件。 更多資訊請參考這些 一般步驟 ,加入任何你想要的觸發點。

    本指南中的範例使用名為「當 HTTP 請求收到時」的請求觸發器,該觸發器會等待外部呼叫者向觸發器發送請求。 或者,你也可以使用名為「Recurrence」的排程觸發器。

  • 一個 整合帳戶資源,用於定義並儲存成品,供企業整合及 B2B 工作流程中跨越多個邏輯應用程式資源使用。

    • 您的企業整合帳戶和邏輯應用程式資源必須存在於相同的 Azure 訂用帳戶和 Azure 區域中。

    • 用於驗證 XML 內容的結構描述。

  • 在您開始使用整合帳戶中如結構描述等成品的 XML 操作之前,必須先將您的 使用量邏輯應用程式或標準邏輯應用程式連結至該整合帳戶。 你可以在多個 Logic App 資源中跨工作流程使用這些產物。

    你可以選擇直接將特定工件加入標準邏輯應用程式的資源。 然而,只有同一資源中的工作流程能處理這些產物。

  • 安裝或使用可傳送 HTTP 要求以測試解決方案的工具,例如:

    謹慎

    針對您有敏感數據的案例,例如認證、秘密、存取令牌、API 密鑰和其他類似資訊,請務必使用一個工具,以必要的安全性功能保護您的數據。 此工具應該離線或本機運作,且不需要登入線上帳戶或將數據同步處理至雲端。 當您使用具有這些特性的工具時,可以降低公開敏感數據給公眾的風險。

如果你使用等待請求啟動工作流程的觸發器,你需要一個 HTTP 請求工具來測試觸發器和工作流程。

新增驗證 XML 動作

  1. 在 Azure 入口網站中,開啟 Logic App 資源。 在設計工具中開啟您的工作流程。

  2. 在設計器中,依照 以下一般步驟 ,加入與你工作流程類型相符名稱的 XML 操作 :

    Workflow 動作名稱
    使用量 XML 驗證
    標準 驗證 XML
  3. 要查看您 XML 內容的原始碼選項,請依照以下步驟操作:

    1. 在 內容 框中選擇,然後選擇以下選項:

      XML 內容來源 選取 Description
      先前工作流程操作的輸出 閃電圖示 打開動態內容清單,這樣你就能從觸發器或之前的動作中選擇輸出。
      表達式的輸出 功能圖示 打開表達式編輯器,可以使用表達式函式或建立表達式來產生 XML 內容。

      此範例繼續使用動態內容清單,例如:

      截圖顯示 Azure 入口網站、工作流程設計器、選擇驗證 XML 動作、游標進入內容框,並開啟動態內容清單。

    2. 從動態內容清單中,選擇包含你想要操作的 XML 內容的輸出。

      此範例選取 Body 輸出,該輸出來自名為 當收到 HTTP 請求時的觸發器。

  4. 要指定驗證的架構,請依照你的工作流程類型遵循步驟:

    • 消費

      從 結構名稱 清單中,選擇連結整合帳號中的結構。

    • Standard

      1. 從 結構來源 列表中,選擇 IntegrationAccount 或 LogicApp。

        此範例選擇 IntegrationAccount。

      2. 從 結構名稱 清單中選擇結構。

  5. 儲存您的工作流程。

你現在已經完成了驗證 XML 動作的設定。 在實際應用程式中,您可能希望將經過驗證的資料儲存在企業應用程式 (LOB),例如 Salesforce。 要將驗證過的輸出傳送到 Salesforce,請新增一個 Salesforce 動作。

測試工作流程

確認工作流程是否如你所預期般運作。

  1. 在設計器中,選擇名為「 當收到 HTTP 請求時」的觸發器。

  2. 從 HTTP URL 屬性中,複製並儲存觸發器的端點 URL。

  3. 在設計工具工具列上,從 [執行] 功能表選取 [執行]。

  4. 要觸發 Request 觸發器,請使用你偏好的 HTTP 請求工具,將 XML 內容傳送到觸發器的端點 URL。

    驗證 XML 動作會在觸發器觸發且 XML 內容可供驗證後執行。

  5. 要檢視每個操作、輸入和輸出的狀態,請依照 「檢視工作流程執行歷史」中的步驟操作。