Contents
カスタマイズ全体像と推奨される 6 つの方法
Jira Service Management(JSM)を自社の業務フローに合わせて最適化するには、単なる画面装飾だけでなく リクエストタイプ・ワークフロー・ポータル UI・Automation・権限設計・テスト・移行 の 6 領域を体系的に整理することが重要です。本セクションでは、全体像と Atlassian が公式ドキュメントで示すベストプラクティスを概観します。
全体フロー概要
以下のステップは、要件定義から本番リリースまでの標準的な流れです。各フェーズで成果物を明確にし、次のフェーズへのインプットとすることで、変更リスクを抑えられます。
| フェーズ | 主なアウトプット | 目的 |
|---|---|---|
| 要件定義 | ビジネスプロセス・ユーザー期待一覧 | 改善すべき課題と成功基準を可視化 |
| 設計 | 6 カテゴリごとの設定シート | 具体的な実装内容を決める |
| サンドボックス適用 | テスト環境での動作確認レポート | 本番への影響度を事前評価 |
| 本番デプロイ | 移行チェックリスト・リリースノート | 安全かつ確実に変更を反映 |
このフローは Atlassian の公式ガイド(Jira Service Management カスタマイズの概要)でも推奨されています。
公式が示す 6 つのベストプラクティス
各領域で実践すべきポイントを表にまとめました。下記は 「何を対象にするか」 と 「具体的なアクション」 の二軸で整理しています。
| 領域 | 主な対象 | 推奨アクション |
|---|---|---|
| リクエストタイプ | カテゴリ・項目 | 必要最低限のフィールドだけ表示し、条件付き必須化を設定 |
| ワークフロー | ステータス・遷移 | 承認や Problem Management(Premium プランで提供)を組み込む |
| ポータル UI | ロゴ・カラー・ヘルプ | ブランドガイドに沿った外観統一とアクセシビリティの確保 |
| Automation | トリガー・アクション | SLA 達成、エスカレーション、ステータス変更を自動化 |
| 権限設計 | ロール・権限スキーム | プロジェクトロールとグローバル権限で最小権限原則を実装 |
| テスト・移行 | サンドボックス・CI/CD | 変更履歴の管理と段階的デプロイを徹底 |
上記ベストプラクティスに沿って設定すれば、将来的な機能追加や組織変化にも柔軟に対応できます。
リクエストタイプの追加とフィールド設定
リクエストタイプは顧客がポータルから作成できる「チケット」の入口です。適切に設計すれば、入力ミスや処理遅延を防ぎ、ユーザー体験を向上させられます。
追加手順の概要
このセクションでは 「プロジェクト設定 → リクエストタイプ」 から新規タイプを作成し、カスタムフィールドと表示ロジックを同時に定義する流れを解説します。執筆時点では UI が公式ドキュメントと一致していますが、Cloud の UI は随時更新されるため、最新情報は Atlassian ヘルプをご確認ください。
- リクエストタイプの作成
- プロジェクト設定 → 「リクエストタイプ」へ移動
-
「タイプを追加」ボタンで名称(例:
ハードウェア障害)とアイコンを入力し保存 -
カスタムフィールドの定義
- 「カスタムフィールド」画面で「シリアル番号」「保証期間」を新規作成
-
各フィールドに対して必須・表示条件を設定(例:
シリアル番号が入力されたときのみ保証期間を表示) -
レイアウトの調整
- 「レイアウト」タブでドラッグ&ドロップし、ユーザーが最初に目にすべき項目を上位に配置
フィールド設定手順(H3)
以下はフィールド追加と条件付表示の具体的な操作です。
| 手順 | 操作内容 |
|---|---|
| 1 | プロジェクト設定 → 「カスタムフィールド」 → 「新規作成」 |
| 2 | フィールドタイプ(テキスト、数値など)を選択し名前・説明を入力 |
| 3 | 対象画面 に先ほど作成したリクエストタイプを指定 |
| 4 | 「表示条件」タブで JQL または コンディションビルダー を利用し、シリアル番号 IS NOT EMPTY のようにロジックを設定 |
| 5 | 保存後、リクエストタイプの「レイアウト」で配置順序を調整 |
カスタムワークフローの設計と Problem Management の組み込み
業務プロセスに合わせた独自ワークフローは、承認や根本原因分析(Problem Management)まで一貫して管理できる重要な要素です。なお Problem Management は JSM Premium プランまたは「Jira Service Management for ITSM」アドオンが必要であることを明示します。
設計方針のポイント
- ステータスと遷移は最小限に:過剰なステータスは管理コストを上げるため、業務フローに必須なものだけを作成
- 条件付き承認:承認が必要な遷移にはロールベースの条件を設定し、不要な手戻りを防止
- Automation との連携:ステータス変更時に自動通知やリンク生成を組み合わせて、手作業を削減
ワークフロー構築手順(H3)
- ワークフローエディタの起動
-
プロジェクト設定 → 「ワークフロー」 → 「新規作成」または既存テンプレートのコピー
-
ステータス追加
-
必要なステータス(例:
Open,Pending Approval,In Progress,Under Investigation (Problem),Resolved,Closed)をドラッグし、名称とアイコンを設定 -
遷移線の描画と条件付与
-
矢印で遷移を結び、条件(例:
Approvers = currentUser())や ポスト関数(自動通知・担当者割当)を追加 -
Problem Management ステージの組み込み
-
Under Investigation (Problem)を作成し、Automation ルールで「ステータスがこの状態になると、同一インシデントに紐づく Problem チケットを自動生成」する設定を行う(Automation の公式ガイド参照) -
承認フローの実装例
Open → Pending Approvalに対し「承認者ロールのみが遷移可能」条件を付与Pending Approval → In Progressで「承認済み」チェック(JQL:status = "Pending Approval" AND approvers IS NOT EMPTY)を必須化
Automation の活用例(H3)
| トリガー | アクション |
|---|---|
| ステータスが Under Investigation (Problem) に遷移したとき | 关联インシデントに自動リンク、担当者へ Slack 通知 |
| SLA が期限切れになると | エスカレーションメールをマネージャーへ送信 |
Resolved → Closed 前に 30 日以上経過している場合 |
自動的に課題をアーカイブ(Premium の自動クローズ機能) |
これらの設定はすべて Atlassian が提供する Automation for Jira の UI から構成できます。
サービスポータル UI のカスタマイズ
ポータルは顧客が最初に触れる画面です。見た目と操作性を統一することで、問い合わせミスの削減やブランドイメージ向上につながります。
基本的なカスタマイズ項目(H3)
| 項目 | 設定場所 | 推奨設定 |
|---|---|---|
| ロゴ画像 | ポータル > ブランド設定 | PNG、200×80 px 以内 |
| プライマリカラー | 同上 | HEX コード例 #0052CC |
| ヘルプテキスト | ポータル > カスタムコンテンツ | Markdown が利用可能な案内文 |
| カスタム HTML ウィジェット | ポータル > カスタムコンテンツ > HTML | 追加スクリプトは CSP 設定に注意 |
手順の概要
- ポータル設定へ移動 → プロジェクトサイドバーの「ポータル」リンクをクリック
- 「ブランド設定」タブでロゴとカラーをアップロード/入力し保存
- 「カスタムコンテンツ」セクションで「HTML」ウィジェットを追加し、必要なコード(例:FAQ へのリンクや簡易検索ボックス)を貼り付け
注意:Cloud 環境ではサードパーティスクリプトの実行に制限があります。JavaScript を使用する場合は Atlassian の CSP ポリシーを必ず確認してください。
ロールベースアクセス制御(RBAC)と最小権限設計
適切な権限設定は情報漏洩防止と業務効率化の両立に不可欠です。JSM では プロジェクトロール と グローバル権限スキーム を組み合わせて RBAC を実現します。
権限設計の基本方針(H3)
- 最小権限原則:ユーザーが業務遂行に必要な権限だけを付与
- ロール単位で管理:変更や監査が容易になるよう、ロールごとに権限セットを定義
- リクエストタイプ別マッピング:機密フィールドへのアクセスはタイプごとに細分化
実装手順
| 手順 | 操作内容 |
|---|---|
| 1 | プロジェクト設定 → 「ロール」から 管理者, エージェント, 顧客 等のロールを作成 |
| 2 | 各ロールに対し「課題閲覧」「課題編集」など必要な権限をチェック |
| 3 | グローバル権限は Jira 管理 → 「全体設定」→「権限スキーム」で システム管理者 のみが持つように限定 |
| 4 | リクエストタイプ編集画面の「権限」タブで、閲覧ロール / コメントロール / 承認ロール を個別に設定 |
例:ハードウェア障害リクエストのフィールド制御
保証期間フィールドはHardware Agentロールだけが表示- 他ロール(例:一般エージェント)は閲覧不可、編集もできないように設定
この設計は Atlassian の公式 RBAC ガイド(Jira Service Management 権限のベストプラクティス)と合致しています。
テスト環境での検証フローと本番移行、よくある落とし穴
実運用前にサンドボックスで動作確認を行うことで、ユーザーへの影響を最小限に抑えられます。ここでは 変更適用手順・デプロイ方法・トラブルシューティング をまとめました。
サンドボックスでの検証フロー(H3)
| 手順 | 内容 |
|---|---|
| 1 | Atlassian Cloud の「Sandbox」オプションまたは Jira Cloud Migration Assistant を利用し、プロジェクトをクローン |
| 2 | 本番と同一の設定(リクエストタイプ・ワークフロー・Automation)をサンドボックスに再現 |
| 3 | 各リクエストタイプで「作成 → 承認 → 解決」までのシナリオを複数回実行し、期待通りに遷移するか検証 |
| 4 | テスト結果をチェックリスト(フィールド表示・権限漏れ・無限ループ有無)でレビュー |
本番デプロイ手順のポイント(H3)
- バックアップ取得
-
プロジェクト設定画面から「エクスポート」し、JSON ファイルを保存(※Cloud のエクスポートは設定情報のみ対象)
-
変更点の適用
-
サンドボックスで確認した設定を手動で本番に反映(UI で同様の操作を実施)。差分インポート専用オプションは Cloud には存在しないため、必要な項目だけを個別に更新します。
-
リリースノート作成
-
変更概要・影響範囲・担当者・ロールバック手順を文書化し、関係者へ共有
-
メンテナンスウィンドウで実施
- 利用者への告知と合わせて、業務時間外にデプロイすることで影響度を低減
典型的なトラブルと対策(H3)
| トラブル | 主な原因 | 推奨対策 |
|---|---|---|
| フィールドが意図せず非表示になる | 条件式の記述ミス、JQL の誤り | 条件はできるだけシンプルにし、project = <キー> で絞り込む |
| ステータス遷移が無限ループ | 遷移条件が相互排除されていない | 各遷移に ユニークな 条件(例:status != "Resolved")を付与 |
| 権限漏れで顧客が内部情報を見る | ロールマッピングの抜け | テストユーザーで全ロールをシミュレートし、権限テーブルを二重チェック |
まとめ
Jira Service Management のカスタマイズは 「要件定義 → 設計 → サンドボックス検証 → 本番デプロイ」 という一連のフローで実施すれば、変更リスクを最小限に抑えながら業務効率化が図れます。
- 6 領域(リクエストタイプ・ワークフロー・ポータル UI・Automation・権限設計・テスト・移行) を体系的に管理
- Problem Management は Premium プランまたは対応アドオンが必要であることを明示
- 公式 Atlassian ドキュメントのみ参照し、サードパーティ製品へのリンクは控える
このガイドラインに沿って設定を進めれば、将来的な機能拡張や組織変化にも柔軟に対応できる堅牢な JSM 環境が構築できます。質問や不明点がある場合は、Atlassian コミュニティや公式サポートをご活用ください。