createRecord (sklic na API odjemalca)

Ustvari zapis tabele.

Sintaksa

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

Parametrov

Ime	Vrsta	Zahtevano	Opis
entityLogicalName	String	Da	Logično ime tabele, ki jo želite ustvariti. Primer: account.
data	Predmet	Da	Predmet JSON, ki določa stolpce in vrednosti za nov zapis tabele. Oglejte si primere
successCallback	Function	Ne	Funkcija, ki jo pokličete, ko je ustvarjen zapis. Glejte Vrnjena vrednost
errorCallback	Function	Ne	Funkcija, ki jo pokličete, ko operacija ne uspe. Podan je predmet s temi lastnostmi: - errorCode:Številka. Koda napake kot pozitivno decimalno število. Koda napake, dokumentirana kot 0x80040333 bo na primer vrnjena kot 2147746611. - message:Niz. Sporočilo o napaki, ki opisuje težavo.

Vrednost vračila

Ob uspehu vrne obljubni predmet s successCallback temi lastnostmi:

Ime	Vrsta	Opis
entityType	String	Logično ime tabele novega zapisa.
id	String	GUID novega zapisa.

Primeri

Ti primeri uporabljajo iste predmete zahteve, kot je prikazano v članku Ustvarjanje vrstice tabele s spletnim API-jem za določanje podatkovnega predmeta za ustvarjanje zapisa tabele.

Osnovno ustvarjanje

Ustvari vzorčni zapis računa.

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

opomba,

Ustvarjanje zapisov s primarno sliko ni podprto v načinu brez povezave. Primarne slike je mogoče nastaviti le z ustvarjanjem v načinu s povezavo. Drugih slikovnih stolpcev ni mogoče nastaviti z ustvarjanjem. Več informacij o primarnih slikah

Ustvarjanje zapisov tabele v relaciji skupaj s primarnim zapisom

Tabele, ki so med seboj povezane, lahko ustvarite tako, da jih določite kot vrednosti lastnosti krmarjenja. Ta vzorec se imenuje globok vstavljanje. V tem primeru ustvarimo vzorčni zapis kupca skupaj s primarnim zapisom stika in povezano kartoteko priložnosti.

opomba,

Ustvarjanje zapisov tabele v relaciji v enem postopku ustvarjanja ni podprto za način brez povezave.

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

Povezovanje tabel pri ustvarjanju novih zapisov

Če želite povezati nove zapise tabele z obstoječimi zapisi tabele, nastavite vrednost lastnosti krmarjenja z eno vrednostjo z @odata.bind uporabo opombe.

opomba,

Imena lastnosti krmarjenja z eno vrednostjo niso vedno enaka LogicalName kot imena atributa iskanja. Prepričajte se, da uporabljate vrednost Name atributa NavigationProperty elementa v spletnem API-$metadata storitve. Več informacij: Lastnosti krmarjenja spletnega API-ja

Tukaj je primer kode:

Ta primer ustvari zapis kupca in ga poveže z obstoječim zapisom stika, da ga nastavi kot primarni stik za zapis novega kupca:

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

Zastarela metoda za scenarij brez povezave za mobilne naprave

opomba,

Namesto uporabe prej prikazanega @odata.bind primera opomb je zastareli iskalni predmet z lastnostmi , ki razlikujejo med velikimi in malimi črkami (logicalnameidin ), še vedno podprt za obstoječe prilagoditve. Priporočamo pa, da namesto tega @odata.bind zastaranega predmeta uporabite opombo tako za scenarij s povezavo kot tudi za scenarij brez povezave.

V tem primeru je uporabljen zastareli način za ustvarjanje zapisa kupca in povezovanje zapisa z obstoječim zapisom stika, da ga nastavite kot primarni stik za zapis novega računa iz mobilnih odjemalcev, ko delate v načinu brez povezave:

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

Povezani članki

Ustvarjanje vrstice tabele s spletnim API-jem
Xrm.WebApi