Page 9800 Users
src/Layers/W1/BaseApp/Modules/System/User/Users.Page.al428 lines, Copyright (c) Microsoft Corporation. MIT
namespace System.Security.User;using System.Agents;using System.Azure.Identity;using System.Email;using System.Environment;using System.Environment.Configuration;using System.Security.AccessControl;page 9800 Users{ AdditionalSearchTerms = 'permission,office 365 admin center,microsoft 365 admin center'; ApplicationArea = Basic, Suite; Caption = 'Users'; CardPageID = "User Card"; DelayedInsert = true; PageType = List; RefreshOnActivate = true; SourceTable = User; SourceTableView = sorting("User Name"); UsageCategory = Administration; Editable = false; AboutTitle = 'About user accounts'; AboutText = 'Here, you manage who has access, and who can do what. Assign specific permissions to individual users, and organize users in security groups with group-level permissions.'; layout { area(content) { repeater(Group) { field("User Security ID"; Rec."User Security ID") { ApplicationArea = Basic, Suite; ToolTip = 'Specifies an ID that uniquely identifies the user. This value is generated automatically and should not be changed.'; Visible = false; } field("User Name"; Rec."User Name") { ApplicationArea = Basic, Suite; Caption = 'User Name'; ToolTip = 'Specifies the user''s name. If the user is required to present credentials when starting the client, this is the name that the user must present.'; trigger OnValidate() begin ValidateUserName(); end; } field("Full Name"; Rec."Full Name") { ApplicationArea = Basic, Suite; Caption = 'Full Name'; Editable = not IsSaaS; ToolTip = 'Specifies the full name of the user.'; } field(State; Rec.State) { ApplicationArea = Basic, Suite; Caption = 'Status'; ToolTip = 'Specifies whether the user can access companies in the current environment.'; } field("Windows Security ID"; Rec."Windows Security ID") { ApplicationArea = Basic, Suite; ToolTip = 'Specifies the Windows Security ID of the user. This is only relevant for Windows authentication.'; Visible = false; Editable = not IsSaas; } field("Windows User Name"; WindowsUserName) { ApplicationArea = Basic, Suite; Caption = 'Windows User Name'; ToolTip = 'Specifies the user''s name on Windows.'; Visible = not IsSaaS; trigger OnValidate() var UserSID: Text; begin if WindowsUserName = '' then Rec."Windows Security ID" := '' else begin UserSID := Sid(WindowsUserName); WindowsUserName := IdentityManagement.UserName(UserSID); if WindowsUserName <> '' then begin Rec."Windows Security ID" := UserSID; ValidateSid(); SetUserName(); end else Error(Text001Err, WindowsUserName); end; end; } field("License Type"; Rec."License Type") { ApplicationArea = Basic, Suite; Caption = 'License Type'; Visible = not IsSaaS; ToolTip = 'Specifies the type of license that applies to the user. For more information, see License Types.'; } field("Authentication Email"; Rec."Authentication Email") { ApplicationArea = Basic, Suite; Editable = false; ExtendedDatatype = EMail; ToolTip = 'Specifies the Microsoft account that this user signs into Microsoft 365 or SharePoint Online with.'; Visible = IsSaaS; } field("User Telemetry ID"; TelemetryUserId) { ApplicationArea = Basic, Suite; Caption = 'Telemetry ID'; ToolTip = 'Specifies a telemetry ID which can be used for troubleshooting purposes.'; Editable = false; Visible = false; } } } area(factboxes) { part("Inherited Permission Sets"; "Inherited Permission Sets Part") { ApplicationArea = Basic, Suite; SubPageLink = "User Security ID" = field("User Security ID"); Visible = CanManageUsersOnTenant or IsOwnUser; } part("User Security Groups"; "User Security Groups Part") { ApplicationArea = Basic, Suite; Caption = 'Security Group Memberships'; SubPageLink = "User Security ID" = field("User Security ID"); Visible = CanManageUsersOnTenant or IsOwnUser; } part(Plans; "User Plans FactBox") { Caption = 'Licenses'; ApplicationArea = Basic, Suite; SubPageLink = "User Security ID" = field("User Security ID"); Visible = IsSaaS and (CanManageUsersOnTenant or IsOwnUser); } part(Control33; "User Settings FactBox") { ApplicationArea = All; SubPageLink = "User Security ID" = field("User Security ID"); } systempart(Control11; Notes) { ApplicationArea = Notes; Visible = false; } systempart(Control12; Links) { ApplicationArea = RecordLinks; Visible = false; } } } actions { area(navigation) { group("User Groups") { Caption = 'Groups'; action("User Details") { ApplicationArea = Basic, Suite; Caption = 'User Identifier Overview'; RunObject = page "User Details"; Image = Users; ToolTip = 'View the list of users with additional details.'; } action("Security Groups") { ApplicationArea = Basic, Suite; Caption = 'Security Groups'; Image = Users; RunObject = Page "Security Groups"; ToolTip = 'Specify security groups as a fast way of giving users access to the functionality that is relevant to their work.'; } } group(History) { Caption = 'History'; Image = History; action("Sent Emails") { ApplicationArea = Basic, Suite; Caption = 'Sent Emails'; Image = ShowList; ToolTip = 'View a list of emails that you have sent to this user.'; trigger OnAction() var Email: Codeunit Email; begin Email.OpenSentEmails(Database::User, Rec.SystemId); end; } } action("User Email Policies") { ApplicationArea = Basic, Suite; Caption = 'User Email Policies'; Image = Email; RunObject = Page "Email View Policy List"; ToolTip = 'View or edit user email policies for the users of the database.'; } action("User Settings") { ApplicationArea = Basic, Suite; Caption = 'User Settings'; Image = UserInterface; Scope = Repeater; ToolTip = 'Manage the user interface settings for the users.'; trigger OnAction() var UserPersonalization: Record "User Personalization"; UserPersonalizationPage: Page "User Personalization"; UserSettingsList: Page "User Settings List"; begin if UserPersonalization.Get(Rec."User Security ID") then begin UserPersonalizationPage.SetRecord(UserPersonalization); UserPersonalizationPage.Run(); end else begin Message(MissingUserSettingsMsg, Rec."User Name"); UserSettingsList.Run(); end; end; } } area(processing) { action(AddMeAsSuper) { ApplicationArea = All; Caption = 'Add me as Administrator'; Image = User; ToolTip = 'Assign the Administrator status to your user account.'; Visible = NoUserExists and (not IsSaaS); trigger OnAction() begin if Confirm(CreateQst, false, UserId) then Codeunit.Run(Codeunit::"Users - Create Super User"); end; } action("Update users from Office") { ApplicationArea = Basic, Suite; Caption = 'Update users from Microsoft 365'; Image = Users; ToolTip = 'Update the names, authentication email addresses, contact email addresses, plans etc. from Microsoft 365 for all users. Having SUPER permission set for all companies is required to run this action.'; Visible = IsSaaS and CanManageUsersOnTenant; Enabled = HasSuperForAllCompanies; AboutTitle = 'Keep in sync with Microsoft 365'; AboutText = 'When licenses or user accounts change in the Microsoft 365 admin center, you must sync the changes back to this list.'; trigger OnAction() begin Page.RunModal(Page::"Azure AD User Update Wizard"); end; } } area(Promoted) { group(Category_Process) { Caption = 'Process', Comment = 'Generated from the PromotedActionCategories property index 1.'; actionref(AddMeAsSuper_Promoted; AddMeAsSuper) { } actionref("Update users from Office_Promoted"; "Update users from Office") { } } group(Category_Category4) { Caption = 'Navigate', Comment = 'Generated from the PromotedActionCategories property index 3.'; actionref("User Details_Promoted"; "User Details") { } actionref("Security Groups_Promoted"; "Security Groups") { } actionref("User Email Policies_Promoted"; "User Email Policies") { } actionref("User Settings_Promoted"; "User Settings") { } } group(Category_Report) { Caption = 'Report', Comment = 'Generated from the PromotedActionCategories property index 2.'; } } } views { view(OnlyEnabled) { Caption = 'Enabled'; Filters = where(State = const(Enabled)); } } var IdentityManagement: Codeunit "Identity Management"; UserCard: Page "User Card"; WindowsUserName: Text[208]; Text001Err: Label 'The account %1 is not a valid Windows account.', Comment = '%1=user name'; Text002Err: Label 'The account %1 already exists.', Comment = '%1=user name'; Text003Err: Label 'The account %1 is not allowed.', Comment = '%1=user name'; Text004Err: Label '%1 cannot be empty.', Comment = '%1=user name'; CreateUserInSaaSErr: Label 'Creating users is not allowed in the online environment.'; DeleteUserInSaaSErr: Label 'Deleting users is not allowed in the online environment.'; MissingUserSettingsMsg: Label 'Some user settings, such as language, region, or time zone, weren''t specified when %1 was created, so default values were assigned. You can change them if needed.', Comment = '%1=user name'; CreateQst: Label 'Do you want to create %1 as super user?', Comment = '%1=user name, e.g. europe\myaccountname'; HasSuperForAllCompanies: Boolean; TelemetryUserId: Text; protected var IsSaas: Boolean; CanManageUsersOnTenant: Boolean; IsOwnUser: Boolean; NoUserExists: Boolean; trigger OnAfterGetCurrRecord() begin IsOwnUser := Rec."User Security ID" = UserSecurityId(); end; trigger OnAfterGetRecord() var UserProperty: Record "User Property"; begin WindowsUserName := IdentityManagement.UserName(Rec."Windows Security ID"); NoUserExists := false; if UserProperty.Get(Rec."User Security ID") then TelemetryUserID := LowerCase(Format(UserProperty."Telemetry User ID", 0, 4)) else Clear(TelemetryUserId); end; trigger OnDeleteRecord(): Boolean begin if UserCard.DeleteUserIsAllowed(Rec) then exit(true); if not UserCard.ManageUsersIsAllowed() then Error(DeleteUserInSaaSErr); end; trigger OnInit() var EnvironmentInfo: Codeunit "Environment Information"; UserPermissions: Codeunit "User Permissions"; begin IsSaaS := EnvironmentInfo.IsSaaS(); CanManageUsersOnTenant := UserPermissions.CanManageUsersOnTenant(UserSecurityId()); HasSuperForAllCompanies := UserPermissions.IsSuper(UserSecurityId()); end; trigger OnInsertRecord(BelowxRec: Boolean): Boolean begin if not UserCard.ManageUsersIsAllowed() then Error(CreateUserInSaaSErr); if Rec."User Name" = '' then Error(Text004Err, Rec.FieldCaption("User Name")); end; trigger OnNewRecord(BelowxRec: Boolean) begin Rec."User Security ID" := CreateGuid(); WindowsUserName := ''; end; trigger OnOpenPage() var AgentUtilities: Codeunit "Agent Utilities"; UserSelection: Codeunit "User Selection"; begin NoUserExists := Rec.IsEmpty(); UserSelection.HideExternalUsers(Rec); AgentUtilities.BlockPageFromBeingOpenedByAgent(); end; local procedure ValidateSid() var User: Record User; begin if Rec."Windows Security ID" = '' then Error(Text001Err, Rec."User Name"); if (Rec."Windows Security ID" = 'S-1-1-0') or (Rec."Windows Security ID" = 'S-1-5-7') then Error(Text003Err, Rec."User Name"); User.SetFilter("Windows Security ID", Rec."Windows Security ID"); User.SetFilter("User Security ID", '<>%1', Rec."User Security ID"); if not User.IsEmpty() then Error(Text002Err, WindowsUserName); end; local procedure ValidateUserName() var UserCodeunit: Codeunit User; begin UserCodeunit.ValidateUserName(Rec, xRec, WindowsUserName); CurrPage.Update(); end; local procedure SetUserName() begin Rec."User Name" := WindowsUserName; ValidateUserName(); end; procedure GetSelectionFilter(var User: Record User) begin CurrPage.SetSelectionFilter(User); end;}