Set o = oAlEv.Item(sId, tTimeOn)
|sId||(String) The unique text identifier of the alarm/event item. See the configurator "Identifier".|
|tTimeOn||[optional] (Date) Creation time of the alarm/event item. If time not specified (or the value 0 is set), the alarm/event item is returned without checking the creation time. If specified, the creation time of the alarm/event item must correspond to the set value. If the alarm/event item that corresponds to the specified text identifier and to the specified creating time doesn't exist, the value Nothing is returned. |
The tTimeOn parameter is useful first of all in two following cases:
1. If several instances of the alarm/event item with the same identifier exist (cased by the alarm/event states inactive unacknowledged (blue)), it enables to return one concrete instance of the alarm/event item (even other than the last). If the tTimeOn parameter is omitted, the last, the latest old, item is returned.
2. If the operation is performed over the alarm/event item and a delay between the beginning of the operation and its termination can arise (the confirmation window for the action or the operation transferred between two computers), then it is advisable to specify by the tTimeOn parameter that the operation has to be performed over the concrete instance of the alarm/event item in the time. If the instance of the alarm/event item doesn't exist in the moment when the operation starts to be performed, the operation is cancelled (e.g. an attempt to acknowledge the same alarm/event item from two computers at the same time), otherwise the operation would have been performed over the newer (other than original) instance of the alarm/event item.