培训
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 | 字符串 | 邮件附件的 ID。 |
AgreementID | int | 由 EDI 接收管道写入。 指定将入站消息解析到的协议 ID。 对于备用协议,此值为 0。 |
AgreementName | 字符串 | 由 EDI 接收管道写入。 指定将入站消息解析到的协议名称。 对于回退协议,此值为 BTSGuestParty。 |
AgreementNameForSend | 字符串 | 由 EDI 发送管道使用,用于出站文档的协议解析。 |
AgreementPartIDForSend | int | 由 EDI 发送管道使用,用于出站文档的协议解析。 此值由批处理业务流程写入。 |
AgreementPartIDOnReceive | int | 由 EDI 接收管道写入。 指定将入站消息解析到的协议的单项协议 ID。 对于备用协议,此值为 0。 |
BatchElementValidationFailure | boolean | 指示当批元素验证失败时批处理系统提示发生错误。 |
BatchEncodingType | 字符串 | BizTalk Server 对传出的批处理交换进行编码时必须使用的编码类型。 |
BatchId | int | 如果此文档只与一个批处理筛选器匹配,则在处理该文档时将使用的批处理配置的批处理 ID。 |
BatchIds | 字符串 | 如果文档与多个批处理筛选器匹配,则为匹配批处理筛选器集的批处理 ID 列表。 |
BatchingError | 字符串 | 描述批处理系统在挂起批元素时提示发生错误。 |
BatchName | 字符串 | 处理此文档时使用的批处理配置的名称。 |
CodePage | 字符串 | 用于验证交换的代码页。 |
CONTRL_UCI4 | 字符串 | CONTRL 确认的“操作代码”字段,指示已接受交换(值为“8”)还是因 UNA 或 UNB 段中存在错误而拒绝交换(值为“4”)(仅适用于 EDIFACT CONTRL 确认)。 |
destinationPartyID (在 BizTalk Server) 中弃用 | int | 应接收消息的目标参与方的 ID。 |
destinationPartyName (在 BizTalk Server) 中已弃用 | 字符串 | 应接收消息的目标参与方的名称。 |
DestinationPartyReceiver 标识符 |
字符串 | 应接收消息的目标参与方的标识符。 可以在自定义组件中升级该属性,以便在发送管道中启用参与方解析。 |
DestinationPartyReceiver 限定符 |
字符串 | 应接收消息的目标参与方的限定符。 可以在自定义组件中升级该属性,以便在发送管道中启用参与方解析。 |
DestinationPartySender 标识符 |
字符串 | 将消息发送到目标参与方的参与方的标识符。 可以在自定义组件中升级该属性,以便在发送管道中启用参与方解析。 |
DestinationPartySender 限定符 |
字符串 | 将消息发送到目标参与方的参与方的限定符。 可以在自定义组件中升级该属性,以便在发送管道中启用参与方解析。 |
EncodingType | short | BizTalk Server 对传出消息进行编码所必须使用的编码类型。 |
ErrorDescription | 字符串 | 对挂起的消息包含错误消息(类似于事件查看器中的消息)的副本。 |
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 | 字符串 | 交换发送方 ID (X12) 如果交换不是) 保留的批处理交换,则 EDI 接收管道会将此属性提升到上下文 (。 |
ISA07 | 字符串 | 交换接收方限定符 (X12) 如果交换不是) 保留的批处理交换,则 EDI 接收管道会将此属性提升到上下文 (。 |
ISA08 | 字符串 | 交换接收方 ID (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),这可能导致信息泄漏。 您可以使用屏蔽安全/授权/密码信息属性将 UNB6.1 和 UNB6.2 字段中的值替换为“#”字符。 请注意,“#”字符不能转换为实际的字符。 |
UNB11 | 字符串 | 用法指示符 (EDIFACT) 如果交换不是) 保留的批处理交换,EDI 接收管道会将此属性提升到上下文 (。 |
UNB2_1 | 字符串 | 交换发送方 ID (EDIFACT) 如果交换不是) 保留的批处理交换,EDI 接收管道会将此属性提升到上下文 (。 |
UNB2_2 | 字符串 | 交换发送方代码限定符 (EDIFACT) 如果交换不是) 保留的批处理交换,EDI 接收管道会将此属性提升到上下文 (。 |
UNB2_3 | 字符串 | 反向路由地址 (EDIFACT) 如果交换不是) 保留的批处理交换,EDI 接收管道会将此属性提升到上下文 (。 |
UNB3_1 | 字符串 | 交换接收方 ID (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 示例) 。
其他资源
文档
-
通过独立 WCF 接收适配器发布 WCF 服务 - BizTalk Server
详细了解:使用独立 WCF 接收适配器发布 WCF 服务
-
详细了解:排查错误
-
配置错误。 消息签名与预期的值不匹配。 - BizTalk Server
详细了解:配置错误。 消息签名与预期的值不匹配。