適用於：Azure Logic Apps (標準)
若要從 Azure Logic Apps 中的標準工作流程存取和執行 IBM Midrange 系統上的 COBOL 和 RPG 程式，您可以使用 IBM i Program Call 內建的服務提供者型連接器。 IBM i作系統提供分散式程式呼叫 （DPC） 伺服器。 連接器會與 IBM i DPC 伺服器通訊，以使用 TCP/IP 執行 COBOL 和 RPG 程式。 除了由 21Vianet 運作的 Azure Government 和 Microsoft Azure 之外，所有 Azure Logic Apps 區域都提供 IBM i 連接器。
本文說明 IBM i 連接器的下列層面：
- 在 Azure Logic Apps 中使用 IBM i 連接器的案例
- 使用IBM i連接器的必要條件和設定
- 將IBM i連接器動作新增至標準邏輯應用程式工作流程的步驟
檢閱連接器使用案例
50多年前，IBM發佈了第一個中層系統。 IBM將其宣傳為「規模小，價格小，性能大。 這是一個現在和未來的系統。多年來，中端系統不斷演進，並在中型企業或大型企業中普及，以擴展大型主機環境。 執行 IBM i 的 Midrange 系統，通常是 Power Systems，支援 TCP/IP 和 SNA。
IBM i 系統包含 DPC 伺服器功能，可讓大部分 IBM i 應用程式使用用戶端起始的唯一要求-回復模式與 Azure Logic Apps 等客戶端互動，且修改最少。 DPC 是一種記載的通訊協定，可支援 IBM i 系統上的程式對程式整合，用戶端應用程式可以使用 TCP/IP 網路通訊協定輕鬆存取。
Microsoft 主機整合伺服器 （HIS） 會使用 TCP/IP 和 APPC LU6.2 來提供 IBM i 系統的連線。 多年來，客戶已使用 HIS 交易整合器來整合內部部署 IBM i 系統和 Windows。 IBM i Program Call 連接器會使用 TCP/IP 程式設計模型來與 IBM i COBOL 和 RPG 程式互動。
下圖顯示 IBM i 連接器如何與 IBM i 系統互動：
為了擴充這些混合式雲端案例，標準工作流程中的 IBM i 連接器會與 HIS Designer for Logic Apps 搭配使用，您可以用來建立 COBOL 或 RPG 程式 的程式定義 或 程式對應 。 針對這項工作，HIS Designer 會使用 程式設計模型 來決定中範圍與工作流程之間數據交換的特性。 HIS Designer 會將該資訊轉換成 IBM i 連接器在工作流程中執行動作時所使用的元數據。
從 HIS Designer 產生中繼資料檔案做為 Host Integration Designer XML (HIDX) 檔案之後，您可以將該檔案新增為標準邏輯應用程式資源的對應成品。 如此一來，當您新增IBM i連接器動作時，您的工作流程就可以存取應用程式的元數據。 連接器會從邏輯應用程式資源讀取元數據檔案，並動態呈現要與工作流程中的IBM i連接器搭配使用的參數。 接著，您可以將參數提供給主應用程式，而連接器會將結果傳回至您的工作流程。 因此，您可以將舊版應用程式與 Azure、Microsoft、Azure Logic Apps 支援的其他應用程式、服務和系統整合。
連接器技術參考
目前，IBM i 連接器提供一項作業： 呼叫IBM i 程式。 下表摘要說明此動作的使用方式：
| 參數 | 為必填項目 | 類型 | 說明 |
|---|---|---|---|
| HIDX 名稱 | 是的 | 繩子 | 選取您想要使用的IBM i HIDX 檔案。 |
| 方法名稱 | 是的 | 繩子 | 在您想要使用的 HIDX 檔案中選取 方法。 |
| 進階參數 | 否 | 不定 | 此清單會出現在您選取方法之後，以便新增其他參數以搭配選取的方法使用。 可用的參數會根據您的 HIDX 檔案和您選取的方法而有所不同。 |
此作業也包含進階參數，其會出現在您選取方法之後，讓您選取並搭配選取的方法使用。 這些參數會根據您的 HIDX 檔案和您選取的方法而有所不同。
先決條件
Azure 帳戶和訂閱。 如果您沒有 Azure 訂用帳戶，請先註冊免費的 Azure 帳戶。
存取裝載 IBM i 系統的 midrange 伺服器。
Host Integration Designer XML (HIDX) 檔案，提供 IBM i 程式呼叫連接器用來執行中型主機程式的必要中繼資料。
若要建立此 HIDX 檔案， 請下載並安裝 Azure Logic Apps 的 HIS 設計工具。 唯一的必要條件是 Microsoft .NET Framework 4.8。
若要叫用midrange程式，您的工作流程必須瞭解midrange程式的類型、參數和傳回值。 IBM i 連接器會管理此程序和數據轉換。 這些必要的轉換會提供從工作流程到midrange程式的輸入數據，並將從midrange程式產生的任何輸出資料傳送至工作流程。 連接器也提供表格式數據定義和代碼頁轉譯。 針對此程式，Azure Logic Apps 會要求您以元數據的形式提供此資訊。
若要建立此元數據，請使用 Logic Apps的 HIS 設計工具。 使用此工具，您可以手動建立您在工作流程中使用的方法、參數和傳回值。 您也可以匯入提供此資訊的 COBOL 或 RPG 程式定義（copybooks）。
此工具會產生主機整合設計工具 XML （HIDX） 檔案，以提供連接器的必要元數據。 如果您使用 HIS，您可以使用 HIS 交易整合器 （TI） 設計工具來建立 HIDX 檔案。
您想要與 IBM i 系統整合的標準邏輯應用程式工作流程。
IBM i 連接器沒有觸發程式，因此請使用任何觸發程式來啟動您的工作流程，例如 週期 觸發程式或 要求 觸發程式。 接下來，您可以新增 IBM i 連接器動作。 若要開始使用，請在您的標準邏輯應用程式資源中建立空白工作流程。
局限性
目前，IBM i 連接器需要您將 HIDX 檔案直接上傳至標準邏輯應用程式資源，而不是整合帳戶。
定義和產生元數據
下載並安裝 Azure Logic Apps 的 HIS 設計工具之後，請遵循 下列步驟，從元數據成品產生 HIDX 檔案。
上傳 HIDX 檔案
若要讓工作流程使用 HIDX 檔案，請遵循下列步驟：
移至儲存 HIDX 檔案的資料夾，並複製檔案。
在 Azure 入口網站中，開啟您的標準邏輯應用程式資源。
在邏輯應用程式功能表上的 [成品] 底下，將 HIDX 檔案以對應的形式上傳至邏輯應用程式資源。
繼續進行下一節，將 IBM i 動作新增至您的工作流程。
稍後在本指南中，當您第一次將 IBM i Program Call 連接器動作新增至工作流程時，系統會提示您建立工作流程與中端系統之間的連線。 建立連線之後，您可以選取先前新增的 HIDX 檔案、要執行的方法，以及要使用的參數。
新增 IBM i 動作
請遵循下列步驟來新增 IBM i 動作並設定必要的參數：
在 Azure 入口網站，於設計工具中開啟您的標準邏輯應用程式資源和工作流程。
如果您沒有觸發程式可啟動工作流程，請遵循 下列一般步驟來新增您想要的觸發程式。
此範例會繼續使用名為收到 HTTP 要求時的要求觸發程序：
若要新增 IBM i 連接器動作，請遵循下列一般步驟來新增名為 Call an IBM i Program 的 IBM i Program 內建連接器動作。
在連線詳細資料窗格出現之後，請提供下列資訊，例如主機伺服器名稱和 IBM i 系統設定資訊：
參數 為必填項目 價值觀 說明 連線名稱 是的 < 連線名稱> 連線的名稱。 伺服器證書一般名稱 否 < 伺服器證書通用名稱> 要使用的傳輸安全性層 （TLS） 憑證名稱。 代碼頁 否 < 代碼頁> 用於轉換文字的代碼頁碼。 密碼 否 < 密碼> 線上驗證的選擇性用戶密碼。 埠號碼 是的 < 連接埠號碼> 用於連線驗證的埠號碼。 伺服器名稱 是的 < 伺服器名稱> 伺服器名稱。 逾時 否 < 超時> 等候伺服器回應時，以秒為單位的逾時期間。 使用者名稱 否 < 使用者名稱> 線上驗證的選擇性用戶名稱。 使用 TLS 否 正確或錯誤 使用傳輸安全性層 （TLS） 保護連線。 驗證伺服器證書 否 正確或錯誤 驗證伺服器的憑證。 例如：
完成時，請選取 [ 新建]。
動作詳細資料窗格出現之後，請在 [ 參數 ] 區段中提供必要資訊：
參數 為必填項目 價值觀 說明 HIDX 名稱 是的 < HIDX 檔案名稱> 選取您想要使用的IBM i HIDX 檔案。 方法名稱 是的 < 方法名稱> 在您想要使用的 HIDX 檔案中選取 方法。 進階參數 否 不定 此清單會出現在您選取方法之後，以便新增其他參數以搭配選取的方法使用。 可用的參數會根據您的 HIDX 檔案和您選取的方法而有所不同。 例如：
選取 HIDX 檔案和方法
選取進階參數
完成後，請儲存您的工作流程。 在設計師工具列上選取儲存。
測試工作流程
請遵循下列步驟來檢查您的工作流程，並確認輸出：
若要執行工作流程，請在設計工具工具列上，選取 [執行執行>]。
工作流程完成執行之後，工作流程的執行歷程記錄隨即出現。 成功的步驟會顯示核取號，而不成功的步驟會顯示驚嘆號（！）。
若要檢閱每個步驟的輸入和輸出，請展開該步驟。
若要檢閱輸出，請選取 [查看原始輸出]。