Jira（ジラ）統合テンプレート

テンプレートは、axe（アックス）の問題フィールドとJira（ジラ）のフィールドを事前に対応付けておくことで、Jira（ジラ）チケットの標準フォーマット作成に役立ちます。テンプレートは、任意のプロジェクトと課題タイプの組み合わせに対して作成でき、組織内の誰でもJiraに課題を送信する際に利用できます。

テンプレートのアクセス管理

テンプレートを作成できるユーザー

Jira統合製品へのアクセス権を持つユーザーなら誰でもテンプレートを作成できます。

テンプレートの編集・削除権限

• テンプレート作成者: テンプレートを作成したユーザーは、自身で作成したテンプレートを編集または削除できます。
• axe Account Portal（アックス・アカウント・ポータル）管理者: 組織内のすべてのテンプレートを編集・削除できます

テンプレートの権限

• テンプレートは組織全体のリソースです。
• Jira統合アクセス権を持つすべてのユーザーは、どのテンプレートでも利用できます。

テンプレートの作成者および管理者のみがテンプレートを修正できます。

• テンプレートは特定のユーザーやグループだけに利用を限定することはできません。

テンプレートの作成

1.axe Account Portal内の「構成」ページにアクセスします（または https://axe.deque.com/configuration/integrations に直接アクセスして、手順2をスキップします）。 1.「設定」ナビゲーション内の「統合」リンクをクリックします 1.「Jiraテンプレートの設定」リンクをクリックします 1.「テンプレートを追加」ボタンをクリックします 「テンプレートを追加」ボタンのスクリーンショット(images/integrations-add-template.png) 1.「テンプレート情報」「フィールドマッピング」「影響マッピング」の各ステップの項目に入力してください。各ステップの詳細については、次のセクションで確認できます。 テンプレート追加フォームのスクリーンショット（ステップ1/4）(images/integrations-create-template-1.png) 1.ステップ1～3で入力した情報を確認します 新規テンプレートのレビュー画面のスクリーンショット (ステップ4/4)(images/integrations-create-template-4.png) 1.「保存」をクリック

テンプレートを利用するには、Jiraへの問題の送信セクションをご参照ください。

テンプレート情報の追加

テンプレート作成の第一歩は、Jiraで問題の作成先や方法を指定する基本情報を設定することです。

1.テンプレート名: 説明的な名前を入力してください。課題をJiraに送信する際、この名前がテンプレートリストに表示されます。 例：「A11Y バグ」、「モバイル アクセシビリティ」、「WCAG 2.1 違反」 2.プロジェクト: このテンプレートを使用する際に課題が作成されるJiraプロジェクトを選択してください。ドロップダウンには、課題を作成する権限があるすべてのプロジェクトが表示されます。 3.課題タイプ: Jiraで作成される課題タイプを選択してください。利用可能なオプションは、選択したプロジェクトの構成によって異なります。 一般的なタイプ: バグ・タスク・ストーリー・サブタスク 4.axe Issue Screenshotsを添付ファイルとして有効化: チェックすると、axe（アックス）ツールでキャプチャされたスクリーンショットが自動的にJira（ジラ）チケットに添付されます。これにより、開発者が問題を修正する際に視覚的な参考情報が提供されます。

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

フィールドマッピングページでは、axeフィールドをJiraフィールドに対応付けることで、チケット作成時にアクセシビリティ問題のデータを自動的に転送することができます。

1.Jiraフィールドのドロップダウンから、対応付けたいJiraフィールドを選択してください。 2.「axe Field」ドロップダウンから、対応する「axeデータフィールド」を選択してください。 3.**「+ Add axe Field」**をクリックして、追加のフィールドをマッピングします。 4.マイナス（−）ボタンをクリックしてマッピングを削除します。 5.「次へ」ボタンをクリックして保存します

重要：このページには、すべての必須Jira（ジラ）フィールド（例：概要）が自動的に表示されます。もし必須フィールドをaxeフィールドにマッピングしない場合、問題を送信する際にユーザーがそれらを手動で入力するよう求められます。

マッピング可能な主な axe フィールドは次のとおりです：

1.ルール: 違反したアクセシビリティルールID 1.説明: アクセシビリティの問題の詳細な説明 1.修正方法: 問題を解決するための手順 1.ヘルプURL：ルールのドキュメントへのリンク 1.問題の概要: 簡単な要約 1.セレクタ: 要素のCSSセレクタ 1.要素ソース: 要素のHTMLソースコード 1.課題のスクリーンショットURL：課題に関連するスクリーンショットのURL 1.タグ: カテゴリー、WCAGチェックポイント識別子などの文字列タグの配列 1.テスト名: 問題が検出された保存済みテストの名前 1.問題シェアURL：axeプロダクトの共有済み問題への直接リンク 1.作成日時: 問題が検出された日付 1.課題テストURL: テスト対象ページのURL 1.検出者: 問題が指摘されたテストを実行したユーザー 1.ページタイトル: テスト対象ページのタイトル 1.axeバージョン: テストに使用したaxe-coreバージョン

Jira（ジラ）の説明フィールド

Jira（ジラ）の説明フィールドは、標準化された構造です。カスタマイズやマッピングはできません。課題がJiraに送信される際、以下のセクションを含む構造化された説明が自動的に追加されます。

• 問題の説明: 該当する問題の内容。
• 修正方法: 段階的な修正手順。
• 問題箇所:
  • セレクタ: 問題のある要素のCSSセレクタ。
  • 要素ソース: 問題のある要素のHTMLソースコード。
• ページのURL：テストしたページのURL。
• 追加の詳細:
  • 影響度: 問題の重大度レベル。
  • Axe Issueリンク: axe Account Portalの課題レポートへのリンク（利用可能な場合）
  • ルールのヘルプ: ルールのドキュメントへのリンク。

インパクトマッピング設定

axe（アックス）のアクセシビリティ問題は影響度によって分類されており、ユーザーへの影響の程度を示します。 Impact Mappingページでは、これらのインパクトレベルをJiraの優先度値に割り当てて、課題の優先順位を適切に管理できます。

エラー処理

必須フィールドの検証

テンプレート内の必須フィールドが入力されていない場合

問題送信時、システムはエラーメッセージを表示し、必須フィールドに値を入力してから問題をJiraに送信してください。すべての必須フィールドに値が入力されるまで、axe（アックス）のIssueをJira（ジラ）に送信することはできません。

テンプレートで必須のJiraフィールドに値をマッピングしている場合でも、その値がすべてのaxe製品に存在しないことがあります。

テンプレート作成時に、マッピングされたフィールドがすべてのaxe製品で利用できない場合、システムは警告メッセージを表示しますが、ユーザーは警告が表示されてもテンプレートの作成を続けることができます。

• Jiraに問題を送信する際、テンプレートにDeque製品で存在しないフィールドへのマッピングが含まれていると、警告メッセージが表示されます。システムは手動入力が必要なフィールドを強調表示し、未入力の必須フィールドには値を手動で入力してください。入力が完了するまで、課題を送信することはできません。すべての必須フィールドが既存のマッピングまたは手動で入力されている場合のみ、問題はJiraに送信されます。

テンプレートの編集と削除

テンプレートを編集または削除するには、特定のテンプレートの「オプション」メニューをアクティブにすると、次の2つのオプションが表示されます。

• テンプレートを編集
• テンプレートを削除

テンプレートオプションメニューのスクリーンショット(images/integrations-edit-delete-template.png)