Opis REST metod za procesiranje nalog
PAAS deluje tudi kot spletni servis. Dostopamo lahko do metod za pridobivanje izpisov, za delo z dokumentnim sistemom in za upravljanje s poslovnimi procesi.
V tem poglavju vam bomo predstavili naslednje REST metode in njihov opis za procesiranje nalog:
- Ustvarjanje nove naloge obdelave
- Pridobivanje stanja obstoječega opravila
- Prenos posamezne nastale datoteke
1. Ustvarjanje nove naloge obdelave
POST /api/v1/:database/process/:command
Nastavitve:
- Database: SQL Server podatkovna baza podatkov, v kateri zaganjamo nalogo;
- Command: ukaz, ki se bo izvajal preko PAAS;
- Body: mora vsebovati JSON parametre za novo nalogo.
Vrnitve:
JSON objekt z dvema poljema:
- task: številčni ID naloge
- runner: žeton opravljenega niza
Primeri ustvarjanja nove naloge obdelave:
 |
Ta metoda razporedi nalogo za izvajanje in se takoj vrne. Ukaza :command in :body se shranita v tabelo tPA_PAASProcesing kot poslana. |
Dejanska izvedba ukazov se izvaja v Pantheon.exe. PAAS bo zagnal PANTHEON, če ta še ni zagnan, ali pa bo preko že zagnanega PANTHEON‑a obvestil uporabnika, da je na voljo naloga, ki jo je treba zagnati.
2. Pridobivanje stanja obstoječega opravila
GET /api/v1/:database/status/:task?guid=:runner
Nastavitve - Database: SQL Server podatkovna baza, kjer velja »naloga = naloga«. Identiteta naloge se ustvari v datoteko; 'runner' je prejet, ko je opravilo ustvarjeno.
Vrnjeno stanje iz tabele tPA_PAASProcessing prične z obdelavo danega opravila:
{ "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 pridobivanja stanja obstoječega opravila
3. Prenos posamezne nastale datoteke
GET /api/v1/:database/download/:task/:file?guid=:guid
Nastavitve:
- Database: SQL Server podatkovna baza podatkov, v kateri zaganjamo nalogo.
- Task: ID ustvarjene datoteke
- File: številski vrstni red datoteke po redu stanje > rezultat > datoteke
- Guid: 'runner' je prejet, ko je naloga opravljena.
Vrne: vsebino datoteke.
Primer prenosa posamezne nastale datoteke.
Povezane vsebine: