EDI 內容屬性
EDI 全域屬性結構描述中的訊息內容屬性都是公開屬性,因此您可以在像是訊息路由等作業中使用這些內容屬性。 這些內容屬性都是定義在 Microsoft.BizTalk.Edi.BaseArtifacts 組件的 PropertySchema.xsd 結構描述中。 屬性的命名空間為 http://schemas.microsoft.com/ Edi/PropertySchema
。 如果它們已升級,這些訊息內容屬性會以 Edi 的形式提供。 <屬性名稱>在UI 指引和開發人員 API 命名空間參考之[傳送埠屬性] 對話方塊的 [篩選] 頁面中。
內容屬性清單
只要在協調流程專案中加入 Microsoft.BizTalk.Edi.BaseArtifacts 組件的參考,這些 EDI 內容屬性也可以用於協調流程。
名稱 | 類型 | 描述 |
---|---|---|
AK901 | 字串 | 表示通知中 AK1 區段內所識別的功能群組為已接受或已拒絕 (僅限 X12 997 通知)。 |
AttachmentId | 字串 | 郵件附件的識別碼。 |
AgreementID | Int | 由 EDI 接收管線撰寫。 指定解析輸入訊息之合約的識別碼。 對於後援合約,此值為 0。 |
AgreementName | 字串 | 由 EDI 接收管線撰寫。 指定解析輸入訊息的合約名稱。 對於後援合約,此值為 BTSGuestParty。 |
AgreementNameForSend | 字串 | 由 EDI 傳送管線用於輸出檔案的合約解析。 |
AgreementPartIDForSend | Int | 由 EDI 傳送管線用於輸出檔案的合約解析。 此值是由批次處理協調流程所撰寫。 |
AgreementPartIDOnReceive | Int | 由 EDI 接收管線撰寫。 指定解析輸入訊息之合約的單向合約識別碼。 對於後援合約,此值為 0。 |
BatchElementValidationFailure | boolean | 表示當批次項目未通過驗證時,批次處理系統升級錯誤的指示。 |
BatchEncodingType | 字串 | BizTalk Server的編碼類型必須用來編碼傳出批次交換。 |
BatchId | Int | 當檔只符合一個批次篩選準則時,處理此檔時要使用的批次組態批次識別碼。 |
BatchIds | 字串 | 如果檔符合多個批次篩選準則,則為相符批次篩選集的批次識別碼清單。 |
BatchingError | 字串 | 當批次處理系統擱置批次項目時,針對該批次處理系統所升級錯誤的說明。 |
BatchName | 字串 | 處理本檔時要使用的批次組態名稱。 |
CodePage | 字串 | 用來驗證交換的字碼頁。 |
CONTRL_UCI4 | 字串 | CONTRL 通知的「動作代碼」欄位,表示交換已被接受 (值 "8"),或交換已因 UNA 或 UNB 區段錯誤而被拒絕 (值 "4") (僅限 EDIFACT CONTRL 通知)。 |
destinationPartyID (在 BizTalk Server) 中已被取代 | int | 訊息應傳送目標之目的合作對象的識別碼。 |
DestinationPartyName (在 BizTalk Server) 中已被取代 | 字串 | 訊息應傳送目標之目的合作對象的名稱。 |
DestinationPartyReceiver 識別碼 |
字串 | 訊息應傳送目標之目的合作對象的識別碼。 這個屬性可由自訂元件升級,以啟用傳送管線中的合作對象解析。 |
DestinationPartyReceiver 限定詞 |
字串 | 訊息應傳送目標之目的合作對象的辨識符號。 這個屬性可由自訂元件升級,以啟用傳送管線中的合作對象解析。 |
DestinationPartySender 識別碼 |
字串 | 傳送訊息至目的合作對象之合作對象的識別碼。 這個屬性可由自訂元件升級,以啟用傳送管線中的合作對象解析。 |
DestinationPartySender 限定詞 |
字串 | 傳送訊息至目的合作對象之合作對象的辨識符號。 這個屬性可由自訂元件升級,以啟用傳送管線中的合作對象解析。 |
EncodingType | short | BizTalk Server的編碼類型必須用來編碼傳出訊息。 |
ErrorDescription | 字串 | 對於擱置的訊息,其中會包含錯誤訊息的複本 (類似 EventViewer 中的訊息)。 |
GS_Segment | 字串 | 完整的 GS (功能群組) 區段 (X12) EDI 接收管線會在交換分割為交易集時 (而非保留交換時),將此屬性寫入內容中。 |
GS01 | 字串 | 功能識別項代碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
GS02 | 字串 | 應用程式傳送者代碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
GS03 | 字串 | 應用程式接收者代碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
GS07 | 字串 | 負責單位 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
GS08 | 字串 | 版本/版次/產業識別項代碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
ISA_Segment | 字串 | 完整的 ISA (交換控制標頭) 區段 (X12) BizTalk Server 會在交換分割為多個交易集時 (而非保留交換時),將此屬性寫入內容中。 這個屬性包含可能導致資訊洩漏的安全性/授權資訊 (ISA2 欄位包含授權資訊,而 ISA4 欄位包含安全性資訊)。 您可以使用 [ 驗證和 ACK 產生 ] 頁面中 (遮罩安全性/授權/密碼資訊屬性,) 將 ISA2 和 ISA4 欄位中的每個字元取代為 「#」 字元。 這是單向進程:「#」 字元無法轉換成實際字元。 EDI 接收管線會在交換分割為交易集時 (而非保留交換時),將此屬性寫入內容中。 |
ISA05 | 字串 | 交換傳送者辨識符號 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
ISA06 | 字串 | 交換傳送者識別碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
ISA07 | 字串 | 交換接收者辨識符號 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
ISA08 | 字串 | 交換接收者識別碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
ISA15 | 字串 | 使用狀況指示符號 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
IsResendControlMessage | int | AS2 引擎用來指出應該重新傳輸 AS2 訊息傳送,因為 MDN 回應尚未在設定的時間內收到。 |
IsSystemGeneratedACK | boolean | 表示訊息是系統產生的通知 (X12 TA1 或 997,或是 EDIFACT CONTRL)。 可以設定為 True 或 False。 這是可做為 EDI 的訊息內容屬性。IsSystemGeneratedACK 位於 [傳送埠屬性] 對話方塊的 [篩選] 頁面中。 |
ReceiverPartyName | 字串 | 由 EDI 接收管線撰寫。 指定訊息解析所在合約中提供的目的地夥伴名稱。 對於後援合約,此值為 RECEIVE-PARTNER。 |
ReceiverPartyNameForSend | 字串 | 由 EDI 傳送管線用於輸出檔案的合約解析。 |
ReuseEnvelope | boolean | 指示交換為保留或是分割狀態。 如果交換是保留狀態,BizTalk Server 就會在處理要傳送的交換時重複使用該信封。 |
SenderPartyName | 字串 | 由 EDI 接收管線撰寫。 指定解析輸入訊息之合約中提供的來源夥伴名稱。 對於後援合約,此值會是 BTS-SENDER。 |
SenderPartyNameForSend | 字串 | 由 EDI 傳送管線用於輸出檔案的合約解析。 |
ST01 | 字串 | 交易集識別項代碼 (X12) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
ST03 | 字串 | 版本/版次/產業識別項代碼 (X12) 您可以撰寫此屬性並將其升階至內容,並將其用於訊息路由。 |
TA1_TA104 | 字串 | TA104 通知的「引擎行為」欄位,表示已接受交換 (值 "A")、已接受交換但發生錯誤 (值 "E"),或已拒絕/已擱置交換 (值 "R") (僅限 X12 TA1 通知)。 |
ToBeBatched | boolean | 指示訊息是否應與其他訊息一起由批次處理協調流程批次處理。 在批次處理交換之後,批次處理協調流程會將此屬性設定為 False。 |
ToBeRouted | boolean | 指示訊息應該由路由協調流程收取,而該協調流程會依照批次項目的訂閱數來建立該批次項目相同數目的複本,然後將複本路由傳送至 MessageBox。 |
UNA_Segment | 字串 | 完整的 UNA (字串服務建議) 區段 (EDIFACT) EDI 接收管線會在交換分割為交易集時 (而非保留交換時),將此屬性寫入內容中。 |
UNB_Segment | 字串 | 完整的 UNB (交換控制標頭) 區段 (EDIFACT) EDI 接收管線會在交換分割為交易集時 (而非保留交換時),將此屬性寫入內容中。 這個屬性包含可能導致資訊洩漏的安全性/授權資訊 (UNB6.1 和 UNB6.2)。 您可以使用 Mask security/authorization/password 資訊屬性,以 「#」 字元取代 UNB6.1 和 UNB6.2 欄位中的值。 請注意,「#」 字元無法轉換成實際字元。 |
UNB11 | 字串 | 使用狀況指示符號 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNB2_1 | 字串 | 交換傳送者識別碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNB2_2 | 字串 | 交換傳送者識別碼辨識符號 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNB2_3 | 字串 | 反向路由的位址 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNB3_1 | 字串 | 交換收件者識別碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNB3_2 | 字串 | 交換收件者識別碼辨識符號 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNG_Segment | 字串 | 完整的 UNG (功能群組) 區段 (X12) EDI 接收管線會在交換分割為交易集時 (而非保留交換時),將此屬性寫入內容中。 |
UNG1 | 字串 | 功能群組識別碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNG2_1 | 字串 | 應用程式傳送者識別碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNG3_1 | 字串 | 應用程式收件者識別碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNH2_1 | 字串 | 訊息類型 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNH2_2 | 字串 | 訊息版本號碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
UNH2_3 | 字串 | 訊息版次號碼 (EDIFACT) EDI 接收管線會將這個屬性升級到內容中 (如果該交換不是保留的批次交換)。 |
從區段內容屬性擷取個別的欄位
有些屬性不會被 EDI 接收管線當做個別的屬性寫入或升級到訊息內容中,而只是做為區段字串的一部分。 這是基於效能的考量,因為屬性升級對效能會有影響。 例如,ISA 區段中的 ISA5、ISA6、ISA7、ISA8 和 ISA15 欄位會被接收管線當做個別的屬性來升級,但其餘 ISA 欄位只會做為 ISA_Segment 屬性的一部分寫入訊息內容中。 只有在 ReuseEnvelope 未設定為 True 時,才會寫入或升級這些屬性,表示未保留接收的批次交換。
如果您需要其中一個區段的個別欄位 (ISA、GS、UNB、UNG 或 UNA) 才能寫入訊息內容,但此個別欄位預設不會寫入訊息內容,您必須撰寫自訂群組件以寫入訊息內容。 這個自訂元件必須剖析區段欄位,並將個別的欄位寫入到訊息內容。
「訊息豐富」範例示範如何使用剖析器,從區段中擷取個別的欄位並將其寫入至內容。 此範例包含在 < drive > :\Program Files\Microsoft BizTalk Server\SDK\Samples\EDI\MessageEnrichment 中。 如需詳細資訊,請參閱訊息擴充範例 (BizTalk Server 範例) 。