ClickUp
把 LaunchCal 的发布关联到它的 ClickUp 列表或任务,发布就会跟随它:状态、进度和评论,每天同步,也可随时手动同步。
ClickUp 在 Taktoria 中的作用
在 LaunchCal 中,发布可以跟随它在 ClickUp 中的工作:一个列表,或一个任务。工作的状态变化时,发布的状态随之变化;发布会显示完成了多少,其评论也会出现在发布上。
Taktoria 只从 ClickUp 读取:它绝不会在那里创建、更改或评论任何内容。文件夹或空间没有自己的状态,因此指向它们的链接会作为普通链接保留:要跟随它,请关联其中的某个列表或任务。
连接 ClickUp
只有工作区所有者或管理员才能连接 ClickUp。
- 打开设置 → 集成。
- 在工单系统下,选择连接 ClickUp。
- 登录 ClickUp,选择要连接的 ClickUp 工作区,然后允许。
Taktoria 以连接 ClickUp 的账户的身份,在那里选择的工作区中读取:该账户能看到的任何列表或任务,都可以被任何能编辑发布的人关联到发布上,其评论也会显示在那里。因此,请不要用你自己的账户,而是用一个专供 Taktoria 使用、只能看到你的发布所跟随工作的账户来连接 ClickUp。用个人账户建立的连接,在此人离职时也会停止同步。
把发布关联到列表或任务
任何能编辑发布的人都可以关联、同步或取消关联它。
- 打开发布的详情标签页。
- 在工单项目下,把列表(或其某个视图)或任务的地址粘贴到项目链接。
- 选择关联项目。
它必须位于已连接的 ClickUp 工作区中,并且是连接所用账户能看到的。关联后会立即同步。在 ClickUp 连接之前粘贴的链接会作为普通链接保留,连接后即开始同步。
连接到 LaunchCal 的 AI 助手和 REST API 也可以关联、同步和取消关联发布,规则相同。
同步什么,何时同步
已关联的发布在上线之前每天同步一次,有人选择立即同步时也会同步。
- 状态:列表没有自己的状态,因此由其中的任务决定:在有任务开始之前为需求梳理,有任务开始后为开发中(已处于设计或测试的发布保持不变),全部完成后即完成。任务由它自己的状态决定:未开始对应需求梳理,进行中对应开发中,已完成或已关闭即完成;但如果状态名称表明它已被放弃(won't do、cancelled、duplicate 等),则对应已搁置。
- 进度:列表中已完成的任务,或任务中已完成的子任务所占的比例。
- 评论:每条评论都会成为发布动态标签页上的一条评论,标有来自 ClickUp并附有指向原文的链接。
- 完成:工作完成后,发布会显示已就绪,并通知其负责人。
你在 LaunchCal 中选择的状态会一直保留,直到 ClickUp 中的状态再次变化。同步带来的更改会在发布的历史记录、发给负责人的消息和审计日志中显示为来自 ClickUp。
它绝不会做的事
- 它绝不会发布任何东西。工作完成只会让发布就绪;必需评审全部决定后,仍然需要有人选择按下发布!。
- 它绝不会更改已经发布的发布。
- 它绝不会写入 ClickUp。
- 除非 ClickUp 中的状态再次变化,它绝不会撤销你在 LaunchCal 中选择的状态。
取消关联和断开连接
发布详情标签页上的取消关联会停止该发布的同步;已同步过来的内容会保留。
设置 → 集成中的断开连接会停止所有发布从 ClickUp 的同步。发布会保留已关联的内容以及到那时为止同步的所有内容,并在 ClickUp 重新连接后继续同步。
ClickUp 没有提供让 Taktoria 撤回自身访问权限的方法:要彻底移除,请同时从连接它的 ClickUp 账户已连接的应用中移除 Taktoria。
故障排除
- 找不到列表或任务:它已被删除、移动,或位于连接所用账户看不到的地方。请为该账户开放访问权限,或关联它当前的地址。
- ClickUp 拒绝了连接:由工作区所有者或管理员在设置 → 集成中重新连接 ClickUp。连接它的账户离职或移除了 Taktoria 时就会这样。
- ClickUp 没有响应上次同步:下次同步会再试,或稍后选择立即同步。
- 被保留为普通链接:ClickUp 尚未连接,或者该地址是文件夹或空间的地址。请改为关联其中的某个列表或任务。