Gemeinsame Operationen

Datensätze aktualisieren

Erstellen oder aktualisieren Sie einen Projekt-, Aufgaben- oder Workflow-App-Datensatz anhand eines externen Schlüssels.

Upsert per externem Schlüssel

POST/api/v2/{entity}/upsertErstellen oder Aktualisieren mit externem Schlüssel

PUT/api/v2/{entity}/upsertErstellen oder Aktualisieren mit externem Schlüssel

Unterstützte Entitäten sind Projekte, Aufgaben und Apps.

Geben Sie einen nicht leeren externen Schlüssel (die ID Ihres Systems) an. Senden Sie nicht die ID. Celoxis sucht in Ihrem Unternehmen nach einem Datensatz mit diesem externen Schlüssel ; falls ein Datensatz vorhanden ist, wird er aktualisiert, andernfalls wird ein neuer erstellt.

Die Antwort enthält das übliche JSON-Objekt der Entität sowie die Aktion (erstellt oder aktualisiert) und den Erfolgswert: true. Der externe Schlüssel muss pro Unternehmen und Entitätstyp eindeutig sein. Mehrere Treffer führen zu einem HTTP-409-Fehler.

So erstellen oder aktualisieren Sie eine Aufgabe:

bash

Beispiel

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

So erstellen oder aktualisieren Sie ein Projekt:

bash

Beispiel

curl -g -X PUT \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-P-1001", "name": "Website Redesign", "workspace": 12345 }' \ 'https://app.celoxis.com/psa/api/v2/projects/upsert'

So erstellen oder aktualisieren Sie einen Workflow-App-Datensatz:

bash

Beispiel

curl -g -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-A-1001", "app": "Bug", "name": "Login-Problem untersuchen", "project": "ERP-P-1001" }' \ 'https://app.celoxis.com/psa/api/v2/apps/upsert'