钉钉日程增删改插件
1. 简介
1.1 插件简介
该插件支持在表单数据新增、修改、删除时,自动进行钉钉日程的创建、修改、删除。支持发起人员、日程标题、开始时间、结束时间、日程地点、参与人员、日程描述 这 7 个日程字段信息。
1.2 应用场景
常用于根据业务表单信息自动给相关人员创建日程。如会议日程、活动日程、任务日程、课程表日程等等。
1.3 预期效果
以市场活动日程创建为例,在「市场活动申报」表单中输入信息提交后,自动给相关人员创建日程。效果如下所示:
1.4 使用说明
1)该插件包含三种执行事件:
- 新增日程
- 修改日程
- 删除日程
注:
1)若后续需修改/删除日程,则新增日程需要使用插件节点或者前端事件来设置,以便新增日程时储存钉钉的日程编号用于后续修改/删除日程时进行对应(智能助手暂时无法接受返回参数「日程编号」)。
2)若后续不需要修改/删除日程,那么新增日程可使用前端事件、智能助手、插件节点中的任意方式来设置。
2)该插件为付费插件,请联系我们增购。插件购买流程如下所示:
注:插件购买期限需要和简道云版本期限保持一致。
2. 钉钉平台配置
2.1 创建钉钉应用
1)管理员需要 PC 端登录 钉钉开放平台,选择「应用开发 >> 企业内部开发 >> 钉钉应用」,点击「创建应用」。如下图所示:
2)选择应用类型为「H5微应用」,填写应用名称和应用描述,选择开发方式为「企业自助开发」。如下图所示:
2.2 申请相关权限
1)申请日历权限
应用创建完成后,点击打开该应用,在「权限管理 >> 个人权限」处搜索日历,并勾选日历相关全部权限,勾选完成后点击「批量申请」。如下图所示:
2)申请通讯录权限
在「权限管理 >> 通讯录权限」处,勾选通讯录相关全部权限,勾选完成后点击「批量申请」。如下图所示:
2.3 查看Appkey和 AppSecret
查看并记录下创建的应用的 Appkey 和 AppSecret ,插件配置时需要填写。如下图所示:
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:钉钉日程增删改安装链接。
- 安装成功后,可参考本文【3.2 配置插件】和【3.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场安装
在简道云「插件市场」处,安装「钉钉日程增删改」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 配置插件
在插件管理中,点击「调整插件配置」按钮,将【2.3 查看Appkey和 AppSecret】中的「应用Key」和「应用Secret」配置进去,配置完成后点击确定。
3.3 启用插件
在插件管理中,打开「钉钉日程增删改」插件右侧开关,启用插件。
4. 表单搭建
插件使用体验可先安装:钉钉日程增删改插件模板表单。本文将按照示例表单进行讲解。
以市场活动创建日程为例,新建「市场活动申报」流程表单,字段设置如下所示:
字段名称 | 字段类型 |
活动主题 | 单行文本 |
活动地点 | |
开始时间 | 日期时间 |
结束时间 | |
参与人员 | 成员多选 |
活动描述 | 多行文本 |
发起人员 | 成员单选 |
日程编号 | 单行文本 |
5. 插件节点设置
本节以新增钉钉日程为例进行插件节点设置说明。若仅需新增钉钉日程,则插件节点设置完成后即可,智能助手无需进一步进行配置。
5.1 添加插件节点
表单创建完成后,切换至「流程设定」中,点击「插件节点」,新增插件节点。如下所示:
注:根据企业业务需要确定「插件节点」放在整个流程的哪个环节。若发起流程时新增日程那么放在「流程发起节点」之后;若流程流转完成时新增日程则放在「流程结束节点」之前。
5.2 插件节点配置
点击「插件节点」,在「节点属性 >> 插件」处,点击「插件配置」。配置内容如下所示:
- 选择「钉钉日程增删改」插件;
- 选择「新增日程」函数;
- 根据企业信息,分别选择【字段值】方式,将「发起人员」、「日程标题」、「开始时间」、「结束时间」、「日程地点」、「参与人员」、「日程描述」配置进去;
- 添加并设置「日程编号」的存储关系,设置完成后点击「确定」。
6. 智能助手配置
本节以修改钉钉日程为例进行智能助手配置。若仅需新增钉钉日程,则无需查看本章节,否则将重复建立日程,即新增 2 个日程。
6.1 添加智能助手
切换至「扩展功能」处,点击「新建智能助手」,并修改智能助手名称为「修改钉钉日程」。
6.2 设置触发动作
由于市场活动申报提交后,自动创建相关钉钉日程。故设置「触发动作」选择「新增数据」,「触发表单」选择「市场活动申报」,设置完成后点击「完成」。
6.3 设置执行动作
市场活动申报审批时,触发「钉钉日程增删改」插件,故执行动作选择「钉钉日程增删改」。
选择「新增日程」,根据企业信息以【字段值】方式,将「日程编号」、「发起人员」、「日程标题」、「开始时间」、「结束时间」、「日程地点」、「参与人员」、「日程描述」配置进去,设置完成后点击「完成」并「保存」。
5.4 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
6.1 日程参数与表单可用字段类型对照说明表
日程参数 | 表单可用字段类型 | 是否必传 | 备注 |
日程编号 | 单行文本 | 是 | 作为一个辅助字段用于储存钉钉的日程编号,无需其他配置,在钉钉日程创建后会自动将编号写入此字段;(以便修改、删除日程时进行对应) |
发起人员 | 成员单选 | 是 | 作为日程的发起人,仅能使用成员字段,以便对应钉钉的成员,且必须为成员单选字段,作为唯一发起人; |
日程标题 | 单行文本、多行文本、单选按钮组、复选框组、下拉框、下拉复选框 | 是 | |
开始时间 | 日期时间 | 是 | 因为日程需要精确到时分,因此要求年月日时分格式,若只传年月日,则时间默认为00:00; |
结束时间 | 日期时间 | 是 | |
日程地点 | 地址、定位、单行文本、多行文本、单选按钮组、复选框组、下拉框、下拉复选框 | 否 | 可以使用地址、定位等结构化字段,也可以使用各类文本字段; |
参与人员 | 成员单选、成员多选 | 否 | 作为日程的参与人,仅能使用成员字段,以便对应钉钉的成员; |
日程描述 | 单行文本、多行文本、单选按钮组、复选框组、下拉框、下拉复选框 | 否 | 注意:暂时不支持图片、附件等信息; |
6.2 关于辅助字段「日程编号」的说明
用于储存钉钉日程创建后的钉钉日程编号,以便在日程修改时、删除时进行数据的对应;无需其他配置,在钉钉日程创建后会自动将编号写入此字段;
- 已有业务表单使用此插件:需要增加一个单行文本的辅助字段「日程编号」;
- 新的业务表单使用此插件:搭建表单时就预留一个单行文本的辅助字段「日程编号」。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)