Опис на REST методи за обработка на задачи
PAAS работи исто така и со web сервис. Може да се користат методи за добивање извештаи, работа со документ системот и за управување со бизнис процеси.
Во ова поглавје може да се најда следните REST методи за обработка на задачи и нивен опис:
1. Креирање на нова задача за процесирање
2. Добивање статус на постојна задача
3. Симнување на единечен фајл со резултат
1. Креирање на нова задача за процесирање
POST /api/v1/:database/process/:command
Параметри:
- база: SQL Server база каде што треба да се изврши задачата;
- команда: команда која се извршува на PAAS;
- тело: треба да содржи JSON параметри за нова задача.
Се враќа: JSON објект со две полиња;
- задача: нумерички ИД на задачата
- извршувач: стринг токен на задачата
Примери на крерање на нова задача за процесирање:
 |
Со оваа метода веднаш се закажува задача. Параметрите :command и :body се чуваат во табелата ‘tPA_PAASProcessing’ како пратени. |
Вистинското извршување се прави со PANTHEON.exe. PAAS го стартува PANTHEON доколку не е веќе стартуван или известува од него дека има достапна задача за извршување.
2. Добивање статус на постојна задача
GET /api/v1/:database/status/:task?guid=:runner
Параметри:
База: SQL Server база каде што задачата е задача: ИД на задачата се креираво фајл; се прима guid 'runner' кога се креира задачата.
Се враќа статус од табелата ‘tPA_PAASProcessing’ за одредена задача:
{ "id": нумерички ИД на задачата (anQId) "status": нумерички статус (anStatus): 0: pending, 102: processing, 200: done OK, 400: Err "lane": име на стринг за приритената лентакаде што задачата се извршува (засега не се користи) "command": стринг за команда за задача (Printing, Workflow, ...) (acCommand) "result": JSON со резултат. се враќа од Pantheon (acResult) кога задачата е готова.
{ "guid": guid на процесорот на задачи (засега не се користи) кога статусот е OK "files": ареа на стрингови ["full\\path1\\to_file1.ext", full\\path1\\to_file1.ext"] "error": стринг за опис на грешки, доколку има грешка } }
Пример за добивање со Get статус на постојна задача
3. Симнување на единечен фајл со резултат
GET /api/v1/:database/download/:task/:file?guid=:guid
Параметри:
- База: SQL Server база каде што задачата се извршува и завршува со OK.
- Задача: ИД на задачата за креираниот фајл.
- Фајл: нумерички редослед на фајлови во ареата во status > result > files.
- Guid: ‘runner’ се прима кога задачата е креирана.
Се враќа: Содржина на фајл.
Пример за симнување на единечен фајл со резултат
Поврзани теми: