Juristische Person

Aufgaben

Abrufen und Verwalten von Aufgaben, Vorgängern, Projektverschiebungen, Upserts, Klonen und Benachrichtigungsverhalten.

Endpunkte

GET/api/v2/tasksRuft eine Liste ab

GET/api/v2/tasks/{id}Einen Datensatz abrufen

POST/api/v2/tasksDatensätze erstellen

PATCH/api/v2/tasksDatensätze aktualisieren

DELETE/api/v2/tasks/{id}Einen Datensatz löschen

Vorgänger

GET/api/v2/tasks/{id}/predecessorsRuft alle Vorgänger einer Aufgabe ab

Aufgaben verschieben

POST/api/v2/tasks/moveVerschiebt eine oder mehrere Aufgaben in ein anderes Projekt

Die Antwort ist ein JSON-Objekt, das das Ergebnis des Verschiebevorgangs darstellt. Senden Sie die Aufgaben als Array von Aufgaben-IDs und das Projekt als Zielprojekt-ID. Die Anfrage sollte nur Aufgaben und Projekt enthalten.

Um Aufgaben mit den IDs 99259, 99260 und 99261 in ein Projekt mit der ID 12345 zu verschieben:

bash

Beispiel

curl -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "tasks": [ 99259, 99260, 99261 ], "project": 12345 }' \ 'https://app.celoxis.com/psa/api/v2/tasks/move'

Benachrichtigungen deaktivieren

PATCH/api/v2/tasks?notifications=falseEine Aufgabe aktualisieren, ohne E-Mail- oder In-App-Benachrichtigungen zu erhalten

Die Antwort ist ein JSON-Objekt mit den aktualisierten Details der Aufgabe. Durch Hinzufügen von `?notifications=false` wird sichergestellt, dass keine E-Mail- oder In-App-Benachrichtigungen für die Aktualisierung ausgelöst werden. Geben Sie die ID und nur die zu ändernden Eigenschaften an

Um eine Aufgabe mit der ID 99266 zu aktualisieren und ihren tatsächlichen Fertigstellungsgrad (actualPercentComplete) auf 64 zu setzen, ohne Benachrichtigungen zu senden:

bash

Beispiel

curl -X PATCH \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "id": 99266, "actualPercentComplete": 64 }' \ 'https://app.celoxis.com/psa/api/v2/tasks?notifications=false'

Aufgabe hinzufügen

POST/api/v2/tasks/upsertErstellen oder Aktualisieren mit externem Schlüssel

PUT/api/v2/tasks/upsertErstellen oder Aktualisieren mit externem Schlüssel

Geben Sie einen nicht leeren externen Schlüssel (Ihre System-ID) an, lassen Sie die IDund identifizieren Sie das Projekt anhand der ID, des Namens oder des externen Schlüssels (sofern unterstützt). Celoxis sucht in Ihrem Unternehmen nach einer Aufgabe mit diesem externen Schlüssel . Wird eine Aufgabe gefunden, wird sie aktualisiert, andernfalls wird sie neu erstellt. Die Antwort enthält das übliche Aufgaben-JSON sowie die Aktion (erstellt oder aktualisiert) und den Statuscode „success: true“. Mehrere Treffer führen zu einem HTTP-409-Fehler.

bash

Beispiel

curl -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-T-9876", "name": "Design review", "project": "ERP-P-1001" }' \ 'https://app.celoxis.com/psa/api/v2/tasks/upsert'

Aufgabe klonen

POST/api/v2/tasks/{id}/cloneErstelle eine Aufgabe aus einer bestehenden Aufgabe

Senden Sie im Anfragetext ein JSON-Objekt, das nur die Eigenschaften enthält, die sich von der Quellaufgabe unterscheiden sollen. Die Antwort lautet : { data: {created-object} }.