Del via

updateRecord (Klient-API-referanse)

Oppdaterer en tabellpost.

Syntaks

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

Parametere

Navn Type Kreves Beskrivelse
entityLogicalName Streng Ja Tabell logisk navn på posten du vil oppdatere. Eksempel: account.
id Streng Ja GUID for tabellposten du vil oppdatere.
data Object Ja Et JSON-objekt som inneholder key: value par, der key er egenskapen til tabellen og value er verdien for egenskapen du vil oppdatere.
Se eksempler for å se hvordan du kan definere data objektet for ulike oppdateringsscenarioer.
successCallback Function Nei En funksjon som skal kalles når en oppføring oppdateres. Se returverdi
errorCallback Function Nei En funksjon som skal kalles når operasjonen mislykkes. Et objekt med følgende egenskaper sendes:
- errorCode:Nummer. Feilkoden som et positivt desimaltall. Feilkoden som for eksempel er dokumentert som 0x80040333 , returneres som 2147746611.
- message:Streng. En feilmelding som beskriver problemet.

Returverdi

Ved vellykket, returnerer et løfteobjekt til successCallback med følgende egenskaper:

Navn Type Beskrivelse
entityType Streng Det logiske tabellnavnet for posten.
id Streng GUID for posten.

Eksempler

Disse eksemplene bruker noen av de samme forespørselsobjektene som vist i Oppdater og slett tabellrader ved hjelp av web-API-en for å definere dataobjektet for oppdatering av en tabellpost.

Grunnleggende oppdatering

Oppdaterer en eksisterende kontopost med post-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
    }
);

Hvis du vil oppdatere tilknytning til relaterte tabellposter (oppslag), angir du verdien for navigasjonsegenskaper med én verdi ved hjelp av merknaden @odata.bind til en annen post.

Her er kodeeksempel:

Følgende eksempel oppdaterer en forretningsforbindelsesoppføring for å knytte en annen kontaktoppføring til hovedkontakten for kontoen:

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

Avskrevet metode for frakoblet mobilscenario

Note

I stedet for å bruke @odata.bind et merknadseksempel ovenfor, støttes fortsatt det avskrevne oppslagsobjektet med egenskaper som skiller mellom store og små bokstaver (logicalname og id) for å eksisitere tilpassinger. Det anbefales imidlertid å bruke @odata.bind merknader for både tilkoblet og frakoblet scenario i stedet for å bruke dette avskrevne objektet.

Følgende eksempel bruker den avskrevne metoden til å oppdatere en forretningsforbindelsesoppføring til å knytte en annen kontaktoppføring som primærkontakt for kontoen fra mobilklienter når du arbeider i frakoblet modus:

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

Hvis du vil oppdatere tilknytning til relaterte tabeller av typen Aktivitet, angir du verdien for navigasjonsegenskaper med én verdi ved hjelp av merknaden @odata.bind til en annen post.

Oppdater kolonne for relaterte salgsmuligheter på aktivitet

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

Oppdater angående kolonne på oppgave

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

Oppdater tilknytninger for navigasjonsegenskaper med samlingsverdi

API-en Xrm.WebApi.online.execute kan brukes til å knytte til og fjerne tilknytningen til navigasjonsegenskaper med samlingsverdi. Dette støttes IKKE for frakoblede scenarioer for mobil.

Xrm.WebApi

  • Last updated on