【协同办公OA同步金蝶ERP可视化配置工具】置同步节点

前言

文章由 协同办公致远oa二开 支持

配置步骤都准备充分，那么一次操作就做完了，接下来的操作就是配置同步节点，也是最重要的操作，一样，很详细，但是稍微有些难度

下载地址：百度网盘 请输入提取码

操作储备

在开始讲解之前，需要了解一下金蝶的数据储存是什么样子的，方便后面配置节点的理解

那么，如果在金蝶中添加数据

步骤如下

1. 填写数据

可能会涉及到数据的查询，比如添加用户数据，或者货币数据都是查询

1. 点保存

1. 点提交

1. 点审核

上面四个步骤之后，金蝶的一条数据才算是真正的添加成功

配置节点

找到入口，第一个功能，同步

打开之前，我们直接用一个例子进行讲解

在oa我们有这样一个流程表

然后配置了一个节点，叫做数据管理员

在金蝶，有一个客户表单

假设我们需要在数据管理员的这个节点，将oa的客户信息同步到金蝶。

回到正题，如何实现

打开同步之后如下，我们点击中间的添加

我们定义一次同步操作叫做一个同步节点

名称：这次同步的目的我们是同步客户信息，那我们就叫同步客户信息

描述：我们可以写，同步客户信息到金蝶，来描述他的作用

节点名称：注意了这里的节点名称是指系统中流程中的节点，这里主要用于来填写，我们需要在流程得到哪个节点进行同步操作，所以我们填写数据管理员

节点属性：同样是指流程节点中的属性，是协同我们就选择协同，如果是其他，就选择其他

同步表单：在下拉列表中选择添加客户，这里选择的是流程

启用：默认启动就行

金蝶目标表单：这里需要填写金蝶客户表单名字，名字怎么获取呢

在金蝶页面，用单独注册的账号，进入web api界面，如果搜不到，那就是账号权限问题

我们找到客户表单，在基础管理，基础资料中。

然后打开之后，点击在线测试webapi，验证接口，表单id就是我们需要的数据

ok，回到正题，所有信息填写完成之后，确认，就可以看到一条信息，

单击数据

左下角的部分可以对刚才内容做修改，右边的部分是接下来的操作

这里讲一概念，一个流程表单可以对应n个同步节点，一个同步节点可以对应多个同步操作集合。右边的部分就是同步操作的集合。每一个集合里面存放的就是表单同步操作的提交保存。

点击右下角的添加操作集合，这里为什么还需要添加，举个例子，简单说明一下，比如oa同步过去的表单，我有两个方案，一个是oa a字段对应金蝶的b，另外一种情况是oa字段c对应b，所以可以新建一个操作集。这里我们随便创建一个，随便创建名字就行，常规这里创建一条数据就行

双击添加的数据

解析器，全部操作最重要的一步

先讲一下什么是解析器，以及他的作用

什么是解析器，储存模拟金蝶调表人员操作集合也可以叫操作集

解析器有什么用，模拟金蝶的储存操作，以及储存字段的对应关系系

在这之前，我们在金蝶添加一条客户数据。

打开客户添加页面，如下图，我们至少需要填写一个名字即可

但是，必须填写的有3个地方，一个创建组织，客户名称，结算币别，除了客户名称，其他都默认值

那么我们然后点击保存，提交，审核

完成，这样就添加了一条客户数据

一共四个步骤，填写数据，保存数据，提交数据，审核数据。这是最快的几个步骤，如果我们要替换上面的结算币别，那就需要多一步操作

回到工具这边，工具的实现方式就是模拟金蝶的填写操作

配置

原理知道了，那我们需要怎么配置呢

点击添加

看到下面的界面先不要慌，我们一点一点来

操作类型，展开可以发现，他就是金蝶的一些基础操作，所以我们需要在这里选我们需要模拟的操作

看起来很复杂，这里需要配置的就是协同平台的字段如何对应金蝶的字段

在技术层面，金蝶的每次操作都有返回值，比如查询货币币别，更改选择就是一种查询，他会将你的选择的数据返回到这个配置中

填入金蝶的字段数据列，工具会做解析，后面会提及。那么现在开始模配置

查看要求

有几个地方需要在我们进行配之前提前打开

第一个界面，金蝶的webapi界面

第二个界面，oa的应用设计中的表单设置

这里讲核心在保存操作上面，所以在webapi中，直接选择客户中的保存

翻到下面的第四点，JSON格式数据，一会儿会用到，至于下面的英文是什么意思，不要慌，往下翻，第五点可以理解。

在此之前，要学习了解一个新知识JSON。跳转《附件JSON》

看到第四点，学过json应该就能看懂了，这个东西有什么用呢，他表示协同平台要同步到金蝶的数据，必须是这个样子，也就是他给出了key，我们要填写value

看到这么多key一个一个对应可能是不对的，猴年马月才能对应完成，所以看第五点，字段说明，能看到每个key的意思，那么除了有明显标注必填项的，我们需要填写v，其他的，按照自己的需求

所有东西都了解之后，现在我们进行分析

我们的协同平台的表单中，想要同步这几条数据，姓名，创建组织，货币类型

再到金蝶中的客户表中查看，姓名应该对应 客户名称，应为创建组织是必填，和货币类型也是必填，所以在协同平台，新增了组织和货币两个字段，那么我们同步的字段就如下

所以，我们同步的字段有以下几个，需要在字段说明中寻找到

虽然都是必填，和正常字段无差异

如图所示，找到这几个对应的地方

1客户名称：FName (必填项)

2创建组织：FCreateOrgId (必填项)

3结算币别：FTRADINGCURRID (必填项)

然后我们查看上面

分别用FName FCreateOrgId FTRADINGCURRID 进行查询

得到如下几个内容

1 "FName": "", 代表名字的格式

2 "FTRADINGCURRID": {

"FNumber": ""

},代表货币的格式

3 "FCreateOrgId": {

"FNumber": ""

},代表创建的格式

FName在表单中就是填写中文内容，可以直接填写

FTRADINGCURRID，FCreateOrgId两个在表单中属于查询选择，所以我们需要通过模拟我们的查询操作，拿到一个FNumber的东西，可以理解成为编号，比如查询结算货币改成人民，看到的是人民币的中文，实际上，系统拿到的是人民币的数据库id，fnumber

模拟查询

模拟查询组织，因为是创建组织，那么我们要查询的就是如下这个地方

按照这几个选项查看，得到表单id，一会儿要用

然后往下滑，看到两个字段

FName FNumber，我们需要得到人民币的FNumber，那么FName就是人民币，所以我们需要通过FName查询FNumber

回到工具

看下面的几个标签，这里就是我们要编写的json

FormId就是表单id

FieldKeys就是我们想要查询的内容是什么

FilterString 就是我们需要查询的条件是什么

一步一步来，回到金蝶，我们需要拷贝一下里面的内容，

记住，拷贝的位置一定要对

然后回到工具中，粘贴到下面

回到上面

表单id就填写之前复制的内容，fieldkeys使我们需要查询的内容，那么就是直接填写FNmber

重点来了，右键选择

第一个条件，我们点击下拉，选择FName，中间小角标选择=，最后一个，我们选择oa中的创建组织

Ok，我们得到了如下的json

{

FormId: "ORG_Organizations",

FieldKeys: "FNmber",

FilterString: " 名称：FName (必填项) = ' field0002:创建组织:text' "

}

什么意思呢，这个json就表示，告诉金蝶，我们要在表单组织中查询FNume等于致远表单中的创建组织中的内容的FNumber

最后一步，返回值中填写orgNumber:FNmber，orgNumber随便写，任意的，最好不要和其他冲突，FNmber就是获取到的值，往上滑，点击保存

同样的操作方式，实现货币的查询。

{

FormId: "BD_Currency",

FieldKeys: "FNumber ",

FilterString: " FName = ' field0003:货币类型:text ' "

}

其中几个地方要注意，formid是BD_Currency，返回值一定不要冲突，最后得到的JSON如图

模拟保存

保存数据之前，我们需要填写填写数据，我们需要3个数据，名称，组织，货币，名称我们可以直接在oa表单里面拿，组织和货我们已经拿到了

查看金蝶的json格式

名称：1 "FName": "", 代表名字的格式

货币：2 "FTRADINGCURRID": {

"FNumber": ""

},代表货币的格式

组织：3 "FCreateOrgId": {

"FNumber": ""

},代表创建的格式

操作之前，别忘了这个，在基础资料，客户中的save选项下面

添加名称

然后选择客户名称：FName (必填项)以及 " field0001:客户姓名:text"

其次，添加货币，同样右键添加两次，变成下面的效果

左边选择结算币别：FTRADINGCURRID (必填项)，中间输入FNumber，其次就是填写之前查询的结果，分别填写

点击保存就可以了

模拟提以及审核

到这里，配置就完成了，那么就可以再协同办公中使用了，信息就会同步到金蝶中

文字比较多，但是很详细，认真看完没什么大问题，有问题请联系参考https://tlzsy.com/