用友畅捷通-工单同步插件

1. 简介

1.1 插件简介

用友畅捷通-工单同步插件，能够将企业在畅捷通中的工单单据同步至简道云对应表单中，若同步工单的单据中包含一级子表单数据，则一级子表单数据也会在简道云中以子表单形式进行存储。

1.2 使用场景

常用于工单需要经过复杂的审批流程或需定制个性化的业务流程的场景中，如跨平台数据整合、工单数据监控与分析等。

1.3 预期效果

以同步销售订单为例，开启用友畅捷通-工单同步插件，通过智能助手定时触发在指定时间自动同步销售订单数据到表单。效果如下所示：

1.4 使用说明

1）该插件适用于简道云企业版，需要具有 API 权限才能使用；使用的财务软件也需具有 API 功能，并确保财务软件具有简道云对应表单的操作权限。

2）该插件包含 2 种事件，如下所示：

3）该插件为付费插件，请联系我们增购。插件购买流程如下所示：

2. 用友畅捷通平台配置

2.1 登录用友畅捷通

登录 用友畅捷通开放平台，点击「进入控制台」，切换至对应的认证企业中。

2.2 创建应用

1）点击「应用管理 >> 创建应用商店应用」，在「新增应用」处选择「应用入驻」，选择完成后，点击「下一步」。

2）在对接产品页面中，选择产品 T+Cloud 和 Tplus，选择完成后，点击「下一步」，上传应用 logo，并填写应用名称、应用介绍和申请理由等基本信息后，点击「保存并提交」。

2.3 获取appkey和appsecret

应用提交后，平台将自动弹出应用相关的重要信息。查看并保存正式环境 AppKey 和正式环境 AppSecret。

2.4 应用凭证配置

1）设置回调地址

应用新建完成后，系统将自动跳转至应用详情页面。在「开发配置 >> 应用凭证 >> 正式环境配置」中，设置正式 OAuth 回调地址为：https://www.jiandaoyun.com/

2）申请接口调用权限

在「开发配置 >> 权限配置」处，搜索「生产加工单查询」和「销售订单查询」这两个接口，勾选接口后点击「申请权限」，申请接口调用权限。

以申请「生产加工单查询」接口权限为例，操作如下所示：

3）设置自主应用绑定

在「应用能力 >> 自主应用绑定」处，选择需要绑定的企业，点击「绑定」。绑定成功后，点击操作栏处的「开通授权」按钮，在提示页面中，继续点击「开通授权」。

4）获取畅捷通code

根据提示继续点击「去开通」和「授权」。授权完成后，畅捷通平台会默认跳转网页，在网页链接中获取code。

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）在简道云「插件市场」处，安装「用友畅捷通-工单同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

3.2.1 获取插件配置参数

1）获取简道云API Key

在「密钥管理 >> API Key」处获取对应 API。

2）获取应用ID

在「开发文档 >> 参数说明 >> 应用切换」中，选择要查询的应用和表单，即可查看和复制应用 ID 。

3.2.2 配置插件

安装后，在插件管理处，点击插件右侧的设置按钮,，进行插件配置：

全部配置完成后，点击「保存」。

3.3 启用插件

在插件管理中，打开「用友畅捷通-工单同步插件」右侧开关，启用插件。

4. 表单搭建

插件配置需要使用 3 张表单，分别是：

5. 智能助手配置

5.1 配置表初始化

5.1.1 添加智能助手

进入「畅捷通配置表」中，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，并修改智能助手的名称为「配置表初始化」：

5.1.2 设置触发动作

设置触发动作如下：

5.1.3 设置执行动作

执行动作设置如下：

5.2 工单同步

5.2.1 添加智能助手

进入「畅捷通配置表」中，在「扩展功能 >> 智能助手」处，点击「新建智能助手」，并修改智能助手的名称为「工单新增同步」：

5.2.2 设置触发动作

设置触发动作如下：

5.2.3 设置执行动作

执行动作设置如下：

5.3 效果演示

效果参见本文【1.3 预期效果】。

6. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：