Mettre à jour

Mettre à jour une ressource

Pour mettre à jour une ressource, la ressource avec l'ID correspondant et les champs mis à jour doit être envoyée à la collection via une URL requête POST.

Si une ressource a été mise à jour avec succès, la réponse inclura la représentation de la ressource et aura HTTP le statut 200.

Remarque : vous pouvez contrôler la représentation des résultats à l'aide des resultAppendURL paramètres resultFormat,resultInclude,resultExclude et.
POST /api/v1/UserStories?resultFormat=json&resultInclude=[Id,Name,Project] HTTP/1.1
Content-Type: application/json
 
{"Id":379, "Name":"CRUD operations"}
HTTP/1.1 200 OK
Content-Length: 113
Content-Type: application/json; charset=utf-8
 
{
  "Id": 379,
  "Name": "CRUD operations",
  "Project": {
    "Id": 378,
    "Name": "Some Project"
  }
}

Mise à jour groupée des entités dans un seul POST

Il est possible de mettre à jour plusieurs entités Targetprocess dans une seule requête POST envoyée à l'API REST. Par exemple, mettons à jour deux récits utilisateur avec les identifiants #12 et #13 et définissons leur statut sur Terminé ( ID#5 ):
URL: /api/v1/userstories/bulk
Method: POST
Content-Type: application/json

[
	{
    "Id": 12,
		"EntityState":{"Id":5}
	},
	{
    "Id": 13,
		"EntityState":{"Id":5}
	}
]

Affecter et désaffecter des actions

Les nouvelles affectations à des entités (telles que les affectations d'utilisateurs et d'équipes) sont gérées à l'aide d'appels POST. Si des affectations existent déjà, elles sont ajoutées et non remplacées. Pour remplacer les affectations par un appel API, vous devez d'abord désaffecter les utilisateurs ou les équipes existants. Il est effectué dans le cadre d'appels DELETE.