Dijeli putem

createRecord (referenca klijentskog API-ja)

Stvara zapis tablice.

Sintaksa

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

Parametri

Ime Tip Obvezno Opis
entityLogicalName String Da Logički naziv tablice koju želite stvoriti. Na primjer: account.
data Objekt Da JSON objekt koji definira stupce i vrijednosti za novi zapis tablice. Pogledajte primjere
successCallback Function Ne Funkcija za pozivanje prilikom stvaranja zapisa. Pogledajte povratnu vrijednost
errorCallback Function Ne Funkcija za pozivanje kada operacija ne uspije. Prosljeđuje se objekt sa sljedećim svojstvima:
- errorCode:Broj. Kôd pogreške kao pozitivan decimalni broj. Primjerice, kôd pogreške dokumentiran kao 0x80040333 će se vratiti kao 2147746611.
- message:Gudački. Poruka o pogrešci koja opisuje problem.

Povratna vrijednost

Nakon uspjeha vraća objekt obećanja sljedećim successCallback svojstvima:

Ime Tip Opis
entityType String Logički naziv tablice novog zapisa.
id String GUID novog zapisa.

Primjeri

Ti primjeri koriste iste objekte zahtjeva kao što je pokazano u retku Stvaranje tablice pomoću web-API-ja za definiranje podatkovnog objekta za stvaranje zapisa tablice.

Osnovno stvaranje

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

Napomena

Stvaranje zapisa s primarnom slikom nije podržano za izvanmrežni način rada. Primarne slike mogu se postaviti samo pomoću mogućnosti stvori u mrežnom načinu rada. Druge stupce slike nije moguće postaviti s stvaranjem. Dodatne informacije o primarnim slikama

Tablice povezane jedna s drugom možete stvoriti tako da ih definirate kao vrijednosti navigacijskih svojstava. Taj se uzorak naziva dubokim umetanjem. U ovom primjeru stvaramo ogledni zapis o računu zajedno s primarnim zapisom kontakta i povezanim zapisom o poslovnoj prilici.

Napomena

Stvaranje povezanih zapisa tablice u jednoj operaciji stvaranja nije podržano za izvanmrežni način rada.

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

Pridruživanje tablica pri stvaranju novih zapisa

Da biste povezali nove zapise tablice s postojećim zapisima tablice, postavite vrijednost svojstava navigacije s jednom vrijednošću pomoću @odata.bind primjedbe.

Napomena

Nazivi jedno vrijednosti navigacijskih svojstava nisu uvijek isti kao za LogicalName atribut pretraživanja. Provjerite koristite li vrijednost atributa Name elementa web-API-ja NavigationProperty $metadata servisa. Dodatne informacije: Svojstva navigacije web-API-jem

Evo primjera koda:

U sljedećem se primjeru stvara zapis računa i pridružuje postojećem zapisu kontakta da bi se potonji postavio kao primarni kontakt za zapis novog poslovnog subjekta:

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

Zastarjela metoda za scenarij za izvanmrežni rad na mobilnim uređajima

Napomena

Umjesto prethodno prikazanog @odata.bind primjera opaske, zastarjeli objekt pretraživanja sa svojstvima koja razlikuju velika i mala slova (logicalnameidi ) i dalje je podržan za postojeće prilagodbe. No umjesto korištenja tog zastarjelog @odata.bind objekta preporučuje se korištenje primjedbe i za scenarij na mreži i za izvanmrežni rad.

U sljedećem se primjeru koristi zastarjela metoda za stvaranje zapisa računa i povezivanje s postojećim zapisom kontakta radi postavljanja potonjeg kao primarnog kontakta za zapis novog računa iz mobilnih klijenata prilikom rada u izvanmrežnom načinu rada:

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

Stvaranje retka tablice pomoću web-API-ja
Xrm.WebApi

  • Last updated on