title | description | ms.author | ms.date | ms.topic | author | ms.reviewer |
---|---|---|---|---|---|---|
SessionSettings.ProfileAppId([Guid]) Method |
Gets or sets the ID of an extension, which provides a profile, in a SessionSettings object. |
solsen |
05/14/2024 |
reference |
SusanneWindfeldPedersen |
solsen |
Version: Available or changed with runtime version 1.0.
Gets or sets the ID of an extension, which provides a profile, in a SessionSettings object.
[ProfileAppId := ] SessionSettings.ProfileAppId([NewProfileAppId: Guid])
Note
This method can be invoked using property access syntax.
SessionSettings
Type: SessionSettings
An instance of the SessionSettings data type.
[Optional] NewProfileAppId
Type: Guid
Sets the GUID of the extension that provides the profile. The value must be a valid GUID for an extension in the system table 2000000072 Profile.
[Optional] ProfileAppId
Type: Guid
The ID of the extension that is set in the SessionSettings object.
A profile can be included as part of an extension, instead of being defined as part of the base application. In order to properly identify a profile from an extension in the SessionSettings object, you must specify the extension ID, by using the ProfileAppId method, and the profile ID, by using ProfileId method.
The ProfileAppId property in a SessionSettings object corresponds to the App ID field in the in the system table 2000000073 User Personalization
This example creates a SessionSettings object that is populated with the current client user's personalization data, and then uses the ProfileAppId method and ProfileId method to set the object to use the profile that has the ID 'MyExtensionProfile', which is provided in the extension that has the ID '12345678-1234-1234-1234-1234567890AB'. Finally, the RequestSessionUpdate method sends a request to the client to abandon the current client session and start a new session that uses the new profile. This example requires a SessionSettings data type variable.
var
MySessionSettings : SessionSettings;
begin
MySessionSettings.Init;
MySessionSettings.ProfileId('MyExtensionProfile');
MySessionSettings.ProfileAppId('12345678-1234-1234-1234-1234567890AB');
MySessionSettings.RequestSessionUpdate(false);
end;
SessionSettings Data Type
Get Started with AL
Developing Extensions