用途:生成或编辑 Salesforce 权限集元数据(PermissionSet XML),授予对象、字段、用户和应用权限,输出可直接部署的元数据。
主要能力与用法:
- 定义核心属性:设置 fullName、label、description,使用描述性 API 名称。
- 对象权限:通过 objectPermissions 配置 allowCreate、allowRead、allowEdit、allowDelete、modifyAllRecords、viewAllRecords、viewAllFields 等 CRUD 权限。
- 字段级安全:用 fieldPermissions 设置 editable、readable,字段引用格式为 ObjectName.FieldName。需要编辑权限时同时设为 true。若允许查看全部字段,可改用 viewAllFields 对象权限。
- 用户权限:通过 userPermissions 授予 ApiEnabled、ViewSetup、ManageUsers、RunReports 等系统级权限。ViewAllData、ModifyAllData、ManageUsers 需安全审查。
- 应用与选项卡可见性:用 applicationVisibilities 设置应用可见;用 tabSettings 设置 Visble、Available 或 None。自定义对象选项卡名必须带 __c 后缀;标准对象选项卡使用 standard- 前缀,如 standard-Account。选项卡名与对象 API 名完全一致。
- 可选:通过 classAccesses 和 pageAccesses 授予 Apex 类与 Visualforce 页面访问;通过 license、hasActivationRequired、recordTypeVisibilities 设置许可证与记录类型可见性;通过 agentName、enabled 配置 Agentforce Employee Agent 访问,代理名须匹配已有开发者名称。
限制与失败原因:必填字段绝对不能出现在 fieldPermissions 中,平台不允许必填字段设置字段级安全,否则部署失败;字段需先确认存在且非必填(元数据含 <required>true</required> 即为必填);公式字段不可编辑;主从关系字段在子对象上为必填。API 名称错误或缺少后缀(如自定义对象、字段、选项卡缺 __c)也会导致失败。部署前应检查 fullName、label、description 已设置,遵循最小权限,无重复权限。部署使用 Salesforce CLI。官方资料未提供具体 CLI 命令与安装步骤。