Podstawowe dane
Z Net47 2.0
Spis treści[ukryj] |
Zapytanie (nowa kolejka):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | //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:
1 2 3 4 5 6 7 8 9 10 11 | //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ę):
pobierajac kolejke o statusie -2. 3 lub 5 zostanie automatycznie usunieta
1 2 3 4 5 6 7 8 9 10 11 12 13 | //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
1 2 3 4 5 6 7 8 9 10 11 12 13 | //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:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | //BEGIN// <? xml version = "1.0" encoding = "UTF-8" ?> < Net47 > < Request > < 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 > </ Request > </ 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