PermissionSetAssignment

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

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

特別なアクセスルール

Summer '20 以降、このオブジェクトにアクセスできるのは、次のいずれかの権限を持つユーザーのみとなります。

「設定・定義の参照」
「権限セットの割り当て」
ユーザーの管理

項目

項目名	詳細
AssigneeId	型 reference プロパティ Create、Filter、Group、Sort 説明 PermissionSetId で示されている権限セットまたは PermissionSetGroupId で示されている権限セットグループが割り当てられているユーザーの ID。これはリレーション項目です。リレーション名 Assignee リレーション種別 Lookup 参照先 User
ExpirationDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明指定したユーザーの権限セットまたは権限セットグループの割り当てが期限切れになる日付。この項目は、API バージョン 52.0 以降で使用できます。
IsActive	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明割り当てが有効か (`true`)、否か (`false`) を示します。デフォルトは `false` です。この項目は、API バージョン 52.0 以降で使用できます。
IsRevoked (ベータ)	型 boolean プロパティ Defaulted on create、Filter、Group、Sort、Update 説明割り当てが取り消されたか (`true`)、否か (`false`) を示します。デフォルトは `false` です。この項目は、API バージョン 57.0 以降で使用できます。この機能はベータサービスです。ベータサービスはお客様独自の裁量で試行するものとします。ベータ機能の使用には、「Agreements and Terms」に記載されたベータサービス規約が適用されます。メモ
LastCreatedByChangeId (ベータ)	型 reference プロパティ Filter、Group、Nillable、Sort 説明この権限セットまたは権限セットグループの割り当てに関連するユーザーアクセス権変更レコードの ID。この項目は、API バージョン 57.0 以降で使用できます。この項目はリレーション項目です。リレーション名 LastCreatedByChange リレーション種別 Lookup 参照先 UserAccessChange この機能はベータサービスです。ベータサービスはお客様独自の裁量で試行するものとします。ベータ機能の使用には、「Agreements and Terms」に記載されたベータサービス規約が適用されます。メモ
LastDeletedByChangeId (ベータ)	型 reference プロパティ Create、Filter、Group、Sort 説明取り消すこの権限セットまたは権限セットグループの割り当てに関連するユーザーアクセス権変更レコードの ID。この項目は、API バージョン 57.0 以降で使用できます。この項目はリレーション項目です。リレーション名 LastCreatedByChange リレーション種別 Lookup 参照先 UserAccessChange この機能はベータサービスです。ベータサービスはお客様独自の裁量で試行するものとします。ベータ機能の使用には、「Agreements and Terms」に記載されたベータサービス規約が適用されます。メモ
PermissionSetGroupId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 AssigneeId に指定されたユーザーに割り当てられる権限セットグループの ID。この項目は、API バージョン 45.0 以降で使用できます。これはリレーション項目です。リレーション名 PermissionSetGroup リレーション種別 Lookup 参照先 PermissionSetGroup
PermissionSetId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 AssigneeId に指定されたユーザーに割り当てられる権限セットの ID。これはリレーション項目です。リレーション名 PermissionSet リレーション種別 Lookup 参照先 PermissionSet

使用方法

権限セットの割り当てを検索する

どの権限がどのユーザーに割り当てられているかを調べるには、PermissionSetAssignment オブジェクトを使用して権限セットの割り当てを照会します。各ユーザーは多数の権限セットに割り当てることができ、各権限セットは多数のユーザーに割り当てることができます。そのため、各 PermissionSetAssignment ID は、単一ユーザーと単一権限セットの関連付けを表します。

たとえば、特定のユーザーに割り当てられているすべての権限セットを検索するには、次を実行します。

1SELECT Id, PermissionSetId
2FROM PermissionSetAssignment
3WHERE AssigneeId = '005600000017cKt'

特定の権限セットに割り当てられたすべてのユーザーを検索するには、次を実行します。

1SELECT Id, AssigneeId
2FROM PermissionSetAssignment
3WHERE PermissionSetId = '0PS30000000000e'

また、新しい権限セットの割り当てを作成したり、ユーザーが割り当てられていない権限セットを削除したりすることもできます。割り当てを更新するには、既存の割り当てを削除してから、新しい割り当てを挿入します。

ユーザーライセンス

権限セットを割り当てるとき、PermissionSet に UserLicenseId がある場合は、その UserLicenseId と Profile の UserLicenseId が一致している必要があります。ユーザーのライセンス割り当てを確認するには、ユーザーのプロファイルを照会してから、プロファイルのライセンスを照会します。

たとえば、ユーザーのプロファイル ID を検索するには、次を実行します。

1SELECT Id, ProfileId
2FROM User
3WHERE Id = '005D0000001GMAT'

権限セットの UserLicenseId を検索するには、次を実行します。

1SELECT Id, LicenseId
2FROM PermissionSet
3WHERE Id = '0PS30000000000e'

ID が一致する場合、割り当てが実行されます。

ユーザーに割り当てられているライセンスを持たないすべての権限セットを見つけるには、次のコードを使用します。

1SELECT Id, Assignee.Name, PermissionSet.Name
2FROM PermissionSetAssignment
3WHERE PermissionSet.LicenseId = null

Salesforce プラットフォームのオブジェクトリファレンス

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

特別なアクセスルール

項目

使用方法

関連項目: