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:

• Primer štampanja
• Primer toka poslovnog procesa

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:

• Značenje i operacije PAAS
• PAAS instalacija i testiranje
• Alternativa za REST API
• Podrazumevane postavke i opcije za PAAS.exe
• Nadogradnja PAAS
• PANTHEON server za automatizaciju