Share via


PROFILEAPPID Function

Gets or sets the ID of an extension, which provides a profile, in a SessionSettings object.

Syntax

[CurrProfileAppId :=] SessionSettings.PROFILEAPPID([NewProfileAppId])  

Parameters

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.

Return Value

Type: GUID

The ID of the extension that is set in the SessionSettings object.

Remarks

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 function, and the profile ID, by using PROFILEID function.

The PROFILEAPPID property in a SessionSettings object corresponds to the App ID field in the in the system table 2000000073 User Personalization

Example

This example creates a SessionSettings object that is populated with the current client user's personalization data, and then uses the PROFILEAPPID function and PROFILEID function 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 function 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.

The code requires that you create the following C/AL variable.

Variable DataType
MySessionSettings SessionSettings
    MySessionSettings.INIT;
    MySessionSettings.PROFILEID('MyExtensionProfile');
    MySessionSettings.PROFILEAPPID('12345678-1234-1234-1234-1234567890AB');
    MySessionSettings.REQUESTSESSIONUPDATE(false);

See Also

INIT Function
PROFILEID Function
REQUESTSESSIONUPDATE Function
SessionSettings Data Type