【Jira】カスタムフィールドの入力欄が表示されない時の対象範囲と同期状態の見直し

Jiraでカスタムフィールドが突然表示されなくなった場合、プロジェクトの運用に支障をきたすことがあります。特に、入力欄が見当たらない理由が「画面レイアウト」なのか「フィールドのコンテキスト設定」なのか、あるいはJira自身の同期状態に起因するのかを切り分ける必要があります。本記事では、カスタムフィールドの入力欄が表示されない原因を「対象範囲」と「同期状態」の観点から整理し、会社員が自分で確認すべき手順を具体的に解説します。

カスタムフィールドが表示されない原因の全体像

Jiraのカスタムフィールドは、プロジェクトごと、課題タイプごとに表示条件を細かく制御できます。そのため、入力欄が表示されない原因は大きく分けて次の3つに分類できます。

• 画面レイアウトの設定: フィールドが画面に追加されていない、または非表示設定になっている。
• フィールドコンフィギュレーションのコンテキスト設定: フィールドが特定のプロジェクトや課題タイプにのみ適用されている、あるいは適用から外れている。
• Jiraの同期状態の問題: Jira Data Center/ServerのクラスタリングやJira Cloudのデータ同期が遅延している。

これらの原因は、影響範囲の広さによって推測できます。例えば、すべてのユーザーで特定のプロジェクトだけ表示されないのか、それとも一人のユーザーだけ見えないのか。現象が発生している課題タイプが限られているのかどうか。以下のセクションで、具体的な確認手順を説明します。

画面レイアウトとフィールドコンフィギュレーションの確認

画面レイアウトの基本設定を確認する

まず、カスタムフィールドがそのプロジェクトの画面レイアウトに含まれているかを確認します。Jiraでは、画面レイアウトはプロジェクトごとに設定され、さらに課題タイプごとに異なる画面を割り当てることができます。以下の手順で確認してください。

1. Jiraの管理画面(歯車アイコン → 「システム」)に移動します。
2. 「画面」メニューを開き、対象のプロジェクトで使用している画面レイアウトの一覧を表示します。
3. 問題のカスタムフィールドが画面に含まれているかどうかを確認します。もし含まれていなければ、画面に追加する必要があります。
4. また、画面内でフィールドが「非表示」に設定されていないかも確認します。フィールドのプロパティで「表示」が選択されていることを確かめてください。
5. 画面レイアウトの変更はJira管理者権限が必要です。権限がない場合は、社内の管理者に変更を依頼してください。

フィールドコンフィギュレーションのコンテキストを確認する

カスタムフィールド自体に設定されている「コンテキスト」によって、表示されるプロジェクトや課題タイプが制限されます。特に、フィールドを新しく作成した後や、既存のフィールドのコンテキストを変更した場合に、入力欄が見えなくなるケースがよくあります。確認手順は次の通りです。

1. 管理画面の「フィールド」→「カスタムフィールド」を開きます。
2. 目的のカスタムフィールドの右側にある「設定」アイコン(歯車)をクリックします。
3. 「コンテキスト」タブを選択し、現在のコンテキスト設定を確認します。
4. フィールドが適用されているプロジェクトと課題タイプを確認します。例えば、「すべてのプロジェクト」に設定されているか、特定のプロジェクトだけかどうか。
5. もし該当するプロジェクトや課題タイプが含まれていない場合は、コンテキストを編集して追加します。

コンテキスト設定はJira管理者権限が必要です。また、コンテキストを変更すると、既存の課題に保存されている値は保持されますが、画面上の表示は即座に反映されます。

プロジェクトコンテキストと課題タイプによる表示条件

カスタムフィールドは、プロジェクトの「課題タイプスキーム」や「ワークフロースキーム」とも連動しています。例えば、特定の課題タイプに対してフィールドを表示しない設定が、別の場所で上書きされている可能性もあります。以下の条件を確認してください。

プロジェクトの課題タイプスキームを確認する

プロジェクトで使用している課題タイプスキームに、対象の課題タイプが含まれているか確認します。含まれていない場合、その課題タイプ自体がプロジェクトで使用できないため、フィールドも表示されません。

ワークフローの画面プロパティを確認する

ワークフローのトランジションに「画面」が設定されている場合、その画面で表示するフィールドが制限されます。特に、画面プロパティでフィールドが「必須」や「読み取り専用」に設定されていると、入力欄が表示されないのではなく、編集できない状態になることもあります。画面プロパティの確認はJira管理者のみ可能です。フィールドがグレーアウトしている場合は、この可能性を疑ってください。

プロジェクトカテゴリと権限の影響

プロジェクトに所属していないユーザーや、適切な権限がないユーザーにはフィールドが表示されないことがあります。例えば、カスタムフィールドの「表示権限」が特定のグループだけに設定されている場合、そのグループに所属していないユーザーには入力欄が見えません。権限設定はフィールド設定の「権限」タブで確認できます。

表示されない状況	主な原因	確認すべき設定
特定のプロジェクトだけ表示されない	画面レイアウトの未設定、またはコンテキスト外	プロジェクトの画面レイアウト、フィールドのコンテキスト
特定の課題タイプだけ表示されない	コンテキストで課題タイプが除外されている	フィールドのコンテキスト設定、画面レイアウトの課題タイプ割り当て
一部のユーザーだけ表示されない	権限設定、またはブラウザのキャッシュ	フィールドの権限、ユーザーのグループ所属、ブラウザのリロード
すべてのプロジェクトで表示されない	フィールド自体が非アクティブ、またはシステム全体の設定	フィールドのステータス、グローバル設定

同期状態の確認(Jira Data Center / Serverの場合)

Jira Data CenterやServer環境では、複数のノード間で設定情報が同期されている必要があります。カスタムフィールドの定義や画面レイアウトの変更が、すべてのノードに反映されていない場合、一部のユーザーからは古い設定が表示され、入力欄が見えないことがあります。このような同期遅延は、特にクラスタ環境で発生しやすい問題です。

同期の状態を確認する方法

Jira管理者は、管理画面の「システム」→「クラスタリング」→「クラスタの状態」で各ノードの同期状況を確認できます。すべてのノードが「同期済み」と表示されているか確認してください。もし未同期のノードがあれば、手動で同期を実行するか、ノードを再起動することで解決する場合があります。

キャッシュの影響

Jiraはパフォーマンス向上のため、各種設定をキャッシュしています。キャッシュが古い情報を保持していると、変更が画面に反映されないことがあります。ブラウザのキャッシュをクリアするだけで解決するケースもあるため、まずはブラウザのハードリロード(Ctrl+F5)を試してください。それでも改善しない場合、Jiraの管理画面で「キャッシュのクリア」を実行することも選択肢です。

Jira Cloudの場合の同期に関する注意点

Jira Cloudは常に最新の状態に保たれるため、同期問題は基本的に発生しません。ただし、以下のような環境では注意が必要です。

複数のアドオンや連携サービス

Jira Cloudに接続しているアドオン(例:プラグインや自動化ルール)がカスタムフィールドの表示を制御している可能性があります。特に、画面にフィールドを動的に追加・削除するようなアドオンを使用している場合、その設定が原因で入力欄が表示されないことがあります。アドオンの設定画面を確認するか、一時的にアドオンを無効にして現象が改善するか試してください。

グローバルな変更の反映遅延

Jira Cloudは通常数秒以内に変更が反映されますが、大規模な変更やサーバー負荷が高い時間帯では、最大で数分遅れることがあります。設定を変更した直後に表示されない場合は、少し待ってから再度アクセスしてみてください。

管理者向けトラブルシューティングの手順

ここでは、Jira管理者がカスタムフィールドの表示問題を解決するための体系的な手順をまとめます。一般ユーザーはこのセクションを管理者に伝える参考にしてください。

1. 問題の再現:どのプロジェクト、どの課題タイプ、どのユーザーで表示されないのかを正確に把握します。
2. 画面レイアウトの確認:該当する画面レイアウトにフィールドが含まれているか、非表示になっていないか確認します。
3. フィールドコンテキストの確認:フィールドのコンテキスト設定で、該当するプロジェクトと課題タイプが含まれているか確認します。
4. 権限の確認:フィールドの権限設定で、対象ユーザーが表示可能な権限を持っているか確認します。
5. ワークフローの画面プロパティの確認:ワークフローのトランジションで使用する画面に、フィールドが必須または読み取り専用になっていないか確認します。
6. 同期状態の確認(Data Center/Server):クラスタの同期状態を確認し、必要に応じて同期を実行します。
7. キャッシュのクリア:Jiraのキャッシュクリア機能を実行し、ブラウザキャッシュもクリアします。
8. アドオンの影響確認:使用しているアドオンを一時的に無効にして、問題が解決するかテストします。

よくある質問と失敗パターン

よくある質問

Q: カスタムフィールドが表示されないが、他のユーザーは見えている。どうすればよいか?
A: ブラウザのキャッシュをクリアするか、別のブラウザでアクセスしてみてください。それでも改善しない場合は、権限設定が原因の可能性が高いです。自分が所属するグループがフィールドの表示権限を持っているか管理者に確認しましょう。

Q: 新しいカスタムフィールドを作成したが、どのプロジェクトにも表示されない。
A: 新しいカスタムフィールドはデフォルトで「すべてのプロジェクト」に適用されるわけではありません。フィールドのコンテキスト設定を確認し、必要なプロジェクトと課題タイプを追加してください。また、画面レイアウトにもそのフィールドを追加する必要があります。

Q: 特定の課題タイプだけフィールドが表示されない。他の課題タイプでは見えている。
A: フィールドのコンテキストで、該当の課題タイプが除外されている可能性があります。フィールド設定のコンテキストタブを開き、課題タイプの選択を確認してください。また、その課題タイプ用の画面レイアウトが別途設定されていて、そこにフィールドが含まれていない場合もあります。

失敗パターン

失敗1: 「必須フィールド」の設定を忘れる
画面レイアウトでフィールドを「必須」に設定していても、画面自体にフィールドが表示されなければ意味がありません。まずは表示されることを確認してから必須設定を行いましょう。

失敗2: コンテキストの「すべてのプロジェクト」を誤って解除する
既存のコンテキストを編集する際に、誤って「すべてのプロジェクト」を解除し、特定のプロジェクトだけを選択してしまうと、他のプロジェクトからフィールドが消えます。変更前の状態をメモしておくか、テスト環境で試すことをおすすめします。

失敗3: ブラウザのキャッシュを疑わない
Jiraの設定を変更したにもかかわらず、ブラウザの古いキャッシュが原因で表示されないケースは非常に多いです。トラブルシューティングの最初のステップとして、必ずハードリロードを試してください。

まとめ

Jiraのカスタムフィールドが表示されない場合、まずは画面レイアウトとフィールドのコンテキスト設定を確認することが基本です。特定のプロジェクトや課題タイプだけの問題なのか、全ユーザーに共通する問題なのかを切り分けることで、原因の特定が速まります。Jira Server/Data Centerでは同期状態やキャッシュも確認し、Jira Cloudではアドオンの影響を考慮してください。問題が解決しない場合は、本記事の手順を管理者に伝えて迅速な対応を依頼しましょう。

🔐

会社アカウント・認証トラブル完全解決データベース 職場または学校アカウント、MFA、Authenticator、VPN、権限、会社ポリシーで止まる問題を横断的に確認できます。