Entité
Tâches
Récupérer et gérer les tâches, les prédécesseurs, les déplacements de projets, les mises à jour, les clones et le comportement des notifications.
Points d'extrémité
/api/v2/tasksRécupérer une liste/api/v2/tasks/{id}Récupérer un enregistrement/api/v2/tasksCréer des enregistrements/api/v2/tasksMise à jour des enregistrements/api/v2/tasks/{id}Supprimer un enregistrementPrédécesseurs
/api/v2/tasks/{id}/predecessorsRécupérer tous les prédécesseurs d'une tâcheDéplacer les tâches
/api/v2/tasks/moveDéplacer une ou plusieurs tâches vers un autre projetLa réponse est un objet JSON représentant le résultat de l'opération de déplacement. Veuillez envoyer les tâches sous forme de tableau d'identifiants de tâches et le projet sous forme d'identifiant du projet de destination. Seules les tâches et le projet doivent figurer dans la requête.
Pour déplacer les tâches dont les identifiants sont 99259, 99260 et 99261 vers un projet dont l'identifiant est 12345 :
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'Désactiver les notifications
/api/v2/tasks?notifications=falseMettre à jour une tâche sans notification par e-mail ni dans l'applicationLa réponse est un objet JSON contenant les détails mis à jour de la tâche. L'ajout de ` ?notifications=false` empêche l'envoi de notifications par e-mail ou dans l'application lors de la mise à jour. Indiquez l'identifiant et uniquement les propriétés à modifier.
Pour mettre à jour une tâche dont l'identifiant est 99266 et définir son pourcentage d'avancement réel à 64 sans envoyer de notifications :
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'Insérer une tâche
/api/v2/tasks/upsertCréer ou mettre à jour par clé externe/api/v2/tasks/upsertCréer ou mettre à jour par clé externeFournissez une clé externe non vide (l'identifiant de votre système), omettez l'identifiant et identifiez le projet par son identifiant, son nom ou une clé externe, selon les options prises en charge. Celoxis recherche une tâche associée à cette clé externe dans votre entreprise ; si elle est trouvée, elle est mise à jour, sinon elle est créée. La réponse inclut le JSON de la tâche, l'action ( « créée » ou « mise à jour » ) et la valeur de succès: « true » . En cas de correspondances multiples, une erreur HTTP 409 est renvoyée.
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'Cloner une tâche
/api/v2/tasks/{id}/cloneCréer une tâche à partir d'une tâche existanteEnvoyez un objet JSON dans le corps de la requête contenant uniquement les propriétés qui doivent différer de la tâche source. La réponse est : { data: {created-object} }.