# タスクとPRをリンクする

## ユースケース

* PRを自動リンクして、タスクトラッカーでセキュリティ修正の可視性を向上させます。
* 各自動修正PRが正しいタスクに関連付けられていることを確認します。
* PRとタスク間のクリック可能な参照を有効にする

## それは何ですか？

タスクトラッカーを未解決のPull Requestと同期させるために、AutoFixは作成するPull Requestをタスクトラッカー内のタスクにリンクできます。AutoFixにはこれを実現する2つの仕組みがあります：

1. 課題のために作成されたタスクをPull Requestにリンクする
2. 開かれた各Pull Requestごとに新しいタスクを作成する

1の場合、次を設定する必要があります [自動タスク作成](https://help.aikido.dev/getting-started/task-management-systems) を課題に対して。2の場合、次を有効にする必要があります `PR 用タスクを作成` を [AutoFix PR構成](https://help.aikidogov.us/docs/docs-ja/autofix-and-remediation/configure/autofix-pr-configuration). ワークフローに応じて、1および/または2を有効にできます。

タスク参照プレースホルダー（`$TASK_REF` ）は次の [プルリクエスト設定](https://help.aikidogov.us/docs/docs-ja/autofix-and-remediation/configure/autofix-pr-configuration#pull-request-configuration) フィールドで使用できます：ブランチプレフィックス、コミットメッセージ、PRタイトル。

次の `$TASK_REF` は、PRで解決された課題にリンクされたタスクと、PRのために作成された新しいタスクで埋められます。もし `PR 用タスクを作成` そのオプションが有効な場合。

## 開かれた各Pull Requestごとに新しいタスクを作成する

各AutoFix PRごとにタスクを作成すると、AutoFix PRのレビューとマージを担当する人を割り当てるのに使えます。Enable "*PR 用タスクを作成*"をあなたの [AutoFixの設定](https://help.aikidogov.us/docs/docs-ja/autofix-and-remediation/configure/autofix-pr-configuration)。各AutoFix PRごとにタスクが作成されます。既存のタスクにリンクされているかどうかは関係ありません。

対応しているタスクトラッカー：

* Jira
* Jira Datacenter
* Linear
* Asana
* Azure Boards

## 既存のIssueタスクへのPull Requestのリンク

PRで修正された課題のタスク識別子は、既定でブランチ名に含まれます。ワークスペースがタスクトラッカーと統合されている場合、PRはタスクトラッカーによって対応するタスクに自動的にリンクされます。

## JiraとSCMを統合する方法

上記のとおり、AutoFixは `$TASK_REF` をPRに追加できます。ソースコード管理（SCM）プラットフォームとタスクトラッカーの間で連携を設定してください。するとトラッカーがタスク参照を検出し、PRをそのタスクにリンクします。

#### **GitHub → Jira**

**ステップ 1:** インストール [**GitHub for Jira**](https://github.com/marketplace/jira-software-github) をGitHub Marketplaceから。

**ステップ 2:** リンクしたいリポジトリへのアクセス権を付与します。

**ステップ 3:** Jira Cloudでは：

* 次へ移動します： **アプリ → アプリの管理 → GitHub for Jira → 設定**.
* GitHub組織に接続します。

**ステップ 4:** Aikidoでは、 `$TASK_REF` をPRタイトル設定で使用します。

**手順 5：** Jiraチケットキー：

* Jiraでクリック可能なリンクとして表示されます。
* GitHubのUIに表示されます（Jiraで表示するとクリック可能）。

***

#### **GitLab → Jira**

**ステップ 1:** GitLabでは：

* プロジェクト → **設定 → 統合 → Jira**.
* 次を入力します：
  * **Jira URL**: `https://yourcompany.atlassian.net`
  * **ユーザー名**：Atlassianのメールアドレス
  * **パスワード/APIトークン**：Atlassianアカウントから生成

**ステップ 2:** 統合を保存します。

**ステップ 3:** Aikidoでは、 `$TASK_REF` をPRタイトル設定で使用します。

**ステップ 4:** Jiraチケットキー：

* GitLab UIで自動リンク。
* Jiraの開発パネルを更新します。

***

#### **Bitbucket → Jira（Cloud）**

**ステップ 1:** Bitbucket Cloudでは：

* 次へ移動します： **設定 → リンク済みリポジトリ → Jiraプロジェクトをリンク**.
* Atlassianアカウントにサインインし、Jiraプロジェクトを選択します。

**ステップ 2:** Aikidoでは、 `$TASK_REF` をPRタイトル設定で使用します。

**ステップ 3:** Jiraチケットキー：

* Bitbucket UIで自動リンク。
* Jiraの開発情報パネルに表示されます。

***

#### **Azure DevOps → Jira**

**ステップ 1:** 次のようなAzure DevOpsとJiraの間のコネクタをインストールします：

* TFS4JIRA
* [Jira用Git Integration](https://marketplace.atlassian.com/apps/4984/git-integration-for-jira-azure-devops-github-gitlab)
* Exalate

**ステップ 2:** 選択したコネクタで、Azure DevOpsとJiraの両方のアカウントを承認します。

**ステップ 3:** チケットパターンを認識するようにコネクタを設定します（例： `ABC-\d+`).

**ステップ 4:** Aikidoでは、 `$TASK_REF` をPRタイトル設定で使用します。

**手順 5：** Jiraチケットキー：

* PRをJiraにリンクし、Jiraの開発パネルに表示されます。

## タスクを閉じる

Aikidoは、課題が解決または無視されたときにタスクを自動的に閉じることができます [Jira](https://help.aikido.dev/getting-started/task-management-systems/advanced-functionalities/auto-close-jira-tasks-when-aikido-issues-are-resolved) と [Linear](https://help.aikido.dev/getting-started/task-management-systems/advanced-functionalities/auto-close-linear-tasks-when-aikido-issues-are-resolved)。自動でタスクを閉じるが有効な場合、AutoFixはPRが閉じられたときに、作成したタスクを自動的に閉じます。