表示制御

概要

表示制御により、管理者はドキュメントカテゴリとユーザーロールに基づいてファイルアクセスを制限できます。ファイルにカテゴリを割り当て、各カテゴリを特定のロールに制限できます — それらのロール外のユーザーにはファイルが表示されません。さらに、任意のユーザーがファイルをプライベートに設定でき、自分自身と承認されたビューアーのみに表示されるようになります。

すべてのフィルタリングはサーバー側で実行されます — ユーザーがアクセスできないファイルはブラウザに送信されません。

ストレージモード要件

表示制御は、コンポーネントのStorage ModeがIsolatedに設定されている場合にのみ利用可能です：

	Standard	Isolated
標準ファイル関連リストでの表示	はい	いいえ
カテゴリ割り当て	利用不可	利用可能
プライベートに設定	利用不可	利用可能
ロールベースの表示フィルタリング	利用不可	利用可能

Isolatedモードでは、ファイルはジャンクションレコードのみを通じてレコードにリンクされます — 標準のSalesforceファイル関連リストには表示されません。

ドキュメントカテゴリ

カテゴリとは？

カテゴリは、誰がそのファイルを閲覧できるかを決定するファイルに割り当てられたラベルです。カテゴリは管理者がConfiguration Wizardを通じて定義し、カスタムメタデータ型レコードとして保存されます。

例：

健康記録
財務報告書
法的契約書
社内メモ

カテゴリフィルタリングの仕組み

各カテゴリには許可されたロールのリストがあります。ファイルにカテゴリが割り当てられている場合：

ユーザーのロールが許可リストにある場合 → ファイルは表示される
ユーザーのロールが許可リストにない場合 → ファイルは非表示になる
カテゴリにロールが割り当てられていない場合 → ファイルは全員に表示される
ファイルにカテゴリがない場合 → ファイルは全員に表示される

ファイルへのカテゴリ割り当て

Tucario - Manage File Categories権限セットを持つユーザーがカテゴリを割り当てられます：

ファイルのアクションメニューをクリックします。
Set Categoryを選択します。
ピッカーからカテゴリを選択するか、No Categoryを選択して現在の割り当てを解除します。

ファイルの表示設定は即座に更新されます。

カテゴリの管理

カテゴリはSmarter FilesアプリのConfiguration Wizardで管理します：

App LauncherからSmarter Files by Tucarioアプリを開きます。
Manage Document Categoriesをクリックします。
ステップ1 — ドキュメントタイプ：カテゴリの名前とオプションの説明を追加します。
ステップ2 — ロールの割り当て：各カテゴリについて、そのカテゴリのファイルを閲覧できるロールを選択します。
ステップ3 — 確認とデプロイ：設定を確認し、デプロイをクリックします。

プライベートドキュメント

ファイルをプライベートに設定

Isolatedモードでは、任意のユーザーがファイルをプライベートに設定できます：

ファイルのアクションメニューをクリックします。
Mark as Privateを選択します。
ファイル名の横にロックアイコンが表示されます。

ファイルは以下のユーザーのみに表示されます：

プライベートに設定したユーザー（オーナー）
Tucario - View Private Documents権限セットを持つユーザー

プライベート状態の解除

ファイルオーナーはプライベートフラグを解除できます：

プライベートファイルのアクションメニューをクリックします。
Remove Privateを選択します。
ファイルは通常の表示ルールに戻ります。

複合フィルタリングロジック

ファイルにカテゴリとプライベートフラグの両方がある場合、ファイルが表示されるには両方のチェックをパスする必要があります：

For each file:
  1. Private check:
     If file is private AND user is not the owner
     AND user lacks "View Private Documents" permission → HIDE

  2. Category check:
     If file has a category with permitted roles
     AND user's role is not in the list
     AND user lacks "Manage Categories" permission → HIDE

  3. Otherwise → SHOW

権限セット

権限セット	目的
Tucario Files	基本アクセス。アプリ、コントローラー、ジャンクションオブジェクトへのアクセスを付与します。すべてのユーザーに割り当ててください。
Tucario - Manage File Categories	ファイルへのカテゴリ割り当てを許可します。カテゴリフィルタリングをバイパスします — この権限を持つユーザーはカテゴリに関係なくすべてのファイルを閲覧できます。
Tucario - View Private Documents	他のユーザーがプライベートに設定したファイルの閲覧を許可します。

ユースケース

健康記録をHRマネージャーと医療スタッフのみに表示。
財務報告書を財務チームに制限。
法的契約書を法務部門のロールのみがアクセス可能に。
機密添付ファイルを個人使用のために個々のユーザーがプライベートに設定。
下書きドキュメントを準備が整うまで外部向けロールから非表示に。