updateRecord (referenční informace k rozhraní API klienta)

Aktualizuje záznam tabulky.

Syntaxe

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

Parametry

Název	Typ	Povinné	Description
entityLogicalName	String	Ano	Logický název tabulky záznamu, který chcete aktualizovat. Například: account.
id	String	Ano	IDENTIFIKÁTOR GUID záznamu tabulky, který chcete aktualizovat.
data	Object	Ano	Objekt JSON obsahující key: value páry, kde key je vlastnost tabulky a value je hodnotou vlastnosti, kterou chcete aktualizovat. V příkladech zjistíte, jak můžete objekt definovat data pro různé scénáře aktualizace.
successCallback	Funkce	Ne	Funkce, která se má volat při aktualizaci záznamu. Zobrazit vrácenou hodnotu
errorCallback	Funkce	Ne	Funkce, která se má volat v případě selhání operace. Předá se objekt s následujícími vlastnostmi: - errorCode:Číslo. Kód chyby jako kladné desetinné číslo. Například kód chyby zdokumentovaný tak, jak 0x80040333 bude vrácen jako 2147746611. - message:Řetězec. Chybová zpráva popisující problém.

Návratová hodnota

Při úspěchu vrátí objekt příslibu successCallback s následujícími vlastnostmi:

Název	Typ	Description
entityType	String	Logický název tabulky záznamu.
id	String	IDENTIFIKÁTOR GUID záznamu.

Examples

Tyto příklady používají některé ze stejných objektů požadavku, jak je znázorněno v aktualizaci a odstranění řádků tabulky pomocí webového rozhraní API k definování datového objektu pro aktualizaci záznamu tabulky.

Základní aktualizace

Aktualizuje existující záznam účtu 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
    }
);

Aktualizace přidružení souvisejících tabulek

Chcete-li aktualizovat přidružení k souvisejícím záznamům tabulky (vyhledávání), nastavte hodnotu vlastností navigace s jednou hodnotou pomocí poznámky @odata.bind na jiný záznam.

Tady je příklad kódu:

Následující příklad aktualizuje záznam účtu tak, aby přidružil jiný záznam kontaktu jako primární kontakt pro účet:

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

Zastaralá metoda pro scénář offline pro mobilní zařízení

Poznámka:

Místo použití @odata.bind výše uvedeného příkladu poznámek je zastaralý vyhledávací objekt s vlastnostmi citlivými na malá a velká písmena (logicalname a id) stále podporován pro exisitování přizpůsobení. Místo použití tohoto zastaralého objektu se ale doporučuje používat @odata.bind poznámky pro online i offline scénář.

Následující příklad používá zastaralou metodu aktualizace záznamu účtu pro přidružení jiného záznamu kontaktu jako primárního kontaktu pro účet z mobilních klientů při práci v offline režimu:

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

Aktualizace přidružení souvisejících tabulek typu Aktivita

Chcete-li aktualizovat přidružení k souvisejícím tabulkám typu Aktivita, nastavte hodnotu vlastností navigace s jednou hodnotou pomocí poznámky k jinému @odata.bind záznamu.

Aktualizace sloupce souvisejících příležitostí u úkolu

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

Aktualizace sloupce Týkající se úkolu

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

Aktualizace přidružení pro vlastnosti navigace s hodnotou kolekce

Rozhraní API Xrm.WebApi.online.execute lze použít k přidružení a zrušení přidružení vlastností navigace s hodnotou kolekce. To není podporováno pro scénáře offline mobilních zařízení.

Související články

Xrm.WebApi