createRecord (klienta API atsauce)

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

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

Tabulas rindas izveide, izmantojot tīmekļa API
Xrm.WebApi