钉钉日程增删改插件

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(微信同号)

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验