Tasks & Kanban (PRM20, PRM02, PRM08)

Transaktionen:

Code	Name	UI-Pfad
PRM20	Meine Tasks	/taskList
PRM02	Kanban Board	/kanbanBoard
PRM08	Kanban Board (Preline)	/prelineKanban

Controller: TaskApiController – /api/task, KanbanApiController – /api/kanban

Business-Zweck

Tasks sind die zentrale Arbeitseinheit im Projektmanagement. Partner pflegen Aufgaben per API, steuern Status und Priorität und nutzen Kanban-Boards für visuelle Workflow-Steuerung.

PRM20 fokussiert die persönliche Task-Liste; PRM02 und PRM08 bieten Board-Ansichten mit konfigurierbaren Spalten (TaskStatus).

Kernbegriffe

Begriff	Bedeutung
Task	Aufgabe mit Nummer, Titel, Projekt, Status, Typ
taskStatus	Workflow-Status (z. B. forWork, erledigt)
taskType	Leistungsart, ggf. mit Material (isInvoiceAble)
taskPriority	Priorität (Sortierung in Tickets)
budget / plannedCostHour	Geplante Stunden/Menge
salesItem	Referenz auf SAL-Auftragsposition
supportLine	Support-Kanal (Ticket-Kontext)
mainTask / subTasks	Hierarchie Haupt-/Unteraufgabe
SubTask	Unteraufgabe mit eigenem Bearbeiter

Fachlicher Ablauf

Kanban-Workflow (PRM02/PRM08)

1. Board laden (POST /api/kanban/ oder GET /api/kanban/{kanbanCode})
2. Tasks erscheinen in Spalten je taskStatus
3. Drag-and-Drop ändert Status (POST /api/task/changeStatusOfTask)
4. Spaltenpräferenzen: GET/POST /api/kanban/kanbanColumnPreferences

PRM08 (Preline) nutzt dasselbe Kanban-Backend mit anderer UI-Konfiguration (terminorientierte Darstellung).

Partner-Szenarien

Task anlegen / aktualisieren

POST /api/task/

Body-Struktur wie UI: { "task": { "project": { "id": ... }, "title": "...", "taskStatus": { "id": ... }, ... } }

Support-Tickets: Query ?type=support setzt isSupportLine=true und wechselt in den Support-Mandanten.

Task-Liste filtern

GET /api/task/?projectId={id}
GET /api/task/{id}

CSV-Export: GET /api/task/?isExport=1 (Background-Job, Transaktion PRM20).

Status ändern (Kanban-Drop)

POST /api/task/changeStatusOfTask

Tasks in Sprint verschieben

POST /api/task/addTasksToSprint

Task kopieren

GET /api/task/copyTask/{id}

SubTasks

GET  /api/task/listSubTasks/{taskId}
POST /api/task/createSubTaskFromTask
POST /api/subTask/

Details: SubTask API

Support-Task aus SAL14

Tasks können aus dem Support Cockpit (SAL14) mit type=support angelegt werden – Verknüpfung zu Tickets.

Voraussetzungen

• Projekt (PRM01) muss existieren
• taskType und taskStatus mandantenspezifisch
• Für abrechenbare Tasks: taskType.isInvoiceAble=1, Projekt profit=1
• Kanban: konfigurierte Spalten (kanbanColumnPreferences)

Auswirkungen im ERP

Aktion	Auswirkung
Task mit salesItem	Verknüpfung zu Auftrag SAL16
Status → erledigt	Voraussetzung für TaskCost-Bestätigung
isInvoiceAble TaskType	Task erscheint in PRM58
Support-Task	Cross-Tenant-Buchung, E-Mail-Thread

API-Referenz

• Kanban: KanbanApiController unter /api/kanban

Weiterlesen

• Projekte PRM01
• Task-Buchungen PRM29
• Tickets PRM25