Podstawowe dane
Z Net47 2.0
Spis treści |
Zapytanie (nowa kolejka):
//BEGIN// <?xml version="1.0" encoding="UTF-8"?> <Net47> <SessionID>9859c16379c2f22e2db8dde9f41cc6a8</SessionID> <!-- ID sesji które otrzymaliśmy po zalogowaniu, niezbędne do przeprowadzenia jakiejkolwiek transakcji --> <Priority>3</Priority> <!-- Priorytet zlecanego zadania, dostępne od -19 do 20, gdzie -19 jest najwyższym priorytetem który zastanie wykonany w pierwszej kolejności --> <Term>Short</Term> <!-- opcjonalne --> <!-- Dostępne: Short lub Long (istotne duże i małe litery), w przypadku braku, przyjmuje wartość Short --> <Request> <Type>AuthorizationLogout</Type> <AuthorizationLogout> <SessionID>9859c16379c2f22e2db8dde9f41cc6a8</SessionID> </AuthorizationLogout> </Request> </Net47> //BEGINEND//
Odpowiedź (nowa kolejka):
W przypadku odpowiedzi na zapytanie będące zleceniem (tak jak np powyżej) wygląda następująco:
//BEGIN// <?xml version="1.0" encoding="UTF-8"?><Net47><Request><Type>QueueID</Type><QueueID><ID>15</ID></QueueID></Request></Net47> //BEGINEND//
Zapytanie (o gotową kolejkę):
//BEGIN// <?xml version="1.0" encoding="UTF-8"?> <Net47> <SessionID>7eda4e589eab180979d0f1fd36479674</SessionID> <Priority>3</Priority> <Request> <Type>GetQueue</Type> <GetQueue> <QueueID>105</QueueID> </GetQueue> </Request> </Net47> //BEGINEND//
W przypadku odpowiedzi na zapytanie będące pytaniem o wykonane zlecenie (jak powyżej) otrzymamy gotowy wynik wygenerowany przez funkcję podwykonawczą
Odpytywanie statusu kolejki
//BEGIN// <?xml version="1.0" encoding="UTF-8"?> <Net47> <SessionID>6243ed6dc002adec9b166e3df13f4924</SessionID> <Priority>3</Priority> <Request> <Type>QueueStatus</Type> <QueueStatus> <QueueID>117</QueueID> <!-- id kolejki o który pytamy --> </QueueStatus> </Request> </Net47> //BEGINEND//
Wynik:
//BEGIN// <?xml version="1.0" encoding="UTF-8"?> <Net47> <QueueID>144</QueueID> <Status> <StatusID>3</StatusID> <!-- Status kolejki, opis poniżej --> <Progress>44</Progress> <!-- Zadanie ukończone wyrażone w procentach --> <Priority>-4</Priority> <!-- Priorytet zadania --> <CreateDate>2011-11-30 12:25:50.658603</CreateDate> <!-- Data utworzenia --> <UpdateDate>2011-11-30 12:25:50.79373</UpdateDate> <!-- Data ostatniej modyfikacji kolejki --> </Status> </Net47> //BEGINEND//
Statusy
Statusy kolejek są wyrażone numerycznie:
- -2 = Błąd w odpowiedzi, zostanie zwrócony gdy pobierzemy wynik kolejki
- -1 = Brak uprawnień
- 0 = Przygotowywanie... Dla zleceń wymagających określonej kolejności zadań
- 1 = Dodano do kolejki, oczekuje na swoją kolej (zależne od priorytetu oraz aktualnego użycia CPU)
- 2 = W trakcie wykonywania
- 3 = Gotowe, można pobrać
- 4 = Gotowe długoterminowe zadanie, można pobrać odpowiednią funkcją wszystkie długoterminowe dla określonego użytkownika
- 5 = Kolejka której funkcją jest dodanie nowych kolejek, oznacza ukończenie dodawania kolejek, co nie oznacza iż są już wykonane