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

CustomPermission

カスタム機能へのアクセス権限を付与する権限を表します。Metadata メタデータ型を拡張し、その fullName 項目を継承します。

ファイルのサフィックスおよびディレクトリの場所

CustomPermission コンポーネントのサフィックスは .customPermission であり、customPermissions フォルダーに保存されます。

バージョン

CustomPermission コンポーネントは、API バージョン 31.0 以降で使用できます。

特別なアクセスルール

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

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

項目

項目名	項目の型	説明
connectedApp	string	この権限に関連付けられた接続アプリケーションの名前。最大 80 文字です。
description	string	カスタム権限の説明。最大 255 文字です。
isLicensed	boolean	必須。参照のみ。権限にアクセスする前に適切な Salesforce ライセンスが必要か (`true`)��否か (`false`) を示します。
label	string	必須。カスタム権限の表示ラベル。最大 80 文字です。
requiredPermission	CustomPermissionDependencyRequired[]	親カスタム権限に必要なカスタム権限を示します。この項目は、API バージョン 32.0 以降で使用できます。

CustomPermissionDependencyRequired

CustomPermissionDependencyRequired は、カスタム権限が親カスタム権限に必要かどうかを決定します。親が有効な場合、必要なカスタム権限は有効である必要があります。

項目名	項目の型	説明
customPermission	string	必須。カスタム権限名。
dependency	boolean	必須。このカスタム権限が親カスタム権限に必要か (`true`)、否か (`false`) を示します。

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

CustomPermission コンポーネントの例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<CustomPermission xmlns="http://soap.sforce.com/2006/04/metadata">
3   <connectedApp>Acme</connectedApp>
4   <description>Read and edit access for Acme accounts.</description>
5   <label>Acme Account Full Access</label>
6   <requiredPermission>
7      <customPermission>Acme_Account_Read</customPermission>
8      <dependency>true</dependency>
9   </requiredPermission>
10</CustomPermission>

次の package.xml の例では、以前の定義と、接続アプリケーションに関連付けられている他のカスタム権限を参照します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3   <types>
4      <members>Acme</members>
5      <name>ConnectedApp</name>
6   </types>
7   <types>
8      <members>Acme_Account_Email_Read</members>
9      <members>Acme_Account_Phone_Edit</members>
10      <members>Acme_Account_Full_Access</members>
11      <members>Acme_Account_Read</members>
12      <name>CustomPermission</name>
13   </types>
14   <types>
15      <members>Acme_Account_Email_Read</members>
16      <members>Acme_Account_Phone_Edit</members>
17      <members>Acme_Account_Full_Access</members>
18      <members>Acme_Account_Read</members>
19      <name>PermissionSet</name>
20   </types>
21   <version>60.0</version>
22</Package>

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

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

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