Workfine系统API使用说明

功能说明

Workfine从5.4.0开始，陆续开放了一批系统内置API，用户可以在取数公式中进行调用使用。

本文以【系统API-新增更新用户】为例，讲解如何设计表单并使用该系统API。

新增更新用户API主要实现了用户信息的调整，包括用户信息、部门信息、权限信息等方面。

表单设计

新建模板【人员变动】，如图添加扩展列并定义

表单内数据字段分别使用提取公式或列表规范进行获取，注意需要使用编号。

5.4.0新增了部门角色权限视图，可以从该视图中获取已有的权限记录。

业务设置

1、进入表间公式=>取数公式，点击新增按扭，选择“调用API”

2、输入公式名称：调整用户信息，来源选择系统API：新增更新用户

3、进入参数字段标签页，根据截图将本表字段依次选择对应进入到对照列中

其中loginName对应登录名，API根据登录名对已有用户进行查找。如果有用户存在，则更新用户信息，如果没有，则根据已有信息新建这个用户。

序号	字段	含义
1	$.option.state	启用状态
2	$.users[*].deptId	部门id
3	$.users[*].deptName	部门名称
4	$.users[*].name	用户名称
5	$.users[*].loginName	用户登录名
6	$.users[*].password	用户登录密码
7	$.users[*].mobile	手机号
8	$.users[*].email	邮箱
9	$.users[*].roleId	角色id
10	$.users[*].roleName	角色名称

由于本示例主要实现功能为修改用户，我们仅使用更新功能。

4、由于这个API没有返回结果，所以我们进入公式执行标签页，选择执行时机为“保存时执行”

注意：如果报错，请在这里选择下数据表，然后再测试【图片】

5、保存这个公式

使用效果

1、打开应用端，新建【人员变动】表单并填写信息

2、点击保存

3、打开设计端，查看benniu用户是否已经调整到营销部并且拥有设置的权限

原文地址：Workfine系统API使用说明 – 服务中心

常见问题