Codeunit 9855 Permission Set Relation

System Application, System.Security.AccessControl

src/System Application/App/Permission Sets/src/PermissionSetRelation.Codeunit.al105 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Security.AccessControl;/// <summary>/// Codeunit that provides functions for permission set relations, such as including and exlcuding permission sets./// </summary>codeunit 9855 "Permission Set Relation"{    Access = Public;    /// <summary>    /// Adds a new permission set relation.    /// </summary>    /// <param name="AppId">The app ID of the permission set.</param>    /// <param name="RoleId">The role ID of the permission set.</param>    /// <param name="Scope">The scope of the permission set.</param>    /// <param name="RelatedAppId">The app ID of the related permission set.</param>    /// <param name="RelatedRoleId">The role ID of the related permission set.</param>    /// <param name="RelatedScope">The scope of the related permission set.</param>    /// <param name="PermissionType">The type of the new permission set relation.</param>    /// <returns>true if creating the permission set relation was successful</returns>    procedure AddNewPermissionSetRelation(AppId: Guid; RoleId: Code[30]; Scope: Option System,Tenant; RelatedAppId: Guid; RelatedRoleId: Code[30]; RelatedScope: Option System,Tenant; PermissionType: Option Include,Exclude) Success: Boolean    var        PermissionSetRelationImpl: Codeunit "Permission Set Relation Impl.";    begin        exit(PermissionSetRelationImpl.AddNewPermissionSetRelation(AppId, RoleId, Scope, RelatedAppId, RelatedRoleId, RelatedScope, PermissionType));    end;    /// <summary>    /// Opens the permission set page for the specified role ID.    /// </summary>    /// <param name="Name">The name of the permission set to open.</param>    /// <param name="RoleId">The role ID of the permission set to open.</param>    /// <param name="AppId">The app ID of the permission set to open.</param>    /// <param name="Scope">The scope of the permission set to open.</param>    procedure OpenPermissionSetPage(Name: Text; RoleId: Code[30]; AppId: Guid; Scope: Option System,Tenant)    var        PermissionSetRelationImpl: Codeunit "Permission Set Relation Impl.";    begin        PermissionSetRelationImpl.OpenPermissionSetPage(Name, RoleId, AppId, Scope);    end;    /// <summary>    /// Verify that the user can edit permission sets, with the specified app ID.    /// Throws an error if not.    /// </summary>    /// <error>When the app ID is not null</error>    /// <error>When the user doesn''t have neither SUPER, nor SECURITY</error>///    /// <param name="AppId">The app ID of the permission set to verify.</param>    procedure VerifyUserCanEditPermissionSet(AppId: Text)    var        PermissionSetRelationImpl: Codeunit "Permission Set Relation Impl.";    begin        PermissionSetRelationImpl.VerifyUserCanEditPermissionSet(AppId);    end;    /// <summary>    /// CopyPermissionSet will copy the source permission set using the specified copy type.    /// </summary>    /// <param name="NewRoleId">The role ID of the new permission set that permissions are copied to.</param>    /// <param name="NewName">The name of the new permission set that permissions are copied to.</param>    /// <param name="SourceRoleId">The role ID of the source permission set that permissions are copied from.</param>    /// <param name="SourceAppId">The app ID of the source permission set that permissions are copied from.</param>    /// <param name="SourceScope">The scope of the source permission set that permissions are copied from.</param>    /// <param name="CopyType">The type of copy operation to use.    /// If the value is set to reference it will copy by creating a new permission set that includes the source set.    /// If the value is set to flat it will copy by flattening all the permissions in the source set and adding them to the new set.    /// If the value is set to clone it will copy by adding the same permissions and including the same permission sets as the source set.    /// </param>    [Scope('OnPrem')]    procedure CopyPermissionSet(NewRoleId: Code[30]; NewName: Text; SourceRoleId: Code[30]; SourceAppId: Guid; SourceScope: Option System,Tenant; CopyType: Enum "Permission Set Copy Type")    var        PermissionSetCopyImpl: Codeunit "Permission Set Copy Impl.";    begin        PermissionSetCopyImpl.CopyPermissionSet(NewRoleId, NewName, SourceRoleId, SourceAppId, SourceScope, CopyType);    end;    /// <summary>    /// Opens the permission set page in lookup mode and assigns the selected record to specified Permission Set record.    /// </summary>    /// <param name="AllowMultiselect">Allow for selecting multiple Permission Sets.</param>    /// <param name="AggregatePermissionSet">The target Permission Set.</param>    /// <returns>true if lookup was successful</returns>    procedure LookupPermissionSet(AllowMultiselect: Boolean; var AggregatePermissionSet: Record "Aggregate Permission Set"): Boolean    var        PermissionSetRelationImpl: Codeunit "Permission Set Relation Impl.";    begin        exit(PermissionSetRelationImpl.LookupAssignablePermissionSets(AllowMultiselect, AggregatePermissionSet));    end;    /// <summary>    /// Event that is raised to show security filter for a tenant permission.    /// </summary>    /// <param name="TenantPermission">The tenant permission to show security filter for.</param>    /// <param name="OutputSecurityFilter">The output security filter.</param>    [IntegrationEvent(false, false)]    [Scope('OnPrem')]    internal procedure OnShowSecurityFilterForTenantPermission(var TenantPermission: Record "Tenant Permission"; var OutputSecurityFilter: Text)    begin    end;}