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

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

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

シンプルな設定

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

サポートされている Jira フィールドタイプ:

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

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

1. 次へ移動します： 連携 > Jira > Jira フィールドマッピング に移動し、 フィールドを追加
   

   

2. Jira のカスタムフィールド名を カスタムフィールド 入力欄に、Jira に表示されているとおり正確に入力してください

3. Aikido のショートコード（例: $SEVERITY）または固定テキスト値を Aikido 値 入力欄に入力してください
   

   

4. クリックします 変更を保存

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

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

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

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

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

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

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

日付および日時フィールド

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

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

高度な例

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

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