$Setup
「階層」型のカスタム設定を参照する際に使用するグローバル差し込み項目の種別です。
使用方法
$Setup は、ドット表記を使用して階層カスタム設定およびその項目値にアクセスするために使用します。たとえば、$Setup.App_Prefs__c.Show_Help_Content__c です。
階層カスタム設定では、次の 3 つの異なるレベルの値を使用できます。
- すべてのユーザーのデフォルト値である組織
- 組織の値を上書きするプロファイル
- 組織およびプロファイルの値を上書きするユーザー
このグローバル変数を使用する Visualforce ページでは、「リスト」型のカスタム設定は使用できません。リストカスタム設定には、Apex でアクセスできます。
例
次の例では、ユーザー設定に応じて入力項目に拡張ヘルプメッセージを条件付きで表示する方法を示しています。
カスタム設定の組織レベルが true に設定されていると、デフォルトで拡張ヘルプメッセージがユーザーに表示されます。個々のユーザーがヘルプメッセージの表示を希望しない場合は、そのユーザーのカスタム設定を false に設定して、組織 (またはプロファイル) の値を上書きすることができます。
1<apex:page>
2 <apex:inputField value="{!usr.Workstation_Height__c}"/>
3 <apex:outputPanel id="helpWorkstationHeight"
4 rendered="{!$Setup.App_Prefs__c.Show_Help_Content__c}">
5 Enter the height for your workstation in inches, measured from the
6 floor to top of the work surface.
7 </apex:outputPanel>
8 ...
9</apex:page>