Gemeinsame Operationen

Datensätze aktualisieren

Aktualisieren Sie einen oder mehrere Datensätze, indem Sie nur die Eigenschaften senden, die geändert werden müssen.

Datensätze aktualisieren

PATCH/api/v2/{entity}Aktualisiere einen oder mehrere Datensätze

Beim Aktualisieren eines Datensatzes lautet die Antwort { data: {updated-object} }. Beim Aktualisieren mehrerer Datensätze lautet die Antwort { data: [{updated-object-1}, {updated-object-2}, … {updated-object-N}] }.

Senden Sie ein JSON-Objekt im Anfragetext, um einen Datensatz zu aktualisieren, oder ein JSON-Array, um mehrere Datensätze zu aktualisieren. Geben Sie die ID und nur die zu ändernden Eigenschaften an. Die aktualisierbaren Eigenschaften sind in der API-Eigenschaftenreferenz in Ihrem Celoxis-Konto aufgeführt.

Um einen Zeiteintrag mit der ID 123456 zu aktualisieren und seine Stunden auf 2,5 und den Zeitcode auf PM:

bash

Beispiel

curl -g -X PATCH \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "id": 123456, "hours": "2.5", "timeCode": "PM" }' \ 'https://app.celoxis.com/psa/api/v2/timeEntries'

Aufgaben zwischen Projekten 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 ein JSON-Objekt, um Aufgaben zu verschieben, oder ein JSON-Array, um mehrere Aufgabengruppen zu verschieben. Die Anfrage darf nur Aufgaben und Projekte enthalten.

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

bash

Beispiel

curl -g -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 für API-basierte Aktualisierungen 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.

Senden Sie ein JSON-Objekt im Anfragetext. Fügen Sie die ID und nur die Eigenschaften hinzu, die geändert werden müssen.

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 -g -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'