Qbik Helpsys

Boolean value

The global data Boolean value provides a centralized true or false value that WinGate components and services can check or change during their operations. For example, Boolean values can be used for controlling policy or script evaluation behavior. You can have a policy or script check or change the current state of the boolean value, to help determine what processing path it should take.

Using a global data boolean value in this way allows you to add greater complexity to script and policy evaluation, since the state of the boolean value can also be set by the configuration and activity of other WinGate services or components.

You can also control the status of a global data boolean value by creating a switch for it in the Dashboard provided by the Data module. Other WinGate components that have been configured to refer to the value of the boolean, can then have their activity easily controlled from this switch on the Dashboard.

Read more about switches on the Dashboard

Creating Boolean values

Boolean values can be created in several ways:

  1. Using the Global Data panel

    1. Open the WinGate Management console.
    2. Navigate to Control Panel > Data.
    3. Select New Boolean value from the Tasks menu. Or alternatively right click anywhere on the Global Data panel and select New Boolean value from the menu. This will open the Edit Boolean configuration.
    4. In the Boolean name field, enter a suitable name for the Boolean value. This is the name that will be used to refer to this Boolean value when accessing global data from throughout WinGate.
    5. In the Value drop down menu, set the starting value that the boolean value will be set to by default.
    6. Select the Store value between restarts checkbox if you wish the Boolean value to be stored after the WinGate engine has been stopped and restarted, otherwise it will be deleted when the WinGate engine is stopped.
    7. Click OK and the new Boolean value will now be listed in the Global Data panel.
  2. Using script or the Symbol Browser

    When using a WinGate scripting system (such as the Lua or Javascript event processors) or a configuration that has access to the Symbol browser, you can utilize the Data object published by the Data module to create and manage global data Boolean values. The Data object provides the GetBool(Text BooleanName) method to create or access particular Boolean value.

    e.g. A script could contain:

    Data.GetBool("testbool")

    This would attempt to get the value of a global data Boolean value called testbool. If this Boolean value did not exist, a new Boolean value would be created automatically with the name testbool. Like other global data items, if the specified Boolean value does not exist then it is created automatically.

    Read more about using WinGate objects

Note

Naming global data items

After they are created, global data items are identified throughout WinGate by their type (e.g. a string, a Boolean, a list etc), and the name you give them.

Global data items of the same type must each have a unique name. If you create a new global data item with the same name as an existing item of the same type, then the new item will replace the old one.

Using Boolean values

Like other global data items, Boolean values can be referenced, modified, and deleted whenever you are:

  1. Using a WinGate script system.
  2. Using a WinGate configuration that has access to the Symbol browser.

Read about accessing global data items

  1. no comments yet...

Download helpfile

You can use basic Full-Text Searches against the page title and body to find matching articles. Use the following search modifiers to refine your query:

  • event management (no quotes) will find all pages containing the words "event" OR "management"
  • "event management" (with quotes) will find all pages containing the phrase "event management"
  • +event -management will find all pages containing the word "event", AND NOT the word "management"