{"title":"SessionSettings.RequestSessionUpdate(Boolean) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/sessionsettings/sessionsettings-requestsessionupdate-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/sessionsettings/sessionsettings-requestsessionupdate-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/sessionsettings/sessionsettings-requestsessionupdate-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Passes a SessionSettings object to the client to request a new session that uses the user personalization properties that are set in the object.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"SessionSettings.RequestSessionUpdate(Boolean) Method","slug":"sessionsettingsrequestsessionupdateboolean-method","at":0,"chars":2594},{"level":2,"title":"Syntax","slug":"syntax","at":330,"chars":81},{"level":2,"title":"Parameters","slug":"parameters","at":411,"chars":907},{"level":2,"title":"Remarks","slug":"remarks","at":1318,"chars":536},{"level":2,"title":"Example","slug":"example","at":1854,"chars":597},{"level":2,"title":"Related information","slug":"related-information","at":2451,"chars":143}],"text":"# SessionSettings.RequestSessionUpdate(Boolean) Method\n> Version: _Available or changed with runtime version 1.0._\nPasses a SessionSettings object to the client to request a new session that uses the user personalization properties that are set in the object. The current client session is abandoned and a new session is started.\n## Syntax\n```al\n SessionSettings.RequestSessionUpdate(saveSettings: Boolean)\n```\n## Parameters\nSessionSettings\nType: sessionsettings-data-type\nAn instance of the sessionsettings-data-type data type.\nsaveSettings\nType: ../boolean/boolean-data-type\nSpecifies whether to save the personalization properties in the SessionSettings object to the table 2000000073 User Personalization in the database for the current client user. true saves the settings; false does not.\nIf you set this parameter to true, before sending the request to the client, the server instance will store the property values of the SessionSettings object to the corresponding fields in the table 2000000073 User Personalization.\nIf you set this to false, when the new client session is closed, the next time the user signs in, the session will return to the previous personalization settings. This enables you to use the SessionSettings object to temporarily change the personalization settings for the current session.\n## Remarks\nWithin the scope of the RequestSessionUpdate method, it is not recommended to run code after the RequestSessionUpdate method call that requires client communication because the current client session will be abandoned.\nBefore the RequestSessionUpdate method is called, be sure that all user personalization properties in the SessionSettings object have values; otherwise the system default values will be used for empty properties. To help, you can use the Init method to populate the object with the values in the database.\n## Example\nThis example uses the Init method to create a SessionSettings object that includes the current client user's personalization settings from the database, and then uses the Company method to set the company to 'MyCompany'. Finally, the RequestSessionUpdate method sends a request that saves the SessionSettings object property values to the database and starts a new client session that uses the new company.\n```al\nvar\n  MySessionSettings : SessionSettings;\nbegin\n  MySessionSettings.Init\n  MySessionSettings.Company('MyCompany');\n  MySessionSettings.RequestSessionUpdate(true);\nend;\n```\n## Related information\nsessionsettings-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}