updateRecord (client-API-verwijzing)

Hiermee werkt u een tabelrecord bij.

Syntaxis

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

Parameterwaarden

Naam Typologie Verplicht Description
entityLogicalName Snaar / Touwtje Yes De logische tabelnaam van de record die u wilt bijwerken. Voorbeeld: account.
id Snaar / Touwtje Yes GUID van de tabelrecord die u wilt bijwerken.
data Object Yes Een JSON-object met key: value paren, waarbij key de eigenschap van de tabel is en value de waarde is van de eigenschap die u wilt bijwerken.
Zie Voorbeelden om te zien hoe u het data object voor verschillende updatescenario's kunt definiëren.
successCallback Functie Nee. Een functie om aan te roepen wanneer een record wordt bijgewerkt. Zie Retourwaarde
errorCallback Functie Nee. Een functie om aan te roepen wanneer de bewerking mislukt. Er wordt een object met de volgende eigenschappen doorgegeven:
- errorCode:Getal. De foutcode als een positief decimaal getal. De foutcode die wordt beschreven zoals 0x80040333 wordt geretourneerd als 2147746611.
- message:Snaar. Een foutmelding die het probleem beschrijft.

Retourwaarde

Retourneert bij succes een promise-object aan de successCallback hand van de volgende eigenschappen:

Naam Typologie Description
entityType Snaar / Touwtje De logische tabelnaam van de record.
id Snaar / Touwtje GUID van de record.

Voorbeelden

In deze voorbeelden worden enkele van dezelfde aanvraagobjecten gebruikt als in Tabelrijen bijwerken en verwijderen met behulp van de Web-API om het gegevensobject te definiëren voor het bijwerken van een tabelrecord.

Example Demonstreert Voorbeeld van web-API
Basisupdate Kolomwaarden bijwerken in een bestaande accountrecord. Basisupdate
Koppelingen naar de gerelateerde tabellen bijwerken De primaire contactpersoon van een account wijzigen met behulp van @odata.bind. Koppelen aan een navigatie-eigenschap met één waarde
Koppelingen bijwerken naar de gerelateerde tabellen van het type Activiteit Een taak koppelen aan een verkoopkans of de bijbehorende opzoekactie instellen op een account. Koppelen aan een navigatie-eigenschap met één waarde
Koppelingen voor navigatie-eigenschappen met verzamelingswaarde bijwerken Gerelateerde records koppelen en ontkoppelen met behulp van Xrm.WebApi.online.execute. Een record toevoegen aan een verzameling en een record verwijderen uit een verzameling

Voorbeeld van eenvoudige update

Hiermee werkt u een bestaande accountrecord bij met record-id = 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
    }
);

Als u de koppeling met de gerelateerde tabelrecords (zoekacties) wilt bijwerken, stelt u de waarde van navigatie-eigenschappen met één waarde in met behulp van de @odata.bind aantekening om naar een andere record te verwijzen.

Hier volgt een codevoorbeeld:

In het volgende voorbeeld wordt een accountrecord bijgewerkt om een andere contactpersoonrecord te koppelen als de primaire contactpersoon voor het account:

// 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
    }
);

Afgeschafte methode voor mobiel offlinescenario

Opmerking

In plaats van de @odata.bind aantekening in het voorgaande voorbeeld te gebruiken, wordt het afgeschafte opzoekobject met hoofdlettergevoelige eigenschappen (logicalname en id) nog steeds ondersteund voor bestaande aanpassingen. Het gebruik van de @odata.bind aantekening wordt echter aanbevolen voor zowel online- als offlinescenario's in plaats van dit afgeschafte object te gebruiken.

In het volgende voorbeeld wordt de afgeschafte methode gebruikt om een accountrecord bij te werken om een andere contactpersoonrecord te koppelen als de primaire contactpersoon voor het account van mobiele clients wanneer u in de offlinemodus werkt:

// 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
    }
);

Als u koppelingen naar de gerelateerde tabellen van het type Activiteit wilt bijwerken, stelt u de waarde van navigatie-eigenschappen met één waarde in met behulp van de @odata.bind aantekening om naar een andere record te verwijzen.

Gerelateerde verkoopkanskolom voor taak bijwerken

// 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
    }
);

Bijwerken met betrekking tot de kolom in de taak

// 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
   }
);

Voorbeeld van koppelingen voor navigatie-eigenschappen met verzamelingswaarden bijwerken

Gebruik de Xrm.WebApi.online.execute-API om navigatie-eigenschappen met verzamelingswaarden te koppelen en los te koppelen. Deze functie wordt niet ondersteund voor offlinescenario's voor mobiele apparaten.

Xrm.WebApi

  • Laatst bijgewerkt om