{"title":"Codeunit 9170 Conf./Personalization Mgt., procedures","url":"https://jonas-paprotka.de/ref/codeunit/9170-conf-personalization-mgt/procedures/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":9170,"name":"Conf./Personalization Mgt.","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/9170-conf-personalization-mgt/","json":"https://jonas-paprotka.de/ref/codeunit/9170-conf-personalization-mgt.json"},"aspect":"procedures","total":32,"rows":[{"name":"DefaultRoleCenterID","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCurrentProfile","sig":"(var Record All Profile)","named":"(var AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetCurrentProfileNoError","sig":"(var Record All Profile)","named":"(var AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"TryGetDefaultProfileForCurrentUser","sig":"(var Record All Profile)","named":"(var AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsCurrentProfile","sig":"(Option, Guid, Code[30])","named":"(Scope: Option; AppID: Guid; ProfileID: Code[30])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(Scope: Option; AppID: Guid; ProfileID: Code[30])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"SetCurrentProfile","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CopyProfileWithUserInput","sig":"(Record All Profile, var Record All Profile)","named":"(SourceAllProfile: Record \"All Profile\"; var DestinationAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(SourceAllProfile: Record \"All Profile\"; var DestinationAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CopyProfile","sig":"(Record All Profile, Code[30], Text[100], var Record All Profile)","named":"(AllProfile: Record \"All Profile\"; NewProfileID: Code[30]; NewProfileCaption: Text[100]; var NewAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\"; NewProfileID: Code[30]; NewProfileCaption: Text[100]; var NewAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ResolveAppNameFromAppId","sig":"(Guid)","named":"(AppId: Guid)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use function \"GetAppName\" from Codeunit \"Extension Management\".","tag":"19.0"},"range":"17-21","first":17,"last":21,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"(AppId: Guid)","returns":"Text","kind":"procedure","access":"public","obsolete":null},{"from":19,"to":21,"named":"(AppId: Guid)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use function \"GetAppName\" from Codeunit \"Extension Management\".","tag":"19.0"}}]},{"name":"ClearProfileConfiguration","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ClearUserPersonalization","sig":"(Record User Personalization)","named":"(User: Record \"User Personalization\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"This procedure cleared old \"User Metadata\" as well. Use ClearPersonalizedPagesForUser instead.","tag":"22.0"},"range":"17-24","first":17,"last":24,"obsoleteSince":22,"spans":[{"from":17,"to":21,"named":"(User: Record \"User Personalization\")","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":22,"to":24,"named":"(User: Record \"User Personalization\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"This procedure cleared old \"User Metadata\" as well. Use ClearPersonalizedPagesForUser instead.","tag":"22.0"}}]},{"name":"ChangeDefaultRoleCenter","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ValidateDeleteProfile","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ValidateDisableProfile","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"FilterToInstalledLanguages","sig":"(var Record Windows Language)","named":"(var WindowsLanguage: Record \"Windows Language\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(var WindowsLanguage: Record \"Windows Language\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ValidateTimeZone","sig":"(var Text)","named":"(var TimeZoneText: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use the method \"ValidateTimeZone\" from codeunit \"Time Zone Selection\".","tag":"19.0"},"range":"17-21","first":17,"last":21,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"(var TimeZoneText: Text)","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":19,"to":21,"named":"(var TimeZoneText: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use the method \"ValidateTimeZone\" from codeunit \"Time Zone Selection\".","tag":"19.0"}}]},{"name":"LookupTimeZone","sig":"(var Text)","named":"(var TimeZoneText: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use the method \"LookupTimeZone\" from codeunit \"Time Zone Selection\".","tag":"19.0"},"range":"17-21","first":17,"last":21,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"(var TimeZoneText: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null},{"from":19,"to":21,"named":"(var TimeZoneText: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Please use the method \"LookupTimeZone\" from codeunit \"Time Zone Selection\".","tag":"19.0"}}]},{"name":"DownloadProfileConfigurationPackage","sig":"()","named":"()","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CopyProfilePageMetadata","sig":"(Record All Profile, Record All Profile)","named":"(OldAllProfile: Record \"All Profile\"; NewAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use procedure CopyProfile instead, which also handles copying page metadata.","tag":"18.0"},"range":"17-24","first":17,"last":24,"obsoleteSince":18,"spans":[{"from":17,"to":17,"named":"(OldAllProfile: Record \"All Profile\"; NewAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null},{"from":18,"to":21,"named":"(OldAllProfile: Record \"All Profile\"; NewAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use new NavDesignerALFunctions.CopyProfile functionality to copy profiles which also handles copying page metadata.","tag":"18.0"}},{"from":22,"to":24,"named":"(OldAllProfile: Record \"All Profile\"; NewAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use procedure CopyProfile instead, which also handles copying page metadata.","tag":"18.0"}}]},{"name":"GetSettingsPageID","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use function \"GetPageId\" from codeunit \"User Settings\" instead.","tag":"19.0"},"range":"17-21","first":17,"last":21,"obsoleteSince":19,"spans":[{"from":17,"to":18,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null},{"from":19,"to":21,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use function \"GetPageId\" from codeunit \"User Settings\" instead.","tag":"19.0"}}]},{"name":"RaiseOnOpenRoleCenterEvent","sig":"()","named":"()","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"SetOtherProfilesAsNonDefault","sig":"(Record All Profile)","named":"(NewDefaultAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(NewDefaultAllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ChangePersonalizationForUserGroupMembers","sig":"(Code[20], Code[30], Code[30])","named":"(UserGroupCode: Code[20]; OldProfileID: Code[30]; NewProfileID: Code[30])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-24","first":17,"last":24,"obsoleteSince":null,"spans":[{"from":17,"to":24,"named":"(UserGroupCode: Code[20]; OldProfileID: Code[30]; NewProfileID: Code[30])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ExtractZipFile","sig":"(Text, Text)","named":"(ZipFilePath: Text; DestinationFolder: Text)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(ZipFilePath: Text; DestinationFolder: Text)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetProfileConfigurationUrlForWeb","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"CanDeleteProfile","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetProfileUrlParameterForEvaluationCompany","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"OpenProfileCustomizationUrl","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"IsProfileIdAmbiguous","sig":"(Record All Profile)","named":"(AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"17-29","first":17,"last":29,"obsoleteSince":null,"spans":[{"from":17,"to":29,"named":"(AllProfile: Record \"All Profile\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"ClearPersonalizedPagesForUser","sig":"(Guid)","named":"(UserSid: Guid)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"22-29","first":22,"last":29,"obsoleteSince":null,"spans":[{"from":22,"to":29,"named":"(UserSid: Guid)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"ChangePersonalizationForUserGroupMembers","sig":"(Record User Group, Record User Group)","named":"(xUserGroup: Record \"User Group\"; UserGroup: Record \"User Group\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"22-24","first":22,"last":24,"obsoleteSince":null,"spans":[{"from":22,"to":24,"named":"(xUserGroup: Record \"User Group\"; UserGroup: Record \"User Group\")","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetDefaultProfileID","sig":"(Guid, var Record All Profile)","named":"(UserSecurityID: Guid; var AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"27-29","first":27,"last":29,"obsoleteSince":null,"spans":[{"from":27,"to":29,"named":"(UserSecurityID: Guid; var AllProfile: Record \"All Profile\")","returns":"","kind":"procedure","access":"public","obsolete":null}]}]}