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

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

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

簡単な設定

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

対応している Jira フィールドの種類：

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

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

1. 次へ移動し 連携 > Jira > Jira フィールドマッピング をクリックして フィールドを追加

   
2. Jira のカスタムフィールド名を カスタムフィールド 入力欄に、Jira に表示されているとおりにそのまま入力してください
3. Aikido のショートコード（例： $SEVERITY）または固定テキスト値を Aikido 値 入力欄に

   
4. クリック 変更を保存

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

Aikido 値：固定テキストとショートコード

オプション 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	このタスクについて 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.

親課題は、あらかじめ Jira に存在している必要があります。また、Aikido で使用するプロジェクトと課題タイプに対して有効でなければなりません。