Jaa

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.

Peruspäivitys

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 (hakuihin), määritä yksiarvoisten siirtymisominaisuuksien arvo huomautuksella @odata.bind 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 yllä olevaa huomautusesimerkkiä, vanhentunutta hakuobjektia , jossa on kirjainkoko huomioon ottava ominaisuus (logicalname ja id), tuetaan edelleen mukautusten muodostamisessa. On kuitenkin suositeltavaa käyttää @odata.bind huomautusta sekä online- että offline-skenaariossa sen sijaan, että käyttäisit 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ä liittyvien taulukoiden liitoksen, määritä yksiarvoisten siirtymisominaisuuksien arvo huomautuksella @odata.bind 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 kokoelmanarvoisille siirtymisominaisuuksille

Xrm.WebApi.online.execute -ohjelmointirajapinnan avulla voidaan liittää ja purkaa kokoelman arvostamia siirtymisominaisuuksia. Tätä EI tueta offline-mobiilikäyttötilanteiden tapauksessa.

Xrm.WebApi

  • Last updated on