updateRecord (référence de l’API client)

Met à jour un enregistrement de table.

Syntaxe

Xrm.WebApi.updateRecord(entityLogicalName, id, data).then(successCallback, errorCallback);

Paramètres

Valeur renvoyée

En cas de réussite, retourne un objet de promesse à successCallback avec les propriétés suivantes :

Examples

Ces exemples utilisent certains des mêmes objets de requête, comme illustré dans Mettre à jour et supprimer des lignes de tables à l’aide de l’API web pour définir l’objet de données pour la mise à jour d’un enregistrement de table.

Mise à jour de base

Met à jour un enregistrement de compte existant avec l’ID d’enregistrement = 5531d753-95af-e711-a94e-000d3a11e605.

// define the data to update a record
var data =
    {
        "name": "Updated Sample Account ",
        "creditonhold": true,
        "address1_latitude": 47.639583,
        "description": "This is the updated description of the sample account",
        "revenue": 6000000,
        "accountcategorycode": 2
    }
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Account updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Mettre à jour les associations avec les tables associées

Pour mettre à jour l’association avec les enregistrements de table associés (recherches), définissez la valeur des propriétés de navigation à valeur unique à l’aide de l’annotation @odata.bind vers un autre enregistrement.

Voici un exemple de code :

L’exemple suivant met à jour un enregistrement de compte pour associer un autre enregistrement de contact comme contact principal du compte :

// define the data to update a record
var data =
    {
        "primarycontactid@odata.bind": "/contacts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
    }
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Account updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Méthode obsolète pour le scénario hors ligne mobile

L’exemple suivant s’appuie sur la méthode obsolète pour mettre à jour un enregistrement de compte à associer à un autre enregistrement de contact afin en tant que contact principal du compte des clients mobiles quand vous travaillez en mode hors connexion :

// define the data to update a record
var data =
    {
        "primarycontactid":
        {
            "logicalname": "contact",
            "id": "61a0e5b9-88df-e311-b8e5-6c3be5a8b200"
        }
    }
// update the record
Xrm.WebApi.offline.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Account updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Mettre à jour les associations avec les tables associées de type Activité

Pour mettre à jour l’association avec les enregistrements de table associés de type Activité, définissez la valeur des propriétés de navigation à valeur unique à l’aide de l’annotation @odata.bind vers un autre enregistrement.

Mettre à jour la colonne d’opportunité associée sur la tâche

// define the data to update a record
var data =
    {
        "new_relatedopportunities_task@odata.bind": "/opportunities(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
    }
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Task updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Mise à jour concernant la colonne sur la tâche

// define the data to update a record
var data =
   {
       "regardingobjectid_account_task@odata.bind": "/accounts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
   }
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
   function success(result) {
       console.log("Task updated");
       // perform operations on record update
   },
   function (error) {
       console.log(error.message);
       // handle error conditions
   }
);

Mettre à jour les associations pour les propriétés de navigation avec une valeur de collection

L’API Xrm.WebApi.online.execute peut être utilisée pour associer et dissocier des propriétés de navigation avec une valeur de collection. Celle-ci N’EST PAS prise en charge pour les scénarios mobiles hors ligne.

Articles associés

Xrm.webApi