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

目录:

1. 提前准备编辑

1.1 软件环境

序号

软件

版本及功能

说明

1

FDL

  • 4.2.0.3及以上

  • 所需功能:

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


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

2

mysql

8.0及以上

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

1.2 硬件配置建议

服务器

硬件

网络

更详细

FDL服务器

 内存:32GB

 CPU:8核 20线程

 JVM内存:16GB

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

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

FineDataLink部署环境准备

1.3 其他内容

序号

内容

说明

1

NC系统的数据库连接信息

 IP地址

 端口号

 数据库名

 用户名

 密码

FDL配置NC源数据库时候需要


2

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

 IP地址

 端口号

 用户名

 密码

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

3

NC中企业报表的编码

 利润表的报表编码

 现金流量表的报表编码

 资产负债表的报表编码

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


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

iShot_2024-11-26_02.53.56.png

2. 开始部署编辑

2.1  资源包导入

登录FDL平台,打开「管理系统>智能运维>资源迁移」,点击上传文件,选取NC连接器资源包;

1.png

选择所有内容,然后点击导入按钮,等待导入成功;

iShot_2024-11-26_01.28.56.png

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

iShot_2024-11-26_01.30.49.png


2.2  配置数据连接

打开「管理系统>数据连接>数据连接管理」,点击新建按钮,新建数据连接;

iShot_2024-11-26_01.38.10.png


新建一个是连接NC系统数据库,连接名必须是“NC数据连接”,具体信息配置根据实际情况,即1.3其他内容中准备的信息;

iShot_2024-11-26_02.09.33.png


再建一个是存放连接器结果数据的数据库(目标仓库),连接名必须是“ODS数据仓库”,具体信息配置根据实际情况,即1.3其他内容中准备的信息,

这里面的数据库名称做个说明,2.1 资源包导入步骤中导入的任务里包含了在目标库中创建数据库表的任务,因为到此任务还未执行,所以:

  • “数据库名称”,这里先空着

  • 等到2.4 执行前置任务之后(会在目标库里面创建库表),要再回到数据连接这里,将“ODS数据仓库”连接中的“数据库名称”处,填上“ODS"

iShot_2024-11-26_14.56.29.png


2.3  设置全局参数

打开「数据开发」,点击“定时任务”右边的设置按钮,添加全局参数,这里需要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


2.4  执行前置任务

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

iShot_2024-11-26_02.13.23.png

iShot_2024-11-26_02.13.52.png

注意:当前置任务执行后,要回到 2.2 配置数据连接,将连接“ODS数据仓库”中空着的“数据库名称”处填上“ODS”


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调度任务”,加入到计划任务;

进行调度配置,设置执行频率;

iShot_2024-11-26_02.46.47.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测试所有任务相同。