在知行EDI系统中实施SNIP验证
此前的文章介绍了SNIP验证EDI文件,本文主要介绍如何在知行EDI系统中实施SNIP验证。知行EDI系统的EDI处理功能包括对较低SNIP验证级别的内置支持。更高的SNIP验证级别可能需要配置验证端口作为数据处理的附加步骤,而最高级别的SNIP验证可能需要编写脚本来实现验证逻辑。
在文章SNIP验证EDI文件中介绍了SNIP的7种类型,本节将描述如何在知行EDI系统中实现每个级别的SNIP验证。但是,在描述所有这些级别之前,对于知行EDI系统的新手来说,描述应用程序如何处理EDI处理可能会有很大帮助。
知行EDI系统的EDI端口
知行EDI系统包含许多EDI端口,这些端口可将各种EDI格式转换为XML或从XML生成EDI文档。将EDI数据转换为XML的过程,遵循知行EDI系统在集成流程中使用XML作为中间数据格式的一般方法。使用XML作为通用数据格式,不仅可以简化通过XML Map Connector进行的数据转换,还可以确保知行EDI系统可以集成来自不同数据源和格式的数据。因此,数据通常在流程的早期转换为XML,在流程的中间传输,然后在流程结束时从XML转换为某种目标格式。
当EDI端口将EDI数据转换为XML时,知行EDI系统还将根据适当的EDI文档架构对EDI结构进行验证。默认情况下,此验证仅包括确保EDI可以正确转换为XML所必需的内容:段顺序,段的打开和关闭等。EDI端口还在“高级设置”选项卡中有一个名为SNIP Validation的设置,启用后会加强对EDI数据的验证要求。知行EDI系统中,启用SNIP Validation的页面如下图所示:
在知行EDI系统中的FLOWS页面下,任选一个EDI端口。以EDIFACT端口为例,点击名为EDIFACT1的端口,在Advanced页面下勾选Enable SNIP validation即可。
如以下小节所述,要确保SNIP验证的前三个级别,只需在EDI端口中启用SNIP Validation设置即可。
要实现更高级别的SNIP验证,可能需要额外的验证端口或自定义Script。这些端口将在EDI端口之后添加到Flow中,因此要验证的数据将是XML(EDI端口已经将EDI转换为XML)。下面提供了此附加验证的详细信息。
实施SNIP类型1
知行EDI系统通过其内置的EDI处理自动实现SNIP类型1。无需启用任何设置,也无需采取任何其他步骤。
实施SNIP类型2和3
为了确保SNIP类型2或3验证,应在负责将EDI转换为XML的EDI端口的“高级”选项卡中启用SNIP验证设置。无需其他步骤。
实施SNIP类型4
SNIP类型4验证要求将“验证端口”添加到处理输入EDI数据的流中。为实现类型4逻辑,可以验证端口配置:元素A 包含值“X”,然后,元素B必须是一组值之一,例如“Y”或“Z”。请注意,验证端口需要XML输入,因此应将输入EDI文件转换为XML的EDI端口之后添加。
在验证端口中正确实现此逻辑需要对所涉及的EDI数据有一定的了解。用户必须熟悉具有这种“if A,then B”关系的特定EDI元素,并能够在转换的XML中追踪到这些元素的xpath。
一旦知道了EDI元素之间的xpath和关系,就可以使用在知行EDI系统工作流中实现这些要求的规则来配置验证端口。这些规则检查两个xpath的值是否都在期望的集合内,并使用运算符“不等于”,“正则表达式匹配”和布尔值“OR”来完成“if-then”逻辑。下面提供了实现此逻辑的示例。
以一个简单的Type 4要求为例:如果elementA的值为“IL”,则elementB必须为“40”,“41”或“42”。
在验证端口中实现此步骤时,需要考虑两个步骤:
- 找到保留相关值的xpath
- 使用“等于”,“正则表达式匹配”和“或”实现if-then关系
为了这个示例,想象一个简单的xpath到我们的两个相关元素:
- /Items/path/elementA
- /Items/path/elementB
这些将在“验证端口”规则的“xpath”字段中使用。
接下来,考虑这些元素之间的逻辑关系:如果elementA具有特定值(“IL”),则elementB必须具有特定值(范围为40-42的数字)。表达这种关系的另一种方法是下面的:要么elementA是不特定的值(“IL”),或elementB 必须具有特定值(40-42)。关系的这种表述可以在验证端口中通过“OR”连接的两个规则来表示:
elementA notequals 'IL'
OR
elementB regex matches (40|41|42)
可以为需要具有“类型4”验证关系的每对元素实施这种验证规则方法。
实施SNIP类型5-7
更高级别的SNIP验证要求编写自定义Script来实现要求。本节将概述开始为每个验证级别编写脚本所必需的概念。
与验证相关的通用脚本概念
将EDI文件转换为XML后,最好应用Script。它包括xmlDOMSearch之类的操作,用于在指定的xpath上循环XML数据。因此,建议的工作流设计是将脚本端口直接放置在EDI端口之后,以负责将EDI文档转换为XML,并使用适当的验证脚本配置该脚本端口。
在xmlDOMSearch中,xpath格式化程序可以检索指定xpath处的值(相对于xmlDOMSearch调用中提供的xpath )。本小节的底部提供了使用此格式化程序的示例。
arc:set关键字用于在一个属性(即变量)中存储一个值。arc:if关键字可以用来实现条件逻辑。arc:select关键字可以用来检查一个值是否在指定的情况集内。
当验证脚本遇到验证失败的EDI数据时,它需要引发错误。Script中的错误使用arc:throw关键字引发。
以下是示例Script的摘要,表示脚本验证规则所需的逻辑种类:
<!-- set input parameters of xmlDOMSearch --> <arc:set attr="input.uri" value="[FilePath]" /> <arc:set attr="input.xpath" value="/Interchange/FunctionalGroup/TransactionSet/TX-00501-837"> <!-- loop over the input file at the given xpath --> <arc:call op="xmlDOMSearch" in="input"> <!-- retrieve specific values from the XML; elementA and elementB --> <arc:set attr="elementA" value="[xpath('HLLoop1/NM1Loop2/NM1/NM101')]" /> <arc:set attr="elementB" value="[xpath('HLLoop1/NM1Loop2/NM1/NM103')]" /> <!-- check elementA against a list of possible values with a 'select' statement --> <arc:select value="[elementA]"> <!-- for each possible elementA value, see if elementB has a valid value --> <arc:case value="IL"> <arc:if exp="[elementB | notequals(40)] && [elementB | notequals(41)] && [elementB | notequals(42)]"> <!-- invalid value detected, throw an error --> <arc:throw code=1 desc="ElementB had an invalid value of [elementB]." /> </arc:if> </arc:case> <arc:case value="PR"> <arc:if exp="[elementB | notequals(43)] && [elementB | notequals(44)]"> <!-- invalid value detected, throw an error --> <arc:throw code=1 desc="ElementB had an invalid value of [elementB]." /> </arc:if> </arc:case> </arc:select> </arc:call>
SNIP类型5
SNIP类型5需要读取外部资源以检查可能的值范围。用户负责获取这些外部资源的过程。
一旦获得,就可以使用一系列Script功能从这些资源中读取值,具体取决于资源的特定类型:
- 可以使用dbQuery操作查询数据库
- 文本文件可以通过fileRead操作读取
- 可以使用csvListRecords操作读取CSV文件
读取到来自外部授权的值后,实现这些限制的过程将遵循与上一小节中提供的代码段相似的语法。
SNIP类型6
SNIP类型6需要根据EDI文件中列出的服务来验证特定的值关系。用于此验证的脚本方法遵循与其他数据验证脚本相同的原则,另外还有一个步骤,即首先在验证每个单独的数据元素时检索要使用的医疗服务价值。
这些脚本应遵循上述相同的“arc:select”和“arc:if”方法,尽管实际的逻辑中可能包含更多级别和元素。
SNIP类型7
SNIP类型7需要来自外部EDI交易伙伴的直接输入。因此,实施这些规则的细节取决于合作伙伴,但是应使用相同的条件逻辑工具(“arc:select”,“arc:if”)来实施这些检查。
知行EDI系统包括对SNIP验证的基线级别的简单一键式支持,并提供了端口和Script验证以实施更具体的验证规则。
更多EDI技术交流,欢迎私信或评论!
注:文案部分图片及内容来源于网络,版权归原创作者所有,如有侵犯到您的权益,请您联系我们进行删除,给您带来困扰,我们深感抱歉。