Descrierea metodelor REST pentru procesarea sarcinilor
PAAS funcționează de asemenea ca un serviciu web. Puteți accesa metode pentru obținerea rapoartelor, pentru lucrul cu sistemul de documente și pentru gestionarea fluxurilor de lucru.
În acest capitol, puteți găsi următoarele metode REST pentru procesarea sarcinilor și descrierile acestora:
1. Crearea unei noi sarcini de procesare
2. Obțineți starea sarcinii existente
3. Descărcați un singur fișier rezultat
1. Crearea unei noi sarcini de procesare
POST /api/v1/:database/process/:command
Parametrii:
- database: baza de date SQL Server unde sarcina ar trebui să fie executată;
- command: comanda de executat pe PAAS;
- body: ar trebui să conțină parametrii JSON pentru noua sarcină.
Returnează: obiect JSON cu două câmpuri;
- task: ID numeric al sarcinii
- runner: token de sarcină string
Exemple de creare a unei noi sarcini de procesare:
 |
Această metodă programează o sarcină pentru execuție și returnează imediat. Parametrii :command și :body sunt stocați în tabelul ‘tPA_PAASProcessing’ așa cum au fost trimisi. |
Execuția efectivă este realizată de ‘PANTHEON.exe’. PAAS va porni PANTHEON dacă nu este deja în execuție sau va notifica dintr-un program PANTHEON deja în execuție că există o sarcină disponibilă de rulat.
2. Obțineți starea sarcinii existente
GET /api/v1/:database/status/:task?guid=:runner
Parametrii:
Baza de date: baza de date SQL Server unde sarcina este sarcina: ID-ul sarcinii este creat în fișier; guid 'runner' este primit când sarcina a fost creată.
Returnează starea din tabelul ‘tPA_PAASProcessing’ pentru sarcina dată:
{ "id": ID numeric al sarcinii (anQId) "status": num status (anStatus): 0: în așteptare, 102: procesare, 200: finalizat OK, 400: Err "lane": numele string al benzii de prioritate unde sarcina este executată (neutilizată pentru moment) "command": comanda string solicitată pentru sarcină (Imprimare, Flux de lucru, ...) (acCommand) "result": JSON cu rezultatele. returnat din Pantheon (acResult) când sarcina este finalizată
{ "guid": guid al procesorului de sarcini (neutilizat pentru moment) când starea este OK "files": array de stringuri ["full\\path1\\to_file1.ext", full\\path1\\to_file1.ext"] "error": descrierea stringului de eroare dacă a existat o eroare } }
Exemplu de obținere a stării sarcinii existente
3. Descărcați un singur fișier rezultat
GET /api/v1/:database/download/:task/:file?guid=:guid
Parametrii:
- Baza de date: baza de date SQL Server unde sarcina a fost executată și finalizată cu OK.
- Sarcina: ID-ul sarcinii fișierului creat.
- Fișier: ordinea numerică a fișierului din array-ul de fișiere în status > result > files.
- Guid: ‘runner’ primit când sarcina a fost creată.
Returnează: Conținutul fișierului.
Exemplu de descărcare a unui singur fișier rezultat
Subiecte conexe: