NCV61-会计平台-技术红皮书(整理后)

1、. NC-V6.1-会计平台-技术红皮书：.；UAP 技术红皮书系列 第PAGE32 / 29页 UAP开发红皮书系列NC-V6.1-会计平台-技术红皮书 UAP中心 编著目录 TOC o 1-4 h z u HYPERLINK l _Toc335049893 HYPERLINK l _Toc335049894 第一章概述 PAGEREF _Toc335049894 h 3 HYPERLINK l _Toc335049895 1.1目的 PAGEREF _Toc335049895 h 3 HYPERLINK l _Toc335049896 1.2读者 PAGEREF _Toc335049896

2、 h 3 HYPERLINK l _Toc335049897 第二章产品/模块设计阐明 PAGEREF _Toc335049897 h 4 HYPERLINK l _Toc335049898 2.1设计原那么与前提 PAGEREF _Toc335049898 h 4 HYPERLINK l _Toc335049899 2.2名词解释 PAGEREF _Toc335049899 h 4 HYPERLINK l _Toc335049900 第三章总体架构设计 PAGEREF _Toc335049900 h 5 HYPERLINK l _Toc335049901 3.1总体架构图 PAGEREF _

3、Toc335049901 h 5 HYPERLINK l _Toc335049902 第四章中心模型设计 PAGEREF _Toc335049902 h 6 HYPERLINK l _Toc335049903 4.1主要业务模型 PAGEREF _Toc335049903 h 6 HYPERLINK l _Toc335049904 4.1.1推式不汇总立刻生成模型系统默许方式财务业务一体化，业务确认财务立刻有反映的场景下建议运用 PAGEREF _Toc335049904 h 6 HYPERLINK l _Toc335049905 4.1.2推式不汇总条件生成方式财务业务关联不严密，不要求业务

4、确认财务立刻有反映的场景建议运用 PAGEREF _Toc335049905 h 8 HYPERLINK l _Toc335049906 4.1.3推式，汇总来源单据方式来源单据数据量大的时候建议运用 PAGEREF _Toc335049906 h 8 HYPERLINK l _Toc335049907 4.2中心效力 PAGEREF _Toc335049907 h 11 HYPERLINK l _Toc335049908 4.2.1音讯发送效力接纳发送到会计平台的音讯 PAGEREF _Toc335049908 h 11 HYPERLINK l _Toc335049909 4.2.2关联关系

5、查询效力根据音讯信息查询关联关系 PAGEREF _Toc335049909 h 13 HYPERLINK l _Toc335049910 4.2.3关联单据查询效力根据信息信息查相关单据 PAGEREF _Toc335049910 h 13 HYPERLINK l _Toc335049911 4.3与来源系统相关的接口需求来源系统实现 PAGEREF _Toc335049911 h 14 HYPERLINK l _Toc335049912 4.3.1单据查询接口根据信息查相关联的单据，主要用于重算、条件生成 PAGEREF _Toc335049912 h 14 HYPERLINK l _To

6、c335049913 4.3.2单据汇总接口主要用于汇总来源单据方式 PAGEREF _Toc335049913 h 15 HYPERLINK l _Toc335049914 4.3.3拉式取数接口主要用于拉式生成，暂时不支持 PAGEREF _Toc335049914 h 16 HYPERLINK l _Toc335049915 4.4与目的系统相关的接口需求目的系统实现 PAGEREF _Toc335049915 h 17 HYPERLINK l _Toc335049916 4.4.1单据处置接口保管、删除、查询等 PAGEREF _Toc335049916 h 17 HYPERLINK

7、l _Toc335049917 4.5第三方运用的接口 PAGEREF _Toc335049917 h 18 HYPERLINK l _Toc335049918 4.5.1音讯监听接口可以在音讯处置中注入本人的处置 PAGEREF _Toc335049918 h 18 HYPERLINK l _Toc335049919 4.5.2目的单据处置监听接口可以在会计平台保管/删除目的单据的时候注入本人的处置 PAGEREF _Toc335049919 h 20 HYPERLINK l _Toc335049920 4.6来源单据UI PAGEREF _Toc335049920 h 22 HYPERLI

8、NK l _Toc335049921 4.6.1单据展现 PAGEREF _Toc335049921 h 22 HYPERLINK l _Toc335049922 4.6.2自定义查询条件 PAGEREF _Toc335049922 h 23 HYPERLINK l _Toc335049923 4.7目的单据UI PAGEREF _Toc335049923 h 23 HYPERLINK l _Toc335049924 4.7.1单据展现 PAGEREF _Toc335049924 h 23 HYPERLINK l _Toc335049925 4.7.2合并条件展现 PAGEREF _Toc33

9、5049925 h 23 HYPERLINK l _Toc335049926 第五章来源系统的快速实现 PAGEREF _Toc335049926 h 24 HYPERLINK l _Toc335049927 5.1实现联查与重算的接口nc.pubitf.fip.external.IbillReflectorService PAGEREF _Toc335049927 h 24 HYPERLINK l _Toc335049928 5.2在fip_billregister表中对需求发送会计平台的单据类型或买卖类型进展注册 PAGEREF _Toc335049928 h 24 HYPERLINK l

10、 _Toc335049929 5.3组装音讯FipRelationInfoVO，该VO包含业务虚体的概要信息，可以协助 用户快速定位单据而不需求联查 PAGEREF _Toc335049929 h 25 HYPERLINK l _Toc335049930 5.4调用FipMsgResultVO nc.pubitf.fip.service.IFipMessageService.sendMessages(FipMessageVO fipmessagevo) throws BusinessException发送音讯到会计平台 PAGEREF _Toc335049930 h 26 HYPERLINK

11、l _Toc335049931 第六章目的系统的快速实现 PAGEREF _Toc335049931 h 27 HYPERLINK l _Toc335049932 6. 1实现联查与重算的接口nc.pubitf.fip.external.IbillReflectorService PAGEREF _Toc335049932 h 27 HYPERLINK l _Toc335049933 6. 2实现目的单据的效力nc.pubitf.fip.external.IDesBillService PAGEREF _Toc335049933 h 27 HYPERLINK l _Toc335049934 6

12、. 3在fip_billregister表中进展注册 PAGEREF _Toc335049934 h 27 HYPERLINK l _Toc335049935 6. 4在fip_entityattcfg中注册需求在模板上展现的字段 PAGEREF _Toc335049935 h 28 HYPERLINK l _Toc335049936 第七章附录 PAGEREF _Toc335049936 h 29概述本章内容概要：目的读者 目的本文档基于NC6.0，主要描画会计平台对外提供的效力、会计平台与其他相关系统之间的交互。以指点相关业务系统经过会计平台和其他业务系统进展业务虚体转换。读者相关系统分析

13、、设计、开发。产品/模块设计阐明本章内容概要：产品设计与前提名词解释设计原那么与前提对原会计平台进展笼统，提炼成一致的业务对象转换平台框架，支持业务单据与财务凭证的转换，业务单据与责听凭证的转换。会计平台设计前提：顺应6.0多组织变化、支持集团运用支持业务单据与多目的对象的转换，且可配置。即根据需求可配置业务单据生成总账凭证、责任会计凭证或行业的本钱单据等制造本钱单据，金融行业本钱单据等支持推式和拉式对象转换支持来源对象汇总和目的对象汇总支持转换规那么、汇总规那么、取数规那么、关联关系的扩展，支持行业插件名词解释总体架构设计本章内容概要：总体架构图总体架构图会计平台整体框架：图 3-1中心模型

14、设计本章内容概要：主要业务模型中心效力与源系统相关的接口需求源系统实现与目的系统相关的接口需求目的系统实现第三方运用的接口来源单据UI目的单据UI主要业务模型推式不汇总立刻生成模型系统默许方式财务业务一体化，业务确认财务立刻有反映的场景下建议运用注：蓝色为主流程，紫色为有接口或效力注入的地方图 4-1该流程涉及会计平台1个效力，3个接口注入，详细是阐明见推式不汇总条件生成方式财务业务关联不严密，不要求业务确认财务立刻有反映的场景建议运用图 4-2该流程涉及0个效力，3个接口推式，汇总来源单据方式来源单据数据量大的时候建议运用图 4-3图 4-4该流程涉及1个效力，4个接口。 中心效力音讯发送效

15、力接纳发送到会计平台的音讯package nc.pubitf.fip.service;public interface IFipMessageService public FipMsgResultVO sendMessage(FipMessageVO fipmessagevo) throws BusinessException;public FipMsgResultVO sendMessages(FipMessageVO fipmessagevo) throws BusinessException;package nc.vo.fip.service;public class FipMessag

16、eVO extends ValueObject public final static int MESSAGETYPE_ADD = 0;/ 添加public final static int MESSAGETYPE_DEL = 1;/ 删除public final static int MESSAGETYPE_OFFSET = 3;/ 红冲60不建议运用private int messagetype = 0;/ 音讯类型 包括 添加 删除private static final long serialVersionUID = 9120956917092845821L;private Aggre

17、gatedValueObject billVO = null;private FipRelationInfoVO messageinfo = null;package nc.vo.fip.service;public class FipRelationInfoVO extends ValueObject private static final long serialVersionUID = -5357529614277574254L;private String pk_group = null;/ 集团private String pk_org = null;/ 组织private Stri

18、ng pk_system = null;/ 系统类型private String pk_billtype = null; / 单据类型或买卖类型PKprivate String relationID = null; / 关联号，和单据之间的独一关联，经过该字段独一对应一个传入的聚合VO/ 留意：一个聚合VO不一定只对应一个单据VO，这个是业务系统控制的，所以这里不是单据主键，而是一个分组号，当关联号和单据一一对应的时候，可以运用PKprivate String pk_operator = null; / 操作员PK，指的是发送会计平台的那个人，不是单据的制单人private UFDate bu

19、sidate = null; / 业务日期，业务生效的日期，不一定是单据日期private String defdoc1 = null; / 自定义关联档案1 关联档案型的数据，比如买卖类型，业务类别，收发类别等。留意：档案型的自定义项必需为全局或集团级的档案类型，不支持组织级的档案类型private String defdoc2 = null; / 自定义关联档案2private String defdoc3 = null; / 自定义关联档案3private String freedef1 = null; / 自定义项1 阐明性的文字，包括金额，摘要，单据编码等private String

20、 freedef2 = null; / 自定义项2private String freedef3 = null; / 自定义项3private String freedef4 = null; / 自定义项4private String freedef5 = null; / 自定义项5关联关系查询效力根据音讯信息查询关联关系/* * */package nc.pubitf.fip.service;public interface IFipRelationQueryService /* * 根据来源单据信息查目的单据。 */public FipRelationInfoVO queryDesBill

21、(FipRelationInfoVO vo) throws BusinessException;/* * 根据目的单据信息查来源单据。*/public FipRelationInfoVO querySrcBill(FipRelationInfoVO vo) throws BusinessException;/* * 根据来源单据信息查关联关系 */public FipRelationVO queryRelationsBySrc(FipRelationInfoVO vo) throws BusinessException;/* * 根据目的单据信息查关联关系 */public FipRelati

22、onVO queryRelationsByDes(FipRelationInfoVO vo) throws BusinessException;关联单据查询效力根据信息信息查相关单据/* * */package nc.pubitf.fip.service;public interface IFipBillQueryService /* * 根据关联号等音讯查单据根据系统自动匹配来源或目的 */public FipExtendAggVO queryBill(FipRelationInfoVO vo) throws BusinessException;/* * 根据来源关联信息查来源单据 */pu

23、blic FipExtendAggVO querySrcBill(FipRelationInfoVO vo) throws BusinessException;/* * 根据目的关联信息查目的单据 */public FipExtendAggVO queryDesBill(FipRelationInfoVO vo) throws BusinessException; 与来源系统相关的接口需求来源系统实现单据查询接口根据信息查相关联的单据，主要用于重算、条件生成/* * */package nc.pubitf.fip.external;/* * 实现重算功能的来源系统提供的单据查询效力，经过业务关

24、联号取业务单据。 * * 该接口为会计平台提出，其他系统实现的一个取数效力，运用者为会计平台或其他经过会计平台取相关联的单据的目的系统 */public interface IBillReflectorService /* * 经过业务关联号获得单据实体，为重算和拉式生成提供单据查询效力 * * 普通情况下，只运用FipMsgInfoVO里的pk_billtype和relationID字段即可以找到对应数据，特殊情况下，允许来源系统在音讯里放置自定义项，这些自定义项会计平台只传送和显示，不运用。 * * 例如，按期间分表存储数据的时候，可以把freedef1作为期间发送会计平台，会计平台只担任

25、传送和显示，不做修正和业务上运用。 */FipExtendAggVO queryBillByRelations(FipRelationInfoVO relationvos) throws BusinessException;单据汇总接口主要用于汇总来源单据方式/* * */package nc.pubitf.fip.external;/* * 汇总来源单据效力，该效力由会计平台定义，相关系统实现，主要目的是为了减少会计平台上单据的数量 */public interface IBillSumService /* * 汇总来源单据方法，该方法由会计平台定义，其他相关系统实现 * * 主要功能：对于

26、一样单据类型的一组单据，经过单据关联号根据分组字段在来源方进展汇总，生成一个或多个汇总后的单据 * * 分组字段包括：入账设置中运用的影响要素，转换模板中运用的单据字段，单据模板中援用对照表的部分公式里运用的影响要素 * */public FipMessageVO querySumBill(FipRelationInfoVO relationvos, String groupfields) throws BusinessException;/* * 汇总来源单据方法，该方法由会计平台定义，其他相关系统实现 * * 主要功能：对于一样单据类型的一组单据，经过单据关联号根据分组字段在来源方进展汇总

27、，生成一个或多个汇总后的单据 * * 关联号将运用 relationid in(子查询)的方式传送，relationIDinSQL传送的就是子查询的SQL * * 分组字段包括：入账设置中运用的影响要素，转换模板中运用的单据字段，单据模板中援用对照表的部分公式里运用的影响要素 */public FipMessageVO querySumBillBySQL(FipRelationInfoVO relationvos, String groupfields, String relationIDinSQL) throws BusinessException;拉式取数接口主要用于拉式生成，暂时不支持/

28、* * */package nc.pubitf.fip.external;import nc.vo.fip.external.FipBillDrawRSVO;import nc.vo.pub.BusinessException;/* * 拉式生成的接口效力，该效力由会计平台定义，其他实现拉式生成方式的系统来实现 */public interface IBillDrawService /* * 拉式取数接口，传入的是单据查询条件，该条件是由单据系统提供的自定义查询生成的，平台只做传送，不做修正 */public FipBillDrawRSVO drawBill(Object con) throw

29、s BusinessException;与目的系统相关的接口需求目的系统实现单据处置接口保管、删除、查询等/* * */package nc.pubitf.fip.external;/* * 目的单据效力，该效力由会计平台定义，目的系统实现，主要目的是为了一致会计平台对不同目的系统的调用 */public interface IDesBillService /* * 目的系统保管单据方法 */public FipSaveResultVO saveBill(Object vo) throws BusinessException;/* * 删除目的系统单据的方法 */public void del

30、eteBill(FipRelationInfoVO vo) throws BusinessException;/* * 能否可以反向处置单据，比如曾经保管的能否可以删除，曾经审核的能否可以反审核并删除 * * 当该方法前往为true的时候，会计平台直接调用deleteBill应该可以删除目的系统的相应单据 */public boolean isRollbackable(FipRelationInfoVO vo) throws BusinessException;/* * 目的单据查询方法 * */public FipExtendAggVO queryBillByRelations(FipRel

31、ationInfoVO vos) throws BusinessException; 第三方运用的接口音讯监听接口可以在音讯处置中注入本人的处置/* * */package nc.pubitf.fip.external;import nc.vo.fip.service.FipMessageVO;import nc.vo.pub.BusinessException;/* * 外部系统对会计平台音讯的监听。 * * 假设某些系统对其他业务系统发送会计平台的音讯感兴趣，那么可以注册该监听器到会计平台 * * * TODO 接口/类功能阐明，运用阐明接口能否为效力组件，效力运用者，类能否线程平安等。

32、* * * 修正记录： * 修正人：修正日期：修正内容： * * * see * author gbh * version V6.0 * since V6.0 创建时间：2021-3-17 下午03:08:09 */public interface IFipMessageHook /* * 该方法在音讯发送到会计平台并且会计平台未做后继处置时被调用，该方法和业务系统发送音讯处与同一事物 * * 假设只是运用音讯里的信息，不对音讯进展修正，那么前往值请置为null，假设想对音讯中的信息进展改写，那么把修正后的结果前往 * * 修正记录： * * * param vo * return * thr

33、ows BusinessException * see * since V6.0 */public FipMessageVO beforeDispose(FipMessageVO vo) throws BusinessException;/* * 该方法在会计平台处置完相关信息，并预备前往业务系统之前被调用 * * 注：音讯处置完成指可以前往业务系统的形状，而不是音讯处置终了的形状，所以在这里监听能够无法获得下面这些数据： * * 汇总生成的结果，定时处置的结果，异步不影响业务流程处置的结果 * * 由于会计平台的相关处置曾经完成，所以监听系统只能运用音讯的信息，而不能进展改写，故不设置前往值

34、 * * * 修正记录： * * * param vo * return * throws BusinessException * see * since V6.0 */public void afterDisPose(FipMessageVO vo) throws BusinessException; 目的单据处置监听接口可以在会计平台保管/删除目的单据的时候注入本人的处置/* * */package nc.pubitf.fip.external;import nc.vo.fip.external.FipSaveResultVO;import nc.vo.fip.service.FipRel

35、ationInfoVO;import nc.vo.pub.BusinessException;/* * * TODO 接口/类功能阐明，运用阐明接口能否为效力组件，效力运用者，类能否线程平安等。 * * * 修正记录： * 修正人：修正日期：修正内容： * * * see * author gbh * version V6.0 * since V6.0 创建时间：2021-3-17 下午03:45:00 */public interface IFipOperateBillHook /* * 在nc.pubitf.fip.external.IDesBillService的saveBill方法前被

36、调用 方法阐明： * * 修正记录： * * * throws BusinessException * see * since V6.0 */public void beforeSave(Object vo) throws BusinessException;/* * 在nc.pubitf.fip.external.IDesBillService的saveBill方法后并且保管关联关系后被调用 * * 为了在该方法里可以访问来源单据和目的单据之间的关联关系，所以该方法应该在保管关联关系后被调用 * * 方法阐明： * * 修正记录： * * * throws BusinessException

37、 * see * since V6.0 */public void afterSave(FipSaveResultVO vo) throws BusinessException;/* * 在nc.pubitf.fip.external.IDesBillService的deleteBill前被调用 * * 方法阐明： * * 修正记录： * * * throws BusinessException * see * since V6.0 */public void beforeDelete(FipRelationInfoVO infovo) throws BusinessException;/*

38、* 在nc.pubitf.fip.external.IDesBillService的deleteBill后被调用 * * 方法阐明： * * 修正记录： * * * throws BusinessException * see * since V6.0 */public void afterDelete(FipRelationInfoVO infovo) throws BusinessException; 来源单据UI单据展现自定义查询条件 目的单据UI单据展现合并条件展现来源系统的快速实现本章内容概要：实现联查与重算的接口nc.pubitf.fip.external.IbillReflect

39、orService在fip_billregister表中对需求发送会计平台的单据类型或买卖类型进展注册组装音讯FipRelationInfoVO，该VO包含业务虚体的概要信息，可以协助 用户快速定位单据而不需求联查 调用 HYPERLINK eclipse-javadoc:%E2%98%82=FIP_6.0/fip%5C/src%5C/public%5C/fip%3Cnc.pubitf.fip.service%7BIFipMessageService.java%E2%98%83IFipMessageServicesendMessages%5C%E2%98%83QFipMessageVO;%E2

40、%98%82FipMsgResultVO FipMsgResultVO nc.pubitf.fip.service. HYPERLINK eclipse-javadoc:%E2%98%82=FIP_6.0/fip%5C/src%5C/public%5C/fip%3Cnc.pubitf.fip.service%7BIFipMessageService.java%E2%98%83IFipMessageService IFipMessageService.sendMessages( HYPERLINK eclipse-javadoc:%E2%98%82=FIP_6.0/fip%5C/src%5C/p

41、ublic%5C/fip%3Cnc.pubitf.fip.service%7BIFipMessageService.java%E2%98%83IFipMessageServicesendMessages%5C%E2%98%83QFipMessageVO;%E2%98%82FipMessageVO FipMessageVO fipmessagevo) throws HYPERLINK eclipse-javadoc:%E2%98%82=FIP_6.0/fip%5C/src%5C/public%5C/fip%3Cnc.pubitf.fip.service%7BIFipMessageService.

42、java%E2%98%83IFipMessageServicesendMessages%5C%E2%98%83QFipMessageVO;%E2%98%82BusinessException BusinessException发送音讯到会计平台实现联查与重算的接口nc.pubitf.fip.external.IbillReflectorService参考nc.bs.arap.global.ArapBillReflectorServiceImpl在fip_billregister表中对需求发送会计平台的单据类型或买卖类型进展注册需求注册的字段包括：Billreflectclass IbillRe

43、flectorService接口的实现类pk_billtype 需求发送会计平台的单据类型或买卖类型的编码modulecode 模块号，例如 gl,ar可以参考pk_billtype=D0的记录留意：假设FipRelationInfoVO的defdoc1有值，那么fip_billregister的defdoc1应该是该值对应的档案实体的ID组装音讯FipRelationInfoVO，该VO包含业务虚体的概要信息，可以协助 用户快速定位单据而不需求联查内容如下：public class FipRelationInfoVO extends SuperVO private static final

44、long serialVersionUID = -5357529614277574254L;private String pk_group = null;/ 集团必输项private String pk_org = null;/ 组织必输项private String pk_system = null;/ 系统类型必输项private String pk_billtype = null; / 单据类型或买卖类型必输项private String relationID = null; / 关联号必输项，和单据之间的独一关联，经过该字段独一对应一个传入的聚合VO/ 留意：一个聚合VO不一定只对应一

45、个单据VO，这个是业务系统控制的，所以这里不是单据主键，而是一个分组号，当关联号和单据一一对应的时候，可以运用PKprivate String pk_operator = null; / 生效人必输项，指的是发送会计平台使单据生效的那个人，不是单据的制单人private UFDate busidate = null; / 业务日期必输项，业务生效的日期，不一定是单据日期private String defdoc1 = null; / 业务分类 关联档案型的数据，比如买卖类型，业务类别，收发类别等。留意：必需为全局或集团级的档案类型，不支持组织级的档案类型private String defdoc2 = null; / 自定义关联档案2private String defdoc3 = null; / 自定义关联档案3private String freedef1 = null; / 单据号private String freedef2 = null; / 备注/阐明private String freedef3 = null; / 金额需格式化private St