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ąžinama 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 šiame straipsnyje: Lentelės eilutės kūrimas naudojant žiniatinklio API. Straipsnyje aiškinama, kaip apibrėžti duomenų objektą lentelės įrašui kurti.

Pavyzdys Rodo Žiniatinklio API pavyzdys
Bazinis kūrimas Kaip sukurti paskyros įrašą su stulpelių reikšmėmis. Bazinis kūrimas
Kurti susijusius lentelės įrašus kartu su pirminiu įrašu Kaip sukurti klientą ir susijusius kontaktus, galimybes ir užduočių įrašus atliekant vieną operaciją. Susijusių lentelės eilučių kūrimas atliekant vieną operaciją
Lentelių susiejimas kuriant naujus įrašus Kaip susieti naują paskyrą su esamu kontaktu naudojant @odata.bind. Susiekite lentelės eilutes kurdami

Basic create example

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 galite nustatyti tik naudodami kurti interneto režimu. Negalite nustatyti kitų vaizdo stulpelių naudodami kūrimo funkciją. 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 sukuriate kliento įrašo pavyzdį kartu su pirminiu kontakto įrašu ir susietu galimybės įrašu.

Pastaba.

Susijusių lentelės įrašų kūrimas viena kūrimo operacija 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. Įsitikinkite, kad naudojate Name žiniatinklio API $metadata tarnybos dokumento elemento atributo reikšmę NavigationProperty . Daugiau informacijos žr. Ž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ę anksčiau parodytą @odata.bind 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 užuot naudoę šį nebenaudojamą objektą, komentarą naudokite @odata.bind tiek internetiniams, tiek autonominiams scenarijams.

Toliau pateiktame pavyzdyje naudojamas nebenaudojamas metodas kliento įrašui sukurti ir susieti su esamu kontakto įrašu, kad jis būtų nustatytas kaip pirminis naujo kliento į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

  • Paskutinį kartą atnaujinta