Events allow executing server-side scripts at some point of time or a certain specific schedule.
Every script executing event consists of:
- the script body (stored in the sys_event_script_action table);
- the register record which the script (or the scripts) refers to;
- the event record that calls the register record (the linked script is executed as a result)
The event structure:
Event Record
Field | Description |
Name | The name of the record called from the sys_event_register table. |
Instance | The ID of the Record object. When creating an event via calling methods ss.eventQueueor ss.eventQueueScheduled, you can pass on the Record object. The object ID will be saved in this field. You'll be able to call on this value in the sys_event_script_action script body: event.instance |
Table | The table that contains the record specified in the Instance field. |
Process on | The date and time of the sys_event_script_action script execution. |
Processed | The date and time when the event has been done. |
Param_1...Param_ 5 | The String parameters. the values of them are callable in the sys_event_script_action script: event.param_1, event.param_2, and so on. |
State | Event state:
|
Processing duration ms | The sys_event_script_action script processing duration in milliseconds. |
User | The event originator. |
The Related List on the form event contains the list of all scripts from the sys_event_script_action table, that will be executed (or has been executed),
Event Register Record
Field |
Описание
Name
Имя записи регистра, на которую будет ссылаться скрипт и по которому будет вызываться событие в записи события
Description | |
Name | The name of the register record on which the script will be referenced to and which will be used to call an event in the event record. |
The Related List on the form event contains the list of all scripts from the На форму события выведен Related List, содержащий список всех скриптов из таблицы sys_event_script_action которые ссылаются на текущую запись table that are referenced to the current record.
Event Script Action Record
Field |
Description |
Name |
The name of the event script action. |
Event Register Record |
The reference to the record in the sys_event_register table. |
Script |
Скрипт выполняемый при вызове события.
В теле скрипта доступны для выбора 5 дополнительных параметров ParamThe script executed at the event call. Five additional String parameters (Param_1 ... Param |
_5) are choosable in the script body, so you can call their value in this way: event.param_1, event.param_2 |
: In the similar way, another Так же |
можно обратиться к значению других полей записи: event.column_name |
How to create an event
To create an event, add a new record into the Создать событие можно добавив новую записи в таблицы sys_event. Для этого через навигатор необходимо перейти: System Definitions -> Event -> New table. For this, please complete the following steps:
- Navigate to the System Definition -> Events
- Press New, fill in the form and press Save.
You can find the fields described above on this page.
Also, the event can be created via server-side API methods ss.eventQueueor ss.eventQueueScheduled.Либо создать событие через методы серверного API ss.eventQueue и ss.eventQueueScheduled. Подробное описание методов здесь (ссылка на https://wiki.simpleone.ru/wiki/development/view/API/Server/SimpleSystem/)
| Table of Contents | ||||
|---|---|---|---|---|
|