Solavel 文档
中文

自动化

最后更新

自动化选项卡包含项目的自动化规则。每条规则具有一个触发器(项目中发生的事件)、可选的条件(对此事件的检查)和一个或多个操作(SolaProjects 执行的动作)。触发器触发且所有条件均满足时,各项操作一起执行,结果记录在最近运行中。

用自动化减少团队的日常跟进工作:清单完成后将任务转入审核、为变得紧急的任务添加评论、工作受阻时记录风险,或提醒团队处理逾期工作。规则由项目经理和管理员设置;团队其他成员只会看到规则产生的评论、状态变更和活动记录。

#哪里可以找到

侧边栏 项目区域(位于项目选择器下方)→ 自动化(位于规划与集成之间)
URL /projects/{project}/automations
命令面板 自动化 · {project name},位于当前项目之下

由谁查看:

  • 计划:自动化属于 Professional 计划,也包含于 Premium 和 Enterprise。Free 和 Standard 隐藏侧边栏标签,避免展示会拒绝访问的页面。付费计划到期后标签隐藏,续订后恢复,规则会保留。
  • 角色:此标签仅供管理使用,只有有项目编辑权的人可加载(见权限)。其他人直接打开 URL 会看到“无法加载自动化。”及重试。

#屏幕导览

该页面是一列卡片。

#自动化卡片(顶部)

元素 显示内容
标题 自动化 — 触发器 → 条件 → 操作规则。
新建自动化(右上角) 打开规则表单。仅在您可以编辑规则时显示。
规则 规则数(已归档的规则不计入)。
活跃 规则已启用。
运行记录 项目规则的每次已记录运行(成功、跳过和失败)。
失败 失败的运行。大于零时显示为红色。

#使用情况卡片

至少存在一条规则时显示。标题为使用情况——按记录的执行次数排列的最活跃规则。最多列出运行次数最多的五条规则:运行 {n} 次 · 失败 {n} 次 · 上次运行 {date}。

#规则卡片

标题 规则 — 启用/禁用、编辑或归档每条规则。 徽章显示数量。规则按最近修改时间排列,最新的在前。

每张规则卡片:

部件 含义
名称 规则名称。
摘要行 触发器(例如 任务优先级已更改)· {n} 次运行 · {n} 次失败(如有)· 最近 {date}。
徽章 启用(绿色)或 暂停。
描述 您的备注(如已输入)。
错误行 ⚠ 最后一条错误消息,适用于规则存在失败且其最近一次运行失败的情况。成功或跳过的运行会清除该消息。
编辑 打开编辑自动化。
暂停 / 恢复 开启或关闭该规则。
存档 确认后,将该规则从列表中移除。

空状态:暂无自动化 — 创建规则,或从下方的预设开始。(只读用户会看到尚未配置任何自动化规则。)

#预设卡片

标题为预设 — 从现成方案开始,保存前请审核。每项预设显示名称和触发器,点击打开预填表单,仅有规则编辑权时可见。

#最近运行卡片

标题 最近运行 — 最新的自动化执行记录(成功 / 跳过 / 失败)。 显示最近 20 次运行。

列 含义
触发时机 运行日期。
规则 规则名称。
触发器 触发的触发器。
状态 成功(绿色)、已跳过(琥珀色——条件不匹配)或 失败(红色)。
行动 已执行的操作数(跳过和失败的运行为 0)。
错误 运行失败的原因,或 —。

空状态:尚无运行记录 — 触发器触发后,自动化运行记录将显示在此处。

没有“立即运行”按钮,也没有导出;规则仅在其触发器触发时运行。

#触发器

触发器 列表显示以下值(按界面显示的标签):

触发器 触发时机 可在条件中测试的字段
任务已创建 在项目中创建任务,包括通过项目 API 创建。 task_id, user_id, status, priority, assigned_to
任务已更新 通过任务表单或表格内联编辑任务。 changed_fields, before.*, after.* (e.g. after.status)
任务状态已变更 任务状态变更——任务表单、看板拖动或批量状态变更。 old_status, new_status
任务优先级已更改 优先级更改——任务表单或批量优先级更改。 old_priority, new_priority
任务已分配 任务分配了新的负责人。 old_assigned_to, new_assigned_to
任务已阻塞 在表单中将任务标记为阻塞。 blocked_reason
清单已完成 任务清单中最后一个未完成的项目已被勾选。 task_id
文档已创建 已创建项目文档。 visibility (internal, client_visible)
收集表单已提交 有人提交了项目的公开登记表单。 —
Playground 物品已转换为任务 Playground 项目已转换为任务。 task_id
工时记录已创建 工时记录在项目或任务上。 duration_minutes, entry_date, is_billable, user_id, task_id
任务已逾期 基于时间:未完成任务的截止日期已过。 days_overdue, due_date, assigned_to
任务明天到期 基于时间:未完成任务的截止日期为明天。 due_date, assigned_to

值格式:状态为状态类型(backlog、todo、in_progress、review、done、cancelled);优先级为 none、low、medium、high、urgent;人员为数字用户 ID。

批量编辑。一次更改多个任务的状态或优先级时,每个值实际发生变化的任务都会分别触发一次运行。批量阻塞还会为每个变为阻塞状态的任务触发任务已阻塞,与在任务表单中逐个阻塞的效果相同(自 2026 年 10 月 5 日起;此前批量阻塞不会运行任何规则)。无论批量还是逐个解除阻塞,都不会触发任何触发器。

时间触发器。任务逾期和任务明天到期由定时作业检查,而非由用户操作触发。每次检查针对每条规则最多查看 250 个未完成任务(到期最早的优先),且同一规则每天对每个任务最多执行一次。已完成和已取消的任务会被忽略。

#条件

每条条件都有字段、运算符和值。所有行都须匹配,表单以“all”列表保存。没有条件行时显示“无条件。每次触发事件发生都会运行此规则。”

操作员 匹配条件
等于 / 不等于 该字段是(不是)该值。5 和 "5" 视为相等。
在岗 / 不在岗 字段值在或不在值列表中。列表用逗号分隔,例如 high, urgent;各项两侧空格会被忽略,数字按文本匹配(5 等于 "5")。2026年10月5日之前,逗号列表不会拆分,因此无法匹配。
为空 / 不为空 该字段无值 / 有值(忽略值框)。0 视为空。
大于 / 小于 两者均为数字,且该字段值较大/较小。

值会被精确比较:urgent,而不是 Urgent。如果条件不匹配,该运行会被记录为已跳过,且不会有任何变化。

#行动

选择操作类型,并在框中输入其值(占位符 "描述、值、负责人 ID、状态或优先级")。

行动 价值 发生的事情 如果为空
更新任务状态 状态类型,例如 review 将任务移至项目中该类型对应的状态。“已完成”类状态会将进度设为 100% 并记录完成时间;其他状态则将进度上限设为 99%。 review
更新任务优先级 none … urgent 设置优先级。任何其他值都会导致运行失败。 high
指派任务 数字用户 ID 分配任务。该人员必须在项目的团队中。 失败
标记任务为已阻塞 原因 以该原因将任务标记为受阻。 自动化已将此任务标记为受阻。
标记任务为未阻塞 — 清除阻止标记及原因。 —
添加任务评论 文本 添加一条 内部 评论,由规则创建者署名。 自动化说明。
设置为客户可见 true / false (0, no 也表示否) 向访客显示或隐藏该任务。 true
记录活动 描述 在任务或项目的活动中写入一条记录。 自动化规则已运行。
创建项目文档 标题 在 文件 中创建一个以该标题命名的内部备注文档。 自动化说明
创建提醒活动 描述 在活动中写入一条提醒记录。 自动化提醒。

操作规则:

  • 任务操作必须有任务。文档已创建和收集表单已提交没有任务,应搭配记录活动、创建提醒活动或创建项目文档;使用任务操作会导致运行失败。
  • 一次运行中的所有操作要么全部成功,要么全部不保留。失败时,该次运行会记为失败并附上错误,同时在活动中添加自动化规则“{name}”失败:…。
  • 自动化所做的更改不会触发其他自动化,因此规则不会形成循环。

#任务

#创建规则

  1. 打开项目 → 自动化 → 新建自动化(右上角)。

  2. 填写新建自动化:

    字段 必填 规则 / 默认设置 注释
    名称 是的 最多 160 个字符。 显示在卡片上和运行记录中。
    描述 否 最多 5,000 个字符。 给您团队的备注。
    触发器 是的 上述触发器之一。默认为 已创建任务。
    条件 否 每行添加条件;删除会删除一行。 字段为空的行将被丢弃。
    行动 是的 至少一项;以 记录活动 / 自动化规则已运行。 开始。添加操作 可添加行;最后一行无法删除。
    活跃 — 默认勾选。 取消勾选可保存为暂停状态的规则。
  3. 可选:检查参考行(操作员:和操作类型:),并展开JSON 预览以查看将要保存的确切内容。

  4. 点击创建。您会看到自动化已创建。

错误显示在对话框顶部:名称必填。操作必填。条件必须是有效 JSON。每项操作必须包含支持的类型。取消会关闭而不保存。

#从预设开始

  1. 在预设中点击一个方案。表单会打开,并显示其名称、触发条件、条件和操作,且启用已勾选。
  2. 调整后点击 创建。
预设 触发器 条件 行动
紧急任务警告 任务优先级已更改 new_priority 等于 urgent 评论 自动化备注:此任务现已紧急。;记录 自动化检测到紧急工作。
已完成清单移至审核 清单已完成 — 将状态更新为 review
阻塞任务风险日志 任务已阻塞 — 记录 自动化记录了被阻止任务的风险。
访客文档更新日志 文档已创建 visibility 等于 client_visible 记录 自动化记录了访客可见的文档更新。
想法草稿已转换 Playground 物品已转换为任务 — 评论 自动化备注:此任务来自 playground 规划室。

#编辑规则

  1. 点击规则卡片上的编辑。编辑自动化会以已保存的数值打开。
  2. 更改任意内容后,点击保存。您会看到自动化已更新。

#暂停和恢复

点击 暂停——自动化已暂停。,徽章显示 已暂停。点击 恢复——自动化已恢复。 不会要求确认。暂停的规则不会触发,之后也不会补执行。

#归档规则

  1. 点击归档。
  2. 确认 归档自动化 ——“此自动化将停止在项目中运行。”
  3. 您会看到“自动化已归档。”该规则将从列表中移除,且无法在此处恢复;其过往运行记录保留在最近运行中,并计入运行次数。

项目的每次创建、更新、暂停/恢复和归档都会记录在项目的活动中。

#状态与生命周期

规则状态 含义 允许
活跃 由其触发器触发。 编辑、暂停、归档
已暂停 保留但从不触发。 编辑、恢复、归档
已存档 已隐藏;永久停止。 — (保留历史记录)
运行状态 含义
成功 条件匹配;所有操作均已执行。
已跳过 条件不匹配。
失败 操作失败;该次运行中的任何内容均未保留。

#权限

角色 打开该选项卡 创建 / 编辑 / 暂停 / 归档
组织所有者 是的 是的
项目管理员 是的 是的
在此担任项目经理的项目经理 是的 是的
未具备项目经理角色的项目经理、项目成员、项目查看者、访客 否(无法加载自动化。) 否

如果门户限制拒绝此项目的编辑项目权限,即使属于上述角色也会失去访问权限。如果组织已关闭规则编辑,页面为只读(没有新建自动化、编辑、暂停/恢复、归档或预设)。保存被拒绝时显示“自动化编辑已禁用,或您无权编辑。”或“您无权执行此操作。请联系工作区管理员。”;页面过期时显示“请重新加载后再试。”

操作以规则创建者的身份执行(评论、活动记录),与触发事件的人无关。

#操作示例

#示例 1 — 检查清单完成 → 审核(日常)

{User 1 name} 管理 {Showroom project name}(DEMO-FIT)。她点击预设 → 已完成清单移至审核 → 创建。随后 {User 2 name} 在 ALN-12 上勾选了细木工质检清单的最后一项。ALN-12 移至审核,而最近运行显示已完成清单移至审核 · 清单已完成 · 成功 · 1。

#示例 2 — 紧急升级,包含批量编辑和一次故障(完整场景)

{User 2 name} 希望将紧急任务升级给 {User 1 name}(用户 ID 214)。

  1. 新建自动化:名称 紧急工作转入审核;触发器 任务优先级已更改;条件 new_priority 等于 urgent。
  2. 操作:更新任务状态 review;添加任务评论 已升级:请今天审核。;分配任务 214。创建 → 自动化已创建。
  3. 次日早上他选中六项任务,并批量将优先级设为紧急。其中四项原为高,两项已是紧急。
结果 价值
已添加的运行 4 次(每个已更改的任务触发一次;两个未更改的任务不触发任何操作)
四项任务中的每一项 状态 审核中,内部备注,负责人 {User 1 name}
页眉 规则 2 · 启用 2 · 运行 5 · 失败 0
  1. 一周后,{User 1 name} 离开项目团队。下一次升级处理显示失败 — 自动化负责人必须是项目成员。任务状态和评论均不会更改(全部成功或全部回滚);规则卡显示 ⚠ 错误,失败以红色显示1,活动记录该次失败。
  2. {User 2 name} 编辑该规则,将 指派任务 设为新负责人的 ID,点击 保存 → 自动化已更新。。下一次运行成功,错误行随之清除。

#示例 3 — 逾期提醒

规则:任务逾期,条件 days_overdue 大于 2,操作创建提醒活动 逾期超过 2 天——催促供应商。计划检查每天运行时,逾期超过两天的任务会获得一条提醒记录;逾期 1–2 天的任务会记录为已跳过。

#连接方式

位置 链接
任务 任务事件是主要触发器;操作会更改任务。
活动 规则变更、失败信息、记录活动和提醒都会显示在那里。
文件 文档已创建 触发器;创建项目文档 操作。
工时跟踪 已创建工时记录 触发器。
创意空间 Playground 条目已转换为任务触发器。
团队访问 接收表单会触发已提交接收表单;被指派人必须是团队成员。
访客共享链接 设为客户可见控制访客能看到的内容。
集成 Webhook 将事件发送到 SolaProjects 之外;自动化则在其内部执行操作。

#提示与常见问题

问题 原因 解决方法
侧边栏中缺少该标签页。 套餐低于 Professional,或付费套餐已过期。 在门户中升级/续订。
无法加载自动化。 您无法编辑此项目。 请咨询项目经理或管理员。
运行始终显示 已跳过。 字段名称或值不完全匹配。 检查拼写和大小写(urgent、new_priority)。
进入与high,urgent永远不匹配。 表单只保存一个值,而不是列表。 使用 等于 设置单独的规则。
自动化指派对象必须是项目成员。 用户 ID 不在项目团队中。 在团队中添加他们,或更改 ID。
状态操作失败。 项目中不存在该类型的状态。 请使用看板上已有的类型。
任务操作在“单据已创建 / 接收”阶段会失败。 这些触发器没有任务。 使用活动或文档操作。
逾期规则今天未重复触发。 按设计,每个任务每天仅一次。 —
另一条规则作出更改后,本规则未触发。 自动化变更不会触发规则。 将两个操作放在同一条规则中。