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.

Example Demonstruje Příklad webového rozhraní API
Základní aktualizace Aktualizace hodnot sloupců u existujícího záznamu účtu Základní aktualizace
Aktualizace přidružení souvisejících tabulek Jak změnit primární kontakt účtu pomocí @odata.bind. Přidružení k jednohodnotové navigační vlastnosti
Aktualizace přidružení souvisejících tabulek typu Aktivita Postup přidružení úkolu k příležitosti nebo nastavení jeho vyhledávání v souvislosti s účtem Přidružení k jednohodnotové navigační vlastnosti
Aktualizace přidružení pro vlastnosti navigace s hodnotou kolekce Jak přidružit a zrušit přidružení souvisejících záznamů pomocí Xrm.WebApi.online.execute. Přidání záznamu do kolekce a odebrání záznamu z kolekce

Příklad 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
    }
);

Chcete-li aktualizovat přidružení k souvisejícím záznamům tabulky (vyhledávání), nastavte hodnotu jednohodnotových navigačních vlastností pomocí poznámky @odata.bind tak, aby odkazovala 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 anotace v předchozím příkladu je zastaralý vyhledávací objekt s vlastnostmi citlivými na malá a velká písmena (logicalname a id) stále podporován pro stávající přizpůsobení. Použití poznámky @odata.bind se ale doporučuje pro online i offline scénáře místo použití tohoto zastaralého objektu.

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

Chcete-li aktualizovat přidružení souvisejících tabulek typu Aktivita, nastavte hodnotu vlastností navigace s jednou hodnotou pomocí poznámky @odata.bind odkazovat na jiný záznam.

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

Příklad aktualizací přidružení pro vlastnosti navigace s hodnotami kolekce

Pomocí rozhraní API Xrm.WebApi.online.execute přidružte a zrušte přidružení vlastností navigace s hodnotou kolekce. Tato funkce není podporovaná pro mobilní offline scénáře.

Xrm.WebApi

  • Poslední aktualizace v