（财务会计）NCV会计平台技术红皮书（整理后）.docx

《（财务会计）NCV会计平台技术红皮书（整理后）.docx》由会员分享，可在线阅读，更多相关《（财务会计）NCV会计平台技术红皮书（整理后）.docx（26页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、（财务会计）NCV会计平台技术红皮书（整理后） 第一章 概述 最好的沉淀本章内容概要： 目的 读者 1.1 目的本文档基于 NC6.0 ，主要描述会计平台对外提供的服务、会计平台与其他相关系统之间的交互。以指导相关业务系统通过会计平台和其他业务系统进行业务实体转换。1.2 读者相关系统分析、设计、开发 。第二章 产品 / 模块设计说明本章内容概要： 产品设计与前提 名词解释2.1 设计原则与前提对原会计平台进行抽象，提炼成统一的业务对象转换平台框架，支持业务单据与财务凭证的转换，业务单据与责任凭证的转换。会计平台设计前提： 适应 6.0 多组织变化、支持集团应用 支持业务单据与多目标对象的转换

2、，且可配置。即根据需要可配置业务单据生成总账凭证、责任会计凭证或行业的成本单据等（制造成本单据，金融行业成本单据等） 支持推式和拉式对象转换 支持来源对象汇总和目标对象汇总 支持转换规则、汇总规则、取数规则、关联关系的扩展，支持行业插件2.2 名词解释第三章 总体架构设计本章内容概要： 总体架构图3.1 总体架构图会计平台整体框架 ：图 3-1第四章 核心模型设计本章内容概要： 主要业务模型 核心服务 与源系统相关的接口（需要源系统实现） 与目标系统相关的接口（需要目标系统实现） 第三方使用的接口 来源单据 UI 目标单据 UI4.1 主要业务模型4.1.1 推式不汇总立即生成模型（系统默认模

3、式）（财务业务一体化，业务确认财务立即有反映的场景下建议使用）注：蓝色为主流程，紫色为有接口或服务注入的地方图 4-1该流程涉及会计平台 1 个服务， 3 个接口注入，详细是说明见4.1.2 推式不汇总条件生成模式（财务业务关联不紧密，不要求业务确认财务立即有反映的场景建议使用）图 4- 2该流程涉及 0 个服务， 3 个接口4.1.3 推式，汇总来源单据模式（来源单据数据量大的时候建议使用）图 4-3图 4-4该流程涉及 1 个服务， 4 个接口。4.2 核心服务4.2.1 消息发送服务（接收发送到会计平台的消息）package nc.pubitf.fip.service;public in

4、terface IFipMessageService public FipMsgResultVO sendMessage(FipMessageVO fipmessagevo) throws BusinessException; public FipMsgResultVO sendMessages(FipMessageVO fipmessagevo) throws BusinessException;package nc.vo.fip.service;public class FipMessageVO extends ValueObject public final static int MES

5、SAGETYPE_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 AggregatedValueObject billVO = null; private Fi

6、pRelationInfoVO 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 String pk_system = null;/ 系统类型 private Str

7、ing pk_billtype = null; / 单据类型或交易类型 PK private String relationID = null; / 关联号，和单据之间的唯一关联，通过该字段唯一对应一个传入的聚合 VO / 注意：一个聚合 VO 不一定只对应一个单据 VO ，这个是业务系统控制的，所以这里不是单据主键，而是一个分组号，当关联号和单据一一对应的时候，可以使用 PK private String pk_operator = null; / 操作员 PK ，指的是发送会计平台的那个人，不是单据的制单人 private UFDate busidate = null; / 业务日期，业务

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

9、l; / 自定义项 2 private String freedef3 = null; / 自定义项 3 private String freedef4 = null; / 自定义项 4 private String freedef5 = null; / 自定义项 54.2.2 关联关系查询服务（根据消息信息查询关联关系）/* * */package nc.pubitf.fip.service;public interface IFipRelationQueryService /* * 根据来源单据信息查目标单据。 */ public FipRelationInfoVO queryDesBil

10、l(FipRelationInfoVO vo) throws BusinessException; /* * 根据目标单据信息查来源单据。*/ public FipRelationInfoVO querySrcBill(FipRelationInfoVO vo) throws BusinessException; /* * 根据来源单据信息查关联关系 */ public FipRelationVO queryRelationsBySrc(FipRelationInfoVO vo) throws BusinessException; /* * 根据目标单据信息查关联关系 */ public Fi

11、pRelationVO queryRelationsByDes(FipRelationInfoVO vo) throws BusinessException;4.2.3 关联单据查询服务（根据信息信息查相关单据）/* * */package nc.pubitf.fip.service;public interface IFipBillQueryService /* * 根据关联号等消息查单据（根据系统自动匹配来源或目的） */ public FipExtendAggVO queryBill(FipRelationInfoVO vo) throws BusinessException; /* *

12、 根据来源关联信息查来源单据 */ public FipExtendAggVO querySrcBill(FipRelationInfoVO vo) throws BusinessException; /* * 根据目标关联信息查目标单据 */ public FipExtendAggVO queryDesBill(FipRelationInfoVO vo) throws BusinessException;4.3 与来源系统相关的接口（需要来源系统实现）4.3.1 单据查询接口（根据信息查相关联的单据，主要用于重算、条件生成）/* * */package nc.pubitf.fip.exter

13、nal;/* * 实现重算功能的来源系统提供的单据查询服务，通过业务关联号取业务单据。 * * 该接口为会计平台提出，其他系统实现的一个取数服务，使用者为会计平台或其他通过会计平台取相关联的单据的目标系统 */public interface IBillReflectorService /* * 通过业务关联号获得单据实体，为重算和拉式生成提供单据查询服务 * * 一般情况下，只使用 FipMsgInfoVO 里的 pk_billtype 和 relationID 字段即可以找到对应数据，特殊情况下，允许来源系统在消息里放置自定义项，这些自定义项会计平台只传递和显示，不使用。 * * 例如，按

14、期间分表存储数据的时候，可以把 freedef1 作为期间发送会计平台，会计平台只负责传递和显示，不做修改和业务上使用。 */ FipExtendAggVO queryBillByRelations(FipRelationInfoVO relationvos) throws BusinessException;4.3.2 单据汇总接口（主要用于汇总来源单据模式）/* * */package nc.pubitf.fip.external;/* * 汇总来源单据服务，该服务由会计平台定义，相关系统实现，主要目的是为了减少会计平台上单据的数量 */public interface IBillSumS

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

16、，其他相关系统实现 * * 主要功能：对于相同单据类型的一组单据，通过单据关联号根据分组字段在来源方进行汇总，生成一个或多个汇总后的单据 * * 关联号将使用 relationid in( 子查询 ) 的方式传递， relationIDinSQL 传递的就是子查询的 SQL * * 分组字段包括：入账设置中使用的影响因素，转换模板中使用的单据字段，单据模板中引用对照表的部分公式里使用的影响因素 */ public FipMessageVO querySumBillBySQL(FipRelationInfoVO relationvos, String groupfields, String re

17、lationIDinSQL) throws BusinessException;4.3.3 拉式取数接口（主要用于拉式生成，暂时不支持）/* * */package nc.pubitf.fip.external;import nc.vo.fip.external.FipBillDrawRSVO;import nc.vo.pub.BusinessException;/* * 拉式生成的接口服务，该服务由会计平台定义，其他实现拉式生成方式的系统来实现 */public interface IBillDrawService /* * 拉式取数接口，传入的是单据查询条件，该条件是由单据系统提供的自定义

18、查询生成的，平台只做传递，不做修改 */ public FipBillDrawRSVO drawBill(Object con) throws BusinessException;4.4 与目标系统相关的接口（需要目标系统实现）4.4.1 单据处理接口（保存、删除、查询等）/* * */package nc.pubitf.fip.external;/* * 目标单据服务，该服务由会计平台定义，目标系统实现，主要目的是为了统一会计平台对不同目的系统的调用 */public interface IDesBillService /* * 目标系统保存单据方法 */ public FipSaveRes

19、ultVO saveBill(Object vo) throws BusinessException; /* * 删除目标系统单据的方法 */ public void deleteBill(FipRelationInfoVO vo) throws BusinessException; /* * 是否可以反向处理单据，比如已经保存的是否可以删除，已经审核的是否可以反审核并删除 * * 当该方法返回为 true 的时候，会计平台直接调用 deleteBill 应该可以删除目标系统的相应单据 */ public boolean isRollbackable(FipRelationInfoVO vo)

20、 throws BusinessException; /* * 目标单据查询方法 * */ public FipExtendAggVO queryBillByRelations(FipRelationInfoVO vos) throws BusinessException;4.5 第三方使用的接口4.5.1 消息监听接口（可以在消息处理中注入自己的处理）/* * */package nc.pubitf.fip.external;import nc.vo.fip.service.FipMessageVO;import nc.vo.pub.BusinessException;/* * 外部系统对会

21、计平台消息的监听。 * * 如果某些系统对其他业务系统发送会计平台的消息感兴趣，则可以注册该监听器到会计平台 * * * TODO 接口 / 类功能说明，使用说明（接口是否为服务组件，服务使用者，类是否线程安全等）。 * * * 修改记录： * 修改人：修改日期：修改内容： * * * see * author gbh * version V6.0 * since V6.0 创建时间： 2010-3-17 下午 03:08:09 */public interface IFipMessageHook /* * 该方法在消息发送到会计平台并且会计平台未做后继处理时被调用，该方法和业务系统发送消息处

22、与同一事物 * * 如果只是使用消息里的信息，不对消息进行修改，则返回值请置为 null ，如果想对消息中的信息进行改写，则把修改后的结果返回 * * 修改记录： * * * param vo * return * throws BusinessException * see * since V6.0 */ public FipMessageVO beforeDispose(FipMessageVO vo) throws BusinessException; /* * 该方法在会计平台处理完相关信息，并准备返回业务系统之前被调用 * * 注：消息处理完成指可以返回业务系统的状态，而不是消息处理

23、完毕的状态，所以在这里监听可能无法获得下面这些数据： * * 汇总生成的结果，定时处理的结果，异步（不影响业务流程）处理的结果 * * 因为会计平台的相关处理已经完成，所以监听系统只能使用消息的信息，而不能进行改写，故不设置返回值 * * * 修改记录： * * * param vo * return * throws BusinessException * see * since V6.0 */ public void afterDisPose(FipMessageVO vo) throws BusinessException;4.5.2 目标单据处理监听接口（可以在会计平台保存 / 删除目

24、标单据的时候注入自己的处理）/* * */package nc.pubitf.fip.external;import nc.vo.fip.external.FipSaveResultVO;import nc.vo.fip.service.FipRelationInfoVO;import nc.vo.pub.BusinessException;/* * * TODO 接口 / 类功能说明，使用说明（接口是否为服务组件，服务使用者，类是否线程安全等）。 * * * 修改记录： * 修改人：修改日期：修改内容： * * * see * author gbh * version V6.0 * sinc

25、e V6.0 创建时间： 2010-3-17 下午 03:45:00 */public interface IFipOperateBillHook /* * 在 nc.pubitf.fip.external.IDesBillService 的 saveBill 方法前被调用 方法说明： * * 修改记录： * * * throws BusinessException * see * since V6.0 */ public void beforeSave(Object vo) throws BusinessException; /* * 在 nc.pubitf.fip.external.IDe

26、sBillService 的 saveBill 方法后并且保存关联关系后被调用 * * 为了在该方法里可以访问来源单据和目标单据之间的关联关系，所以该方法应该在保存关联关系后被调用 * * 方法说明： * * 修改记录： * * * throws BusinessException * see * since V6.0 */ public void afterSave(FipSaveResultVO vo) throws BusinessException; /* * 在 nc.pubitf.fip.external.IDesBillService 的 deleteBill 前被调用 * *

27、方法说明： * * 修改记录： * * * throws BusinessException * see * since V6.0 */ public void beforeDelete(FipRelationInfoVO infovo) throws BusinessException; /* * 在 nc.pubitf.fip.external.IDesBillService 的 deleteBill 后被调用 * * 方法说明： * * 修改记录： * * * throws BusinessException * see * since V6.0 */ public void after

28、Delete(FipRelationInfoVO infovo) throws BusinessException;4.6 来源单据 UI4.6.1 单据展示4.6.2 自定义查询条件4.7 目标单据 UI4.7.1 单据展示4.7.2 合并条件展示第五章 来源系统的快速实现本章内容概要： 实现联查与重算的接口 nc.pubitf.fip.external.IbillReflectorService 在 fip_billregister 表中对需要发送会计平台的单据类型或交易类型进行注册 组装消息 FipRelationInfoVO ，该 VO 包含业务实体的概要信息，可以帮助用户快速定位单据

29、而不需要联查 调用 FipMsgResultVO nc.pubitf.fip.service. IFipMessageService .sendMessages( FipMessageVO fipmessagevo) throws BusinessException 发送消息到会计平台5.1 实现联查与重算的接口 nc.pubitf.fip.external.IbillReflectorService参考 nc.bs.arap.global.ArapBillReflectorServiceImpl5.2 在 fip_billregister 表中对需要发送会计平台的单据类型或交易类型进行注册需

30、要注册的字段包括：Billreflectclass IbillReflectorService 接口的实现类pk_billtype 需要发送会计平台的单据类型或交易类型的编码modulecode 模块号，例如 gl,ar可以参考 pk_billtype= D0 的记录注意：如果 FipRelationInfoVO 的 defdoc1 有值，则 fip_billregister 的 defdoc1 应该是该值对应的档案实体的 ID5.3 组装消息 FipRelationInfoVO ，该 VO 包含业务实体的概要信息，可以帮助用户快速定位单据而不需要联查内容如下：public class Fip

31、RelationInfoVO extends SuperVO private static final 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

32、 = null; / 关联号（必输项），和单据之间的唯一关联，通过该字段唯一对应一个传入的聚合 VO / 注意：一个聚合 VO 不一定只对应一个单据 VO ，这个是业务系统控制的，所以这里不是单据主键，而是一个分组号，当关联号和单据一一对应的时候，可以使用 PK private String pk_operator = null; / 生效人（必输项），指的是发送会计平台使单据生效的那个人，不是单据的制单人 private UFDate busidate = null; / 业务日期（必输项），业务生效的日期，不一定是单据日期 private String defdoc1 = null; /

33、业务分类 关联档案型的数据，比如交易类型，业务类别，收发类别等。注意：必须为全局或集团级的档案类型，不支持组织级的档案类型 private String defdoc2 = null; / 自定义关联档案 2 private String defdoc3 = null; / 自定义关联档案 3 private String freedef1 = null; / 单据号 private String freedef2 = null; / 备注 / 说明 private String freedef3 = null; / 金额（需格式化） private String freedef4 = nul

34、l; / 自定义项 4 private String freedef5 = null; / 自定义项 55.4 调用 FipMsgResultVO nc.pubitf.fip.service. IFipMessageService .sendMessages( FipMessageVO fipmessagevo) throws BusinessException 发送消息到会计平台第六章 目的系统的快速实现本章内容概要： 实现联查与重算的接口 nc.pubitf.fip.external.IbillReflectorService 实现目标单据的服务 nc.pubitf.fip.externa

35、l.IDesBillService 在 fip_billregister 表中进行注册 在 fip_entityattcfg 中注册需要在模板上展示的字段6. 1 实现联查与重算的接口 nc.pubitf.fip.external.IbillReflectorService6. 2 实现目标单据的服务 nc.pubitf.fip.external.IDesBillService6. 3 在 fip_billregister 表中进行注册需要注册的字段包括：Billreflectclass IbillReflectorService 接口的实现类pk_billtype 单据类型或交易类型的编码modulecode 模块号，例如 gl,arclass_entity_id 分类定义目标档案实体 ID ，例如 科目，要素org_entity_id 目标单据主组织档案实体 ID ，例如 财务核算账簿，责任账簿，成本中心可以参考 pk_billtype= C0 的记录6. 4 在 fip_entityattcfg 中注册需要在模板上展示的字段