Skip to main content

Description

This Node initializes a new xApp session. After the execution of this Node, the xApp can be accessed in two different ways:

Without PIN

To require only a URL to access an xApp session, a Session URL can be shared. This URL is available via the xApp Session URL token. The xApp Session URL token provides a URL, which is also accessible via input.apps.url in the input object. With the provided link, a user can access the xApp page without requiring a PIN.

With PIN

To allow users to access the xApp session via a PIN, share both a PIN and a PIN Page URL with the users. This functionality is available via the xApp PIN Page URL token and the xApp: Get Session PIN Node. The Get Session PIN Node generates a PIN, which is accessible via the xApp Session PIN token or input.apps.session.pin in the input object. The xApp PIN Page URL token provides a URL, which is also accessible via input.apps.baseUrl in the input object. With the provided link, a user can access the PIN page and enter their provided PIN to gain access to the xApp.

Parameters

ParameterTypeDescription
Background ColorCognigyScriptA color that is displayed in the background of all Shell Page Screens. You can use CSS background-color values such as hex, hsl+a, and rgb+a.
Text ColorCognigyScriptA color that is used for textual content on all Shell Page Screens. You can use CSS color values such as hex, hsl+a, and rgb+a. Make sure that the text color has high contrast with the background color.
LogoListYou can choose to show the default logo, not any logo, or a custom logo. If you select the custom logo option, specify the Custom Logo URL.
Custom Favicon URLCognigyScriptAn image URL for the custom favicon.
Page TitleCognigyScriptA text shown as a tab or window title. The title is displayed on all Shell Page Screens.
ParameterTypeDescription
’Loading’ TextCognigyScriptSpecify messages displayed to the user when the xApp Page is loading
’Launch Error’ TextCognigyScriptSpecify messages displayed to the user when the xApp Page fails for some reason
’xApp Error’ TextCognigyScriptSpecify messages displayed to the user when the xApp Page encounters an error or is halted
Customize the text displayed on the Intermediate Screen. Alternatively, you can replace the default Intermediate Screen with an xApp Page by providing the xApp Template, a mini website containing HTML/CSS/JS, and parameters that you pass into this xApp Template, the xApp Template Data.
Customize the text displayed on the Connection Screen. Alternatively, you can replace the default Connection Screen with an xApp Page by providing the xApp Template, a mini website containing HTML/CSS/JS, and parameters that you pass into this xApp Template, the xApp Template Data.

More Information

I