| sId | (String) Jednoznaczny identyfikator tekstowy event pozycji. Patrz konfigurator "Identyfikator". |
|---|---|
| tTimeOn | [opcjonalne] (Date) Czas powstania event pozycji.
Jeżeli nie jest ustawione (lub jest określona wartość 0), wtedy zwracana jest event pozycja bez kontroli czasu powstania. Jeżeli jest określony, wtedy musi czas powstania event pozycji być zgodny z określoną wartością. Jeżeli nie istnieje event pozycja zgodna z określonym tekstowym identyfikatorem oraz wpisanej wartości czasu powstania, wtedy zwracana jest wartość null dla JavaScript lub Nothing dla VBScript. Parametr tTimeOn jest pożyteczny przede wszystkim w następujących przypadkach: 1. Jeżeli istnieje kilka instancji jednej event pozycji z tym samym identyfikatorem (zpowodowane stanami event pozycji: nieaktywny niepotwierdzony [niebieski]), wtedy umożliwia zwrócić jedną konkretną instancję event pozycji (również inną, niż ostatnią). Jeżeli nie zostanie określony parametr tTimeOn, wtedy zostanie zwrócona ostatnia, najmniej stara event pozycja.
2. Jeżeli jest wykonywana operacja nad event pozycją a może powstać opóźnienie pomiędzy początkiem operacji a jej zakończeniem (okno potwierdzające dla akcji albo operacji przenoszone pomiędzy dwoma komputerami), wtedy jest wskazane określić przy pomocy parametru tTimeOn, że operacja ma zostać wykonana nad konkretną instancją event pozycji w określonym czasie. Jeżeli w chwili, gdy rozpoczęto operacja już dana instancja event pozycji nie istnieje, wtedy operacja zostanie anulowana (np. próba potwierdzenia tejże event pozycji z dwu komputerów równocześnie), w innym przypadku operacja ta została by wykonana nad nowszą (inną aniżeli pierwotna) instancją event pozycji. |
var oEv = pMe.Pm("/Event");
var oItem = oEv.Item("event0", 0);