Geplante Berichte anzeigen und ausführen.
URL
POST /api/v1/tasks/{TaskID}/run
Dabei ist es auch möglich, die Berichte mit Berichtsparametern zu starten und die Standardwerte dadurch zu überschreiben.
Beispiel:
POST http://localhost/rs31/api/v1/tasks/1249E640-BB94-4449-88B4/run?$Year=2019
Wichtig: Normal können Benutzer (ohne Adminrechte) nur Tasks anzeigen und ausführen, die sie selbst angelegt haben (um sensible Daten in den Task-Aktionen zu schützen). API-Benutzerkonten sind davon nicht betroffen, diese können jeden Task starten sobald die Task ID bekannt ist. Die Zugriffsrechte von Berichtsvorlagen und Datenquellen, die für die Ausführung des Tasks benötigt werden, werden aber trotzdem geprüft.
Rückgabe
Der Request läuft solange, bis der Task abgeschlossen wurde (Code 200) oder ein Fehler aufgetreten ist.
Fehler (zusätzlich zu Allgemeine Fehlercodes)
|
Statuscode |
Statustext |
Erläuterung |
|
500 |
- |
Fehler beim Export. Der Request Body besteht aus zwei Zeilen: [TASK_PHASE] [Lokalisierte Fehlermeldung] TASK_PHASE ist "PrepareTask", "GenerateReport", "ExecuteActions" oder "Unknown" |
|
404 |
ERR_INVALID_TASK |
task not found |