调用API,通过HTTP请求添加、激活以及禁用系统用户

本篇文章将介绍通过调用系统API、HTTP请求,添加、禁用以及激活系统用户。其中调用API、HTTP请求可以配置在动作、审批流程、列表流程等不同场景下。

本篇文章以列表流程为例,用户掌握原理后可自行配置在其他场景中。

首先在列表中创建账号状态,账号,姓名,邮箱地址,部门,直属经理,用户ID必要字段(第三步、第四步中有进一步解释),可以根据实际业务增改字段信息。(注意字段类型,此处账号状态有三种为:Active、Disable、Re-active

创建列表流程,并设置相应的启动条件:此处的启动条件为新增 - 列表有新增记录后且当账号状态为Active时。

在设计器中打开 ----- 创建流程:

第一步:创建变量并关联

  1. 创建两个复杂类型定义 header与Data。

header包含字段如下图:

Data包含字段如下图:

  1. 创建下列变量,并将Header与Data与对应复杂类型定义关联。

第二步:设置变量,认证API信息

在流程中加入 ---- “设置变量” 组件并按照下图设置,其中API值在 系统设置集成 中获取当前商户的API地址(注意该API只有当前商户的系统管理员可以获取,API为隐私信息请注意保密)。

第三步:设置HTTP请求

在流程中加入 ---- “HTTP请求” 组件,HTTP请求中应用到的信息,从以下网址中获取:

易企办 APIs | 易企办 开发者网站 (yeeoffice.com)

因为此流程是用以添加用户账号,因此在Users部分下找到 “添加用户” 并引用相关信息。

其中 “HTTP地址” 复制 “添加用户” 信息下的第一个地址。

“提交数据” 中,复制 “添加用户” 中数据并修改填写对应列表字段,如下图:

LoginAccount,Name,Email,DeparmentID, Linemanager,IsSendMail为必填字段:

  • LoginAccount为登录账号,一旦注册不可修改

  • Name即用户姓名

  • Email为与此账号绑定的邮箱地址,注册后可以修改, Email 与 LoginAccount通常一致

  • DeparmentID为用户所在部门,必须保证有值,否则将产生报错

  • Linemanager为用户直属经理,必须保证有值,否则将产生报错

  • IsSendMail为“true”时,通过列表流程添加用户时会给绑定的邮箱发送邮件;IsSendMail为“false”时,则不会发送邮件

  • Attrs中为选填内容,如需创建更多信息,则要在Attrs中增加字段及值

其他数据按照下图填写:

第四步:创建成功后设置数据列表(创建成功后可直接结束流程,根据实际业务情况调整)

创建成功条件为:

设置列表数据,回填如图字段(回填字段可根据实际调整,如业务场景需通过改变“帐号状态”来实现禁用及激活账户,则必须回填UserID)

第五步:创建失败后指派任务,可根据需求调整(创建失败后可直接结束流程,根据实际业务情况调整)

创建失败条件为:

第六步:结束流程

以下为禁用与激活用户列表流程创建步骤

启动条件如下:

第一步:创建变量(同创建账号第一步)
第二步:设置变量(同创建账号第二步)
第三步:HTTP请求

其中HTTP地址更换为禁用用户的地址(粘贴复制第一个),将其中的" {id} “替换为列表字段"UserID”, 方法更换为PUT,提交数据中不需要填写,其他数据如下图。

第四步:禁用成功后更新数据(可直接结束流程,根据实际业务调整)

禁用成功条件(同创建账号第四步)

第五步:禁用失败后发送邮件(可直接结束流程,根据实际业务调整)

禁用失败条件(同创建账号第五步)

第六步:结束流程(激活账号设置逻辑与禁用账户相同)