PermissionSet

サポートされているコール

create()、delete()、describeSObjects()、query()、retrieve()、search()、update()、upsert()

特別なアクセスルール

項目

使用方法

既存の権限セットを照会するには、PermissionSet オブジェクトを使用します。

たとえば、「すべてのデータの編集」権限を含むすべての権限セットを検索するには、次を実行できます。

1SELECT Name, PermissionsModifyAllData
2FROM PermissionSet
3WHERE PermissionsModifyAllData=true

PermissionSetAssignment オブジェクトと合わせて使用すると、「すべてのデータの編集」などの特定の権限に割り当てられたすべてのユーザを返すネストされたクエリを作成できます。

1SELECT Name, (SELECT AssigneeId FROM Assignments)
2FROM PermissionSet
3WHERE PermissionsModifyAllData=true

権限セットがユーザに割り当てられていない場合、権限セットを作成または削除することもできます。

ユーザライセンス

ユーザライセンスは、権限セットで使用できる権限を制御します。

どの権限セットも 1 つのユーザライセンスまたは権限セットライセンスに関連付けることができます。権限セットを異なるユーザライセンスおよび権限セットライセンスを持つ複数のユーザに割り当てる場合は、LicenseId を空のままにします。1 つの種類のライセンスを持つユーザのみがこの権限セットを使用する場合は、LicenseId をその 1 つのユーザライセンスまたは権限セットライセンスに設定します。権限セットライセンスに関連付けられた権限セットが必要な場合、LicenseId をその権限セットライセンスに設定します。LicenseId を取得するには、次のクエリを実行します。

1SELECT Id, Name
2FROM UserLicense

または、LicenseId に対してユーザまたはプロファイルを照会します。

1SELECT Id, Profile.UserLicenseId
2FROM User

子オブジェクト

API を使用する場合、各権限セットまたはアクセス制御の関連セットを、ユーザが権限レコードを入力する空のコンテナであると考えてください。

これらの子オブジェクトでは、アクセス権はレコードに保存されるため、レコードが存在しないということはアクセス権がないことを示します。SOQL クエリでレコードを返すには、各子オブジェクトに対する最小限の権限または設定が必要です。

権限は関連する複数のオブジェクトに保存されるため、SOQL を使用する場合は、どのようなクエリを作成するべきかを理解することが重要です。たとえば、オブジェクトに対する「削除」権限がある権限セットと、商品の返品を承認する権限がある (承認チェックボックスは項目権限で制御される) 権限セットを把握したいとします。権限セットを使用して SOQL の使用時に適切なクエリを行うことにより、ユーザに権限を移行するか、あるいはユーザに権限セットを割り当てるかなどの必要な情報を確実に取得できます。

たとえば、次のクエリでは Merchandise__c オブジェクトに対して「参照」権限が有効であるすべての権限セットが返されます。

1SELECT SobjectType, ParentId, PermissionsRead
2FROM ObjectPermissions
3WHERE PermissionsRead = True AND SobjectType = 'Merchandise__c'

オブジェクトに対する「参照」権限を持つすべての権限セットを照会できます。ただし、オブジェクトのレコードが存在しないためにアクセス権がない権限セットを照会することはできません。たとえば、次のクエリではレコードは返されません。これは、レコードを返すには、少なくともオブジェクトに「参照」権限が必要であるためです。

1SELECT SobjectType, ParentId, PermissionsRead
2FROM ObjectPermissions
3WHERE PermissionsRead = False AND SobjectType = 'Merchandise__c'

少なくともオブジェクトに対する「参照」権限がある場合は、同じオブジェクトのその他の権限に対する条件付きクエリを作成できます。たとえば、次のクエリでは、少なくとも「参照」権限はあるが「編集」権限がないオブジェクトのすべてのレコードが返されます。