自定义信封架构中的枚举

BizTalk Server 允许自定义服务(信封)架构中的 ID 字段枚举。 这样,便可以在信封的发送方或接收方 ID 字段中接收或发送具有非标准值的交换(超出 X12 标准正文定义的值集)。 它还使你能够更改协议属性定义中标头值的下拉列表中可用的限定符。

重要

修改架构时,该修改适用于有关标准的所有事务。 不能对单个参与方的信封架构进行修改。

BizTalk Server 从随产品附带的 Microsoft.BizTalk.Edi.BaseArtifacts.dll中的静态服务架构中提取允许的值列表。 若要扩展基本值集,需要开发和部署服务架构扩展。 BizTalk Server 提供服务(信封)架构模板,以便你可以修改枚举。 这些服务架构X12_ServiceSchemaExtension.xsd 和 EDIFACT_ServiceSchemaExtension.xsd。 每个自定义架构将具有以下命名空间之一,具体取决于标准。 无法更改此命名空间。

标准 Namespace
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 或 UNB 和 UNG for EDIFACT)时,它将根据其命名空间检查自定义服务架构是否存在。 如果部署了自定义架构,BizTalk Server 会将该架构与常规服务架构合并,并将使用指定的自定义和标准枚举值。 可以自定义架构以扩展枚举列表,但不能从其中删除值。 如果未部署自定义架构,BizTalk Server 将使用标准服务架构。

部署自定义架构后,BizTalk Server 管理控制台中的贸易合作伙伴管理(TPM)用户界面将使用自定义枚举中的值来填充 TPM 属性页中的相应下拉列表。 如果尚未部署自定义架构,TPM 将使用标准服务架构中的枚举中的值。 此外,BizTalk Server 运行时将使用自定义枚举来验证消息。

如果使用 BizTalk Server 提供的 XML 工具来验证包含其信封的实例,并且已自定义服务架构,则除了文档(事务集)架构和(如有必要)批次架构外,还必须在 BizTalk 项目中包括自定义服务架构。 如果验证没有信封的事务集实例,则不需要这样做。

先决条件

必须以 BizTalk Server 管理员组的成员身份登录。

可以修改的信封字段

只能修改以下信封字段。 扩展架构中仅包括这些字段。 在服务扩展架构中添加的其他字段不会对处理产生任何影响。

标准 领域
X12 和 HIPAA ISA01 – 授权限定符

ISA03 – 安全限定符

ISA05 – 发件人 ID 限定符

ISA07 - 接收方 ID 限定符

GS01 - 功能代码

GS07 - 责任机构
EDIFACT UNB2.2 - 发送方代码限定符

UNB3.2 - 接收方代码限定符

不应修改的信封字段

信封中的某些字段影响引擎中的行为。 因此,不应将这些字段的值添加到现有枚举列表中。 这些字段如下:

标准 领域
X12 和 HIPAA ISA11 – 交换控制标准标识符

ISA12 – 交换控制版本号

ISA14 – 请求确认
EDIFACT UNB1.1 – 语法标识符

UNB1.2 – 语法版本号

UNB9 – 确认请求

自定义信封架构中的列举枚举

  1. 在 Visual Studio 中,创建新项目。

  2. 将 X12_ServiceSchemaExtension.xsd 架构(用于修改 X12 或 HIPAA 枚举)或 EDIFACT_ServiceSchemaExtension.xsd 架构,添加到 \Program Files (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI 中的 BizTalk 编辑器中的 BizTalk 项目。 打开架构。

  3. 若要更改枚举中的值,请在 “属性 ”窗格中选择枚举,然后单击省略号以打开 枚举编辑器。 根据需要添加到值列表中,确保“ ”窗格中每行都有一个值。 单击 “确定”

    重要

    无法更改服务架构的命名空间。 架构应具有与随产品一起安装的原始扩展架构相同的命名空间和根节点名称。

    注释

    如果要向架构添加新字段,将忽略该字段。 只有上述 “可以修改的信封字段 ”部分中列出的字段才能更改。

  4. 保存该架构。

  5. 右键单击架构,然后单击“ 部署”。

    注释

    架构必须部署在当前 BizTalk 组中。

另请参阅

开发 EDI 架构
修改 EDI 架构