設計主機檔案的中繼資料成品

本指南說明如何設計主機檔案的中繼資料成品。 然後，您可以將這些中繼資料成品儲存為主機整合伺服器定義 XML (HIDX) 檔案，以搭配 Azure Logic Apps 中的主機檔案內建服務提供者型連接器使用。

必要條件

• 下載及安裝 Visual Studio。 安裝之後，請確定您也會在 Visual Studio 中使用 C++ 安裝名為 Desktop 開發的 工作負載。 否則，您會收到 來自 HRESULT 0x800A007C的錯誤例外狀況。

• 下載並安裝適用于 Azure Logic Apps 的 HIS Designer。 唯一的必要條件是 Microsoft .NET Framework 4.8。

• 在 Azure Logic Apps 中啟用一般檔案處理器的 Visual Studio 支援。 針對這項工作，請遵循下列步驟：

  1. 開啟 Visual Studio。 在工具列上，開啟 [ 工具] 功能表，然後選取 [ 選項]。

  2. 從 [ 選項 ] 清單中，展開 [ 主機整合伺服器]，然後選取 [ 主機檔案]。

  3. 在 [ 主機環境] 索引 標籤上，選取 [包含一般檔案處理器和 Logic Apps 的支援]。

     

建立主機檔案專案

在 Visual Studio 中，您可以使用主機檔案專案範本來建立中繼資料成品。 然後，您可以在 Azure Logic Apps 的標準工作流程中，將這些成品與主機檔案內建的服務提供者型連接器搭配使用。 若要建立新的主機檔案專案，請遵循下列步驟：

1. 在 Visual Studio 的 [檔案] 功能表中，選取 [新增>專案]。

2. 從專案範本清單中，選取 [下一步主機檔案> ]。

3. 在 [ 設定您的新專案 ] 方塊中，變更您想要的詳細資料，然後選取 [ 建立]。

   

新增主機檔案定義

若要在 Azure Logic Apps 中支援主機檔案連接器，您需要新增主機檔案定義。

1. 在方案總管中，開啟新的主機檔案專案的快捷方式功能表，然後選取 [新增>新增主機檔案定義]。

2. 當 [ 新增專案 ] 方塊出現時，請在 [ 名稱] 屬性中提供主機檔案定義的名稱，然後選取 [ 新增]。

   這些步驟會繼續範例名稱 HostFileDefinition1。

3. 啟動 [主機檔案定義精靈] 之後，在 [ 主機環境 ] 方塊中，根據下表選取 [ 主機環境 ] 和 [ 主機語言]：

   主機環境	主機語言
   System z (z 系列 IBM 大型主機系統的主機檔案)	COBOL
   System i (i 系列 IBM midrange 系統的主機檔案)	COBOL 或 RPG

4. 當您完成時，選取 [建立]。

完成精靈之後，主要設計檢視隨即出現，可讓您手動建立或匯入中繼資料成品。 針對這項工作，請繼續進行下一節。

設計中繼資料成品

本節說明如何手動建立中繼資料成品。 若要改為匯入主機定義，請參閱 匯入主機定義。

下表列出主要設計檢視的元件：

元件	Description
Tables 資料夾	資料表會定義主機檔案與架構之間的對應。 Tables 資料夾會將元件中的資料資料表分組。
Schemas 資料夾	架構會定義主機檔案記錄欄位與 .NET 資料類型之間的對應。 Schemas 資料夾會群組具有共用屬性的變數。
Unions 資料夾	等位可以根據規則的類型套用一組規則。 Unions 資料夾包含 COBOL 等位的對等專案。

新增資料表

1. 在主要設計檢視中，開啟 [ 資料表 ] 快捷方式功能表，然後選取 [ 新增資料表]。

   

2. 開啟新資料表的快捷方式功能表，然後選取 [ 屬性]。 根據下表提供每個資料行屬性的值：

   屬性	描述或值
   別名	開頭為 [A-Za-z] 的有效別名，後面接著最大長度為 256 的英數位元，例如 CUSTOMER
   主機名稱	大型主機檔案名最多有 22 個部分，以句號分隔 (。) 。 每個部分限制為 10 個字元。 總大小上限為 44 個字元，例如 HISDEMO。NWIND。客戶
   結構描述	表示主機檔案的結構，包括資料類型。

   

新增結構描述

1. 在主要設計檢視中，開啟 [ 架構] 快捷方式功能表，然後選取 [ 新增架構]。

   

   設計工具會建立具有一個欄位的架構。

2. 若要新增其他欄位，請開啟新架構的快捷方式功能表，然後選取 [ 新增欄位]。 視需要重複此步驟。

3. 開啟新欄位的快捷方式功能表，然後選取 [ 屬性]。 根據下表提供每個欄位屬性的值：

   屬性	描述或值
   Is Array	如果為 true，您必須設定陣列維度，以支援最多 7 個維度和 16,777,215 個元素的陣列。 您也必須輸入陣列屬性的 [發生計數] 和 [視情況而定]的值。
   資料類型	欄位的 .NET 資料類型
   名稱	功能變數名稱
   錯誤處理	觸發錯誤、四捨五入或截斷。
   主機資料類型	欄位的 COBOL 或 RPG 資料類型
   大小	32 位整數
   字串分隔	Null 終止 或 空格填補
   尾端填入	對於長度小於指定最大值的欄位，您必須指定填入大小。

   

新增等位

1. 在主要設計檢視中，開啟 [ 聯集 ] 快捷方式功能表，然後選取 [ 新增聯集]。

   

   設計工具會建立具有兩個成員的聯集。

2. 若要新增另一個成員，請開啟新聯集的快捷方式功能表，然後選取 [ 新增聯集成員]。 視需要重複此步驟。

3. 開啟成員的快捷方式功能表，然後選取 [ 屬性]。 根據下表提供每個成員屬性的值：

   屬性	描述或值
   Is Array	如果為 true，您必須設定陣列維度，以支援最多 7 個維度和 16,777,215 個元素的陣列。 您也必須輸入陣列屬性的 [發生計數] 和 [視情況而定]的值。
   資料類型	成員的 .NET 資料類型。 此值可以包含上一節中定義的結構。
   名稱	成員的名稱
   錯誤處理	觸發錯誤、四捨五入或截斷。
   主機資料類型	成員的 COBOL 或 RPG 資料類型
   大小	32 位整數
   字串分隔	Null 終止 或 空格填補
   尾端填入	對於長度小於指定最大值的成員，您必須指定填入大小。

   

4. 當您完成時，請繼續進行下一節，以建立儲存中繼資料設計的程式庫。

建立主機整合定義 XML (HIDX) 或中繼資料成品

本節說明如何建立儲存中繼資料成品設計的程式庫。

1. 若要產生中繼資料成品，請在 Visual Studio [檔案 ] 功能表或工具列上，選取 [ 全部儲存]。 (鍵盤：按 Ctrl+Shift+S)

   

2. 若要尋找產生的 HIDX 檔案，請移至主機檔案的資料夾。

   

相關內容

• 匯入 COBOL 主機定義