用友ERP-NC管理软件用户手册（UAP下）NC应用系列丛书目录第16章信息交换平台.116.1信息交换平台介绍..116.1.1功能介绍.116.1.2按发送流程介绍节点：.116.2导入文件介绍..2216.2.1文件格式介绍.2216.2.2基本档案.2516.2.3凭证及凭证期初.2816.3导入步骤详细介绍及常见提示解决方法..2816.3.1非U8系统数据文件导入（手动加载方式）..2816.3.2非U8系统数据文件导入（预警平台发送方式）..2916.3.3U8数据离线导入（包括基本档案、凭证期初、财务凭证）..3316.3.4U8凭证在线导入.3616.3.5常见提示分析及解决方法.4016.3.6凭证导入案例.5816.4导出步骤介绍..6616.4.1配置信息交换平台信息.6616.4.2导出XML文件..6716.5升级介绍..6716.5.1非U8交换规则定义升级..6716.5.2U8交换规则定义升级.6716.5.3外系统为U8EX的用于NC系统科目导出发送到U8系统的交换规则定义升级..67第17章数据传输.6917数据传输.6917.1总体概述..6917.2使用说明..71第18章自定义查询.7618.1查询引擎..7618.1.1查询引擎基本概念及案例.7618.1.2查询引擎管理操作方法.8618.1.3查询引擎权限控制.135II目录第19章Portal.14519.1PORTAL概述.14519.1.1什么是Portal.14519.1.2NCPortal的简介..14519.1.3NC5.5Portal的新特性..14619.1.4NCPortal的界面用语..14619.1.5V5.5版Portal的结构..14719.2PORTAL55的安装配置与登录..14719.2.1Portal55的安装配置..14719.2.2Portal的登录与注销.15819.3如何集成第三方系统..16019.3.1与NC集成配置.16219.3.2与IUFO集成配置.16419.3.3与BO集成配置.16619.3.4利用IFramePortlet集成web系统..16819.3.5与CS架构系统的集成配置..17119.3.6如何集成多套NC系统.17419.4PORTAL的个性化设置.17619.5PORTAL管理.17919.5.1角色管理..17919.5.2用户管理..18219.5.3资源管理..19319.5.4portlet管理..19419.5.5布局管理..19519.6CMS管理..20019.6.1新闻管理..20019.6.2公告栏管理..21119.6.3论坛管理..21319.6.4公司发文管理..21419.6.5链接组管理..22219.6.6重建索引..23019.7企业论坛..23119.8PORTAL内置的PORTLET介绍.23119.8.1外部应用portlets..23219.8.2信息类Portlets..23619.8.3办公类portlets..23819.8.4集成类portlets..24219.8.5动态发布portlets..249目录III19.8.6私有portlets..250附录：一些图片的更换说明..2501关于portal_normal.jsp..2502关于login.jsp..2523关于发文管理中题头/题尾图片和发文字前面的“用友软件”..254第16章信息交换平台本文档适用于5.5信息交换平台所有用户，和以前版本不同地方将重点介绍。本文档分为五个部分，1.信息交换平台自身功能介绍。2.导入文件介绍。3.导入步骤详细介绍及常见提示解决方法。4.导出步骤介绍。5.升级介绍。16.1信息交换平台介绍16.1.1功能介绍信息交换平台是用来在NC和其他外部系统之间交换数据的工具。其他外部系统如U8产品，或者其他公司的产品，只要遵守了共同约定的数据规范（在该平台中使用的是XML文档），就可以实现诸如基本档案、会计凭证和各种业务单据的系统间的交换。信息交换平台与其他系统交换数据主要有两种方式，异步发送方式和同步发送方式。异步发送方式又分两种方式，手动加载方式和预警加载方式。手动加载方式是指在Server端启动了NC系统后，由客户端登陆到NC系统，通过信息交换平台的手动加载界面把客户端的业务文档手动传送到Server端的NC系统，或者用电子邮件发送到Server端，然后由有权限的用户通过手动加载界面加载到Server端。预警加载方式是一种自动加载方式，借助于NC预警平台设定所要发送的业务文档、发送触发的时间等，然后交由预警平台将数据发送到Server端的NC系统。同步发送方式是一种自定义的发送方式，通过编写代码向NCServer端发起POST方法的请求，建立连接后直接将业务文档的数据写入连接，NCServer端从连接中读取数据内容后进行后续处理。其他系统编写和调用这种自定义代码，可以实现与NC系统间的实时交互。利用外部数据交换平台还可以通过发送XML格式的查询条件导出NC系统的数据（需业务插件支持），导出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。在某些应用场景下，还可以通过配置NC系统内的单据动作脚本，在某一业务操作被触发时向外系统发送数据。16.1.2按发送流程介绍节点：交换平台日志（参数设置）（必须）信息交换平台参数设置类似于NC客户化参数设置，用来设置信息交换平台各参数，各参数的意义下面具体介绍。参数可以随时修改，修改后即时生效，不需要重新登陆或重启中间件。2第十六章信息交换平台打开NC[信息交换平台]-[交换平台日志]，点击[参数设置]，在弹出对话框中逐个输入各参数值，确认后即可生效。下面逐个介绍各参数： 外部系统默认账套:一般指定为当前登陆账套，指定默认账套后，如果发送时没有指定账套，则取该默认账套。 单篇最大传输上限：设置要传输的单个数据文件大小的上限。如要导入的数据文件大小比该值大，系统将会提示文件超长，要求整理数据文件。如不需整理文件，可把该值改大。在5.5版本中最大上限为10M。 接收公司匹配规则：为兼容3.0及以前版本按公司的pk值匹配接收公司而设立的参数。选择的值由用户的数据文件属性头中receiver值或手动加载中URL地址的接收方值是公司的pk还是编码决定。 导入过程中是否记录中间文件：为提高信息交换平台的导入效率而设置。因记录中间文件需要一定时间，用户在日常发送时建议不勾选该选项，如发送时出现错误，再勾选，查找错误原因。 回执文件后台备份：从其他系统通过http协议发送文件到NC系统时，回执文件有时会被外系统吃掉，无法查找问题原因，勾选该选项后会在NC服务器端备份一份回执文件，便于查找问题原因，日常发送时建议不勾选该选项。 回执和导出文件编码格式：NC系统支持导出UTF-8和gb2312两种格式的XML文件，由用户根据自身系统编码格式决定需要NC导出的XML文件的编码格式。第十六章信息交换平台3 单据导入规则设置：用户可根据自身需要选择同一文档中的单据一并发送还是逐个发送，如凭证等可选择逐个发送，成功的发送过去，有错的再次发送，提高发送效率并减小并发错误几率。 发送方IP范围设置：为提高信息交换平台的安全性而设立该参数，用户可指定发送方IP地址或IP范围，防止通过信息交换平台向NC系统发送垃圾数据。 记录输入流：为诊断特殊的网络环境，以及验证传入交换平台的数据是否正确，记录的输入流，可以在[交换平台日志]-[输入流监控]中查看。外部系统信息配置（必须）外部系统要和NC系统交换数据，彼此间必须相互可以识别，外部系统信息配置就是用来配置NC系统可识别的外部系统。根据协议，发送的数据文件属性头中必然包括sender字段，配置外系统为sender字段内容后，NC系统便可以识别该外系统文件，并根据随后配置的匹配规则、辅助信息、基础数据对照表及交换规则对文件进行处理，翻译转化为NC系统中数据。打开NC[信息交换平台]-[外部系统信息设置]，增加外系统及匹配规则，增加时注意外系统编码填写数据文件属性头sender中内容。 匹配规则用来配置数据文件中需参照NC基本档案翻译字段的翻译规则，其优先级低于基础数据对照表中配置的对照关系，表体中基础数据类型匹配规则优先级高于表头的默认匹配规则。配置匹配规则是为了免去用户逐条配置基础数据对照表的繁琐，提高易用性，请用户根据自身实际情况灵活使用。4第十六章信息交换平台 配置方法：默认匹配规则一般看数据文件中需参照基本档案的字段多数和NC系统中基本档案的编码或名称哪项一致，即设置成依据哪项默认匹配，其他档案在表体中设成按其他规则匹配，都不一致的就只能增加对照表了。 Eg.发送一张凭证到NC系统，其中科目、凭证类别、币种、辅助核算内容（如客户辅助核算）等字段都需要根据NC基本档案进行翻译，文件中科目为现金、银行存款等，需要对应的NC科目名称也同样为现金、银行存款；凭证类别为记，对应NC凭证类别编码为记，名称为记账凭证；币种为人民币，对应NC名称为人民币；客户辅助核算值和NC对应客户档案编码、名称都不一致。对于这张凭证，较简单的配置方法是默认匹配规则设置为按名称，表体中设置凭证类别按编码，在基础数据对照表中设置客户辅助核算的对照关系，这样就省去为科目、凭证类别、币种等设置对照表的步骤，如下图所示。辅助信息配置（可配）对于存货基本档案、客商基本档案、项目基本档案等在集团增加可分配到下级公司的档案，支持导入到集团的同时分配给公司，只需在辅助信息中配置。对于存货管理档案，可分配到库存组织。对于凭证，配置凭证各字段是否允许修改、删除。对于银行对账单，配置对账单的对账账户和业务类型信息。 打开NC[信息交换平台]-[辅助信息配置]，增加客商档案、存货档案、项目档案的分配关系、凭证的修改和删除权限及银行对账单的业务信息。第十六章信息交换平台5 在配置时客商、项目档案的接收公司为集团，在表体中增加要分配到的公司，在导入档案到集团的同时，系统自动把基本档案分配到辅助信息中配置的公司。客商、项目的接收公司不能为公司，没有意义。下图为配置的客商档案辅助信息。6第十六章信息交换平台 存货档案可以分三种形式导入：存货基本档案(简称基本档案)、存货基本档案+管理档案(简称管理档案)、存货基本档案+管理档案+物料生产档案(简称综合档案)。 存货基本档案有两种发送方式：集团(不分配给公司)、集团(分配给公司)，如果选择导入集团同时分配给公司，则需要在辅助信息设置界面设定待分配的公司，并且单据类型要选择invbas，如下图所示。 管理档案也有三种发送方式：集团(不分配给公司)、公司、集团(分配给公司)，如要分配给公司，同样需要配置辅助信息，只是配置辅助信息时单据类型要选择bsinvbas。如下图。可以看出管理档案发送到集团并分配给公司时和基本档案差不多，只是可以在数据文件中默认带一些管理档案的信息。第十六章信息交换平台7 综合档案有两种发送方式：公司(不分配给多库存组织，此时物料生产档案直接增加到数据文件中定义的库存组织)、公司(分配给多库存组织，可以在辅助信息界面配置待分配的库存组织及相应的主仓库，配置辅助信息时单据类型要选择bsinvbas，如下图所示。)以上各种导入方式用户可根据业务需要，灵活选择。·8第十六章信息交换平台 原U8在线导入凭证时必须配置辅助信息，作为接收主体账簿，U870后不再必须配置，在U8中配置接收公司时填写公司@主体账簿即可。下图为U8配置界面。 辅助信息配置只定义修改删除权限，并且必须保证配置正确，下图为凭证配置界面。 在配置银行对账单时，配置信息需和数据文件中对应信息一致，如下图所示：第十六章信息交换平台9基础数据对照表（可配）对于需要参照NC基础档案进行翻译的字段，配置匹配规则只能翻译外系统值和NC档案名称或编码一致的，对于不一致的，需要在基础数据对照表中作对应。打开NC[信息交换平台]-[基础数据对照表]，配置按匹配规则(编码、名称翻译方式)无法翻译的字段与NC相应值的对照关系。如按匹配规则能翻译过来，不建议逐个档案都增加对照，过于繁琐。10第十六章信息交换平台 比如外系统人员字段值为C001，NC系统中与此对应人员的编码也为C001，那么就不需要建立数据对照，指定人员档案按编码匹配即可；如人员名称为C001，则指定人员档案按名称匹配；但如果外系统编号为C001的人员，对应NC系统中的B002，则需要在基础数据对照中建立C001到B002的对照关系，如下图所示。基础数据对照表增加自动增加和文件导入两种增加方式，方便用户使用。 选择外系统和基础数据分类后，点击[基础数据自动增加]按钮，选择按编码或名称导入，系统会自动增加该基础数据类型表中所有数据，[外部系统值]同基础数据的编码或名称。用户可以在此基础上修改部分[外部系统值]，达到快速增加对照关系的目的。第十六章信息交换平台11 基础数据文件导入支持Excel文件和XML文件导入。Excel文件导入时，系统自动取文件的第一列添入[外部系统值]中，取第二列并校验其是否为NC系统合法值，合法则填充；XML文件导入时，系统根据用户指定按编码或名称导入取编码或名称值添入[外部系统值]中。用户自行选择对应的基础数据，对于没有输入基础数据的[外部系统值]，系统将自动按照外系统的默认数据匹配规则进行翻译转换。12第十六章信息交换平台手动加载界面（可选）信息交换平台的异步发送方式有两种，手动加载方式和预警加载方式，在手动加载界面完成对外系统文件的加载。打开NC[信息交换平台]-[手动加载界面]，发送数据文件到NC系统。在加载数据的同时，NC系统会返回回执文件，如未发送成功，用户可根据提示内容调整配置，再次发送。 加载成功转移目录：输入加载成功转移目录后，如果数据文件中全部单据成功完成，该文件就被转移到该目录下，如有未成功单据，则不被转移，仍在原目录下。 压缩传输：NC支持压缩传输与非压缩传输两种传输模式，如果机器性能较差但网络状况很好(比如局域网内)，可以采用非压缩传输，相反，则采用压缩传输，在远程传输较大的数据文件时，压缩传输能大大提高传输效率。 目标URL地址：由服务器地址、服务、发送账套、接收方地址等组成，登陆时自动生成，可手工修改。如发送主体账簿类型的档案或凭证，需手工在receiver=公司后加@要发送的主体账簿编码，如下图所示。如不加主体账簿，表示发送到公司的主账簿。 手工发送界面会将当前用户信息发送到后台。第十六章信息交换平台135.0增加接收公司和文件中组织字段值一致性判断，如二者不相同，将无法导入。如文件中组织字段内容为空，交换平台会自动将接收公司值写入公司字段。但要注意如交换规则定义中组织字段不允许为空，仍通不过检查，如用户需要此功能，需把交换规则定义中组织字段改为允许为空，如下图所示。14第十六章信息交换平台交换平台日志（可选）在每次发送数据文件返回回执的同时，信息交换平台会生成平台日志，在该节点可进行日志的查询、删除等操作。打开NC[信息交换平台]-[交换平台日志]，查询、删除日志信息。在交换平台日志节点，刷新操作的结果为查询当天的日志，删除操作的结果为删除当前界面显示的所有日志。V55交换平台日志增强（可选）在V55中，信息交换平台加强了前台日志查询功能，通过前台查看后台日志可以准确定位一些常见的错误和问题。详细日志 单据类型发送文档单据类型 发送方外部系统 接收方接收公司 单据编号文档id 是否成功接收红叉表示失败 业务单据返回值业务插件返回值 原始文档原始输入文档 翻译后文档交换平台翻译后文档第十六章信息交换平台15日志统计统计一次发送的文档中的单据总数量、成功数量、失败数量16第十六章信息交换平台输入流监控在往信息交换平台网络传输的过程中，不可避免地会出现网络传输错误、文档格式错误、文档翻译错误，和正常文档。因此准确定位错误类型，有助于快速解决问题。打开输入流监控，将降低系统性能。在参数设置中打开输入流监控，这样所有通过信息交换平台传输的数据将会被记录。查看错误类型及查看出入文档原始文档交换规则定义（可配）（原校验文件管理节点）外部系统数据文件的格式和内容差异性很大，要转化成NC系统可识别的数据才可导入，就需要在交换规则定义节点定义数据的校验规则、转换规则、导出格式等。因本文档的适用读者为实施人员及用户，只介绍导入文件时经常涉及到的内容，二次开发人员请参考《实施和二次开发指南》。打开NC[信息交换平台]-[交换规则定义]，打开要修改的单据类型，对应外系统的交换规则定义文件，修改后保存即可，修改后即时生效，不需要重新登陆或重启中间件。第十六章信息交换平台17常用字段属性说明： 该字段在外系统中的名称：NC字段和外系统中相同意义的字段名称并不一定一致，修改该值为外系统中字段名，导入时将外系统中字段转换为NC中对应字段。 是否允许为空：在插件检查前信息交换平台会先根据交换规则检查必输字段内容是否已输入，一般情况下不需要修改，用户也可根据自身需要修改各字段是否必输。 需要参照的NC基础档案：单据的某些字段值需要参照NC基本档案进行翻译，类似于界面的参照选择，如导入凭证时，会计科目值需要参照科目档案翻译，这里定义字段需要参照的基本档案。 添加默认值：如字段为NC系统必输项，外系统中无此字段或字段值为空，可点右键添加默认值，在文件中字段为空的情况下，交换平台会取默认值写入字段。 规则：一般情况下该字段不需要用户自行修改。Eg.外系统中值为True或False，而NC系统存储值为0或1，可定义规则：True=0;False=1，交换平台将外系统值转换为NC值。 需要与接收方一致：5.0新增内容，在手动加载界面已经介绍过，本版增加了数据文件中组织字段值和接收方公司的一致性校验。这里要注意组织字段的选择，公司类型档案一般选择公司字段作为组织字段，而主体账簿类型档案一般选择主体账簿字段作为组织字段。如下图所示。18第十六章信息交换平台 是否需要导出：该字段用于需从NC系统导出文件时，如用户不需要NC中某些字段信息，可把对应字段设为不需要导出。 单据备用编号字段：选中交换文档从右键菜单中增加，值根据用户需要输入数据文件中某个字段名。该字段用于数据文件的ID号为空时，取定义的字段值作为单据的ID号。 Eg.科目的数据文件根标签为<codeid=-->，流水号为空，如下图所以，定义科目的交换规则文件的备用字段为id，则发送时取该单据的id字段值作为流水号，如单据中有语句<id>1</id>，则交换平台处理时将流水号置为1，相当于数据文件的根标签为<codeid=-1->，仍可通过发送文件对这张单据进行编辑。为了使流水号不重复，选择作为备用流水号的字段应为值满足唯一性字段。如不增加该字段，交换平台处理时将流水号置为永不重复值，只能导入不能通过交换平台对单据进行编辑了。第十六章信息交换平台19以上介绍的是在导入导出过程中常用的属性，其他属性非二次开发人员不建议修改。 5.0增加导出功能：打开某单据类型的交换规则定义文件后，通过导出可得到NC系统标准文件，供外系统和NC系统集成时参考。20第十六章信息交换平台 5.0增加交换规则定义升级：此升级针对3.X版本用户配置的除默认的U860交换规则文件的其他用于导入U8数据的交换规则文件升级。在3.X版本中，用户定义多个外系统用于发送U8数据，在升级过程中，NC统一升级为默认的交换规则文件，升级完成后，用户需登陆5.0系统，选择用于发送U8数据的外系统再次进行升级，升级后用户在3.X版本中配置的信息会全部升级上来。注意 选择的外部系统应为从3.5升级上来的用于导入U8数据的外系统。新增的外系统或非导入U8数据外系统请不要选择升级。 5.5新增加交换规则合并功能从5.5开始，标准交换规则会在NCHOME/pfxx/billdefine/standard目录下完整保存一份，并提供一个合并工具。如下图所示，选择其他外部系统，是否为标准产品，打开新的交换规则，用做合并交换规则的参考。第十六章信息交换平台21如上图所示，对于打开一个交换规则后，可以选择合并一个其他外系统或标准交换规则。标准规则为发版所带规则，不会被修改。确定后出来如下界面。系统会查找新交换规则在当前使用规则中的差异。”当前使用交换规则不在新交换规则中”不在比较范围之列。选中任何一个交换规则，系统会自动查找所对应的交换规则，没有则取其上级节点。对当前使用的交换规则，所有右键菜单操作和交换规则定义相同，确定保存修改操作；新交换规则不会做任何改动。22第十六章信息交换平台当前交换规则：正在使用得交换规则新交换规则：合并对话框选择的其他外系统或标准交换规则上一个下一个：循环查找新交换规则和当前交换规则的差异。：将选中得新交换规则拷贝到当前交换规则中。确定：保存到当前交换规则中。取消：不做任何改动。16.2导入文件介绍16.2.1文件格式介绍以凭证样本数据文件为例介绍导入文件：第十六章信息交换平台23下面逐条介绍文件：1.文件的编码头：为XML文件必须的格式定义，包括版本号（在本例中为version=”1.0”）和编码格式（包括gb2312及utf_8两种，本例中为gb2312格式）。2.文件的属性头：以ufinterface开头，内容为XML文件各属性。下面对文件属性进行逐个说明：roottag:根标签，其内容和单据的根标签值一致。(本例中roottag值为voucher，单据的根标签（3）也为voucher。)billtype:单据类型，必有，表示要传输的文件类型。（本例中billtype值为gl，表示传输的文件为财务凭证）。单据类型值可参考交换规则定义。sender:发送方编码，必有，值任意。发送文件时在外系统信息配置中配置编码和该值一致的外系统。receiver:接收方地址，其值可以为NC系统接收公司、接收主体账簿或为空。当加载界面的接收方地址为空或通过http协议发送无接收方时取该值作为接收方。replace:是否覆盖标志，表示文件已经被正确导入后是否允许再次导入，值为Y/N，默认为Y。isexchange:是否参照NC基本档案进行翻译。值为Y/N，默认为Y。filename:文件名，值任意。proc:动作，必有，表示发送的文件要对NC系统进行的操作，值有add（增加）、update（修改）、delete（删除）、query（查询）、audit(审批)、unaudit（反审）等。3.根标签：内容和属性头中roottag值一致，每张单据有且只有一个，所以可以作为单据的开始，后跟单据的流水号（即ID号）。ID号是一张单据的唯一标识，相同的ID号代表同一张单据，如果ID号为空，NC系统会自动为单据生成流水号。（具体规则请见14.2.1章节交换规则定义中关于单据流水号的说明）4.单据头：单据的表头，一般一张单据只有一个单据头。5.单据体：单据的表体，可有可无，也可有多个体，格式根据外系统文件各异。6.分录：单据体中的子层次，内容和格式根据外系统文件各异。（本例中凭证有三条分录，故有三个entry）下图为单据头voucher_head打开后的内容：24第十六章信息交换平台从上图可见，凭证单据头由若干简单字段组成，各字段含义和注意事项在发版盘附带的样本数据中均有介绍。下两图为单据体一条分录打开后的内容：第十六章信息交换平台25从上图可见，分录中科目、金额等信息由简单字段组成，辅助核算项目和现金流量信息由多层结构组成，这说明外系统文件的层次和格式内容都是可由外系统自行定义的，但各字段的层次结构在交换规则定义中定义。发版盘提供的样本数据文件是NC默认格式，用户可参考。如发送文件和样本数据文件格式相同，则可使用发版盘提供的已定义好的默认交换规则定义，无需自行修改，二次开发人员请参阅《实施和二次开发指南》。16.2.2基本档案5.0版本支持导入的基本档案：公司目录、自定义项档案、部门档案、人员类别、人员档案、地区分类、客商档案、存货分类、仓库档案、计量档案、存货基本档案、存货管理档案、存货综合档案、项目基本档案、结算方式、会计科目。支持导入的U8基本档案：部门档案、人员类别、人员档案、地区分类、客户档案、供应商档案、存货分类、会计科目。支持导出的基本档案：部门档案、人员类别、人员档案、客商管理档案、会计科目。下面逐个说明各基本档案导入时的注意事项：公司目录： 发送方为集团。 导入后公司一律不建账，建账操作要登陆界面进行。 封存标志和封存时间的输入与否保持一致。26第十六章信息交换平台自定义项档案： 不支持通过再次发送update。 所属自定义项（pk_defdoclist）字段需填写自定义项名称。 上级档案（pk_defdoc1）字段需根据导入内容修改交换规则定义的需要参照的NC基本档案，选择档案所属自定义项即可。部门档案： 发送方为公司。 部门封存标志和封存时间的输入与否保持一致。 发送U8部门档案后，在基础数据对照表界面调整导入的部门级次。人员档案： 发送方为公司。 满足集团设置的人员档案约束条件。地区分类： 发送U8地区分类后，如存在上下级关系，请登陆NC界面手工调整级次。客商档案： 可配置辅.
