Opis REST metoda za obradu zadataka

PAAS takođe radi kao veb usluga. Možete pristupiti metodama za dobijanje izveštaja, za rad sa sistemom dokumenata i za upravljanje tokovima poslovnih procesa.

U ovom poglavlju možete pronaći sledeće REST metode za obradu zadataka i njihove opise:

1. Kreiranje novo zadatka obrade
2. Dobijanje statusa postojećeg zadatka
3. Preuzmianje 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 vrednosti: JSON objekat sa dva polja;

• task: numerički ID zadatka
• runner: string task token

Primeri kreiranja novog zadatka obrade:

• Primer štampanja
• Primer toka poslovnog procesa

Ova metoda planira izvršenje zadatka i odmah daje povratnu vrednost. 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 obavestiti 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 } }

Primer 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 OK
• task: id zadatka kreiranog fajla
• file: numerički redosled datoteke iz niza datoteka u status-> result-> files
• guid: runner primljen prilikom kreiranja zadatka.

Povratna vrednost: 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