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.

Eksempel Viser Eksempel på web-API
Grunnleggende oppdatering Slik oppdaterer du kolonneverdier i en eksisterende kontopost. Grunnleggende oppdatering
Oppdatere tilknytninger til de relaterte tabellene Slik endrer du primærkontakten for en konto ved hjelp av @odata.bind. Knytte til en navigasjonsegenskap med én enkelt verdi
Oppdater tilknytninger til relaterte tabeller av typen Aktivitet Slik knytter du en oppgave til en salgsmulighet eller angir angående oppslag til en konto. Knytte til en navigasjonsegenskap med én enkelt verdi
Oppdater tilknytninger for navigasjonsegenskaper med samlingsverdi Slik knytter og deaktiverer du tilknyttede poster ved hjelp av Xrm.WebApi.online.execute. Legge til en post i en samling og fjerne en post fra en samling

Eksempel på 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 å bruke merknaden @odata.bind til å peke 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 merknaden @odata.bind i det foregående eksemplet, støttes fortsatt det avskrevne oppslagsobjektet med egenskaper som skiller mellom store og små bokstaver (logicalname og id) for eksisterende tilpassinger. Bruk av merknader @odata.bind anbefales imidlertid 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 tilknytninger til relaterte tabeller av typen Aktivitet, angir du verdien for navigasjonsegenskaper med én verdi ved å bruke merknaden @odata.bind til å peke 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 eksempel for navigasjonsegenskaper med samlingsverdi

Bruk Xrm.WebApi.online.execute-API-en til å knytte til og fjerne tilknytningen til navigasjonsegenskaper med samlingsverdi. Denne funksjonen støttes ikke for frakoblede scenarioer for mobil.

Xrm.WebApi

  • Sist oppdatert