Partajați prin

createRecord (referință API client)

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.

Valoarea 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 așa cum s-a demonstrat în Crearea unui rând de tabel utilizând WEB API pentru a defini obiectul de date pentru crearea unei înregistrări de tabel.

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. Imaginile principale pot fi setate doar cu crearea în modul online. Alte coloane imagine nu se pot seta cu crearea. Aflați mai multe despre imaginile principale

Puteți crea tabele asociate între ele, definindu-le ca valori de proprietăți de navigare. Acest model se numește inserare profundă. În acest exemplu, creăm o înregistrare de cont eșantion, împreună cu înregistrarea de persoană de contact principală și o înregistrare oportunitate asociată.

Notă

Crearea înregistrărilor 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
    }
);

Asocierea tabelelor la crearea de înregistrări noi

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 identice cu atributul LogicalName de căutare. Trebuie să vă asigurați că utilizați Name valoarea atributului elementului NavigationProperty din documentul serviciului $metadata WEB API. Informații suplimentare: Proprietăți de 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, se recomandă să utilizați @odata.bind adnotări atât pentru scenariul online, cât și 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 pe aceasta din urmă 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
    }
);

Crearea unui rând de tabel utilizând API-ul web
Xrm.WebApi

  • Last updated on