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 preset value is "ev".

Target object (PmAlarmEvent) 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 bea NON-LOCALIZED path to PROMOTIC object (it is evaluated while the application is launching).

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

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

Event sourceThe text that specifies the logical placement of an alarm/event 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 can not be used for input.

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

Macro expression can be used for input ($.text ..) (it is evaluated while calling a method). Caution: Macro expression $vb can not 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.
Specify the bit number to testIf "3 - JavaScript expression" is set, then it is used 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 is used for definition of the JavaScript expression itself. The JavaScript expression can have two parameters:
pVal: The value of Var.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 ifDefinition, 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 Data extensions configurator in the data item of the PmData object.
 
Caution!In order to create user defined event description (desc) it is possible to use 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 Var 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 Var variable of the String type on each writing, so the string written into the variable will appear in event description. The Macro expression will be shown for Event description configurator.
  $.expr(pDE.var.Value)
Example2:
Generating the event from the Var variable of the Single type on each writing, so the localised string, separator and current value written into the variable will appear in event description. The Macro expression will be shown for Event description configurator.
  $.join($.text("sys","description"),": ",$.expr("pDE.var.Value"))
or to ExtSubVar
  $.join($.text("sys","description"),": ",$.expr("pDE.var.Extension('sv').Value"))
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice