《HRP G 外部交换平台》由会员分享，可在线阅读，更多相关《HRP G 外部交换平台（29页珍藏版）》请在金锄头文库上搜索。
1、HRP G 外部交换平台培训,用友医疗卫生信息系统有限公司2012年 8月 20日,提纲,业务分析 案列精讲 接口方案 注意事项,业务分析,例：门诊业务收入 医院的收入数据或收入报表（截图或表格展现） 门诊收入凭证：借：现金银行存款贷：门诊收入-挂号收入门诊收入-检查收入 住院收入凭证：借：应收医疗款贷：住院收入-床位收入住院收入-检查收入,外部交换平台总体结构,外部数据交换平台主要用于外部系统和NC系统进行集成。利用外部数据交换平台，可以将外系统的基本档案和业务数据发送到NC系统中，并进行相关的业务操作，如审批、弃审，也可以通过发送XML格式的查询条件导出NC系统的数据（需业务插件支持），导
2、出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。,外部交换平台功能特点,采用XML格式作为统一的数据交换标准，为数据访问提供简便、 统一的模式。 面向服务的架构。这使得第三方系统可以随时随地向NC系统发送相关的业务数据，NC内部的预警服务及工作流引擎使得NC系统可以在合适的时候向第三方系统传送需要的数据，并且满足第三方系统的格式规范。 灵活配置。数据转换的规则可灵活定义，独立于应用集成和业务逻辑，也就是说根据不同的外部数据结构，直接通过修改交换规则文件的定义，即可达到各种异构数据无缝集成的目的。 自由扩充。对于标准产品不支持的业务单据，如果有集成需求，外部交换平台提供了向导
3、式的二次开发工具，集成了所有与二次开发相关的功能及配置，支持动态部署，可以在用户环境上进行快速有效的开发。,外部交换平台功能介绍,外部交换平台与其他系统交换数据主要有两种方式，异步发送方式和同步发送方式。 同步发送方式是一种自定义的发送方式，通过编写代码向NC Server端发起POST方法的请求，建立连接后直接将业务文档的数据写入连接，NC Server端从连接中读取数据内容后进行后续处理。其他系统编写和调用这种自定义代码，可以实现与NC系统间的实时交互。,外部交换平台功能介绍,异步发送方式又分两种方式：手动加载方式和预警加载方式。手动加载方式是指在Server端启动了NC系统后，由客户端登
4、陆到NC系统，通过外部交换平台的手动加载界面把客户端的业务文档手动传送到Server端的NC系统，或者用电子邮件发送到Server端，然后由有权限的用户通过手动加载界面加载到Server端。 预警加载方式是一种自动加载方式，借助于NC预警平台设定所要发送的业务文档、发送触发的时间等，然后交由预警平台将数据发送到Server端的NC系统。 利用外部数据交换平台还可以通过发送XML格式的查询条件导出NC系统的数据（需业务插件支持），导出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。在某些应用场景下，还可以通过配置NC系统内的单据动作脚本，在某一业务操作被触发时向外系统发送数据。
5、,Servlet的URL地址参数与XML交换文档头属性的关系,在外系统的单据数据的导入过程中需要用到一些初始化信息，如帐套、接收方（包括接收公司和主体账簿）、数据所属外部系统（发送方）、单据类型、业务处理（新增、更新还是查询）等。这部分数据可以在Servlet的URL地址的参数中指定，也可以在XML数据文件的文档头属性中指定，但是在Servlet的URL地址的参数中指定的信息比在XML数据文件的文档头属性中指定的信息有更高的优先级别。比如在Servlet的URL地址参数中指定receiver=yk，而在XML数据文件的文档头属性中指定receiver=yy，则最终还是将数据发送到yk公司。,S
6、ervlet的URL地址参数与XML交换文档头属性的关系,【必须设置的属性】： billtype属性，这个属性值决定了这个XML文件（文档）中所有单据的单据类型，外部交换平台所有的处理都是围绕单据类型的。 sender属性，这个属性值设置的是外系统编码，指定的是数据的来源系统，即习惯上所说的发送方。 proc属性，这个属性值设置对文件中所有单据要做的操作，如新增add、更新update、删除delete、查询query等等。单据具体支持哪些业务操作可以到二次开发工具-交换平台设置-交换单据设置中查询。【根据Servlet的URL参数设置决定是否必设的属性】： 这些属性其实也是必设属性，但如果S
7、ervlet的URL参数里面设置了这几个属性的话，XML文档头里面可以不设置这几个属性值，即使设置了也不会起作用。 account属性,这个属性指定要将数据导入至NC系统的哪个帐套。 receiver属性，这个属性指定数据的接收方。接收方又是有一定格式的，可以将这个格式用一个正则表达式表示为： 接收方=（公司编码|公司主键）(主体帐簿编码),Servlet的URL地址参数与XML交换文档头属性的关系,【根据需要决定是否设置的属性】： filename属性，在数据导入过程中，对于每张单据我们都可以记录其原始数据、翻译后数据，对整个文档我们也可以记录其导入后的回执信息，这个filename属性的值
8、就是用于记录上述数据文件时的文件名。当然，如果您没有设置的话，系统会为每个导入的文档默认生成文件名。isexchange属性，这个属性值决定了在外系统的数据在导入NC系统的过程中，是否使用外部交换平台提供的翻译转换和校验功能。正常情况下应将这个属性设置为“Y”，或者干脆不设。除非从其他NC系统产生的符合NC转换后标准的XML数据直接导入NC系统，并且很多基础档案数据字段直接用的是PK值，此时可以设置属性为“N”和“n”，可避免无谓的翻译转换。replace 属性，这个属性值决定是否允许将相同单据往同一个接收方重复导入。V50版的插件一般允许相同单据重复导入，除了将第一次导入视作新增之外，其余导
9、入视作更新。总的来说，XML文档头的【必须设置的属性】和【根据Servlet的URL参数设置决定是否必设的属性】，均为在外系统交换文档发送过程中必须得到的初始化信息，可以在Servlet的URL地址参数中设置，也可以在XML文档头属性中设置，但必须进行设置。而对于XML文档头的【根据需要决定是否设置的属性】，也可以在Servlet的URL地址的参数中设置，但一般不推荐这么做。,客户化外部交换平台交换平台日志参数设置,外部交换平台参数设置,外部交换平台参数设置,外部交换平台参数设置类似于NC客户化参数设置，用来设置外部交换平台各参数，各参数的意义下面具体介绍。参数可以随时修改，修改后即时生效，不
10、需要重新登陆或重启中间件。外部系统默认账套:将某个外系统数据文档导入到哪个帐套是由Servlet的URL地址的account参数或者文档根属性account决定的，但是如果这两个地方都没有申明这个值，那么系统就将外部数据导入至这个参数设置的帐套中。打开对话框就会显示当前系统所有帐套编码。一般指定为当前登陆账套.,外部交换平台参数设置,单篇最大传输上限：设置要传输的单个数据文件大小的上限。如要导入的数据文件大小比该值大，系统将会提示文件超长，要求整理数据文件。如不需整理文件，可把该值改大。接收公司匹配规则:接收公司匹配规则是指在导入过程中如何对接收方参数中指定的公司值进行翻译,按编码或者按PK，
11、系统默认值是“按编码”。比如用户现在要将外部数据发送到编码为“001”，PK为“1046”的公司，如果用户将其设置成“按编码”，那么在Servlet的URL参数或者待导入文档根属性的地方写上：receiver=001，如果用户将其设置成“按PK”，那么相应写的是receiver=1046。选择的值由用户的数据文件属性头中receiver值或手动加载中URL地址的接收方值是公司的pk还是编码决定。,外部其他系统的的数据要实现和NC数据之间的交换,必须遵守共同约定的数据规范,在该平台中使用的就是.xml文件.以凭证样本数据文件为例介绍文件格式:NC57homepfxxdemodatafipub1、
12、文件的编码头：为XML文件必须的格式定义，包括版本号（在本例中为version=”1.0”）和编码格式（包括gb2312及utf_8两种，本例中为gb2312格式）。 2、文件的属性头：以ufinterface开头，内容为XML文件各属性。下面对文件属性进行逐个说明：roottag:根标签，其内容和单据的根标签值一致。(本例中roottag值为voucher，单据的根标签也为voucher。),XML文件属性介绍,根标签:内容和属性头中roottag值一致，每张单据有且只有一个，所以可以作为单据的开始，后跟单据的流水号（即ID号）。ID号是一张单据的唯一标识，相同的ID号代表同一张单据，如果I
13、D号为空，NC系统会自动为单据生成流水号。 单据头(head)：单据的表头，一般一张单据只有一个单据头。单据体(body)：单据的表体，可有多个体，格式根据外系统文件各异。分录(entry)：单据体中的子层次，内容和格式根据外系统文件各异。（本例中凭证有三条分录，故有三个entry）,XML文件属性介绍,billtype:单据类型，必有，表示要传输的文件类型。（本例中 billtype值为gl，表示传输的文件为财务凭证）。replace:是否覆盖标志，表示文件已经被正确导入后是否允许再次导入，值为Y/N，默认为Y。sender:发送方编码，必有，值任意。发送文件时在外系统信息配置中配置编码和该
14、值一致的外系统。receiver:接收方地址，其值可以为NC系统接收公司、接收主体账簿或为空。当加载界面URL的接收方地址为空或通过http协议发送无接收方时取该值作为接收方。,XML文件属性介绍,isexchange:是否参照NC基本档案进行翻译。值为Y/N，默认为Y。filename:样本名，值任意。proc:动作，必有，表示发送的文件要对NC系统进行的操作，值有add（增加）、update（修改）、delete（删除）、query（查询）、 audit(审批)、unaudit（反审）等。 Operation:表示操作单据响应的方向,外系统传入单据是req表示请求操作,外部交换平台反馈信息
15、是res表示答应操作.,XML文件属性介绍,导入步骤,外系统根据单据类型将相同单据类型的数据组织在一个XML文件中，然后将其发送到NC系统的某个账套下的某个公司或集团中（对于有账簿信息的单据而言，比如会计科目或者凭证，则是某个公司的某个账簿之下）。一般来说，如果需要发送某种单据类型的数据至NC系统中，需要如下几步： 一、注册外部系统。如果不存在可用的外系统的话，请在“外部系统信息注册”界面中注册一个外部系统。二、准备外系统数据。这份数据可能是外系统直接输出的，也可能是二次开发人员通过写程序从第三方系统数据库中抓出来的，或者由Excel格式或其他格式文件转换过来的。写这份数据时，可以参考NC安装
16、盘附带的XML模板，XML文件头或者说文档头的属性项三、配置辅助信息（可选）。如果要导入的单据数据需要辅助信息配置，在“辅助信息配置”界面根据外部系统、单据类型、接收公司及主体帐簿（如果带的话）为此次文件发送配置辅助信息。,导入步骤,四、设置基础数据对照（可选）。如果要导入的单据数据需要作基础数据对照（对于需要参照基本档案的字段，如果其值不能按名称或者编码自动翻译过来的话，在导入过程中系统会自动提示必须为该值做基础数据对照），在“基础数据对照”界面根据需要参照的外部系统、需要参照的基本档案、公司（取当前登陆公司）及主体帐簿（如果带的话）为需要对照的值做基础数据对照。五、配置Servlet的URL地址。将要发送至的帐套编码作为account属性值写入要发送到的Servlet的URL中（或者写入XML文件的头中），将接收公司和主体帐簿（如果带的话）的代码拼成接收方（接收公司编码接收主体账簿编码）作为receiver属性写入要发送到的Servlet的URL中（或者XML文件的头中）。最后，就可以利用客户端触发该单据类型的数据文件的发送了。,
