Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
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
U ovim se primjerima koriste isti objekti zahtjeva kao i sljedeći članak: Stvaranje retka tablice pomoću WEB API-ja. U članku se objašnjava kako definirati podatkovni objekt za stvaranje zapisa tablice.
| Primjer | Pokazuje | Primjer WEB API-ja |
|---|---|---|
| Osnovno stvaranje | Stvaranje zapisa računa s vrijednostima stupaca. | Osnovno stvaranje |
| Stvaranje povezanih zapisa tablice zajedno s primarnim zapisom | Stvaranje poslovnog subjekta i povezanog kontakta, poslovne prilike i zapisa zadataka u jednom postupku. | Stvaranje povezanih redaka tablice u jednom postupku |
| Pridruživanje tablica prilikom stvaranja novih zapisa | Kako povezati novi račun s postojećim kontaktom pomoću @odata.bind. |
Povezivanje redaka tablice nakon stvaranja |
Osnovno stvaranje primjera
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 možete postaviti samo pomoću mogućnosti stvori u mrežnom načinu rada. Pomoću stvaranja ne možete postaviti druge slikovne stupce. Dodatne informacije o primarnim slikama
Stvaranje povezanih zapisa tablice zajedno s primjerom primarnog zapisa
Tablice povezane s drugima možete stvoriti tako da ih definirate kao vrijednosti navigacijskih svojstava. Taj se uzorak naziva dubokim umetanjem. U ovom primjeru stvarate ogledni zapis poslovnog subjekta 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
}
);
Associate tables when creating new records example
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 vrijednih navigacijskih svojstava nisu uvijek isti kao za LogicalName atribut pretraživanja. Provjerite koristite li vrijednost atributa Name elementa u NavigationProperty web-API-ju $metadata servisnog dokumenta. Dodatne informacije potražite u članku 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 primjedbu koristite @odata.bind i za mrežne i izvanmrežne scenarije umjesto da koristite taj zastarjeli objekt.
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
}
);