Zu Content springen
Deutsch
zum Kundenportal
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

📄 Aufgaben über die REST API verwalten

In diesem Artikel wird beschrieben, wie Aufgaben (Tasks) über die ValueStreamer REST API erstellt, bearbeitet und systemseitig automatisiert gesteuert werden können. Die Zielgruppe sind Entwickler:innen oder IT-Verantwortliche, die Aufgaben aus Drittsystemen (z. B. Ticketing-Tools, MES, PM-Software) systematisch in den ValueStreamer integrieren wollen.

🔍 Inhalt



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

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

ℹ️ 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)

 

❓ 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.