> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 日程

> 本文介绍了如何通过宜搭表单和钉钉集成自动化功能来自动创建日程，包括创建表单、配置集成与自动化以及提交表单等步骤，适用于公司会议准备等场景。

## 使用场景

如公司每月月底都需要召开全员总结大会，需要提前进行会务准备。会务组成员需要为自己创建日程便于提醒。现在通过宜搭的表单的填写与提交，即可自动为其在钉钉上创建日程。可将待办事项写入到钉钉日历并在钉钉日历中展示。

## 实现效果

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637313207842-96bd6dbc-77ed-4305-a18c-9c87f468cdd5.png)
</Frame>

图3-1 连接器实现自动创建钉钉日程

## 步骤一：表单的创建与配置

创建表单，用于录入日程相关信息，并作为触发连接器功能的数据来源。

**操作步骤：**

1. 新建表单，命名为「日程信息登记」。
2. 在表单内分别添加两个日期组件，分别命名为「日程开始时间」和「日程结束时间」，将格式设置为「年-月-日 时:分」，设置为必填项。（操作如图2.1-1 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645684526431-2cda5bcb-2c7a-40f4-bb24-3d551da3fe73.png)
</Frame>

图2.1-1 添加并配置日期组件

3. 添加一个成员组件，命名为「参与人」，开启多选模式，设置为必填项。（操作如图2.1-2 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645684699388-4f6901fb-3bb0-445a-8452-a6c29f40d66b.png)
</Frame>

图2.1-2 添加并配置成员组件

4. 添加一个单行文本组件，命名为「日程标题」，设置为必填项。（操作如图2.1-3 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645684836629-301c9eaf-cacf-418e-96e4-334f613c9e8d.png)
</Frame>

图2.1-3 添加并配置单行文本组件

5. 添加一个多行文本组件，命名为「日程备注」。（操作如图2.1-4 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645684955506-3dc75dc2-d835-41f5-b1f8-e406436b351a.png)
</Frame>

图2.1-4 配置多行文本组件并保存表单

6. 添加一个成员组件，命名为「日程组织者」，状态设置为只读，默认值设置为公式编辑，在公式编辑对话框中添加 USER() 公式，最后设置为必填项，点击保存，即可。（操作如图2.1-5 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645685541987-fe8161f1-b0cc-49c9-af16-3406a01a8927.png)
</Frame>

图2.1-5 添加并配置成员组件

## 步骤二：创建集成&自动化

提交表单时，系统自动为指定人员发起日程，因此我们需要配置连接器。

**操作步骤：**

1. 后台管理页面 >> 集成&自动化 >> 新建集成&自动化 >> 从空白新建（操作如图2.2-1所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645685914071-a33f9ac5-0008-42e2-95b7-0a8035fe0eeb.png)
</Frame>

图2.2-1 连接器入口

2. 新建集成&自动化 >> 命名连接器为「创建日程」>> 表单事件触发类型下选择「日程」表单 >> 确定。（操作如图2.2-2 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1645686082782-053cf34c-adf4-4cf2-a19d-4b05ed585d2b.png)
</Frame>

图2.2-2 新建连接器

## 步骤三：配置集成&自动化

1. 点击选中「表单事件触发」，在触发事件中选择「创建成功」， 数据过滤选择「全部数据」。最后，点击右下角保存按钮，即可。（操作如图2.2-3 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637312623030-3988b102-535b-4193-8dcb-e63f97d4043f.png)
</Frame>

图2.2-3 配置表单事件触发

2. 配置「连接器」节点，在选择应用中选中「日程」，并点击下一步按钮。（如图2.2-4 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1721728193890-d80da5f5-ac51-4747-98e6-0c5582a3cb9c.png)
</Frame>

图2.2-4 配置连接器-步骤一：选择应用

2. 在选择执行动作中选中「创建日程」执行动作，点击下一步按钮。（如图2.2-5 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637312839901-6f8e57b7-469c-4722-9c6c-493f0f131ac3.png)
</Frame>

图2.2-5 配置连接器-步骤二：选择执行动作

3. 在配置执行动作中对各个配置项进行配置，点击保存。（如图2.2-6 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637312923878-ec1191ca-45bf-42a2-9198-f0c0874b6807.png)
</Frame>

图2.2-6 配置连接器-步骤三：配置执行动作

4. 点击页面右上角保存后，点击发布即可。

## 步骤四：配置待办任务内容

通过上述两个步骤，我们实现功能的配置工作已经完成，接下来，只需提交表单即可触发连接器，从而在指定的时间节点为指定的人员创建日程，并在指定的时间节点关闭日程。

**操作步骤：**

填写表单内容，点击提交，即可。（操作如图2-3 所示）

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1637313053904-3ff8177f-c4e5-472c-a106-1ec949df7126.png)
</Frame>

图2-3 录入表单信息并提交

## 附录：连接器执行动作参数说明

| **名称** | **页面组件** | **是否必填** | **描述**                                           |
| ------ | -------- | -------- | ------------------------------------------------ |
| 日程标题   | 文本组件     | 是        | 日程标题，最大不超过2048个字符。                               |
| 备注     | 文本组件     | 否        | 日程描述，最大不超过5000个字符。                               |
| 参与人    | 成员组件     | 是        | 参与人列表，最多支持选择500位参与人。                             |
| 开始时间   | 日期组件     | 是        | 日程开始日期，格式：yyyy-MM-dd HH:mm:ss                    |
| 结束时间   | 日期组件     | 是        | 日程结束日期，格式：yyyy-MM-dd HH:mm:ss。**注**：结束时间应晚于开始时间。 |
| 日程组织者  | 成员组件     | 是        | 日程创建者，可以通过userId()公式获取。                          |
