përshkrimi i metodave REST për përpunimin e detyrave
PAAS gjithashtu funksionon si një shërbim web. Ju mund të aksesoni metodat për të marrë raporte, për punë me sistemin e dokumenteve dhe për menaxhimin e flukseve të punës.
Në këtë kapitull, mund të gjeni metodat e mëposhtme REST për përpunimin e detyrave dhe përshkrimet e tyre:
1. Krijimi i një detyre të re përpunimi
2. Merr statusin e detyrës ekzistuese
3. Shkarko një skedar të vetëm rezultues
1. Krijimi i një detyre të re përpunimi
POST /api/v1/:database/process/:command
Parametrat:
- database: databaza SQL Server ku detyra duhet të ekzekutohet;
- command: urdhri për të ekzekutuar në PAAS;
- body: duhet të përmbajë parametrat JSON për detyrën e re.
Kthen: objekt JSON me dy fusha;
- task: ID numerik i detyrës
- runner: token string i detyrës
Shembuj të krijimit të një detyre të re përpunimi:
 |
Kjo metodë planifikon një detyrë për ekzekutim dhe kthen menjëherë. Parametrat :command dhe :body ruhen në tabelën ‘tPA_PAASProcessing’ siç janë dërguar. |
Ekzekutimi aktual kryhet nga ‘PANTHEON.exe’. PAAS do të fillojë PANTHEON nëse nuk është duke u ekzekutuar tashmë, ose do të njoftojë nga një program PANTHEON që është duke u ekzekutuar tashmë se ka një detyrë të disponueshme për t'u ekzekutuar.
2. Merr statusin e detyrës ekzistuese
GET /api/v1/:database/status/:task?guid=:runner
Parametrat:
Database: databaza SQL Server ku detyra është detyra: ID e detyrës krijohet në skedar; guid 'runner' merret kur detyra është krijuar.
Kthen statusin nga tabela ‘tPA_PAASProcessing’ për detyrën e dhënë:
{ "id": ID numerik i detyrës (anQId) "status": num status (anStatus): 0: në pritje, 102: në përpunim, 200: përfunduar OK, 400: Gabim "lane": emri string i rrugës së prioritetit ku detyra po ekzekutohet (nuk përdoret për tani) "command": urdhri string i kërkuar për detyrën (Printimi, Fluksi i Punës, ...) (acCommand) "result": JSON me rezultatet. kthyer nga Pantheon (acResult) kur detyra është përfunduar
{ "guid": guid i procesorit të detyrës (nuk përdoret për tani) kur statusi është OK "files": array e stringjeve ["full\\path1\\to_file1.ext", full\\path1\\to_file1.ext"] "error": përshkrimi i stringut të gabimit nëse kishte një gabim } }
Shembulli i marrjes së statusit të detyrës ekzistuese
3. Shkarko një skedar të vetëm rezultues
GET /api/v1/:database/download/:task/:file?guid=:guid
Parametrat:
- Database: databaza SQL Server ku detyra u ekzekutua dhe përfundoi me OK.
- Task: ID e detyrës së skedarit të krijuar.
- File: rendi numerik i skedarit nga array e skedarëve në status > rezultat > skedarët.
- Guid: ‘runner’ i marrë kur detyra u krijua.
Kthen: Përmbajtja e skedarit.
Shembulli i shkarkimit të një skedari të vetëm rezultues
Tema të lidhura: