Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Creează o înregistrare de tabel.
Sintaxă
Xrm.WebApi.createRecord(entityLogicalName, data).then(successCallback, errorCallback);
Parametri
| Nume | Type | Obligatoriu | Descriere |
|---|---|---|---|
entityLogicalName |
Șir | Da | Numele logic al tabelului pe care doriți să-l creați. De exemplu: account. |
data |
Obiect | Da | Un obiect JSON care definește coloanele și valorile pentru noua înregistrare de tabel. Vedeți exemple |
successCallback |
Funcţie | Nu | O funcție de apelat atunci când este creată o înregistrare. Consultați Valoarea returnată |
errorCallback |
Funcţie | Nu | O funcție de apelat atunci când operațiunea eșuează. Se transmite un obiect cu următoarele proprietăți: - errorCode:Număr. Codul de eroare ca număr zecimal pozitiv. De exemplu, codul de eroare documentat ca 0x80040333 va fi returnat ca 2147746611.- message:Șir. Un mesaj de eroare care descrie problema. |
Valoare returnată
La succes, returnează un obiect promisiune către successCallback următoarele proprietăți:
| Nume | Type | Descriere |
|---|---|---|
entityType |
Șir | Numele logic al noii înregistrări. |
id |
Șir | GUID-ul noii înregistrări. |
Exemple
Aceste exemple utilizează aceleași obiecte de solicitare ca următorul articol: Crearea unui rând de tabel utilizând API-ul web. Articolul vă arată cum să definiți obiectul de date pentru crearea unei înregistrări de tabel.
| Example | Demonstrează | Exemplu de API Web |
|---|---|---|
| Creare de bază | Cum se creează o înregistrare cont cu valori de coloană. | Creare de bază |
| Crearea înregistrărilor de tabel asociate împreună cu înregistrarea primară | Cum să creați un cont și o persoană de contact, o oportunitate și înregistrări de activitate asociate într-o singură operațiune. | Crearea rândurilor de tabel asociate într-o singură operațiune |
| Asocierea tabelelor la crearea de înregistrări noi | Cum să asociați un cont nou cu o persoană de contact existentă utilizând @odata.bind. |
Asocierea rândurilor de tabel la creare |
Exemplu de creare de bază
Creează o înregistrare de cont eșantion.
// 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
}
);
Notă
Crearea de înregistrări cu o imagine principală nu este acceptată pentru modul offline. Puteți seta imagini principale doar utilizând modul de creare în modul online. Nu puteți seta alte coloane de imagini utilizând crearea. Aflați mai multe despre imaginile principale
Crearea înregistrărilor de tabel asociate împreună cu exemplul de înregistrare primară
Puteți crea tabele asociate între ele, definindu-le ca valori ale proprietăților de navigare. Acest model se numește inserare profundă. În acest exemplu, creați o înregistrare de cont eșantion, împreună cu înregistrarea de persoană de contact principală și o înregistrare oportunitate asociată.
Notă
Crearea de înregistrări de tabel asociate într-o singură operațiune de creare nu este acceptată pentru modul offline.
// 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
Pentru a asocia înregistrări de tabel noi la înregistrările de tabel existente, setați valoarea proprietăților de navigare cu valoare unică utilizând @odata.bind adnotarea.
Notă
Numele proprietăților de navigare cu valoare unică nu sunt întotdeauna la fel ca atributul LogicalName de căutare. Asigurați-vă că utilizați Name valoarea atributului elementului NavigationProperty din documentul serviciului $metadata API Web. Pentru mai multe informații, consultați Proprietăți navigare API Web.
Iată un exemplu de cod:
Următorul exemplu creează o înregistrare cont și o asociază cu o înregistrare de persoană de contact existentă, pentru a o seta pe aceasta din urmă ca persoană de contact principală pentru noua înregistrare de cont:
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
}
);
Metodă perimată pentru scenariul mobil offline
Notă
În loc să utilizați @odata.bind exemplul de adnotare afișat anterior, obiectul de căutare perimat cu proprietăți sensibile la litere mari și mici (logicalname și id) este acceptat în continuare pentru particularizările existente. Totuși, utilizați @odata.bind adnotarea atât pentru scenariile online, cât și pentru cele offline, în loc să utilizați acest obiect perimat.
Următorul exemplu utilizează metoda perimată pentru a crea o înregistrare cont și a o asocia cu o înregistrare de persoană de contact existentă pentru a o seta ca persoană de contact principală pentru noua înregistrare de cont de la clienții mobili atunci când lucrați în modul offline:
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
}
);