Kopīgot, izmantojot

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

Šajos piemēros tiek izmantoti tie paši pieprasījuma objekti, kas parādīti sadaļā Tabulas rindas izveide, izmantojot Web API , lai definētu datu objektu tabulas ieraksta izveidei.

Pamata izveide

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 izveide ar primāro attēlu netiek atbalstīta bezsaistes režīmā. Primāros attēlus var iestatīt tikai ar izveidi tiešsaistes režīmā. Citas attēlu kolonnas nevar iestatīt ar create. Uzziniet vairāk par primārajiem attēliem

Varat izveidot savstarpēji saistītas tabulas, definējot tās kā navigācijas rekvizītu vērtības. Šis modelis ir pazīstams kā dziļš ieliktnis. Šajā piemērā mēs izveidojam uzņēmuma ieraksta paraugu kopā ar primāro kontaktpersonas ierakstu un saistīto iespējas ierakstu.

Piezīmes

Saistīto tabulu ierakstu izveide vienā izveides operācijā netiek 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
    }
);

Tabulu saistīšana jaunu ierakstu izveidē

Lai saistītu jaunus tabulas ierakstus ar esošajiem tabulas ierakstiem, iestatiet vienas vērtības navigācijas rekvizītu vērtību, izmantojot @odata.bind anotāciju.

Piezīmes

Vienas vērtības navigācijas rekvizītu nosaukumi ne vienmēr ir tādi paši kā LogicalName uzmeklēšanas atribūta nosaukumi. Pārliecinieties, Name vai izmantojat elementa NavigationProperty atribūta vērtību Web API $metadata pakalpojuma dokumentā. Papildinformācija: Tīmekļa API navigācijas rekvizīti

Šeit ir koda piemērs:

Tālāk sniegtajā piemērā tiek izveidots konta ieraksts un tas tiek saistīts ar esošu kontaktpersonas ierakstu, lai iestatītu to kā primāro 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 @odata.bind iepriekš parādīto anotācijas piemēru, novecojušais uzmeklēšanas objekts ar reģistrjutīgiem rekvizītiem (logicalname un id) joprojām tiek atbalstīts esošajiem pielāgojumiem. Tomēr ir ieteicams izmantot @odata.bind anotāciju gan tiešsaistes, gan bezsaistes scenārijam, nevis izmantot šo novecojušo objektu.

Tālāk sniegtajā piemērā tiek izmantota novecojusi metode, lai izveidotu konta ierakstu un saistītu to ar esošu kontaktpersonas ierakstu, lai iestatītu to kā primāro kontaktpersonu 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

  • Last updated on