Jira

LaunchCal では、ローンチを、その作業を管理する Jira のエピック、または任意の課題に追従させられます。課題のステータスが変わるとローンチのステータスも変わり、エピックの子課題のうちいくつが完了したかが表示され、課題のコメントがローンチに表示されます。

Jira のプロジェクト全体には独自のステータスがないため、プロジェクトへのリンクは通常のリンクとして保持されます。追従させるには、そのエピックや課題を紐付けてください。

Taktoria は Jira から読み取るだけです（課題とそのステータス、子課題、コメント、そしてそれを書いた人の名前）。そこで何かを作成、変更したり、コメントしたりすることはありません。

Jira と連携できるのは、ワークスペースのオーナーか管理者だけです。

1. 設定 → 連携を開きます。
2. チケット管理システムの下でJira と連携を選択します。
3. Atlassian にサインインし、連携する Jira のサイトを選んで承認します。

Taktoria は、連携した Atlassian アカウントとして Jira を読み取ります。そのアカウントが見られる課題は、ローンチを編集できる人なら誰でもローンチに紐付けられ、そのコメントもローンチに表示されます。Jira でその課題を開けない人であっても同じです。そのため、ご自身のアカウントではなく、ローンチが追うプロジェクトだけを見られる Taktoria 専用のアカウントで Jira と連携してください。個人のアカウントで連携すると、その人が退職したりアクセスを失ったりしたときに同期も止まります。

ローンチを編集できる人なら誰でも、紐付け、同期、紐付けの解除ができます。

1. ローンチの詳細タブを開きます。
2. チケット管理のプロジェクトで、エピックや課題のアドレスをプロジェクトのリンクに貼り付けます。課題自体のページでも、その課題を開いたボードや一覧でもかまいません。
3. プロジェクトを紐付けを選択します。

課題は、連携している Jira のサイトにあり、連携したアカウントが見られるものである必要があります。すぐに同期されます。Jira と連携する前に貼り付けたリンクは通常のリンクとして保持され、連携した時点で同期が始まります。

LaunchCal に接続した AI アシスタントや REST API でも、同じルールでローンチの紐付け、同期、紐付けの解除ができます。

紐付けたローンチは、ローンチされるまで 1 日 1 回、また誰かが今すぐ同期を選択するたびに同期されます。

• ステータス：課題のステータスが変わると、ローンチのステータスも追従します。To Do は要件整理、進行中は開発中（すでにデザインかテストにあるローンチはそのまま）、「対応しない」や重複として完了した課題は停止中になります。LaunchCal で選んだステータスは、課題のステータスが次に変わるまで維持されます。
• 進捗：エピックの子課題のうち完了したものの割合です。
• コメント：課題のコメントはそれぞれ、ローンチのアクティビティタブのコメントになり、Jira からの印と元へのリンクが付きます。Jira で一部の人に制限されたコメントは取り込まれません。Jira で編集すると次回の同期で変更が反映されます。
• 完了：課題が完了すると、ローンチに準備ができたことが表示され、オーナーに通知されます。

同期による変更は、ローンチの履歴でも、オーナーへの通知でも、監査ログでも、Jira によるものとして表示されます。監査ログには、コメントが取り込まれたことや変わったことは記録されますが、その内容や誰の名前が挙がっているかは記録されません。

• 何かをローンチすることはありません。完了した課題はローンチを準備完了にするだけで、必須のレビューが決まったら、誰かが**押してローンチ！**を選択します。
• ローンチ済みのローンチを変更することはありません。
• Jira に書き込むことはありません。
• 一部の人に制限されたコメントを取り込むことはありません。
• LaunchCal で選んだステータスを元に戻すことはありません。課題のステータスが再び変わった場合を除きます。

ローンチの詳細タブの紐付けを解除で、そのローンチの同期が止まります。取り込まれた内容はそのまま残ります。

設定 → 連携の連携を解除で、Jira からのすべてのローンチの同期が止まります。ローンチは紐付けたものとそれまでに同期した内容を保持し、Jira と再び連携すると同期を再開します。Jira との連携を解除すると、Atlassian の要件に従い、取り込んだコメントから Jira ユーザーの名前も削除されます。コメントの本文は残りますが投稿者の名前は消え、メンションは @someone と表示されます。Atlassian からあるユーザーのアカウントが閉鎖されたと通知された場合も、その人の名前に同じことが行われます。

Atlassian には Taktoria が自ら Jira へのアクセスを取り消す手段がありません。完全に削除するには、Atlassian アカウントの接続済みアプリからも Taktoria を削除してください。

• 課題が見つからない：削除されたか、移動されたか、連携したアカウントが見られない場所にあります。そのアカウントに課題のプロジェクトへのアクセス権を与えるか、現在のアドレスを紐付けてください。
• Jira に連携を拒否された：ワークスペースのオーナーか管理者が設定 → 連携で Jira ともう一度連携します。連携したアカウントの人が退職したりアクセスを失ったりすると起こります。
• 前回の同期で Jira から応答がなかった：次回の同期で再試行されます。あとで今すぐ同期を選択することもできます。
• プロジェクト全体が同期されない：プロジェクトには独自のステータスがありません。代わりにそのエピックや課題を紐付けてください。
• コメントが見当たらない：Jira で一部の人に制限されたコメントは取り込まれません。