【Salesforce】添付ファイルからFilesへの移行が一部ユーザーだけ見えない時のレポート条件と項目設定の直し方

Salesforceで従来の添付ファイル(Attachments)からFiles(ContentDocument)への移行を実施した後、特定のユーザーだけがファイルを参照できないという問題が発生することがあります。この問題は、移行時の共有設定やレポートのビュー権限に起因するケースが多く、適切なレポート条件と項目設定を見直すことで解決できます。本記事では、ファイルが見えない原因を切り分ける方法と、レポートを活用した具体的な修正手順を解説します。

添付ファイルからFilesへの移行で起こる権限問題の原因

Salesforceでは、従来の添付ファイル(Attachments)はレコードに直接紐づき、レコードへのアクセス権限があれば誰でも参照できました。一方、Files(ContentDocument)は独立したオブジェクトであり、共有設定(ContentDocumentLink)によってアクセスを制御します。この設計の違いにより、移行時に共有設定が適切に複製されないと、一部ユーザーだけが見えなくなる問題が発生します。

従来の添付ファイルとFilesのアクセス権限の違い

添付ファイルは、親レコードの共有設定に依存します。例えば商談レコードに添付されたファイルは、その商談の参照権限を持つ全ユーザーが自動的にアクセスできました。しかしFilesでは、各ファイルに個別の共有設定が必要です。移行ツール(例:ContentMigration)を使用しても、すべての共有設定が正しく移行されない場合があります。

移行後の共有設定の不備

移行時によくある問題は、以下のようなパターンです。

• 移行元の添付ファイルが複数のレコードにリンクされている場合、すべての関連レコードに対してContentDocumentLinkが作成されていない。
• 共有設定が「公開範囲:特定のユーザー」のまま、一般ユーザーには見えなくなっている。
• レポートやダッシュボードでFilesを利用する場合、フォルダの権限が不足している。

「一部ユーザーだけ見えない」問題の切り分け方

問題を解決するには、まず原因を切り分けることが重要です。以下の表に、原因別の症状と確認ポイントをまとめました。

原因	症状	確認ポイント
ContentDocumentLinkの欠落	特定のレコードのFilesのみ見えない	レコードの関連リストにFilesが表示されない
プロファイル/権限セットの不足	同一プロファイルのユーザー全員が見えない	Filesオブジェクトのアクセス権を確認
共有ルールの未設定	特定のグループ/ロールのユーザーのみ見えない	Filesの共有設定画面で共有対象を確認
レポートフォルダの権限不足	レポート上でファイルが表示されない	レポートフォルダの共有設定を確認

レポートを使って見えないファイルを特定する

問題を特定するために、以下のレポート条件を使用して、移行後のFilesの共有状態を可視化します。

• レポートタイプ:「Files」または「ContentDocument with ContentDocumentLink」 を選択します。
• フィルター条件:「ContentDocumentLink の共有エンティティID」が空白でない、かつ「ContentDocumentLink の共有タイプ」が「V(表示のみ)」または「I(共同編集者)」のものを抽出します。
• グループ化:「ファイル所有者」「親レコードのID」などでグループ化し、リンク数が期待より少ないファイルを特定します。

レポート条件と項目設定の具体的な修正手順

ここからは、実際にレポートを作成し、問題のあるファイルを特定して共有設定を修正する手順を説明します。

1. Salesforceの「レポート」タブから新規レポートを作成し、レポートタイプに「Files」または「ContentDocument with ContentDocumentLink」を選択します。
2. 表示項目として、以下のフィールドを追加します:「ファイルタイトル」「ファイル所有者」「ContentDocumentLinkのリンク先レコードID」「ContentDocumentLinkの共有タイプ」「親レコード名」。
3. フィルターロジックを設定します。「ContentDocumentLink の共有タイプ」が「V」または「I」であること、「ファイル所有者」がシステム管理者以外を含む条件にします。
4. レポートを実行し、各ファイルに対してContentDocumentLinkの数が、本来関連付けるべきレコード数と一致しているかを確認します。不足している場合、そのファイルIDをメモします。
5. 問題のファイルについて、ファイル詳細画面を開き「共有」セクションを確認します。不足しているレコードのユーザーまたはグループを手動で追加するか、Apexバッチなどで一括追加します。
6. レポートのフォルダ権限が原因の場合、「レポートフォルダ」の共有設定を開き、対象ユーザーに対して「参照」権限を付与します。

レポートタイプの選択における注意点

標準の「Files」レポートタイプでは、ContentDocumentLinkが表示されない場合があります。その場合は「ContentDocument with ContentDocumentLink」カスタムレポートタイプを作成するか、既存のものを利用してください。カスタムレポートタイプの作成には「レポートタイプ」設定で「ContentDocument」を主オブジェクト、「ContentDocumentLink」を関連オブジェクトとして追加します。

フィルター条件の設定のコツ

フィルター条件では、特定のユーザーグループだけが見えない場合、そのグループのユーザー名やロールを条件に加えると効果的です。例えば「共有エンティティID」が特定のロールIDと一致しないファイルを抽出することで、権限不足のファイルを絞り込めます。

失敗しやすいパターンと注意点

移行元の添付ファイルの参照関係を誤って削除

移行後に、元の添付ファイルを削除してしまうケースがあります。しかし、Filesの共有設定が完全に反映される前に削除すると、ファイルが完全に見えなくなるリスクがあります。必ず移行後の共有設定をレポートで確認し、必要に応じて一時的に両方を保持することを推奨します。

共有設定を一括で変更した結果、逆に見えなくなる

例えば、すべてのファイルの共有設定を「非公開」に変更した場合、意図しないユーザーにまで影響が及びます。変更前に影響範囲を特定するために、レポートを使って現在の共有設定をエクスポートし、バックアップを取得しておきましょう。

管理者に確認すべきポイント

プロファイルと権限セット

プロファイルや権限セットで、ContentDocumentオブジェクトに対する「参照」権限が有効になっているか確認してください。また、レポートやダッシュボードでFilesを使用する場合は、「レポートの作成とカスタマイズ」権限も必要です。システム管理者であれば問題ありませんが、一般ユーザーには別途権限セットを割り当てる必要があります。

共有ルールと組織の共有設定

Filesの共有設定は、レコードの共有設定とは独立しています。組織の共有設定で「公開読み取り/書き込み」になっている場合でも、Filesはデフォルトでは非公開です。共有ルールを使用して、特定のロールやグループにFilesを公開する設定が可能です。管理者は、組織の「Filesの共有設定」を確認し、必要に応じてルールを追加してください。

よくある質問(FAQ)

Q: 移行後、すべてのユーザーがFilesを見れないのはなぜですか?

A: 移行ツールの設定で、ContentDocumentLinkの作成がスキップされた可能性があります。移行ジョブのログを確認し、エラーがないかチェックしてください。また、プロファイルの権限が不足している場合もあります。

Q: レポートでFilesが見えるのに、レコードの関連リストには表示されないのはなぜ?

A: レコードの関連リストは、ContentDocumentLinkのレコードIDが正しく設定されている場合に表示されます。レポートで表示されるのは、ファイル自体が存在するからです。関連リストに表示するためには、該当のレコードに対してContentDocumentLinkを追加する必要があります。

Q: 大量のファイルを一括で共有設定を修正する方法は?

A: Data LoaderやApexバッチを使用して、ContentDocumentLinkレコードを一括作成できます。ただし、権限設定を誤るとデータ漏洩のリスクがあるため、事前にテスト環境で検証してください。また、対象ファイルの親レコードの共有設定を再確認しましょう。

まとめ

添付ファイルからFilesへの移行後に一部ユーザーだけファイルが見えない問題は、ContentDocumentLinkの欠落や権限設定の不備が主な原因です。レポートを使って該当ファイルを特定し、適切な共有設定を追加することで解決できます。問題の切り分けには、ユーザーのプロファイルや共有ルールも考慮しましょう。移行前には必ずテスト環境で動作確認を行い、本番環境では段階的に移行を実施することをお勧めします。