Configured Events: Custom Metadata

The list of configured events is set on the Custom Metadata > Events tab in the Parameters dialog box.

NOTE. Event setup is available for the users included in the Administrators group.

In the web application select the Parameters item on the side panel of the object navigator.
In the desktop application select the Tools > Parameters item in the object navigator's main menu.

To add an event, execute one of the operations:

In the web application click the Add button.
In the desktop application:

Click the Add button.
Select the Add item in the context menu of the list of events.

After executing one of the operations the event is added to the end of the list of events. Set event name. Event identifier is generated automatically and cannot be changed.

To rename event:

Open the event name for edit:

In the web application click the event name.
In the desktop application:

Select the event and click the Rename button.
Select the Rename item in the event's context menu.
Select the event and press F2.

Enter a new name of the event and press the ENTER key.

After executing the operations the event is renamed.

To delete the event:

Select one or several events while holding down the CTRL or SHIFT key.
Execute one of the operations:

In the web application click the Delete button.
In the desktop application:

Click the Delete button.
Select the Delete item in the event's context menu.

After executing the operations the deletion confirmation dialog box opens. If the answer is positive, the selected events are deleted.

Generate event

Event occurrence is traced with task scheduler interface is used to work with the events collection. In this case the task container specified in task scheduler settings should contain tasks run on occurring the configured event.

An event may occur after executing a task if the corresponding setup is created for it. An event can also be generated from application code. The IMetabaseCustomForeEvents interface is used to work with the events collection. To generate an event, get its description by means of properties or methods of the specified interface, and execute the IMetabaseCustomForeEvent.Invoke method.

The example of generating event named Loading Start. If on executing the example the task scheduler is run, and the container, with which the task scheduler works, has tasks started on executing this event, they will be executed. To execute the example, add a link to the Metabase system assembly.

Sub InvokeEvent;
Var
    MB: IMetabase;
    CustomClassExtender: IMetabaseCustomExtender;
    Events: IMetabaseCustomForeEvents;
    ForeEvent: IMetabaseCustomForeEvent;
Begin
    // Get repository
    MB := MetabaseClass.Active;
    // Get container of custom classes
    CustomClassExtender := Mb.SpecialObject(MetabaseSpecialObject.CustomExtender).Edit As IMetabaseCustomExtender;
    // Get list of events
    Events := CustomClassExtender.Events;
    ForeEvent := Events.FindByName("Loading start");
    // Generate event
    ForeEvent.Invoke;
End Sub InvokeEvent;