Opis REST metoda za obradu zadataka
PAAS takođe radi kao web servis. Možete pristupiti metodama za dobijanje izvještaja, za rad sa sistemom dokumenata i za upravljanje tokovima poslovnih procesa.
U ovom poglavlju možete pronaći slijedeće REST metode za obradu zadataka i njihove opise:
1. Kreiranje novog zadatka obrade
2. Dobijanje statusa postojećeg zadatka
3. Preuzimanje jedne rezultujuće datoteke
1. Kreirajanje novog zadatka obrade
POST /api/v1/:database/process/:command
Parametri:
- database: SQL Server baza podataka u kojoj treba izvršiti zadatak;
- command: komanda za izvršavanje na PAAS-u;
- body: treba da sadrži JSON parametre za novi zadatak.
Povratne vrijednosti: JSON objekat sa dva polja;
- task: numerički ID zadatka
- runner: string task token
Primjeri kreiranja novog zadatka obrade:
 |
Ova metoda planira izvršenje zadatka i odmah daje povratnu vrijednost. Parametri :command i :body čuvaju se u ‘tPA_PAASProcessing’ tabeli kao poslati. |
Stvarno izvršenje vrši Pantheon.exe. PAAS će pokrenuti Pantheon ako nije pokrenut ili obavjestiti Pantheon koji već radi da postoji dostupan zadatak koji treba pokrenuti.
2. Dobijanje statusa postojećeg zadatka
GET /api/v1/:database/status/:task?guid=:runner
Parametri:
Database: SQL baza podataka u kojoj je zadatak zadatak: id zadatka kreirane datoteke guide: runner primljen prilikom kreiranja zadatka.
Vraća status iz ‘tPA_PAASProcessing’ tabele za zadati zadatak:
{ "id": numeric task ID (anQId) "status": num status (anStatus): 0: pending, 102: processing, 200: done OK, 400: Err "lane": string name of priority lane where task is executing (unused for now) "command": string requested task command (Printing, Workflow, ...) (acCommand) "result": JSON with results. returned from Pantheon (acResult) when task is done
{ "guid": guid of task processor (unused for now) when status is OK "files": array of strings ["full\\path1\\to_file1.ext", full\\path1\\to_file1.ext"] "error": error string description if there was an error } }
Primjer dobijanja statusa postojećeg zadatka
3. Preuzimanje jedne rezultujuće datoteke
GET /api/v1/:database/download/:task/:file?guid=:guid
Parametri:
- database: SQL Server baza podataka u kojoj je zadatak pokrenut i završen sa statusom OK
- task: id zadatka kreiranog fajla
- file: numerički redoslijed datoteke iz niza datoteka u status-> result-> files
- guid: runner primljen prilikom kreiranja zadatka.
Povratna vrijednost: Sadržaj datoteke.
Primer preuzimanja jedne rezultujuće datoteke
Povezane teme: