> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/hajimeni/task-management-systems/map-aikido-data-to-jira-custom-fields.md).

# Aikido のデータを Jira のカスタムフィールドにマッピングする

#### **カスタムフィールドマッピングを使う理由:**

* **必須フィールド:** Jiraの課題タイプに必須のカスタムフィールドがある場合、Aikidoはそれらに値をマッピングしないとチケットを作成できません
* **より豊富なチケットデータ:** 重大度、SLAの日付、チームなどのAikidoデータをJiraのフィールドに直接送信できます
* **Jira自動化:** マッピングしたフィールド値を使って、ワークフローの起動、チケットの振り分け、優先度の自動設定を行えます

#### **シンプルな設定**

* Jiraに表示されているとおりに、Jiraのフィールド名をそのまま入力するだけです
* フィールドID、APIの参照、特別な書式は不要です
* 固定値の場合は、読みやすい名前だけをプレーンテキストで使用してください

#### **対応しているJiraのフィールドタイプ:**

* 自由記述: `短いテキスト` `段落`
* リンク: `URLフィールド`
* 選択フィールド: `選択リスト（単一選択）`
* 複数選択フィールド: `選択リスト（複数選択）`
* 数値: `数値フィールド`
* 日付: `日付ピッカー`
* 日時: `日時ピッカー`

#### フィールドマッピングを設定

1. 次へ移動 [**統合** > **Jira** > **Jiraフィールドマッピング**](https://app.aikido.dev/settings/integrations/tasktracker/fields/custom) をクリックします **フィールドを追加**<br>

   <figure><img src="/files/13325d402fa210175f2c3ca709a70c6447cb3c38" alt=""><figcaption></figcaption></figure>
2. Jiraのカスタムフィールド名を **カスタムフィールド** 入力欄に、Jira上に表示されているとおりに正確に入力してください
3. Aikidoのショートコード（例: `$SEVERITY`）または固定テキスト値を **Aikidoの値** 入力欄に入力してください<br>

   <figure><img src="/files/8ee9114813116d5cfd7d2b3652bd46be8a52b863" alt=""><figcaption></figcaption></figure>
4. をクリック **変更を保存**

その **プレビュー** 列には、Jiraに送信される値が表示されます。これらはショートコードに基づく値、または固定値／自由記述の値にできます。

#### Aikidoの値: 固定テキスト vs ショートコード

**オプション1: 自由記述で固定値をJiraに送信**

一定の値を設定するには、ショートコードの代わりにプレーンテキストを入力します。読みやすい名前だけを使えばよく、JiraのIDや特別な書式は不要です。

たとえば、 `セキュリティ` と入力すると、Aikidoから作成されるすべてのチケットで、そのJiraフィールドに「Security」が設定されます。

**オプション2: ショートコードでAikidoの値をJiraに送信**

ショートコードは、Aikidoの課題からデータを取得するプレースホルダーです。Jiraチケットが作成されると、ショートコードは実際の値に置き換えられます。たとえば、 `課題: $TLDR` または `$FIRST_DETECTED_DATE で検出`のように、ショートコードと固定テキストを組み合わせることもできます。必要なショートコードが一覧にない場合は、ご連絡ください。

| ショートコード                 | 説明                                                             |
| ----------------------- | -------------------------------------------------------------- |
| `$SEVERITY_SCORE`       | 脆弱性の数値による重大度スコア（例: 85）                                         |
| `$SEVERITY`             | 重大度レベル（Critical、High、Medium、Low）                               |
| `$ASSIGNEE`             | Aikidoで課題対応を担当するユーザー                                           |
| `$TLDR`                 | 課題グループの要約                                                      |
| `$HOW_TO_FIX`           | 課題グループの修正方法の説明                                                 |
| `$FIX_TIME`             | 課題グループの修正にかかる時間（分）                                             |
| `$TASK_DESCRIPTION`     | スコープ、TLDR、修正方法を含む、このタスクに対してAikidoが生成する既定の説明                    |
| `$TEAMS`                | 関連課題の担当チーム                                                     |
| `$SCOPES_REPO`          | このタスクに関連するリポジトリ名のみを含むように絞り込まれたスコープ。一部のグループ化された課題では空になる場合があります。 |
| `$SCOPES_SHORT`         | リポジトリ名、コンテナ名、クラウド名など、このタスクに関連するスコープの短い版                        |
| `$SCOPES`               | タスクに関連するスコープ／場所（リポジトリ、コンテナなど）                                  |
| `$SLA_DATE`             | SLAの期限日                                                        |
| `$SLA_TIME`             | UnixタイムスタンプとしてのSLA期限日                                          |
| `$FIRST_DETECTED_DATE`  | 課題が最初に検出された日付                                                  |
| `$FIRST_DETECTED_TIME`  | Unixタイムスタンプとしての最初の検出日付                                         |
| `$AIKIDO_LINK`          | Aikido内の課題グループへのリンク                                            |
| `$CWE_IDS`              | このタスクに関連する課題のCWE ID                                            |
| `$CVSS`                 | このタスクに関連する課題の最高CVSSスコア                                         |
| `$ISSUE_TYPE`           | このタスクに関連する課題の種類                                                |
| `$PROGRAMMING_LANGUAGE` | このタスクに関連する課題のプログラミング言語                                         |

#### 日付と日時フィールド

Jiraの **日付** フィールドでは、 `YYYY-MM-DD` 形式（例: `2024-03-15`）または `_DATE` ショートコードを使用してください。

Jiraの **日時** フィールドでは、 `_TIME` ショートコード（例: `$SLA_TIME`, `$FIRST_DETECTED_TIME`）を使用してください。これらはUnixタイムスタンプを出力し、AikidoがJiraで必要な日時形式に自動変換します。

#### 高度な例

**すべてのAikido課題を1つの固定親課題にリンクする**

Aikidoから作成されるすべてのJiraチケットで同じ親課題を使いたい場合は、Jiraの **親** フィールドを固定値にマッピングします。 **Aikidoの値** 入力欄には、親課題のJira課題キーを `SEC-123`.

<figure><img src="/files/aa1c9f07801e5df37a91032d00ddf7db4a3a28ff" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
のように入力してください。親課題はすでにJiraに存在している必要があります。また、Aikidoで使用するプロジェクトと課題タイプに対して有効である必要があります。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/hajimeni/task-management-systems/map-aikido-data-to-jira-custom-fields.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.