Asana

在 LaunchCal 中，发布可以跟随存放其工作的 Asana 项目。随着项目中的任务完成，发布的状态随之变化；发布会显示有多少任务已完成，项目被标记为完成后，发布即完成。

Taktoria 只从 Asana 读取：它绝不会在那里创建、更改或评论任何内容。任务、项目组合或目标在这里没有自己的状态，因此指向它们的链接会作为普通链接保留。

只有工作区所有者或管理员才能连接 Asana。

1. 打开设置 → 集成。
2. 在工单系统下，选择连接 Asana。
3. 登录 Asana 并允许。

Taktoria 只向 Asana 申请读取项目、人员和工作区的权限，并以连接它的 Asana 账户的身份，在该账户所属的每个 Asana 工作区中读取。该账户能看到的任何项目，都可以被任何能编辑发布的人关联到发布上，其进度也会显示在那里。因此，请不要用你自己的账户，而是用一个专供 Taktoria 使用、只能看到你的发布所跟随项目的账户来连接 Asana。用个人账户建立的连接，在此人离职时也会停止同步。

任何能编辑发布的人都可以关联、同步或取消关联它。

1. 打开发布的详情标签页。
2. 在工单项目下，把项目或其某个视图的地址粘贴到项目链接。
3. 选择关联项目。

项目必须是连接所用账户能看到的项目。关联后会立即同步。在 Asana 连接之前粘贴的链接会作为普通链接保留，连接后即开始同步。

连接到 LaunchCal 的 AI 助手和 REST API 也可以关联、同步和取消关联发布，规则相同。

已关联的发布在上线之前每天同步一次，有人选择立即同步时也会同步。

• 状态：在项目中有任务完成之前为需求梳理，之后为开发中（已处于设计或测试的发布保持不变）。被标记为完成的项目即完成。
• 进度：项目中已完成任务所占的比例。
• 完成：项目被标记为完成后，发布会显示已就绪，并通知其负责人。

项目的状态更新不会同步过来：Asana 不允许像 Taktoria 这样只读的应用读取它们。你在 LaunchCal 中选择的状态会一直保留，直到项目的状态再次变化。同步带来的更改会在发布的历史记录、发给负责人的消息和审计日志中显示为来自 Asana。

• 它绝不会发布任何东西。项目完成只会让发布就绪；必需评审全部决定后，仍然需要有人选择按下发布！。
• 它绝不会更改已经发布的发布。
• 它绝不会写入 Asana。
• 除非项目的状态再次变化，它绝不会撤销你在 LaunchCal 中选择的状态。

发布详情标签页上的取消关联会停止该发布的同步；已同步过来的内容会保留。

设置 → 集成中的断开连接会停止所有发布从 Asana 的同步，并撤销 Taktoria 在那里的访问权限。发布会保留已关联的内容以及到那时为止同步的所有内容，并在 Asana 重新连接后继续同步。

• 找不到项目：它已被删除，或连接所用账户看不到它。请为该账户开放它的访问权限，或关联它当前的地址。
• Asana 拒绝了连接：由工作区所有者或管理员在设置 → 集成中重新连接 Asana。连接它的账户离职或失去访问权限时就会这样。
• Asana 没有响应上次同步：下次同步会再试，或稍后选择立即同步。
• 没有同步过来状态更新：Asana 不允许只读的应用查看它们。发布改为跟随项目的任务和完成情况。
• 被保留为普通链接：Asana 尚未连接，或者该地址是任务、项目组合或目标的地址，而不是项目的地址。