Apex 開発者ガイド
jNewer Version Available
stripInaccessible メソッドによるセキュリティの適用
stripInaccessible メソッドを使用して、項目およびオブジェクトレベルのデータ保護を適用します。このメソッドを使用してクエリおよびサブクエリの結果からユーザがアクセスできない項目を除外できます。また、このメソッドを使用して、DML 操作の前にアクセスできない sObject 項目を削除して例外を回避し、信頼されないソースから非逐次化された sObject を適切な���態にすることもできます。
項目およびオブジェクトレベルのデータ保護には、Security および SObjectAccessDecision クラスを介してアクセスします。アクセスの検査は、作成、参照、更新、または更新/挿入という指定された操作のコンテキストで、現在のユーザの項目レベルの権限に基づいて行われます。stripInaccessible メソッドは、ソースレコードに現在のユーザの項目レベルセキュリティチェックに失敗した項目がないかを確認し、sObject のリストを作成します。返されるリストは、現在のユーザがアクセスできない項目が除外されている以外は、ソースレコードと同じです。getRecords メソッドによって返される sObject には、stripInaccessible メソッドの sourceRecords パラメータ内の sObject と同じ順序でレコードが含まれています。照会されない項目は、例外が発生することなく、戻りリストで null になります。
削除されたアクセスできない項目を特定するには、isSet メソッドを使用できます。たとえば、戻りリストには取引先責任者オブジェクトが含まれおり、カスタム項目 social_security_number__c はユーザからアクセスできません。このカスタム項目は、項目レベルのアクセスチェックに失敗するため、項目が設定されず、isSet は false を返します。
stripInaccessible メソッドを使用可能ないくつかの例を次に示します。
例
このコード例では、アクセスできない項目がクエリ結果から削除されます。キャンペーンデータの表示テーブルには、常に BudgetedCost を表示する必要があります。ActualCost は、この項目を読み取る権限を持つユーザのみに表示される必要があります。
例
このコード例では、アクセスできない項目がサブクエリ結果から削除されます。Contacts オブジェクトの Phone 項目を参照する権限を持たないユーザ。
例
このコード例では、DML 操作の前にアクセスできない項目が sObject から削除されます。取引先の Rating を作成する権限を持っていないユーザでも、取引先を作成できます。このメソッドでは、Rating は設定されず、例外は発生しません。
例
このコード例では、信頼されないソースからの並列化された sObject をサニタイズします。ユーザには、取引先の AnnualRevenue を更新する権限がありません。