Piezīmes
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt pierakstīties vai mainīt direktorijus.
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt mainīt direktorijus.
Izveido tabulas ierakstu.
Sintakse
Xrm.WebApi.createRecord(entityLogicalName, data).then(successCallback, errorCallback);
Parametrus
| Vārds | Tips | Nepieciešams | Apraksts |
|---|---|---|---|
entityLogicalName |
String | Jā | Izveidojamās tabulas loģiskais nosaukums. Piemēram, account. |
data |
Objektu | Jā | JSON objekts, kas definē jaunā tabulas ieraksta kolonnas un vērtības. Skatīt piemērus |
successCallback |
Function | Nē | Funkcija, kas jāizsauc, kad tiek izveidots ieraksts. Skatīt atgriezto vērtību |
errorCallback |
Function | Nē | Funkcija, kas jāizsauc, ja operācija neizdodas. Tiek nodots objekts ar šādām īpašībām: - errorCode:Skaitlis. Kļūdas kods kā pozitīvs decimālskaitlis. Piemēram, kļūdas kods, kas dokumentēts kā 0x80040333 , tiks atgriezts kā 2147746611.- message:Virkne. Kļūdas ziņojums, kurā aprakstīta problēma. |
Atgrieztā vērtība
Ja tas ir veiksmīgs, atgriež solījuma objektu successCallback ar šādiem rekvizītiem:
| Vārds | Tips | Apraksts |
|---|---|---|
entityType |
String | Jaunā ieraksta tabulas loģiskais nosaukums. |
id |
String | Jaunā ieraksta GUID. |
Piemēri
Šie piemēri izmanto tos pašus pieprasījuma objektus kā šajā rakstā: Izveidojiet tabulu rindu, izmantojot Web API. Rakstā parādīts, kā definēt datu objektu tabulas ieraksta izveidei.
| Piemērs | Parāda | Web API piemērs |
|---|---|---|
| Pamata radīšana | Kā izveidot konta ierakstu ar kolonnu vērtībām. | Pamata radīšana |
| Izveido saistītus tabulu ierakstus kopā ar galveno ierakstu | Kā izveidot kontu un saistītos kontaktu, iespēju un uzdevumu ierakstus vienā operācijā. | Izveidot saistītas tabulas rindas vienā operācijā |
| Asociētās tabulas, veidojot jaunus ierakstus | Kā piesaistīt jaunu kontu esošam kontaktam, izmantojot @odata.bind. |
Asociētās tabulas rindas uz create |
Pamata izveides piemērs
Izveido konta ieraksta paraugu.
// 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
}
);
Piezīmes
Ierakstu veidošana ar primāro attēlu nav atbalstīta bezsaistes režīmā. Primāros attēlus var iestatīt tikai, izmantojot create tiešsaistes režīmā. Tu nevari iestatīt citas attēlu kolonnas, izmantojot Create. Uzziniet vairāk par primārajiem attēliem
Izveidot saistītus tabulu ierakstus kopā ar primāro ierakstu piemēru
Jūs varat izveidot savstarpēji saistītas tabulas, definējot tās kā navigācijas īpašību vērtības. Šis modelis ir pazīstams kā dziļš ieliktnis. Šajā piemērā jūs izveidojat parauga konta ierakstu kopā ar galveno kontaktu un saistīto iespēju ierakstu.
Piezīmes
Saistīto tabulu ierakstu izveide vienā izveides operācijā nav atbalstīta bezsaistes režīmā.
// 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
}
);
Asociētās tabulas, veidojot jaunus ierakstus, piemērs
Lai sasaistītu jaunus tabulu ierakstus ar esošajiem tabulas ierakstiem, iestatiet vienas vērtības navigācijas īpašību vērtības, izmantojot @odata.bind anotāciju.
Piezīmes
Vienas vērtības navigācijas īpašību nosaukumi ne vienmēr sakrīt ar LogicalName meklēšanas atribūta nosaukumiem. Pārliecinieties, ka izmantojat Name elementa NavigationProperty atribūtu vērtību Web API $metadata pakalpojuma dokumentā. Papildu informācijai skatiet Web API navigācijas īpašības.
Šeit ir koda piemērs:
Nākamais piemērs izveido konta ierakstu un piesaista to esošam kontaktu ierakstam, lai iestatītu pēdējo kā galveno kontaktpersonu jaunajam konta ierakstam:
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
}
);
Novecojusi metode Mobile Offline scenārijam
Piezīmes
Tā vietā, lai izmantotu iepriekš parādīto @odata.bind anotācijas piemēru, novecojušais meklēšanas objekts ar reģistrjutīgām īpašībām (logicalname un id) joprojām tiek atbalstīts esošajām pielāgošanām. Tomēr izmantojiet anotāciju @odata.bind gan tiešsaistes, gan bezsaistes situācijās, nevis izmantojiet šo novecojušo objektu.
Nākamais piemērs izmanto novecojušo metodi, lai izveidotu konta ierakstu un sasaistītu to ar esošu kontaktu ierakstu, lai pēdējo iestatītu kā galveno kontaktu jaunajam konta ierakstam no mobilajiem klientiem, strādājot bezsaistes režīmā:
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
}
);