Dalintis per

createRecord (kliento API nuoroda)

Sukuria lentelės įrašą.

Sintaksė

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

Parametrai

Vardas, pavadinimas Rūšis Privalomas Apibūdinimas
entityLogicalName String Taip Lentelės, kurią norite sukurti, loginis pavadinimas. Pavyzdžiui: account.
data Objektas Taip JSON objektas, apibrėžiantis naujo lentelės įrašo stulpelius ir reikšmes. Žr . pavyzdžius
successCallback Funkcija No Funkcija, kurią reikia iškviesti sukūrus įrašą. Žr. grąžinamą reikšmę
errorCallback Funkcija No Funkcija, kurią reikia iškviesti, kai operacija nepavyksta. Perduotas objektas su šiomis ypatybėmis:
- errorCode:Numeris. Klaidos kodas kaip teigiamas dešimtainis skaičius. Pavyzdžiui, klaidos kodas, dokumentuotas kaip 0x80040333 bus grąžintas kaip 2147746611.
- message:Eilutės. Klaidos pranešimas, apibūdinantis problemą.

Grąžinimo reikšmė

Sėkmingai grąžins pažado objektą successCallback su šiomis ypatybėmis:

Vardas, pavadinimas Rūšis Apibūdinimas
entityType String Naujo įrašo lentelės loginis pavadinimas.
id String Naujo įrašo GUID.

Pavyzdžiai

Šiuose pavyzdžiuose naudojami tie patys užklausos objektai, kaip parodyta lentelės eilutės kūrimas naudojant žiniatinklio API , kad būtų apibrėžtas duomenų objektas lentelės įrašui kurti.

Bazinis kūrimas

Sukuria abonemento įrašo pavyzdį.

// define the data to create new account
var data =
    {
        "name": "Sample Account",
        "creditonhold": false,
        "address1_latitude": 47.639583,
        "description": "This is the description of the sample account",
        "revenue": 5000000,
        "accountcategorycode": 1,
        "opendeals_date": new Date("2024-02-03T00:00:00Z")
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Pastaba.

Įrašų su pirminiu vaizdu kūrimas neprisijungus nepalaikomas. Pirminius vaizdus galima nustatyti tik kuriant prisijungus. Kitų vaizdo stulpelių negalima nustatyti naudojant kūrimo būdą. Sužinokite daugiau apie pagrindinius vaizdus

Galite kurti tarpusavyje susijusias lenteles apibrėždami jas kaip naršymo ypatybių reikšmes. Šis modelis vadinamas giliu įterpimu. Šiame pavyzdyje sukuriame kliento įrašo pavyzdį kartu su pirminiu kontakto įrašu ir susietu galimybės įrašu.

Pastaba.

Susijusių lentelės įrašų kūrimas vienos kūrimo operacijos metu nepalaikomas autonominiu režimu.

// define data to create primary and related table records
var data =
    {
        "name": "Sample Account",
        "primarycontactid":
        {
            "firstname": "John",
            "lastname": "Smith"
        },
        "opportunity_customer_accounts":
        [
            {
                "name": "Opportunity associated to Sample Account",
                "Opportunity_Tasks":
                [
                    { "subject": "Task associated to opportunity" }
                ]
            }
        ]
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Lentelių susiejimas kuriant naujus įrašus

Norėdami susieti naujus lentelės įrašus su esamais lentelės įrašais, nustatykite vienos reikšmės naršymo ypatybių reikšmę naudodami komentarą @odata.bind .

Pastaba.

Vienos reikšmės naršymo ypatybių pavadinimai ne visada sutampa LogicalName su peržvalgos atributo pavadinimais. Turite įsitikinti, kad naudojate Name atributo NavigationProperty reikšmę žiniatinklio API $metadata tarnybos dokumente. Daugiau informacijos: Žiniatinklio API naršymo ypatybės

Štai kodo pavyzdys:

Toliau pateiktame pavyzdyje sukuriamas kliento įrašas ir susieja jį su esamu kontakto įrašu, kad jis būtų nustatytas kaip naujas paskyros įrašo pirminis kontaktas:

var data =
    {
        "name": "Sample Account",
        "primarycontactid@odata.bind": "/contacts(465b158c-541c-e511-80d3-3863bb347ba8)"
    }

// create account record
Xrm.WebApi.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Nebenaudojamas "Mobile Offline" scenarijaus metodas

Pastaba.

Užuot naudoję @odata.bind anksčiau parodytą komentaro pavyzdį, nebenaudojamas peržvalgos objektas su didžiąsias ir mažąsias raides skiriaiomis ypatybėmis (logicalname ir id) vis dar palaikomas esamiems tinkinimams. Tačiau rekomenduojama naudoti @odata.bind komentarą tiek prisijungus, tiek neprisijungus, o ne naudojant šį uždraustą objektą.

Toliau pateiktame pavyzdyje naudojamas nebenaudojamas metodas kliento įrašui kurti ir susieti jį su esamu kontakto įrašu, kad jis būtų nustatytas kaip pirminis naujo abonemento įrašo kontaktas iš mobiliųjų klientų dirbant neprisijungus:

var data =
    {
        "name": "Sample Account",
        "primarycontactid":
        {
            "logicalname": "contact",
            "id": "465b158c-541c-e511-80d3-3863bb347ba8"
        } 
    }

// create account record
Xrm.WebApi.offline.createRecord("account", data).then(
    function success(result) {
        console.log("Account created with ID: " + result.id);
        // perform operations on record creation
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Lentelės eilutės kūrimas naudojant žiniatinklio API
Xrm.WebApi

  • Last updated on