有关在 Azure 逻辑应用协议中进行 X12 消息设置的参考
适用范围:Azure 逻辑应用(消耗型 + 标准型)
本参考将介绍为了指定如何处理参与方之间的消息而可在 X12 协议中设置的属性。 请根据与消息交换合作伙伴之间达成的协议来配置这些属性。
X12 接收设置
标识符
属性 | 说明 |
---|---|
ISA1(授权限定符) | 要使用的授权限定符值。 默认值为“00 - 不存在任何授权信息”。 注意:如果选择其他值,请指定 ISA2 属性的值。 |
ISA2 | 当 ISA1 属性不是“00 - 不存在任何授权信息”时要使用的授权信息值。 此属性值必须最少包含一个字母数字字符,最多包含 10 个。 |
ISA3(安全限定符) | 要使用的安全限定符值。 默认值为“00 - 不存在任何安全信息”。 注意:如果选择其他值,请指定 ISA4 属性的值。 |
ISA4 | 当 ISA3 属性不是“00 - 不存在任何安全信息”时要使用的安全信息值。 此属性值必须最少包含一个字母数字字符,最多包含 10 个。 |
确认
属性 | 说明 |
---|---|
预期的 TA1 | 向交换发送方返回技术确认 (TA1)。 |
预期的 FA | 向交换发送方返回功能确认 (FA)。 对于“FA 版本”属性,根据架构版本,选择 997 或 999 确认。 若要在功能确认中为接受的事务集生成 AK2 循环,请选择“包括 AK2/IK2 循环”。 |
架构
对于此部分,请从每个事务类型 (ST01) 和发送方应用程序 (GS02) 的集成帐户中选择一个架构。 EDI 接收管道会通过将在此部分中设置的值和架构与传入消息中的 ST01 和 GS02 值进行匹配以及与传入消息的架构进行匹配,来分解传入消息。 完成每行后,会自动显示新的空行。
属性 | 说明 |
---|---|
版本 | 架构的 X12 版本 |
事务类型 (ST01) | 事务类型 |
发送方应用程序 (GS02) | 发送方应用程序 |
架构 | 要使用的架构文件 |
包络线
properties | 说明 |
---|---|
ISA11 用法 | 要在事务集中使用的分隔符: - 标准标识符:在 EDI 接收管道中使用句点 (.) 十进制表示法,而不是使用传入文档的十进制表示法。 - 重复分隔符:为重复出现的简单数据元素或重复数据结构指定分隔符。 例如,脱字符 (^) 通常用作重复分隔符。 对于 HIPAA 架构,只能使用脱字符。 |
控制编号
属性 | 说明 |
---|---|
不允许交换控制编号重复项 | 阻止重复交换。 检查交换控制编号 (ISA13) 是否匹配接收的交换控制编号。 如果检测到匹配项,则 EDI 接收管道不处理交换。 若要指定执行检查的间隔天数,请为“每 x 天检查重复的 ISA13”属性输入适当的值。 |
不允许组控制编号重复项 | 阻止具有重复组控制编号的交换。 |
不允许事务集控制编号重复项 | 阻止具有重复事务集控制编号的交换。 |
验证
“默认”行显示用于 EDI 消息类型的验证规则。 如果要定义不同的规则,请选择要将规则设置为 true 的每个框。 完成每行后,会自动显示新的空行。
属性 | 说明 |
---|---|
消息类型 | EDI 消息类型 |
EDI 验证 | 根据架构的 EDI 属性、长度限制、空数据元素和尾部分隔符的定义,对数据类型执行 EDI 验证。 |
扩展验证 | 如果数据类型不是 EDI,则验证会基于数据元素要求,且允许重复、枚举和数据元素长度验证(最小/最大)。 |
允许前导零/尾随零 | 保留所有额外的前导或尾随零和空格字符。 不要删除这些字符。 |
剪裁前导零/尾随零 | 删除任何前导或尾随零和空格字符。 |
尾随分隔符策略 | 生成尾部分隔符。 - 不允许:禁止在入站交换中包含尾随分隔符。 如果交换包含尾部分隔符,会将它声明为无效。 - 可选:接受包含或不包含尾随分隔符的交换。 - 必需:入站交换必须包含尾随分隔符。 |
内部设置
属性 | 说明 |
---|---|
将隐式小数格式“Nn”转换为十进制数值 | 将使用格式“Nn”指定的 EDI 数字转换为十进制数值。 |
如果允许尾随分隔符,请创建空的 XML 标记 | 使交换发送方包含用于尾随分隔符的空 XML 标记。 |
将交换拆分为事务集 - 出错时暂停事务集 | 通过将相应包络线应用于事务集,将交换中的每个事务集分析为单独 XML 文档。 仅暂停未通过验证的事务。 |
将交换拆分为事务集 - 出错时暂停交换 | 通过应用相应包络线,将交换中的每个事务集分析为单独 XML 文档。 如果交换中的一个或多个事务集未能通过验证,则暂停整个交换。 |
保留交换 - 出错时暂停事务集 | 保留交换不变,并为整个批处理交换创建 XML 文档。 仅暂停未能通过验证的事务集,但继续处理所有其他事务集。 |
保留交换 - 出错时暂停交换 | 保留交换不变,为整个批处理交换创建 XML 文档。 如果交换中的一个或多个事务集未能通过验证,则暂停整个交换。 |
X12 发送设置
标识符
属性 | 说明 |
---|---|
ISA1(授权限定符) | 要使用的授权限定符值。 默认值为“00 - 不存在任何授权信息”。 注意:如果选择其他值,请指定 ISA2 属性的值。 |
ISA2 | 当 ISA1 属性不是“00 - 不存在任何授权信息”时要使用的授权信息值。 此属性值必须最少包含一个字母数字字符,最多包含 10 个。 |
ISA3(安全限定符) | 要使用的安全限定符值。 默认值为“00 - 不存在任何安全信息”。 注意:如果选择其他值,请指定 ISA4 属性的值。 |
ISA4 | 当 ISA3 属性不是“00 - 不存在任何安全信息”时要使用的安全信息值。 此属性值必须最少包含一个字母数字字符,最多包含 10 个。 |
确认
属性 | 说明 |
---|---|
预期的 TA1 | 向交换发送方返回技术确认 (TA1)。 此设置指定发送消息的管理方请求协议中的托管方的确认。 管理方基于协议的接收设置需要这些确认。 |
预期的 FA | 向交换发送方返回功能确认 (FA)。 对于“FA 版本”属性,根据架构版本,选择 997 或 999 确认。 此设置指定发送消息的管理方请求协议中的托管方的确认。 管理方基于协议的接收设置需要这些确认。 |
架构
对于此部分,请从每个事务类型 (ST01) 的集成帐户中选择一个架构。 完成每行后,会自动显示新的空行。
属性 | 说明 |
---|---|
版本 | 架构的 X12 版本 |
事务类型 (ST01) | 架构的事务类型 |
架构 | 要使用的架构文件。 如果先选择架构,将自动设置版本和事务类型。 |
包络线
properties | 说明 |
---|---|
ISA11 用法 | 要在事务集中使用的分隔符: - 标准标识符:在 EDI 发送管道中使用句点 (.) 十进制表示法,而不是使用出站文档的十进制表示法。 - 重复分隔符:为重复出现的简单数据元素或重复数据结构指定分隔符。 例如,脱字符 (^) 通常用作重复分隔符。 对于 HIPAA 架构,只能使用脱字符。 |
控制版本号
对于此部分,请从每个交换的集成帐户中选择一个架构。 完成每行后,会自动显示新的空行。
属性 | 说明 |
---|---|
控制版本号 (ISA12) | X12 标准的版本 |
用法指示符 (ISA15) | 交换的上下文,为测试数据、信息数据或生产数据 |
架构 | 用于为发送到 EDI 发送管道的 X12 编码交换生成 GS 和 ST 段的架构。 |
GS1 | 可选:选择功能代码。 |
GS2 | 可选:指定应用程序发送方。 |
GS3 | 可选:指定应用程序接收器。 |
GS4 | 可选:选择 CCYYMMDD 或 YYMMDD 。 |
GS5 | 可选,选择 HHMM、HHMMSS 或 HHMMSSdd 。 |
GS7 | 可选:选择负责代理的值。 |
GS8 | 可选:指定架构文档版本。 |
控制编号
属性 | 说明 |
---|---|
交换控制编号 (ISA13) | 交换控制编号的值范围,最小值为 1,最大值为 999999999 |
组控制编号 (GS06) | 组控制编号的值范围,最小值为 1,最大值为 999999999 |
事务集控制编号 (ST02) | 事务集控制编号的值范围,最小值为 1,最大值为 999999999 - 前缀:可选,字母数字值 - 后缀:可选,字母数字值 |
字符集和分隔符
“默认”行显示用作消息架构分隔符的字符集。 如果不想使用“默认”字符集,可以为每种消息类型输入不同分隔符集。 完成每行后,会自动显示新的空行。
提示
若要提供特殊字符值,请编辑作为 JSON 的协议并提供特殊字符的 ASCII 值。
属性 | 说明 |
---|---|
要使用的字符集 | X12 字符集,为“基本”、“扩展”或“UTF8”。 |
架构 | 要使用的架构。 选择架构后,请根据以下分隔符说明选择要使用的字符集。 |
输入类型 | 字符集的输入类型 |
组件分隔符 | 分隔复合数据元素的单个字符 |
数据元素分隔符 | 分隔复合数据中的简单数据元素的单个字符 |
替换字符分隔符 | 用于在生成出站 X12 消息时替换有效负载数据中的所有分隔符的替换字符 |
段终止符 | 指示 EDI 段的结尾的单个字符 |
后缀 | 与段标识符一起使用的字符。 如果指定了后缀,则段终止符数据元素可以为空。 如果段终止符留空,则必须指定后缀。 |
验证
“默认”行显示用于 EDI 消息类型的验证规则。 如果要定义不同的规则,请选择要将规则设置为 true 的每个框。 完成每行后,会自动显示新的空行。
属性 | 说明 |
---|---|
消息类型 | EDI 消息类型 |
EDI 验证 | 根据架构的 EDI 属性、长度限制、空数据元素和尾部分隔符的定义,对数据类型执行 EDI 验证。 |
扩展验证 | 如果数据类型不是 EDI,则验证会基于数据元素要求,且允许重复、枚举和数据元素长度验证(最小/最大)。 |
允许前导零/尾随零 | 保留所有额外的前导或尾随零和空格字符。 不要删除这些字符。 |
剪裁前导零/尾随零 | 删除任何前导或尾随零和空格字符。 |
尾随分隔符策略 | 生成尾部分隔符。 - 不允许:禁止在出站交换中包含尾随分隔符。 如果交换包含尾部分隔符,会将它声明为无效。 - 可选:发送包含或不包含尾随分隔符的交换。 - 必需:出站交换必须包含尾随分隔符。 |
HIPAA 架构和消息类型
使用 HIPAA 架构和 277 或 837 消息类型时,需要执行一些额外的步骤。 这些消息类型的文档版本号 (GS8) 具有 9 个以上的字符,例如“005010X222A1”。 此外,某些文档版本号映射到变体消息类型。 如果在架构和协议中未引用正确的消息类型,则会收到以下错误消息:
"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."
此表列出了受影响的消息类型、所有变体以及映射到这些消息类型的文档版本号:
消息类型或变体 | 说明 | 文档版本号 (GS8) |
---|---|---|
277 | 医疗保健信息状态通知 | 005010X212 |
837_I | 医疗保健索赔:机构 | 004010X096A1 005010X223A1 005010X223A2 |
837_D | 医疗保健索赔:牙科 | 004010X097A1 005010X224A1 005010X224A2 |
837_P | 医疗保健索赔:职业 | 004010X098A1 005010X222 005010X222A1 |
使用这些文档版本号时,还需要禁用 EDI 验证,因为它们会导致字符长度无效的错误。
若要指定这些文档版本号和消息类型,请执行以下步骤:
注意
具有 837_P、837_I 或 837_D 类型的每条消息都需要单独的协议。
在 HIPAA 架构中,将当前消息类型替换为要使用的文档版本号的变体消息类型。
例如,假设你要将文档版本号
005010X222A1
用于837
消息类型。 在架构中,将每个"X12_00501_837"
值替换为"X12_00501_837_P"
值。若要更新架构,请执行以下步骤:
在 Azure 门户中,转到集成帐户。 查看和下载你的架构。 替换消息类型并重命名架构文件,然后将修改后的架构上载到集成帐户。 有关详细信息,请参阅编辑架构。
在协议的消息设置中,选择修改后的架构。
在协议的
schemaReferences
对象中,添加另一个条目来指定与文档版本号匹配的变体消息类型。例如,假设要将文档版本号
005010X222A1
用于837
消息类型。 协议有一个schemaReferences
部分,其中包含以下属性和值:"schemaReferences": [ { "messageId": "837", "schemaVersion": "00501", "schemaName": "X12_00501_837" } ]
编辑
schemaReferences
部分,使其与以下示例类似:"schemaReferences": [ { "messageId": "837", "schemaVersion": "00501", "schemaName": "X12_00501_837_P" } ]
在协议的消息设置中,如果使用“默认”值,请通过清除每个消息类型或所有消息类型的“EDI 验证”复选框来禁用 EDI 验证。