Skip to main content
Version: 8.1

system.perspective.logout

This function is used in Python Scripting.

Description

Triggers a logout event, which will log the user out. For this function to work, an Identity Provider (IdP) must be set in the Perspective Project properties.

caution

Be advised that this function should not be used in the same script, or in the same triggering event as system.perspective.login. Logging in and Logging out should always be triggered by separate events.

Syntax

system.perspective.logout([sessionId], [pageId], [message])

Parameters

TypeParameterDescription
StringsessionIdIdentifier of the Session to target. If omitted, the current Session will be used automatically. When targeting a different Session, then the pageId parameter must be included in the call. [optional]
StringpageIdIdentifier of the Page to target. If omitted, the current Page will be used automatically. [optional]
Stringmessage
New in 8.1.8
The message to display when the user logs out of their session. This message is only shown when the project requires authentication. If omitted, the default message (set in Project Properties) is shown. [Optional]

Returns

Nothing

Scope

Gateway, Perspective Session

note

This function will only work in the Gateway scope if both sessionId and pageId are supplied to the call.

Code Examples

Code Snippet
# This example is a script on a Button component and will log the current user out.
system.perspective.logout()

Keywords

system perspective logout, perspective.logout