updateRecord (odkaz na rozhranie API klienta)

Aktualizuje záznam tabuľky.

Syntax

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

Parametre

Meno	Typ	Požaduje sa	Description
entityLogicalName	String	Áno	Logický názov tabuľky záznamu, ktorý chcete aktualizovať. Napríklad: account.
id	String	Áno	IDENTIFIKÁTOR GUID záznamu tabuľky, ktorý chcete aktualizovať.
data	Namietať	Áno	Objekt JSON obsahujúci key: value páry, čo key je vlastnosť tabuľky a value je hodnotou vlastnosti, ktorú chcete aktualizovať. Pozrite si časť Príklady a zistite, ako môžete definovať data objekt pre rôzne scenáre aktualizácie.
successCallback	Function	No	Funkcia na volanie pri aktualizácii záznamu. Zobraziť vrátenú hodnotu
errorCallback	Function	No	Funkcia, ktorá sa volá v prípade zlyhania operácie. Odovzdá sa objekt s nasledujúcimi vlastnosťami: - errorCode:Číslo. Kód chyby ako kladné desatinné číslo. Napríklad kód chyby zdokumentovaný ako 0x80040333 sa vráti ako 2147746611. - message:Povrázok. Chybové hlásenie popisujúce problém.

Vrátená hodnota

Po úspešnom dokončení vráti objekt sľubu successCallback s nasledujúcimi vlastnosťami:

Meno	Typ	Description
entityType	String	Logický názov tabuľky záznamu.
id	String	Identifikátor GUID záznamu.

Príklady

Tieto príklady používajú niektoré rovnaké objekty požiadavky, ako je to znázornené v téme Aktualizácia a odstránenie riadkov tabuľky pomocou webového rozhrania API na definovanie údajového objektu na aktualizáciu záznamu tabuľky.

Základná aktualizácia

Aktualizuje existujúci záznam konta s ID záznamu = 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
    }
);

Aktualizácia priradení k súvisiacim tabuľkám

Ak chcete aktualizovať priradenie k záznamom súvisiacej tabuľky (vyhľadávania), nastavte hodnotu vlastností navigácie s jednou hodnotou pomocou @odata.bind komentára k inému záznamu.

Tu je príklad kódu:

Nasledujúci príklad aktualizuje záznam konta a priradí iný záznam kontaktu ako primárny kontakt pre konto:

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

Zastaraná metóda pre scenár mobilnej offline

Poznámka

Namiesto použitia @odata.bind vyššie uvedeného príkladu poznámky je zastaraný objekt vyhľadávania s vlastnosťami (logicalname a ) rozlišujúci veľké a malé písmená idpodporovaný na vytváranie prispôsobení. Odporúča sa však namiesto používania tohto zastaraného objektu použiť @odata.bind komentár pre scenár online aj offline.

Nasledujúci príklad používa zastaranú metódu na aktualizáciu záznamu konta na priradenie iného záznamu kontaktu ako primárneho kontaktu pre konto z mobilných klientov pri práci v režime offline:

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

Aktualizovať priradenia k súvisiacim tabuľkám typu Aktivita

Ak chcete aktualizovať priradenie k súvisiacim tabuľkám typu Aktivita, nastavte hodnotu vlastností navigácie s jednou hodnotou pomocou @odata.bind komentára k inému záznamu.

Aktualizácia stĺpca súvisiacej príležitosti v úlohe

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

Aktualizácia stĺpca Súvisiace v úlohe

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

Aktualizujte priradenia pre vlastnosti navigácie s hodnotami z kolekcie

Rozhranie API Xrm.WebApi.online.execute možno použiť na priradenie a zrušenie priradenia vlastností navigácie s hodnotou kolekcie. Toto nie je podporované pre scenáre v režime offline pre mobilné zariadenia.

Súvisiace články

Xrm.WebApi