updateRecord (asiakkaan ohjelmointirajapinnan viittaus)

Päivittää taulukkotietueen.

Syntaksi

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

Parametrit

Nimi Tyyppi Pakollinen Description
entityLogicalName String Kyllä Päivitettävän tietueen looginen nimi. Esimerkki: account.
id String Kyllä Sen taulukkotietueen GUID-tunnus, jonka haluat päivittää.
data Objekti Kyllä Pareja sisältävä key: value JSON-objekti, jossa key on taulukon ominaisuus ja value päivitettävän ominaisuuden arvo.
Katso esimerkeistä , miten voit määrittää objektin erilaisissa data päivitystilanteissa.
successCallback Function Ei Funktio, johon soitetaan, kun tietuetta päivitetään. Katso Palautusarvo
errorCallback Function Ei Funktio, jota kutsutaan, kun toiminto epäonnistuu. Objekti, jolla on seuraavat ominaisuudet, välitetään:
- errorCode:Numero. Virhekoodi positiivisena desimaalilukuna. Esimerkiksi virhekoodi, joka on dokumentoitu muodossa 0x80040333 , palautetaan muodossa 2147746611.
- message:Merkkijono. Ongelmaa kuvaava virheilmoitus.

Palautusarvo

Kun onnistuminen onnistuu, palauttaa lupausobjektin kohteeseen successCallback seuraavilla ominaisuuksilla:

Nimi Tyyppi Description
entityType String Tietueen looginen nimi taulukkoon.
id String Tietueen GUID-tunnus.

Esimerkit

Näissä esimerkeissä käytetään samoja pyyntöobjekteja kuin taulukkorivien päivittäminen ja poistaminen -kohdassa näytetty objekti verkko-ohjelmointirajapinnan avulla taulukkotietueen päivittämistä varten.

Esimerkki Osoittaa Esimerkki WWW-ohjelmointirajapinnasta
Peruspäivitys Olemassa olevan tilitietueen sarakearvojen päivittäminen. Peruspäivitys
Liittyvien taulukoiden yhdistysten päivittäminen Tilin ensisijaisen yhteyshenkilön muuttaminen :n avulla @odata.bind Liitä yksiarvoiseen siirtymisominaisuudeen
Päivitys liittyvät aktiviteetin tyyppisiin taulukoihin Miten voit liittää tehtävän mahdollisuuteen tai määrittää sen suhteen haun tiliin. Liitä yksiarvoiseen siirtymisominaisuudeen
Päivitä yhdistykset kokoelmanarvoisille siirtymisominaisuuksille Liittyvien tietueiden liittämistä ja erottamista varten käyttämällä Xrm.WebApi.online.execute. Tietueen lisääminen kokoelmaan ja tietueen poistaminen kokoelmasta

Peruspäivitysesimerkki

Päivittää olemassa olevan tilitietueen tietuetunnuksella = 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
    }
);

Jos haluat päivittää liitoksen liittyviin taulukon tietueisiin (haut), määritä yksiarvoisten siirtymisominaisuuksien arvo huomautuksella @odata.bind osoittamaan toiseen tietueeseen.

Tässä on esimerkki koodista:

Seuraavassa esimerkissä asiakastietue päivitetään niin, että toinen yhteyshenkilötietue liitetään tilin ensisijaiseksi yhteyshenkilöksi:

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

Vanhentunut menetelmä mobiililaitteiden offline-skenaariossa

Note

Sen sijaan, että käyttäisit @odata.bind huomautusta edellisessä esimerkissä, vanhentunutta hakuobjektia , jossa kirjainkoko on merkitsevä,logicalnameidtuetaan edelleen olemassa olevissa mukautuksissa. Huomautusten @odata.bind käyttöä suositellaan kuitenkin sekä online- että offline-tilanteissa sen sijaan, että käytettäisiin tätä vanhentunyttä objektia.

Seuraavassa esimerkissä käytetään vanhentunyttä menetelmää tilitietueen päivittämiseen, jotta toinen yhteystietotietue liitetään mobiiliasiakkaiden ensisijaiseksi yhteyshenkilöksi tilille offline-tilassa toimittaessa:

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

Jos haluat päivittää aktiviteetin tyyppiä olevat liittyvät taulukot, määritä yksiarvoisten siirtymisominaisuuksien arvo huomautuksella @odata.bind osoittamaan toiseen tietueeseen.

Aiheeseen liittyvän mahdollisuuden sarakkeen päivittäminen tehtävässä

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

Päivitä liittyy-sarake tehtävässä

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

Päivitä yhdistykset kokoelma-arvoisille siirtymisominaisuuksille esimerkki

Xrm.WebApi.online.execute-ohjelmointirajapinnan avulla voit liittää ja purkaa kokoelman arvostamia siirtymisominaisuuksia. Tätä ominaisuutta ei tueta offline-mobiilikäyttötilanteissa.

Xrm.WebApi

  • Viimeksi päivitetty