在信封結構描述中自訂列舉

發行項
07/21/2023

BizTalk Server可讓您自訂服務 (信封) 架構中的識別碼欄位列舉。如此可讓您接收或傳送信封的寄件者或接收者識別碼欄位中擁有非標準值 (在 X12 標準組織所定義的值集合以外) 的交換。它也可讓您變更合約屬性定義中標頭值的下拉式清單中可用的限定詞。

重要

當您修改結構描述時，該修改會套用至實際標準的所有交易。您無法在單一合作物件的信封架構中修改。

BizTalk Server會從隨附于產品的靜態服務架構中，提取 Microsoft.BizTalk.Edi.BaseArtifacts.dll 中允許的值清單。若要擴充基本的值集合，您需要開發和部署服務結構描述延伸模組。 BizTalk Server提供服務 (信封) 架構範本，可用來修改中的列舉。這些服務架構X12_ServiceSchemaExtension.xsd 和 EDIFACT_ServiceSchemaExtension.xsd。根據標準而定，每個自訂結構描述都會有下列其中一個命名空間。這個命名空間無法變更。

標準	命名空間
X12 和 HIPAA	`http://schemas.microsoft.com/BizTalk/EDI/X12/2006`
EDIFACT	`http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006`

您會在 Visual Studio 的 [BizTalk 編輯器] 中變更結構描述 (請參閱以下程序)。完成需要的變更之後，必須部署結構描述。

當 BizTalk Server 驗證信封區段 (X12 位為 ISA 和 GS，EDIFACT 則為 UNB 和 UNG) 時，會根據命名空間同時在接收和傳送端檢查是否有自訂服務結構描述存在。如果已部署自訂結構描述，則 BizTalk Server 將合併該結構描述與一般服務結構描述，並且同時使用自訂和標準列舉值 (如有指定的話)。您可以自訂結構描述以擴充列舉清單，但是無法移除清單中的值。如果未部署自訂結構描述，則 BizTalk Server 將使用標準服務結構描述。

部署自訂架構之後，BizTalk Server管理主控台中的交易夥伴管理 (TPM) 使用者介面將會使用自訂列舉中的值，在 TPM 屬性頁中填入適當的下拉式清單。如果您尚未部署自訂架構，TPM 會使用標準服務架構中列舉中的值。此外，BizTalk Server 執行階段將使用自訂列舉驗證訊息。

如果您使用隨附BizTalk Server的 XML 工具來驗證實例的信封，而且您已自訂服務架構，除了檔 (交易集) 架構之外，還必須在 BizTalk 專案中包含自訂服務架構，) 架構集 () ，並視需要包含批次架構。如果您要驗證沒有信封的交易集執行個體，則不需要這樣做。

必要條件

您必須以「BizTalk Server 系統管理員」群組的成員身分登入。

可以修改的信封欄位

只有下列信封欄位才能修改。延伸模組結構描述中只包含這些欄位。在服務延伸模組結購描述中加入其他欄位，對於處理程序不會有任何影響。

標準	欄位
X12 和 HIPAA	ISA01 – 授權辨識符號 ISA03 – 安全性辨識符號 ISA05 – 傳送者識別碼辨識符號 ISA07 - 接收者識別碼辨識符號 GS01 - 功能代碼 GS07 - 負責單位
EDIFACT	UNB2.2 - 傳送者代碼辨識符號 UNB3.2 - 接收者代碼辨識符號

不應該修改的信封欄位

信封中的某些欄位會驅動引擎的行為。因此，您不應該新增值至這些欄位的現有列舉清單。這些欄位包括：

標準	欄位
X12 和 HIPAA	ISA11 – 交換控制標準識別項 ISA12 – 交換控制版本號碼 ISA14 – 要求認可
EDIFACT	UNB1.1 – 語法識別項 UNB1.2 – 語法版本號碼 UNB9 – 通知要求