Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Data extension configuration: ExtEvent

Description:
Data extension configuration ExtEvent - An extension for generating events
Configuration items:
Data extension identifierSystem text (without spaces and diacritics). It is used for unambiguous identification of data extension in data item (e.g. for Extension property).

The default value is "ev".

Target object (PmaEventGroup)Path to the target object of appropriate type, in which the data item must be registered. The object can also be selected by the button on the right.

Macro expression can be used for input, the result must be a NON-LOCALIZED path to Pma object (it is evaluated after starting the application).

Event templateThe unique text identifier of an alarm of Template type (see "Template for dynamically created items" configurator), whose configuration is used.
Automatically generated event identifierIf checked, then the alarm identifier will be created automatically by the system (_autoN).
Event identifierManually enetered alarm identifier.

This configurator sets the initial value of the property PmAlarmItem.Id.

Event source (source)The text specifies the logical placement of an alarm in the technology. It has the same meaning as "Source" configurator for standalone configured alarms/events.

Macro expression can be used for input ($.text ..) (it is evaluated while calling a method). Caution: Macro expression $vb cannot be used for input.

Event description defined here (otherwise from template)If checked, then the event description can be specified in the following configurator. Otherwise the template event description is used.
Event description (desc)

Macro expression can be used for input ($.text ..) (it is evaluated while calling a method). Caution: Macro expression $vb cannot be used for input.

Value typeMethod for obtaining value for evaluation (testing):
0 - whole value - The whole value is used.Non-zero value means true and zero value means false.
1 - defined bit - Value of specified bit is used.Non-zero value means true and zero value means false.
3 - JavaScript expression - Value defined by JavaScript expression is used.Non-zero value means true and zero value means false.
Specifies the bit number to testIf "3 - JavaScript expression" is set, then serves for specifying the particular bit index. The particular bit is identified by the order, so the lowest bit is numbered 0.
JavaScript expressionIf "3 - JavaScript expression" is set, then it serves for definition of the JavaScript expression itself. The JavaScript expression can have two parameters:
pVal: The value of PmVar.Value variable for simple usage in the expression.
pDE: Reference to data extension object (for obtaining other values from data extension or from variable).
Activate the event ifSpecifies when is the event activated.
On each writing - The event will be activatet with each writing into the variable (whole value or defined bit).
On each modification - The event will be activated if writing into a variable (whole value or defined bit) changes it.
On each change to true - The event will be activated if after writing into the variable (whole value or defined bit) the value is changed to true (non-zero value).
On each change to false - The event will be activated if after writing into the variable (whole value or defined bit) the value is changed to false (zero value).
Note:
This configuration window can be opened from the "Data extensions" configurator in the variable of the PmaData object.
 
Caution! In order to create user defined event description (desc) can be used Macro expression, that is evaluated with EVERY activation of such event. Macro expression $.expr allows to access the script interface of the data extension via the pDE variable. The pDE.Var property enables to access the PmVar object. This way it is possible to create an event description that may be different with each activation and may even contain a name, current value of a variable, etc. (pDE.Var.Name, pDE.Var.Value). See examples.
Example1:
Generating the event from the PmVar variable of the String type on each writing, so the string written into the variable will appear in the description of event. The Macro expression will be shown for "Event description (desc)" configurator.
Example2:
Generating the event from the PmVar variable of the String type on each writing, so the localised string, separator and current value written into the variable will appear in the description of event. The Macro expression will be shown for "Event description (desc)" configurator.
  $.join($.text("sys","description"), ": ", $.expr("pDE.Var.Value"))
or to ExtSubVar
  $.join($.text("sys","description"), ": ", $.expr("pDE.Var.Extension('sv').Value"))

History:
Pm8.03.00: Created
PROMOTIC 9.0.5 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice