> 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) を開き、 **フィールドを追加**
2. Jira のカスタムフィールド名を **カスタムフィールド** 入力欄に、Jira に表示されているとおり正確に入力してください
3. Aikido のショートコードを入力するか（例： `$SEVERITY`）、または固定テキスト値を **Aikido 値** 入力欄に入力してください
4. クリック **変更を保存**
その **プレビュー** 列には、Jira に送信される値が表示されます。これらはショートコードに基づく値、または固定値 / 自由テキストにできます。
#### Aikido 値：固定テキスト vs ショートコード
**オプション 1：自由テキストを使って固定値を Jira に送信**
固定値を設定するには、ショートコードの代わりにプレーンテキストを入力してください。読みやすい名前だけを使用すればよく、Jira の ID や特別な書式は必要ありません。
たとえば、 `Security` と入力すると、Aikido から作成されるすべてのチケットでその Jira フィールドに「Security」が設定されます。
**オプション 2：ショートコードを使って Aikido の値を Jira に送信**
ショートコードは、Aikido の課題からデータを取得するプレースホルダーです。Jira チケットが作成されると、ショートコードは実際の値に置き換えられます。たとえば、 `Issue: $TLDR` または `Detected on $FIRST_DETECTED_DATE`のように、ショートコードと固定テキストを組み合わせることもできます。ここにないショートコードが必要ですか？ご連絡ください。
| ショートコード | 説明 |
| --------------------------------------------------- | ----------------------------------------------------------- |
| `$SEVERITY_SCORE` | 脆弱性の数値による重大度スコア（例：85） |
| `$SEVERITY` | 重大度レベル（Critical、High、Medium、Low） |
| `$ASSIGNEE` | Aikido でこの課題の担当に割り当てられたユーザー |
| `$TLDR` | 課題グループの要約 |
| `$HOW_TO_FIX` | 課題グループの修正方法の説明 |
| `$FIX_TIME` | 課題グループの修正にかかる時間（分） |
| `$TASK_DESCRIPTION` | このタスクに対して Aikido が生成する既定の説明。スコープ、TLDR、修正方法を含みます |
| `$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`.
{% 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=&goal=
```
`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.
