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:

1. Ustvarjanje nove naloge obdelave
2. Pridobivanje stanja obstoječega opravila
3. 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:

• Primer izpisa
• Primer poslovnega procesa (Workflow)

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:

• PANTHEONov strežnik za avtomatizacijo
• Pomen in delovanje PAAS
• Namestitev in testiranje PAAS
• Alternativa za REST API
• Privzete vrednosti in možnosti PAAS.exe
• Nadgradnja PAAS