物料同步
1. 简介
1.1 插件简介
物料同步场景指的是，根据表单业务数据，通过物料同步函数在金蝶云星空企业版中同步物料相关数据。
1.2 应用场景
常用于在简道云中发生采购入库相关业务时，通过该插件自动在金蝶云星空企业版中同步物料信息。
1.3 预期效果
开启金蝶云星空-采购入库单同步插件，在「物料同步」表单中输入信息提交后，自动在金蝶云星空中同步对应的物料信息。效果如下所示：
1.4 使用说明
该插件为付费插件，进入简道云「开放平台 >> 插件市场」，找到「金蝶云星空-采购入库单同步」插件，点击插件后进行购买：
2. 插件安装及启用
2.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：金蝶云星空-采购入库单同步插件安装。
- 安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处启用插件。
2）在简道云「插件市场」处，安装「金蝶云星空-采购入库单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中，点击「调整插件配置」按钮，配置「授权模式」「账套 ID」「授权用户」「用户密码」「用户ID」「应用密钥」「接口地址」，点击保存。
注：
1）金蝶云星空全部公有云版本和私有云 7.3 以上版本可使用三方授权模式，私有云 7.3 以下版本需使用账号密码授权模式。
2）三方授权模式无需填写用户密码，其他参数必填；账号密码授权模式无需填写应用 ID /应用密钥，其他参数必填。不同的授权模式，插件配置参数的获取方式不同。详情可见 金蝶云星空-采购入库单同步【2. 金蝶云星空平台配置 】。
2.3 启用插件
在插件管理中，打开「金蝶云星空-采购入库单同步」插件右侧开关，启用插件。
3. 表单搭建
插件使用体验可先安装：金蝶云星空-采购入库单同步插件应用模板。本文将按照示例中的「物料同步」表单进行讲解。
新建「物料同步」流程表单，字段设置如下所示：
分类 | 字段名称 | 字段类型 | 字段说明 |
基础信息 | 物料编码 | 单行文本 | 必填，注：自己定义一个物料编码，需要是唯一，同时作为金蝶云星空此物料的编码。公式举例： CONCATENATE("C",TEXT(INT(RAND()*10000)),RIGHT("0"+RECNO(),1)) |
物料名称 | 必填 | ||
创建组织 | 必填，一般这个编码是固定的，特殊业务可动态传对应的编码。 | ||
使用组织 | 必填，一般这个编码是固定的，特殊业务可动态传对应的编码 | ||
物料信息 | 基本单位 | 非必填 | |
物料属性 | |||
库存信息 | 库存单位 | ||
安全库存 | 数字 | ||
扩展参数 | 扩展字段 | 单行文本 | 设置默认值为公式编辑，公式设置如下所示： CONCATENATE('{','"SubHeadEntity":{"FBaseUnitId.fnumber":基本单位,"FErpClsID":物料属性},"SubHeadEntity1":{"FStoreUnitID.fnumber":库存单位,"FSafeStock":安全库存}','}') |
4. 流程节点设置
4.1 流程发起节点
点击流程发起节点，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」「可编辑」权限：
注：除「扩展字段」，其余字段均勾选「可见」「可编辑」权限。
4.2 添加审批节点
新增流程节点，在「节点属性 >> 节点名称」处，修改节点名称为「审批节点」；在「节点属性 >> 字段权限」处，在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：
4.3 启用流程
流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。
5. 智能助手Pro配置
5.1 新建智能助手Pro
进入「供应商同步」流程表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro 的名称为「供应商同步」，并选择触发方式为表单触发，表单选择「物料同步」表。
5.2 配置触发动作
触发动作进行如下设置：
- 触发动作：
- 选择「新增数据」时；
- 或「修改数据」勾选「任意字段」修改时；
- 或「流程结束」时。
5.3 配置触发动作
点击节点连接线上的加号按钮，添加插件节点，进行如下设置：
- 执行插件：选择「金蝶云星空-采购入库单 >>物料」；
- 操作类型：选择自定义，勾选「审核」；
- 编码：选择字段值，勾选「触发数据--物料编码」；
- 名称：选择字段值，勾选「触发数据--物料名称」；
- 创建组织：选择字段值，勾选「触发数据--创建组织」；
- 使用组织：选择字段值，勾选「触发数据--使用组织」；
- 扩展字段：选择字段值，勾选「触发数据--扩展字段」。
5.4 保存并启用
全部设置完成后，点击右上方「保存并启用」，启用智能助手。
5.5 效果演示
效果参见本文【1.3 预期效果】
6. 注意事项
6.1 插件节点配置字段说明
字段名称 | 是否必填 | 字段来源 | 字段说明 |
操作类型 | 必填 | 自定义/字段值 | 可根据表单提交后，金蝶云进行哪些操作进行选择，提供以下 3 种操作：
|
编码 | 金蝶云星空物料的编码，编码需要是唯一的。 | ||
名称 | 金蝶云星空物料的名称，填写物料名称。 | ||
创建组织/使用组织 | 通常情况下，这两个编码是固定且相同的，特殊业务可分别传对应的编码。 | ||
扩展字段 | 非必填 | 字段值 | 即表单中的「扩展字段」。 可根据需要添加任意字段，最终通过在「扩展字段」中拼接字段名和字段值进行数据传递；（字段名可在 金蝶云星空API中心 查询） |
6.2 关于插件的测试说明
因物料同步后，涉及金蝶云星空关键单据/关联单据/关联事件的变化，建议大家测试时请自己的金蝶云星空服务顾问进行协助，以便更好的和自己的金蝶云星空系统中的业务规则相结合。
7. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
400-111-0890
在线咨询