ユーザーガイド
チェックリストパネルは、有効化されているすべてのプロジェクトのJira課題ビューに組み込まれています。展開する必要も、追加のタブも、プラグインを起動する必要もありません。課題を開くだけで、チェックリストはすでにそこに表示されています。
チェックリストの表示場所
- 課題ビュー — 課題の下にネイティブにレンダリングされ、パネルの上部に
3/5 Doneのような進捗インジケーターが表示されます。 - ボードカード (カンバン / スクラム) — Checklist Progress カスタムフィールドを通じて、完了率が数値のパーセンテージバッジとして表示されます。
- 課題の作成モーダル — 課題の作成中にアイテムを追加およびチェックできます。状態は送信時に保持されます。
- トランジションモーダル — ワークフロートランジションの一環として、必須アイテムをチェックできます。状態は送信時に保持されます。
- JSMカスタマーポータル — 管理者によって有効化されている場合、読み取り専用ビューとして表示されます。
Checklist Hub
Jiraのトップナビゲーションメニューから直接 Checklist Hub にアクセスできます。このフルページダッシュボードは、チェックリストのパーソナルコマンドセンターとして機能します。
- My Incomplete Work — 担当している、または操作した課題のうち、チェックリストが未完了のものを最大25件表示します。リストには課題キー(クリック可能なディープリンク)、要約、ステータス、および
チェック済み / 合計のプログレスバーが表示されるため、保留中の作業を正確に把握できます。 - Recent Templates — 最近使用した6つのグローバルテンプレートをグリッド表示で閲覧できます。各カードにはテンプレート名、アイテム数、リンクされた課題数が表示され、利用可能な標準手順を一目で確認できます。
アイテムの操作
プロジェクトの 課題の編集 権限を持つユーザーは誰でもチェックリストを管理できます。プロジェクトの閲覧 権限のみを持つユーザーには、読み取り専用で表示されます。
- アイテムの追加 — パネル下部の入力欄に入力し、Enterキーを押します。アイテムのテキストは 500文字 に制限されており、1つのチェックリストには最大 50アイテム まで追加できます。
- チェック / チェックを外す — シングルクリックで操作します。プログレスバーはページをリロードすることなく即座に更新されます。管理者が Notify on item completed を有効にしている場合、ウォッチャーと担当者にJira通知が送信されます。
- 一括チェック / チェックを外す — 複数のアイテムを選択し、1回の操作で切り替えることができます。
- インライン編集 — アイテムのテキストをクリックすると、その場で編集できます。
- 削除 — アイテムのインラインアクションを使用します。
- ドラッグ&ドロップによる並べ替え — ハンドルを掴み、目的の場所にアイテムをドロップします。
- 表示名 — チェックされたアイテムには、AtlassianアカウントIDから解決された、チェックしたユーザーの表示名が表示されます。
- ビューのフィルタリング — All、Completed、Incomplete を切り替えて、リストの表示を絞り込みます。
Markdownとリッチテキスト
アイテムは、ランブック、Confluenceページ、または外部のエビデンスへのリンクに便利なMarkdownのサブセットをサポートしています。
| 構文 | レンダリング結果 |
|---|---|
**bold** | bold |
*italic* | italic |
`code` | inline code |
[link](https://example.com) | hyperlink |
レンダリングはXSSに対してサニタイズされています。セキュリティの詳細については、Compliance & Audit ページを参照してください。
テンプレートの適用
- 課題とチェックリストパネルを開きます。
- パネルメニューから Apply Template を選択します。
- モーダルのドロップダウンからテンプレート(例:
QA Release Checklist)を選択します。
各テンプレートには タイプを示すロゼンジ(ラベル) が付与されています。
- Do-Confirm — リストに照らし合わせて完了した作業を検証します(例: リリース準備状況のレビュー)。
- Read-Do — 手順としてステップを順番に実行します(例: インシデント対応のランブック)。
タイプのないレガシーテンプレートも引き続きサポートされており、タイプなしとしてレンダリングされます。
後で管理者がそのテンプレートを更新して同期した場合、次回課題を開いたときに新しいアイテムがチェックリストに 追加(アペンド) されます。ローカルで編集、並べ替え、または削除したアイテムは保持されます。同期によって作業が上書きされることはありません。
チェックリストをテンプレートとして保存
課題上で有用なチェックリストを作成しましたか? 課題ビューから離れることなく、それを昇格させることができます。Save as template を選択し、名前(最大100文字)を付け、Do-Confirm または Read-Do を選択すると、グローバルテンプレートライブラリに保存され、誰でも再利用できるようになります。
課題のクローン
課題をクローンする場合:
- チェックリストは新しい課題にコピーされます。
- すべてのアイテムが未チェック状態にリセットされます。 クローンは通常、新しい作業を表すため、チェック済みの状態を保持すると完了状況を誤って伝えることになるためです。
- 元のテンプレートへのリンクは保持されるため、将来のテンプレート同期はクローンにも適用されます。
状態のロック — 課題が Done になった場合
課題のステータスが Done カテゴリ(Done、Closed、Resolved、またはそのカテゴリにマッピングされたカスタムステータス)に入ると、チェックリストは 読み取り専用 になります。引き続き表示や監査証跡のエクスポートは可能ですが、アイテムのチェック、チェックの解除、編集、削除、並べ替えはできなくなります。バックエンドでも同様の制限が適用されるため、API呼び出しも拒否されます。
これは意図的な仕様であり、SOC 2コンプライアンス要件を満たすために必要です。詳細については、Compliance & Audit を参照してください。
JSMポータル — カスタマー向けの可視性
管理者がJSMポータルの可視性を有効にしている場合、Jira Service Managementカスタマーポータルでリクエストを表示しているカスタマーには、チェックリストが 読み取り専用 モードで表示されます。カスタマーは、「ステータスはどうなっていますか?」といったコメントを投稿することなく、エージェントが「メールのプロビジョニング」、「ワークステーションの設定」、「ウェルカムパックの送信」などの進捗を進めていく様子を確認できます。カスタマーがアイテムをチェックしたり、チェックを外したり、編集したりすることは一切できません。
JQL — チェックリストの進捗による課題の検索
Checklist Progress(0〜100%)および Checklist Audit Log カスタムフィールドは、JQL、フィルター、ダッシュボード、ボードで検索可能です。便利なクエリの例:
"Checklist Progress" < 100 AND status = "In Review"
"Checklist Progress" = 0 AND assignee = currentUser()
"Checklist Progress" = 100 AND status != Done
制限事項の概要
| 制限事項 | 値 |
|---|---|
| チェックリストあたりのアイテム数 | 50 |
| 課題あたりのチェックリスト数 | 1 |
| アイテムのテキスト | 500文字 |
| テンプレート名 | 100文字 |