セットアップと管理
本ガイドでは、インストール、管理ダッシュボード、テンプレート管理、プロジェクトの有効化、ワークフローの適用、自動化の連携、JSMポータルへの公開、自動適用設定、およびHubページについて説明します。
1. アプリのインストール
- Jiraから アプリ → その他のアプリを見つける を開き、Enterprise Checklists for Jira を検索するか、Atlassian Marketplaceのリストから直接インストールします。
- インストール後、Jira設定 (⚙) → アプリを管理 → Enterprise Checklists for Jira を開き、管理ダッシュボードにアクセスします。
- 初めての管理者は、ダッシュボードの4つのタブを案内する Getting Started (はじめに) ページと Configure (設定) ページにルーティングされます。
管理ダッシュボードにアクセスできるのは、Jiraの サイト管理者 または プロジェクト管理者 権限を持つユーザーのみです。日常的なチェックリストの権限は、プロジェクトの既存の権限スキームに連動します。詳細は後述の 権限モデル を参照してください。
2. 管理ダッシュボード — 4つのタブ
Templates (テンプレート)
Templatesタブは、グローバルテンプレートライブラリ のコントロールプレーンです。
- 名前付きチェックリストの 作成 / 編集 / 削除 (例:
QA Release Checklist、Bug Triage、Production Deployment)。テンプレート名は 100文字 に制限されています。 - 公開前にレンダリングされたチェックリストを プレビュー します。
- リンクされた課題数 — 各行には、現在そのテンプレートを参照しているアクティブな課題の数が表示されるため、同期前に影響範囲を把握できます。
- 同期 (Sync) — 新しいテンプレート項目を、現在そのテンプレートにリンクされているすべてのアクティブで未解決の課題にプッシュします。同期は 追記のみ です (後述の 動的テンプレート同期 を参照)。
- チェックリストタイプ — すべてのテンプレートには
Do-ConfirmまたはRead-Doのラベルが付けられます (Atul Gawandeの著書 The Checklist Manifesto に由来)。完了した作業をリストと照合して確認する場合は Do-Confirm を使用し、手順をステップバイステップで順次実行する場合は Read-Do を使用します。このラベルは、テンプレートリスト、スターターギャラリー、および課題パネルにロゼンジ (バッジ) として表示されます。タイプ指定のないレガシーテンプレートも引き続きサポートされます。
組み込みのスターターテンプレート
Templatesタブでは、アプリに同梱されている 11種類のスターターテンプレート の厳選されたカタログも公開されています。ギャラリーを閲覧し、レンダリングされた項目とメターロゼンジ (カテゴリ、タイプ、項目数) をプレビューして、Add to my templates をクリックすると、スターターがワークスペースの編集可能なグローバルテンプレートライブラリにコピーされます。
| カテゴリ | スターター |
|---|---|
| エンジニアリング / DevOps | 本番環境へのデプロイ · 本番データベースのスキーマ移行 |
| QA / アジャイル | スプリントの準備状況 |
| ITSM | インシデント管理 · ITプロビジョニング |
| セキュリティ / ベンダー | ベンダー評価 · サードパーティデータ共有リクエスト |
| 人事 | 従業員の退職手続きとアクセス権の取り消し |
| コンプライアンス | クラウドインフラストラクチャ ePHI ベースライン (HIPAA) · 財務システム ITGC 監査 (SOX) |
| マーケティング / 一般 | 外部向けプレスリリース |
適用すると、標準の createTemplate パスを通じて 独立したコピー が作成されます。カタログのオリジナルは読み取り専用であり、自動適用されることはなく、後のアプリアップグレード時にカスタマイズされたコピーを上書きすることもありません。
Projects (プロジェクト)
- 検索可能でページネーションされた、すべてのJiraプロジェクトのリスト。
- プロジェクトごとの 有効化 / 無効化 (Enable / Disable) トグル。プロジェクトは デフォルトで有効 になっています (オプトアウトモデル)。
- プロジェクトを無効にすると、そのプロジェクト内のすべての課題からチェックリストパネルが完全に 非表示 になります (単にグレーアウトされるわけではありません)。
Settings (設定)
- Notify on item completed (項目完了時の通知) — 項目にチェックを入れた際に、Jiraネイティブのウォッチャー / 担当者への通知をトリガーするかどうかを制御するグローバルトグル。
- JSM portal visibility (JSMポータルの可視性) — Jira Service Managementのカスタマーポータル上で、読み取り専用のチェックリストを表示するかどうかを制御するグローバルトグル。プロジェクトごとに上書きすることも可能です。
- Auto-Apply Default Templates (デフォルトテンプレートの自動適用) — 任意のグローバルテンプレートを1つ以上のJira課題タイプにマッピングします。そのタイプの新しい課題が作成されると、Jira Automationのルールを必要とせずに、作成時にテンプレートが追加されます。
Export (エクスポート)
- 選択したプロジェクト内のすべてのチェックリストの一括 CSVエクスポート。大規模な環境向けにページネーションされています。
- 出力はOWASPの数式インジェクションから保護されており、監査人が直接相互参照できるように、Issue Key 列には人間が読めるJira課題キー (例:
CMSP-7) が使用されます。 - 課題ごとのエクスポートも、引き続き課題パネルから利用可能です (Jira管理者 / プロジェクト管理者のみ)。
3. Checklist Hub (管理者ビュー)
Jiraのトップナビゲーションメニューから直接アクセスできる Checklist Hub は、すべてのユーザーにとっての単一のエントリポイントとして機能します。エンドユーザーには自身に割り当てられた作業が表示されますが、Jira管理者およびプロジェクト管理者は、このページで追加のガバナンス機能にアクセスできます。
- テンプレート使用状況のインサイト (Template Usage Insights): インスタンス全体の集計統計 (チェックリストとテンプレートの総数) とともに、各テンプレートにリンクされている課題の正確な数を示すランキング表を確認できます。これを活用して、依存度の高いプロセスを特定したり、未使用のプロセスを非推奨にしたりできます。
- プロジェクトの例外 (Project Exceptions): グローバルなデフォルト設定から逸脱しているプロジェクト (例: チェックリストが完全に無効化されている、またはプロジェクトレベルの可視性の上書きが適用されているなど) のロールアップリストを使用して、設定状況を迅速に監査できます。
- クイックアクション (Quick Actions): 管理ダッシュボードや「はじめに」のオンボーディングフローに直接移動できるナビゲーションリンクです。
4. 権限モデル
チェックリストの権限は、課題の既存のJira権限スキームに連動します。
| Jira権限 | 実行可能な操作 |
|---|---|
| 課題の編集 | 作成、編集、削除、チェック / チェック外し、並べ替え、テンプレートの適用、現在のチェックリストをテンプレートとして保存。 |
| プロジェクトの閲覧 のみ | チェックリストを読み取り専用で表示。 |
| プロジェクト管理者 | 上記すべて + 課題ごとの監査CSVエクスポート。 |
| Jira / サイト管理者 | 上記すべて + 管理ダッシュボード、グローバルテンプレート管理、プロジェクトのトグル、一括CSVエクスポート。 |
JSMポータルのカスタマーには、JSMポータルの可視性が有効になっている場合にのみ、チェックリストが常に読み取り専用で表示されます。
5. 動的テンプレート同期
グローバルテンプレートを変更し、Sync (同期) をクリックした場合の動作は以下の通りです。
- 管理者UIに 影響を受ける課題の数 が表示され、続行する前に明示的な確認が求められます。
- 同期は 追記のみ です。新しい項目は、各課題のチェックリストの末尾に追加されます。
- 既存の項目 (ローカルで並べ替え、編集、または削除されたものを含む) が上書きされたり、再挿入されたりすることは 絶対にありません。
- 重複は 大文字と小文字を区別しないテキストの一致 によって検出され、スキップされます。
- 一括同期では、大量のメール通知を防ぐために 課題ごとのウォッチャー通知が抑制 されます。ユーザーは次回その課題を開いたときに新しい項目を確認します。
6. ワークフローの適用 — Checklist Complete バリデーター
チェックリストが満たされるまでトランジションをブロックします。
- 対象のJiraワークフローを編集し、制限したいトランジション (例:
In Review → Done) を選択します。 - バリデーター → Checklist Complete を追加します。
- チェックリストがない 課題はバリデーターを通過します (そのため、レガシーな課題がブロックされることはありません)。
7. ネイティブ通知と自動化
- ウォッチャー通知 — Notify on item completed (項目完了時の通知) 設定によって制御されます。オンにすると、項目にチェックを入れた際に、ウォッチャーと担当者にJiraネイティブの通知が送信されます。
- 自動化プロパティ — チェック / チェック外しのすべてのアクションは、課題プロパティ
enterprise-checklist-eventに書き込まれます。Jira Automationで 課題プロパティが変更されたとき (Issue property changed) トリガーを使用してルールを構築し、チェックリストのアクティビティに反応させることができます (例: Slackへの投稿、課題のトランジション、サブタスクの作成など)。
8. JQLとカスタムフィールド
フィルター、ダッシュボード、ボード、およびJQL用に、2つの読み取り専用カスタムフィールドが公開されています。
- Checklist Progress (0–100%) —
"Checklist Progress" < 100 AND status = "In Review"のようなJQLで使用可能です。また、カンバン / スクラムボードのカード上に数値バッジとしても表示されます。 - Checklist Audit Log — 最新の監査エントリの要約であり、Jiraの履歴タブに表示されます。
9. デフォルトテンプレートの自動適用
Settings → Auto-Apply にて、任意のグローバルテンプレートを1つ以上のJira課題タイプにマッピングします。ユーザーがそのタイプの新しい課題を作成すると、一致するテンプレートが自動的に追加されます。これにより、多くのチームが手動で構築している「課題タイプがバグの場合、チェックリストを追加する」といった壊れやすいJira Automationルールを置き換えることができます。
10. JSMポータルの可視性
Settings でグローバル設定を切り替え、必要に応じて Projects タブからプロジェクトごとに上書きします。有効にすると、Jira Service Managementのカスタマーポータル上にチェックリストが 読み取り専用 で表示されます。これは、編集権限は持たずに進捗状況を可視化したい人事のオンボーディングやITプロビジョニングのリクエストなどに役立ちます。
11. 運用上の制限
| 制限事項 | 値 |
|---|---|
| チェックリストあたりの最大項目数 | 50 |
| 課題あたりのチェックリスト数 | 1 |
| 項目のテキスト長 | 500文字 |
| テンプレート名の長さ | 100文字 |
これらの制限は、UIとバックエンドの両方で適用されます。