この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

PermissionSetGroup

権限セットとセット内の権限のグループを表します。権限セットグループを使用して、職務やタスクに基づいて権限を整理します。その後、必要に応じてグループをパッケージ化できます。

Metadata メタデータ型を拡張し、その fullName 項目を継承します。

宣言的なメタデータファイルのサフィックスおよびディレクトリの場所

権限セットグループは permissionsetgroups ディレクトリに保存されます。ファイル名は権限セットの API 参照名に一致し、拡張子は .permissionsetgroup です。たとえば、Finance_Mgmt_PermSetGroup という名前の権限セットグループは permissionsetgroups/Finance_Mgmt_PermSetGroup.permissionsetgroup に保存されます。

バージョン

権限セットグループは API バージョン 45.0 以降で使用できます。

特別なアクセスルール

Summer ’20 以降、この種別を表示するには、ユーザーは次の権限のいずれかを持っている必要があります。

「設定・定義の参照」
「セッション権限セットの有効化の管理」
「権限セットの割り当て」

この種別を編集するには、ユーザーは「プロファイルと権限セットの管理」権限を持っている必要があります。

項目

項目	項目の型	説明
description	string	権限セットグループの作成者が提供する権限セットグループの説明。
hasActivationRequired	boolean	権限セットグループが、関連付けられた有効なセッションを要求するか (`true`)、否か (`false`) を示します。デフォルト値は `false` です。この項目は、API バージョン 53.0 以降で使用できます。
label	string	必須。権限セットグループの表示ラベル。
mutingPermissionSets	string	権限セットグループで無効にする権限が含まれる権限セット。この項目は、API バージョン 46.0 以降で使用できます。
permissionSets	string	権限セットグループに含まれる 1 つ以上の権限セット。
status	string	権限セットグループの再適用の状況を示します。有効な値は、次のとおりです。 `Updated` — グループは最新です。 `Outdated` — グループに再適用が必要です。 `Updating` — グループは再適用モードになっています。 `Failed` — グループの再適用に失敗しました。

宣言的なメタデータの定義のサンプル

権限セットグループを追加する場合、次のようなことを実行できます。権限セットグループではなく、参照される権限セットに個々の権限が含まれます。

1<?xml version="1.0" encoding="UTF-8"?>
2<PermissionSetGroup xmlns="http://soap.sforce.com/2006/04/metadata">
3     <fullName>Finance_Mgmt_PermSetGroup</fullName>
4     <description>Finance_Mgmt_PermSetGroup desc</description>
5     <label>Finance_Mgmt_PermSetGroup</label>
6     <permissionSets>Billing_PS</permissionSets>
7</PermissionSetGroup>

権限セット Billing_PS には、Finance_Mgmt_PermSetGroup に含まれている個々の権限が含まれます。

1<?xml version="1.0" encoding="UTF-8"?>
2<PermissionSet xmlns="http://soap.sforce.com/2006/04/metadata">
3     <fullName>Billing_PS</fullName>
4     <description>Billing_PS</description>
5     <label>Billing_PS</label>
6     <hasActivationRequired>false</hasActivationRequired>
7     <license>Salesforce</license>
8     <userPermissions>
9          <enabled>true</enabled>
10          <name>ViewSetup</name>
11     </userPermissions>
12     <userPermissions>
13          <enabled>true</enabled>
14          <name>ViewRoles</name>
15     </userPermissions>
16     <userPermissions>
17          <enabled>true</enabled>
18          <name>EditBillingInfo</name>
19    </userPermissions>
20</PermissionSet>

この package.xml マニフェストの例では、組織の PermissionSetGroup メタデータを取得します。権限セットグループを取得する場合、関連するコンポーネントも取得します。たとえば、PermissionSetGroup を取得するには、PermissionSet も取得する必要があります。

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3     <types>
4          <members>Finance_Mgmt_PermSetGroup</members>
5          <name>PermissionSetGroup</name>
6     </types>
7     <types>
8          <members>Billing_PS</members>
9          <name>PermissionSet</name>
10     </types>
11     <version>45.0</version>
12</Package>

マニフェストファイル内のワイルドカードのサポート

このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。

メタデータ API 開発者ガイド