> 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 参照、特別な書式設定は不要です
* 固定値にはプレーンテキストを使用してください — 読みやすい名前だけでOKです

#### **対応している 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`             | 重要度レベル（重大、高、中、低）                                             |
| `$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.