历史版本13 :用友NC/NCC/BIP连接器安装部署 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 提前准备编辑

1.1 软件环境

序号

软件

版本及功能

说明

1

部署FDL

  • 4.2.0.3及以上

  • 所需功能:

分类
功能点
数据开发-定时步骤流程-基础节点包
步骤流程-高级节点包
数据转换-基础算子包
数据转换-高级算子包
数据源管理-进阶接口协议-定时


连接器基于FDL构建的,用到了数据开发功能

2

部署mysql,并新建一个数据库,数据库名为“ODS”

8.0及以上

用于存储连接器跑出的数据结果

1.2 硬件配置建议

服务器

硬件

网络

更详细

FDL服务器

 内存:32GB

 CPU:8核 20线程

 JVM内存:16GB

 磁盘空间:提供大致数据量级,推荐200G以上,具体按照数据量来计算

 推荐带宽50-100Mb/s以上

FineDataLink部署环境准备

1.3 其他内容

序号

内容

说明

1

NC(NCC/BIP)系统的数据库连接信息

 IP地址

 端口号

 数据库名

 用户名

 密码

FDL配置NC(NCC/BIP)源数据库时候需要


2

目标数据库(mysql)连接信息

 IP地址

 端口号

 用户名

 密码

此处说的是上面第2点环境准备里面的mysql,连接器处理好的数据存放的目标库

3

NC(NCC/BIP)中企业报表的编码

 利润表的报表编码

 现金流量表的报表编码

 资产负债表的报表编码

同步企业报表的数据时候需要


3里面的企业报表编码获取,可参照下面截图(NC系统的页面截图),具体客户,有可能在“报表表样-全局”里管理报表也有可能在“报表表样-集团”里管理报表,此外,点进去后,报表表样名称,“报表表样名称”列,也未必一定是资产负债表、利润表、现金流量表的叫法,所以,具体使用时候要看具体情况。

iShot_2024-11-26_02.53.56.png

2. 开始部署编辑

2.1  资源包导入


登录FDL平台,如下图所示,点击「资源导入」:

iShot_2024-12-23_17.16.17.png



选择对应资源包,点击上传:

iShot_2024-12-23_17.21.58.png

刷新下平台,打开「数据开发」,确认是否导入成功;

iShot_2024-11-26_01.30.49.png


2.2  修改数据连接

打开「管理系统>数据连接>数据连接管理」,会发现“NC数据连接”和“ODS数据仓库”两个数据连接。“NC数据连接”指的是要连接的NC(NCC/BIP)系统的数据库,“ODS数据仓库”指的是连接器将数据处理好后存放的目标数据库。

说明:这两个数据连接名切勿修改,必须叫“NC数据连接”、“ODS数据仓库”!

点击“NC数据连接”,修改成项目中NC(NCC/BIP)系统的数据库信息:

iShot_2024-12-23_17.39.00.png


点击“ODS数据仓库”,编辑修改成项目中的目标数据库信息:

iShot_2024-12-23_17.39.40.png






2.3  确认全局参数是否修改

打开「数据开发」,点击“定时任务”右边的设置按钮,发现以下5个静态全局参数,说明:这5个全局参数的参数名切勿修改:

iShot_2024-11-26_15.55.29.png

iShot_2024-11-26_15.56.26.png


  • orgcode,静态参数,参数类型为文本,默认值为all,表示所有公司,如果默认值写上某个具体公司code,则只执行该公司的

  • period,静态参数,参数类型为日期,默认值为yyyy-mm-1,表示当前年月前1个月,如果想前两个月,yyyy-mm-2

  • dbo,静态参数,参数类型为文本,默认值为2.2配置数据连接中“NC数据连接”中的用户名,即连接NC系统数据库的用户名

  • ODS,静态参数,参数类型为文本,默认值为ODS

  • DW,静态参数,参数类型为文本,默认值为DW



根据项目实际情况,是否要调整5个参数的参数值!


再次确认,上述5个参数的参数名切勿修改!


2.4  执行前置任务

打开「数据开发」,找到名称为“前置任务”的任务,点开,并运行该任务;该任务主要用途是创建数据库、对照表、存储过程;

iShot_2024-11-26_02.13.23.png

iShot_2024-11-26_02.13.52.png



2.5 企业报表数据获取配置


企业报表,即常说的“三大报表”数据,该处实现将三大报表数据同步到目标库


2.5.1 配置连接信息


打开ncreport.war包,在下图所示路径下找到“jdbc.properties”文件,编辑文件中NC数据连接信息、mysql数据仓库信息、财务报表编码信息

注:财务报表编码来源上面步骤1.3其他内容里面的3的信息

iShot_2024-11-26_03.08.59.png


2.5.2 部署war包文件

将编辑好后的“ncreport.war”文件放至FDLHome/webapps路径下,并重启FDL

备注,目前war包文件部署还不支持容器化部署,如果遇到容器化部署,临时方案是,单独部署个tomcat,ncreport.war文件放置此tomcat的webapps下,重启tomcat


2.5.3  配置API接口

打开「数据开发」,点击任务“企业报表”

iShot_2024-11-26_03.13.53.png


切换到开发模式,点开“dan单个公司”

iShot_2024-11-26_03.30.42.png



点开“API输入”

iShot_2024-11-26_03.31.07.png



API配置,下图中IP及端口号改成具体的FDL所在服务器地址及端口。改完后,点击保存。

http://war包文件所在tomcat的ip地址:端口号/ncreport/NCReportDataSyc

iShot_2024-11-26_16.29.45.png


同理,开发模式下,点开“所有公司”

iShot_2024-11-26_03.36.45.png


点开“API输入”

iShot_2024-11-26_03.37.05.png


API配置,下图中IP及端口号改成具体的FDL所在服务器地址及端口。改完后,点击保存。

http://war包文件所在tomcat的ip地址:端口号/ncreport/NCReportDataSyc

iShot_2024-11-26_16.33.05.png


2.6  修改定时调度任务


打开「运维中心」,点击“调度计划”,找到“NC(NCC&BIP)调度计划数”,点击计划后面的按钮:

iShot_2024-12-23_18.04.53.png


点击编辑:

iShot_2024-12-23_18.06.54.png


根据实际情况,修改调度配置:

iShot_2024-12-23_18.07.33.png

修改完后,点击确定。


至此,连接器部署完成!

3.  测试编辑

通过上面步骤完成了连接器的部署,以及调度任务的设置。如果想看一下部署是否有问题,可以跑个测试。跑测试时候可以跑所有任务,k可以测试某些任务。可以跑所有数据,可以跑某个公司、某个月份数据。

不建议工作时间跑所有公司、所有月份,防止计算量大,影响ERP系统使用。


3.1  测试所有任务

参数值设置为要测试的公司、要测试的日期。这里可以直接改全局参数的值,但要注意g测试完之后再改回来;也可以不改全局参数,添加任务参数,任务参数优先级高于全局参数,所以跑测试添加任务参数,不要发布,发布了,后面任务调度就按照任务参数了。

  • 如果调整全局参数的话,见下图:

    orgcode:参数值改成具体想测的公司的code

    period:参数值调整成想测试的月份,也可以将参数类型改成文本,参数值改成具体年月

注意,测试完成后,要把全局参数改回来!

iShot_2024-11-26_16.55.13.png

  • 如果添加任务参数的话也可以,见下图,添加orgcode和period两个参数:

   orgcode:参数值填具体的公司code

    period:参数值填具体的年月

注意,用任务参数测试任务的话,不要点击发布,点击发布,任务参数优先级会高于全局参数,自动调度时候就按照这里设置的任务参数执行了!

iShot_2024-11-26_17.10.46.png

3.2  测试单个任务

打开具体要测试的任务,业务页面上点运行就行。其他参数相关和3.1测试所有任务相同。