Jira

在 LaunchCal 中，发布可以跟随记录其工作的 Jira 史诗或任意问题。问题的状态变化时，发布的状态随之变化；发布会显示史诗下有多少子问题已完成，问题的评论也会出现在发布上。

整个 Jira 项目没有自己的状态，因此指向它的链接会作为普通链接保留：要跟随它，请关联其中的某个史诗或问题。

Taktoria 只从 Jira 读取（问题及其状态、子问题和评论，以及撰写者的名字）：它绝不会在那里创建、更改或评论任何内容。

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

1. 打开设置 → 集成。
2. 在工单系统下，选择连接 Jira。
3. 登录 Atlassian，选择要连接的 Jira 站点，然后批准。

Taktoria 以连接 Jira 的那个 Atlassian 账户的身份读取 Jira。该账户能看到的任何问题，都可以被任何能编辑发布的人关联到发布上，其评论也会显示在那里，即使此人在 Jira 中打不开这个问题。因此，请不要用你自己的账户，而是用一个专供 Taktoria 使用、只能看到你的发布所跟随项目的账户来连接 Jira。用个人账户建立的连接，在此人离职或失去访问权限时也会停止同步。

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

1. 打开发布的详情标签页。
2. 在工单项目下，把史诗或问题的地址粘贴到项目链接：可以是它本身的页面，也可以是打开了它的看板或列表。
3. 选择关联项目。

问题必须位于已连接的 Jira 站点上，并且是连接所用账户能看到的问题。关联后会立即同步。在 Jira 连接之前粘贴的链接会作为普通链接保留，连接后即开始同步。

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

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

• 状态：问题的状态变化时，发布的状态随之变化：待处理对应需求梳理，进行中对应开发中（已处于设计或测试的发布保持不变），以“不会处理”或重复为结果完成的问题对应已搁置。你在 LaunchCal 中选择的状态会一直保留，直到问题的状态再次变化。
• 进度：史诗下已完成子问题所占的比例。
• 评论：问题的每条评论都会成为发布动态标签页上的一条评论，标有来自 Jira并附有指向原文的链接。在 Jira 中仅限部分人查看的评论绝不会被带入。在 Jira 中修改后，下次同步会带来修改。
• 完成：问题完成后，发布会显示已就绪，并通知其负责人。

同步带来的更改会在发布的历史记录、发给负责人的消息和审计日志中显示为来自 Jira。审计日志只记录有评论进来或被修改，绝不记录评论的内容或其中提到的人。

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

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

设置 → 集成中的断开连接会停止所有发布从 Jira 的同步。发布会保留已关联的内容以及到那时为止同步的所有内容，并在 Jira 重新连接后继续同步。按照 Atlassian 的要求，断开 Jira 的连接还会从已带入的评论中移除 Jira 用户的名字：评论保留内容，但不保留作者的名字，提及显示为 @someone。当 Atlassian 告知某人的账户已关闭时，此人的名字也会这样处理。

Atlassian 没有为 Taktoria 提供撤销自身 Jira 访问权限的方式：要彻底移除，还请在你的 Atlassian 账户的已连接应用中移除 Taktoria。

• 找不到问题：它已被删除、移动，或位于连接所用账户看不到的地方。请为该账户开放其项目的访问权限，或关联它当前的地址。
• Jira 拒绝了连接：由工作区所有者或管理员在设置 → 集成中重新连接 Jira。连接它的账户离职或失去访问权限时就会这样。
• Jira 没有响应上次同步：下次同步会再试，或稍后选择立即同步。
• 整个项目没有同步：它没有自己的状态。请改为关联其中的某个史诗或问题。
• 缺少某条评论：在 Jira 中仅限部分人查看的评论绝不会被带入。