Table of Contents
< All Topics

Gnosis Script Variables

Several special variables available in Gnosis Scripts are context-sensitive and start with a dollar sign symbol.


Gnosis Platform built timestamp.


Invoke the Expression property for the Base Type. It is valid only in the Expression type properties for extended Item Types.

The following is an Expression of the derived Item Type. It is an anonymous function, so the context can be passed to the $Base:

(this) => (
	this.Parent.TriggerNotificationOnStateChange(null, 'Speaker Created', { ProposedSpeaker = this });


Current client IP address.


The $Config object holds the Gnosis App Configuration settings. For security reasons, the keys are unavailable for the $Config object.

To get a configuration setting value, specify the key:


In addition, the values for sub-keys (e.g., $Config.’Mail/Support’) are secure in that null will be returned. The value is only available when the configuration setting is used in Gnosis Extention Functions and when passed as the passw$Contextord to specific Gnosis Scripts functions:

  • DocProtect
  • Excel
  • RestService
  • Zip


All currently available variables.


An object containing the session cookies.


A flag indicating the View is of type New or Update. Valid only during server-side view rendering or view state calculation.


The current Error occurred during Workflow execution. Valid only inside OnError handlers (see Sequence activity).


The special frame evaluation guard (usually on the Solution level.)


Product License information.


The context Item for the current operation.


The context Item Type of the current operation.


Input parameters for current View or Task.


The context Property for the View State calculation and Constraint Check expressions.


The result of the executed background task. Valid only inside Callback handlers.


This flag indicates that the script is running in read-only mode; thus, all non-read-only operations are prohibited. If a script attempts to change something, such as updating an Item, it terminates with an error.

Views called with the GET method are in read-only mode.


The current request URL.


This flag indicates that the script is running in service mode. Operates with fewer restrictions and ignores permissions.

To enable this mode, use the ServiceMode() function.

Users with the Administrator Role can set the Service Mode for the session.


The current server URL.


This flag indicates that the script is running in simulation mode.

Simulation mode is used for debugging purposes. It permits non-read-only operations but simulates them without affecting anything.

So, updating an Item in simulation mode will succeed, but no changes will be applied after the script is finished.

  • Simulation mode is available in the Scripting Console.
  • Calling an Action View using the v1 View GET method will run in Simulation mode.
  • Calling an Action View with the simulate=true parameter.
  • To enable this mode, use the Simulate() function.

$Solution or @

The target solution of the current operation (if any). (@) is the shortcut version of this variable.

$Solutions or $

Solutions are accessible to the current User (dictionary name -> Solution). ($) is the shortcut version of this variable.


The event target (string) of the current event. Valid only inside Event handlers.


The target view from which the rendering started (if any). Valid only during server-side view rendering.


The current background task (if any). Valid only for background task scripts.


The current Transition of the target item. Valid only for lifecycle state transitions.


The current User is responsible for the current operation. For example, the User who initiated the lifecycle state transition, changed, or requested particular item data.


Returns an object:

	"IsUser": true,
	"Role": "Administrator",
	"FirstName": "System",
	"LastName": "Support",
	"TimeZone": {
		"Id": "Eastern Standard Time",
		"Offset": "-05:00:00",
		"Name": "(UTC-05:00) Eastern Time (US & Canada)",
		"StandardName": "Eastern Standard Time",
		"DaylightName": "Eastern Daylight Time",
		"HasDaylight": true,
		"Abbreviation": "EST"
	"Language": "en-US",
	"Id": "d82b5d94-d2c9-ee11-8e62-a841f43fb547",
	"Name": "System Support"


The new Value of the target item property. Valid only for constraint check expressions.


Platform Version.


The current View is being rendered (if any). Valid only during server-side view rendering.