介绍
自动化提供开放灵活的规则指令，使用「触发场景+筛选条件 + 执行动作」的配置方式，实现节点流转、操作通知、字段值修改等场景的个性化操作。
也可以通过规则运行测试和执行记录功能，测试和查看规则配置效果
250px|700px|reset
基础概念
在使用飞书项目自动化前，我们需要了解一下自动化相关的基础概念。
流程图
自动化提供了易上手的界面化流程编辑，先命名，接着设置触发器，如果有条件选择条件，再接着设置操作是否通知、执行 Webhook 等操作。
250px|700px|reset
语义化
对流程图的语义化解释。
250px|700px|reset
触发器
在自动化配置中，触发器配置的是“在什么场景下触发”，也就是自动化触发的时机。
在某个场景下触发自动化规则，例如：
- 需求创建时触发。
- 需求的开发节点延期 1 天。
- 在某个时间点触发，例如每周一的早上 10:00。
- 项目排期变更时触发。
250px|700px|reset
条件
在自动化配置中，条件配置的是“需要满足什么条件”，也就是过滤出满足条件的任务列表。
对某条件下的实例执行自动化规则，例如：
- 对某条业务线下的需求进行通知
- 汇总未排期的需求列表
- 筛选出某个“人员”或“团队”参与的任务列表
- 汇总“前端开发”角色参与的需求到前端小组群
250px|700px|reset
操作
在自动化配置中，操作配置的是“执行什么操作”。
执行某个对应的操作，例如：
- 通知
- 修改或同步指定的字段值
- 将指定的节点状态修改为指定值
- 向指定的节点/角色分配人员
- 变更指定的工作项状态值
- 在当前空间中创建新的工作项
250px|700px|reset
运行测试
- 支持指定数据（如某个需求）测试一次自动化规则，所有操作会在当前空间真实生效，如字段、节点、状态、人员修改，创建工作项、群组
- 如果卡片配置了拆分规则，如定时循环-个人仅收到当前负责人为自己的卡片，在运行测试的时候不会生效，收到的是符合条件值的数据集卡片
支持用户手动触发运行自动化规则，自行检测规则运行是否符合配置预期，如测试「定时循环通知卡片效果」，操作步骤：
- 点击规则页面对应操作
- 点击右上方的运行页面
- 点击运行或选择运行数据后点击运行
业务实践场景 | 配置截图 |
查看飞书通知是否符合预期 用户配置完成了定时任务的卡片，想看下自己配置的筛选条件是否准确，以及卡片的展现效果是不是符合自己的预期。 支持用户手动触发定时任务通知，对应卡片即刻可推送至个人账号，查看对应的卡片效果，若不符合预期即刻可调整规则再次测试，提升规则配置效率 | 250px|700px|reset |
查看自动化操作是否会生效 用户配置完成了缺陷和关联执行用例同步的规则，想看下对应规则生效以后的字段值同步效果。 支持用户在规则配置中直接调起对应符合规则配置的当前空间实例，查看当前规则下的执行效果是否符合预期。 | 250px|700px|reset |
执行记录
- 点击空间配置>自动化>右上角的 执行记录 按钮，可查看所有规则的运行情况。
- 点击编辑自动化规则> 上方的执行记录页面，也可以查看对应规则的运行情况。
注：只支持查询本功能上线时间后的执行日志，且日志查询上限为最近30天
使用场景
操作记录支持按照分支+节点查看执行成功/失败的明细
1）若规则未触发，则执行记录不展现
2）若规则触发但未执行操作，对应触发节点执行成功，但操作节点执行失败，支持查看具体节点未执行/执行失败的原因
业务实践场景 | 配置 | 图示 |
查找自动化通知对应的规则名称 可查看所有规则的运行情况 | 场景：收到了飞书通知，想知道是哪个规则触发的通知 排查：点击空间配置>自动化>右上角的 执行记录 按钮，通过触发时间筛选对应的规则名称 | 250px|700px|reset 250px|700px|reset |
自动化规则未生效排查 操作记录支持按照分支+节点查看执行成功/失败的明细 | 场景：配置了消息通知，如节点流转通知，但实际未收到通知 排查：对应的需求未满足条件配置 | 250px|700px|reset |
自动化部分数据未生效排查 执行记录支持查看触发/操作对应的工作项list | 场景：配置了一个定时任务进行批量的字段修改，查看哪些工作项同步成功 | 250px|700px|reset |
规则未生效排查方法
场景一：无执行记录
若对应规则无执行记录，则说明规则未被成功触发，即触发器配置有误或未满足触发条件
场景二：显示执行成功，但规则未生效
- 显示执行成功但未满足筛选条件，操作不会生效，需排查条件配置
- 飞书通知执行成功但无执行对象，可通过下面方法排查
常见原因 | 排查方法 | 图示 |
不满足筛选条件组 |
| 250px|700px|reset |
|
| 250px|700px|reset |
飞书通知-消息ID-无执行对象 |
举个例子：
| 250px|700px|reset 250px|700px|reset |
|
在具体需求-详情页-查看角色上是否有人，或者使用的是否为角色人员控件上的角色，而不是自定义字段 如：节点流转通知给角色PM，PM上没填具体的人，就不会通知 | 250px|700px|reset |
场景三：显示执行失败或部分成功
可通过下列操作及常见失败原因进行排查
操作分类 | 失败原因 | 排查方法 |
飞书通知 | 操作人主动关闭消息通知 | - |
| 批量数据操作关闭消息通知 | 勾选了「批量修改时,关闭消息通知」 250px|700px|reset |
| 数据导入关闭消息通知 | 导入数据时，勾选了「本次导入关闭消息通知」 250px|700px|reset |
| 计算字段变更自动化关闭消息发送 | - |
| 构造卡片失败 | - |
| 发送卡片失败，状态码：xxxx | - |
| 接收人不在飞书项目机器人的可用范围内，或者是在禁用范围内 | 250px|700px|reset 250px|700px|reset |
| 用户已设置不再接收机器人消息 | - |
| 飞书项目机器人不在接收群内 | 在群「···」-设置-群机器人-查看是否有「飞书项目」机器人 注：字节内部为「Meego项目管理」机器人 250px|700px|reset |
| 当前时间不在配置的发送时间范围内（如跳过节假日） | 自动化规则-飞书通知-勾选了「工作日通知设置，跳过法定节假日及周六日」 250px|700px|reset |
webhook | 自动化系统异常 | - |
| 操作人主动关闭消息通知 | - |
| 批量数据操作关闭消息通知 | 勾选了「批量修改时,关闭消息通知」 250px|700px|reset |
| 数据导入关闭消息通知 | 导入数据时，勾选了「本次导入关闭消息通知」 250px|700px|reset |
| 计算字段变更自动化关闭消息发送 | - |
| 商业化额度不足 | Webhook 每日触发次数
|
| 失败次数过多被熔断 | - |
| 调用webhook地址失败，状态码：xxxx | - |
字段修改 | 不符合目标字段的选项匹配策略（选项id一致才可匹配成功） | 配置选项字段同步，需选项id一致才可成功；在空间配置-工作项管理-工作项（如需求）-字段管理-字段-查看选项-高级配置，可查看 如优先级字段，必须两个工作项「P0」选项的id一致才能同步 已配置的选项id无法修改，可通过新建字段-复用已有字段选项或新建选项来实现一致 250px|700px|reset 250px|700px|reset |
| 不符合目标字段的字段范围（包含多选关联字段/多选丢弃部分无效值） | 确认字段管理-关联字段-数据可见范围，比如配置了数据范围不等于已归档，已归档的不会同步 250px|700px|reset |
| 工作项实例不存在 | - |
人员分配 | 不符合目标人员的限制范围 | - |
| xx角色在实例中不可见，无法更新人员值 | 点击详情页-角色与人员控件，确认该需求对应角色是否默认出现，如未出现，可通过批量修改-参与人员-角色-批量添加角色 250px|700px|reset |
| 工作项实例不存在 | - |
状态/节点流转 | 未满足节点/状态流转条件（具体的必填项填写完整、多人确认节点等） | 点击详情页-对应节点
|
| 需流转的节点/状态暂未到达 | 点击详情页-对应节点，看节点是否未未开始（置灰），未到达的节点无法流转成完成 250px|700px|reset |
| 工作项实例不存在 | - |
FAQ
自动化可以实现定时导入数据么？
不支持。
