【SharePoint】リストの表示形式を変えたら入力画面が崩れた時の直し方

SharePointリストで列やビューの表示形式をJSONでカスタマイズした後、新しいアイテムの入力画面や編集画面が崩れてしまった経験はありませんか。入力フィールドが表示されなかったり、レイアウトが乱れたりすると、業務に大きな支障が出ます。この記事では、表示形式の変更が原因で入力画面が崩れた場合の直し方を、原因の切り分けから具体的な修正手順まで詳しく解説します。

入力画面が崩れる主な原因

表示形式を変更して入力画面が崩れる原因は、大きく分けて3つあります。それぞれの特徴を理解しておくと、素早く問題を特定できます。

JSONコードの構文エラー

表示形式に使用するJSONコードに、括弧の不一致や引用符の欠落などの構文エラーがあると、SharePointが正しく解釈できず画面表示が乱れます。特に、複数の列を参照する複雑なJSONを手書きした場合に発生しやすいです。

存在しない列名や無効なプロパティの指定

JSON内で参照している列名が実際の列と一致しない、または指定したプロパティ(色、アイコンなど)がその列のデータ型で使えない場合も表示が崩れます。例えば、日付列に背景色を指定しようとして誤ったプロパティ名を使うと、全体のレンダリングが停止することがあります。

表示形式とフォームのカスタマイズの競合

SharePointリストでは、列の表示形式(列のフォーマット)と、フォーム全体のカスタマイズ(Power Appsやフォームカスタマイザー)が両方設定されている場合があります。両者が干渉し合うと、入力画面が予期しない動作をします。特に、列の表示形式で入力フィールドを非表示にする設定をしていると、フォーム上でその列が完全に見えなくなることがあります。

表示形式の確認と修正手順

ここでは、問題の原因を特定し、表示形式を修正する具体的な手順を説明します。以下の順番で試してみてください。

1. 問題が発生しているリストを開き、右上の歯車アイコンから「リスト設定」をクリックします。
2. 「列」のセクションで、表示形式を変更した列をクリックして開きます。画面下部に「この列の書式設定」というセクションがあるので、そこにJSONコードが記載されています。
3. JSONコードをすべて選択し、メモ帳などにコピーしてバックアップを取ります。その後、コードを削除して「保存」します。
4. リストに戻り、新しいアイテムの追加画面や既存アイテムの編集画面を開いて、画面が正常に表示されるか確認します。正常になった場合は、JSONコードに問題があったことが確定します。
5. コードを少しずつ修正しながら再度設定し、その都度画面を確認します。エラーの原因が特定できたら、正しいコードに置き換えて保存します。

もし列の表示形式をすべてリセットしても改善しない場合は、ビューの表示形式やフォームのカスタマイズを確認してください。ビューの表示形式は「現在のビューの書式設定」で確認できます。フォームのカスタマイズはリスト設定の「フォーム設定」から確認できます。

失敗パターンと回避方法

実際に起こりやすい失敗例とその回避方法を紹介します。

JSON内で条件分岐を使った際の誤動作

例えば、特定のユーザーのときだけ列を表示するような条件分岐を記述した場合、その条件に該当しないユーザーがフォームを開くと、列が非表示になり入力できなくなることがあります。これを避けるには、表示形式はあくまで表示のみに使い、入力の制御は別の方法(列の必須設定や権限)で行うようにします。

複数の列に同じJSONを適用した場合の競合

同じJSONコードを複数の列に適用した場合、特に列名をハードコードしていると、別の列でその列名が存在しなかったり、データ型が合わなかったりしてエラーが発生します。共有テンプレートを使う場合は、列名を動的に取得する関数(@currentField)を使うことを検討してください。

状況別の比較表

管理者へ確認すべきこと

会社のSharePoint環境で表示形式をカスタマイズする場合、以下の点を事前に管理者に確認しておくとトラブルを避けられます。

• カスタムスクリプトが許可されているかどうか。許可されていない場合、JSONの表示形式が機能しないことがあります。
• リストのフォームにPower Appsが適用されている場合、表示形式のカスタマイズと競合する可能性があるため、管理者にフォームのカスタマイズ状態を確認してください。
• 列の表示形式を頻繁に変更する場合は、変更履歴を残すためにバージョン管理が有効になっているか確認しましょう。

よくある質問

Q. 表示形式を削除しても入力画面が直らない場合はどうすればよいですか?
A. その場合、フォームのカスタマイズ(Power Apps)や、リストに適用しているJavaScriptファイルなど、他のカスタマイズが原因の可能性があります。リスト設定の「フォーム設定」からカスタマイズをオフにして確認してください。また、ブラウザのキャッシュをクリアしてから再読み込みすることも試してみてください。

Q. 表示形式のJSONコードが正しいかどうかを事前にチェックする方法はありますか?
A. オンラインのJSONバリデーター(jsonlint.comなど)を使うと構文エラーを検出できます。また、Microsoftが提供するJSON Formatterツールを利用すると、SharePoint専用のサンプルと照らし合わせて確認できます。

Q. 表示形式の変更で入力画面が崩れた場合、他のユーザーにも影響が出ますか?
A. はい、影響は全ユーザーに及びます。編集権限があるユーザー全員の入力画面が同じように崩れます。そのため、修正中はリストの編集を一時的に制限するなどの対応が必要です。

まとめ

SharePointリストの表示形式を変更したことで入力画面が崩れた場合、最初に行うべきは該当列のJSONコードを削除して正常復帰を確認することです。構文エラーや列名の誤りが原因であることが多いため、コードを慎重に見直してください。表示形式以外のカスタマイズ(Power Appsなど)が競合している可能性も考慮し、必要に応じて管理者と連携しながら修正を進めましょう。日頃から表示形式の変更履歴を残しておくことで、トラブル時の復旧がスムーズになります。