Megosztás:

updateRecord (ügyfél API-referencia)

Táblarekord frissítése.

Szemantika

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

Paraméterek

Név Típus Kötelező Description
entityLogicalName Lánc Igen A frissíteni kívánt rekord tábla logikai neve. Például: account.
id Lánc Igen A frissíteni kívánt táblarekord GUID azonosítója.
data Objektum Igen Egy párokat tartalmazó key: value JSON-objektum, amely key a tábla tulajdonsága, és value a frissíteni kívánt tulajdonság értéke.
A példákból megtudhatja , hogyan definiálhatja az objektumot a data különböző frissítési forgatókönyvekhez.
successCallback Funkció Nem Egy függvény, amelyet egy rekord frissítésekor hívnak meg. Lásd : Visszatérési érték
errorCallback Funkció Nem A művelet sikertelensége esetén meghívandó függvény. A következő tulajdonságokkal rendelkező objektumok átadása történik:
- errorCode:Szám. A hibakód pozitív decimális számként. Például a dokumentált 0x80040333 hibakód a következőként 2147746611lesz visszaadva: .
- message:Húr. A problémát leíró hibaüzenet.

Visszaadott érték

Siker esetén egy ígéretobjektumot ad vissza a successCallback következő tulajdonságokkal:

Név Típus Description
entityType Lánc A rekord tábla logikai neve.
id Lánc A rekord GUID azonosítója.

Példák

Ezek a példák ugyanazokat a kérésobjektumokat használják, mint a Táblasorok frissítése és törlése a Webes API-val a táblarekordok frissítéséhez használt adatobjektum meghatározásához.

Alapszintű frissítés

Meglévő fiókrekord frissítése rekordazonosítóval = 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
    }
);

Ha frissíteni szeretné a társítást a kapcsolódó táblarekordokhoz (keresésekhez), állítsa be az egyértékű navigációs tulajdonságok értékét a @odata.bind széljegyzet használatával egy másik rekordra.

Íme egy példa kódra:

Az alábbi példa frissíti a fiókrekordot, hogy egy másik partnerrekordot társítson a fiók elsődleges kapcsolattartójaként:

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

Elavult módszer mobil offline forgatókönyv esetén

Megjegyzés:

A fenti széljegyzetes példa helyett @odata.bind a kis- és nagybetűk megkülönböztetésévellogicalname (és id) rendelkező elavult keresési objektum továbbra is támogatott a testreszabások számbavételéhez. Javasoljuk azonban, hogy az elavult objektum használata helyett az online és offline forgatókönyvben is használjon @odata.bind széljegyzetet.

Az alábbi példa az elavult metódust használja egy fiókrekord frissítésére, hogy egy másik partnerrekordot társítson elsődleges kapcsolattartóként a mobil ügyfelektől, amikor offline módban dolgozik:

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

Ha a tevékenység típusú kapcsolódó táblákhoz szeretne társítást frissíteni, állítsa be az egyértékű navigációs tulajdonságok értékét a @odata.bind széljegyzet használatával egy másik rekordra.

Kapcsolódó lehetőség oszlop frissítése a tevékenységen

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

Frissítés a tevékenység oszlopával kapcsolatban

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

Gyűjteményértékű navigációs tulajdonságok társításainak frissítése

Az Xrm.WebApi.online.execute API használatával társíthatja és leválaszthatja a gyűjtemény-érték szerinti navigációs tulajdonságokat. Ez nem támogatott a mobil offline forgatókönyvekben.

Xrm.WebApi

  • Last updated on