本文へスキップ

Jira インテグレーション

Threada を Jira に接続し、WorkItem からの統制された課題の作成と更新を、監査可能なワークフローのハンドオフとともに実現します。

概要

Jira インテグレーションにより、Threada は統制されたアクションとして Jira 課題を作成・更新できます。WorkItem のコンテキスト（Evidence、決定、ポリシー結果）が自動的に Jira に流れます。

機能

  • WorkItem のエスカレーションから構造化されたコンテキスト付きで課題を作成
  • 統制されたアクションから Jira 課題を更新（コメントの追加とトランジションの実行）
  • プロジェクト、課題タイプ、カスタムフィールドをマッピング
  • 関連する WorkItem と Evidence を Jira 課題にリンク
  • すべての課題操作の監査証跡

実例

Threada が Jira と実行する、端から端までのフローの一例です。

  1. リクエストがメール、Slack、またはフォームから届き、型付きスキーマと引用付きの Evidence を備えた統制された WorkItem になります。
  2. ポリシーが、その業務には追跡可能なエンジニアリングタスクが必要だと判断し、承認者が明示的な決定ステップを通じて承認します。
  3. Threada が統制されたアクションとして Jira の課題を作成します。プロジェクト、課題タイプ、フィールドがマッピングされ、WorkItem のコンテキストと Evidence が添付されます。
  4. Threada は統制されたアクションとして Jira 課題のトランジションを実行でき、すべての操作が WorkItem の監査証跡に記録されます。

セットアップ

Studio のパックガバナンス内でインテグレーションを設定します。プロジェクト単位の権限を持つ Jira API 認証情報を入力し、フィールドをワークフロースキーマにマッピングします。

  1. Studio で、パックガバナンスのもとに Jira 連携を追加します。
  2. Threada が書き込み可能な特定のプロジェクトに範囲を限定した Jira API 認証情報を入力します。
  3. Jira のプロジェクト、課題タイプ、カスタムフィールドを WorkItem スキーマにマッピングします。
  4. 接続を検証します。テスト書き込みが成功した後にのみ連携が有効化されます。

権限とデータアクセス

Jira では、Threada がホストする OAuth アプリではなく、お客様が提供する認証情報を使用します。

  • Threada は、お客様が提供する Jira API トークンで認証します。このトークンは書き込み可能な特定のプロジェクトに範囲を限定され、Secret Manager に保存されます。
  • Threada は Jira の REST API を呼び出して課題を作成・更新し、トランジションを実行します。Jira のステータスを WorkItem に読み戻すことはありません。
  • すべての課題操作は統制されたアクションとして実行され、WorkItem の監査証跡に記録されます。

よくあるご質問

Threada は Jira の課題を自動で作成しますか？
ポリシーのもとでのみ行います。課題の作成は統制されたアクションとして実行されるため、自動で実行されるか承認者を待つかは、お客様のポリシーオーバーレイによって決まります。Threada が作成するすべての課題は WorkItem のコンテキストを伴い、監査証跡に記録されます。
Threada は Jira のトランジションを WorkItem に読み戻しますか？
現時点では行いません。Threada は Jira への書き込み（統制されたアクションとしての課題の作成、コメントの追加、トランジションの実行）を行います。Jira のステータスを WorkItem に読み戻す受信同期は現在サポートしていません。
この連携にはどのようなアクセス権が必要ですか？
Threada が書き込み可能な特定のプロジェクトに範囲を限定した Jira API 認証情報です（最小権限）。接続は有効化の前に検証され、すべての課題操作はログに記録されます。
インテグレーションドキュメントを見る