Partage via

updateRecord (Référence API JavaScript) pour l’environnement d’intégration du canal de Dynamics 365 1.0

  • Article

Met à jour un enregistrement d’entité.

Syntaxe

microsoft-ciframework.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);

Paramètres

Nom  Type Requise Description
entityLogicalName Chaîne Oui Nom logique de l’entité de l’enregistrement à mettre à jour. Par exemple : « compte ».
Id String Oui GUID de l’enregistrement d’entité à mettre à jour.
Données Chaîne Oui

Chaîne contenant des paires key: value, où key est la propriété de l’entité et value est la valeur de la propriété à mettre à jour.

Consultez les exemples plus loin dans cette rubrique pour savoir comment définir la chaîne data pour le scénario de mise à jour.
successCallback Fonction Non

Fonction à appeler lorsqu’un enregistrement est mis à jour.
errorCallback Fonction Non Fonction à appeler lorsque l’opération échoue.

Valeur renvoyée

En cas de réussite, retourne une promesse contenant la chaîne avec les attributs mis à jour et leurs valeurs.

Exemples

Cet exemple de code met à jour un enregistrement de contact existant avec l’ID d’enregistrement = a8a19cdd-88df-e311-b8e5-6c3be5a8b200

//// define the data to update a record
var entityLogicalName = "contact";
var data = {
    "firstname": "Updated Sample",
    "lastname": "Contact",
    "fullname": "Updated Sample Contact",
    "emailaddress1": "contact@contoso.com",
    "jobtitle": "Sr. Marketing Manager",
    "telephone1": "555-0109",
    "description": "Updated values for this record were set programmatically."
}
// update contact record
var id = "b44d31ac-5fd1-e811-8158-000d3af97055";
var jsonData = JSON.stringify(data);
Microsoft.CIFramework.updateRecord(entityLogicalName,id,jsonData).then(
    function success (result) {
      res=JSON.parse(result);
          console.log("Contact updated with ID: " + res.id);
          //the record is updated
      },
      function (error) {
          console.log(error);
          //handle error conditions
      }
  );