📄 Aufgaben über die REST API verwalten

🔍 Inhalt

1. So funktioniert’s

2. Weitere Hinweise

3. Tipps & Best Practices

4. Nächste Schritte

5. FAQ

6. Weiterführende Artikel

🛠️ So funktioniert’s

Mithilfe der REST API kannst du Aufgaben (Tasks) in ValueStreamer automatisiert erstellen, lesen, aktualisieren und verwalten. Dies ermöglicht die Integration von Aufgaben aus externen Systemen wie z. B. Jira, ServiceNow, ERP oder MES-Systemen.

Voraussetzungen:

• Aktive REST API-Schnittstelle in deinem Mandanten

• Authentifizierung (API-Token / Basic Auth)

• Zugriff auf Team- und Aufgaben-IDs

Beispiel-Endpunkte:

• GET /tasks → Liste aller Aufgaben abrufen

• GET /tasks/{id} → Eine bestimmte Aufgabe abrufen

• POST /tasks → Neue Aufgabe erstellen

• PUT /tasks/{id} → Aufgabe bearbeiten

• DELETE /tasks/{id} → Aufgabe löschen

Wichtige Felder beim Erstellen (POST):

• title: Titel der Aufgabe

• description: Beschreibung

• teamId: Team-ID, dem die Aufgabe zugewiesen wird

• dueDate: Fälligkeitsdatum

• category: Kategorie (z. B. „Problemlösung“)

• status: Initialer Status (z. B. „OPEN“)

• assignedUserId: ID des Verantwortlichen

📸 Screenshot: Beispielhafte Darstellung einer automatisiert erstellten Aufgabe über Swagger
📸 Screenshot: Ansicht in ValueStreamer nach API-Erstellung

📥 YAML-Datei zum Import in Swagger:
👉 tasks-api_v1.yaml herunterladen

ℹ️ Weitere Hinweise

• Aufgaben müssen gültigen Teams zugeordnet sein

• Nur User mit den richtigen Rechten (z. B. Systemadministrator) können Aufgaben über die API steuern

• Der status kann mit einem API-Update verändert werden

• Webhooks für Änderungen sind in Vorbereitung

✨ Tipps & Best Practices

✅ Nutze UUIDs oder stabile IDs für eine eindeutige Aufgabensteuerung
✅ Strukturierte Kategorien erleichtern die Filterung im System
✅ Nutze Tags oder Labels zur besseren Zuordnung
✅ Für wiederkehrende Aufgaben empfiehlt sich ein Scheduler (z. B. per Script)

🚀 Nächste Schritte

• YAML in Swagger importieren und erste Tests durchführen

• Aufgabenanbindung an externe Systeme einrichten

• Validierung über Aufgaben-Boards im Team

❓ FAQ

Kann ich Aufgaben automatisiert aus Jira importieren?
→ Ja, über ein Zwischensystem oder direkt, wenn Jira API-Support vorhanden ist.

Wie finde ich die Team-ID für eine neue Aufgabe?
→ Die Team-ID kann über GET /teams abgefragt werden.

Kann ich Aufgaben mit Abweichungen verknüpfen?
→ Aktuell nicht direkt über die Task-API, aber über die Measure/Issue-API.

🔗 Weiterführende Artikel

• [Kennzahlen via REST API verwalten]

• [Teams via REST API anlegen]

• [Authentifizierung und Sicherheit in der API]