Partekatu bidez

createRecord (bezeroaren APIaren erreferentzia)

Taulako erregistroa sortzen du.

Sintaxia

Xrm.WebApi.createRecord(entityLogicalName, data).then(successCallback, errorCallback);

Parametroak

Eman izena Mota Beharrezkoa Deskribapenak
entityLogicalName String Yes Sortu nahi duzun taularen izen logikoa. Adibidez: account.
data Objektua Yes Taulako erregistro berriaren zutabeak eta balioak definitzen dituen JSON objektua. Ikusi adibideak
successCallback Function Ez Erregistro bat sortzen denean deitzen zaion funtzioa. Ikusi itzulitako balioa
errorCallback Function Ez Eragiketan akats bat gertatzen denean deitzen zaion funtzioa. Propietate hauek dituen objektu bat pasatzen da:
- errorCode: Zenbakia. Errore-kodea zenbaki hamartar positibo gisa. Adibidez, dokumentatutako errore-kodea honela 0x800403332147746611itzuliko da.
- message: String. Arazoa deskribatzen duen akats-mezua.

Itzuli balioa

Arrakasta izanez gero, promesa-objektu bat honako propietate hauekin itzultzen du successCallback :

Eman izena Mota Deskribapenak
entityType String Erregistro berriaren taularen izen logikoa.
id String Disko berriaren GUID.

Adibideak

Adibide hauek eskaera objektu berberak erabiltzen dituzte Sortu taula errenkada bat Web APIa erabiliz taula erregistro bat sortzeko datu-objektua definitzeko.

Oinarrizko sorkuntza

Kontuaren erregistro adibide bat sortzen du.

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

Oharra

Irudi nagusi batekin erregistroak sortzea ez da onartzen lineaz kanpoko moduan. Irudi nagusiak sortu lineako moduan soilik ezar daitezke. Beste irudi zutabeak ezin dira sortu. Informazio gehiago Lehen mailako irudiei buruz

Elkarren artean erlazionatutako taulak sor ditzakezu, nabigazio-propietateen balio gisa definituz. Eredu hau txertaketa sakona bezala ezagutzen da. Adibide honetan, kontuaren erregistro adibide bat sortzen dugu, kontaktu erregistro nagusiarekin eta lotutako aukera erregistro batekin batera.

Oharra

Erlazionatutako taulako erregistroak sortzeko eragiketa bakarrean sortzea ez da onartzen lineaz kanpoko moduan.

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

Lotu taulak erregistro berriak sortzean

Taulako erregistro berriak lehendik dauden taulako erregistroekin lotzeko, ezarri balio bakarreko nabigazio-propietateen balioa oharpena erabiliz @odata.bind .

Oharra

Balio bakarreko nabigazio-propietateen izenak ez dira beti bilaketa atributuaren berdinak LogicalName . Ziurtatu elementuaren NavigationProperty atributu-balioa erabiltzen Name ari zarela Web API $metadata zerbitzu dokumentuan. Informazio gehiago: WEB API-ren nabigazio-propietateak

Hona hemen kodearen adibidea:

Ondorengo adibideak kontu-erregistro bat sortzen du, eta lehendik dagoen kontaktu-erregistro bati lotzen dio, azken hau kontu-erregistro berriaren kontaktu nagusi gisa ezartzeko:

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

Mugikorretarako lineaz kanpoko agertokirako metodo zaharkitua

Oharra

Aurretik erakutsitako oharpen-adibidea erabili @odata.bind beharrean, maiuskulak eta minuskulak bereizten dituen ( eta id) propietateaklogicalname dituen bilaketa-objektu zaharkitua onartzen da lehendik dauden pertsonalizazioetarako. Hala ere, gomendatzen da oharpena erabiltzea @odata.bind lineako eta lineaz kanpoko agertokietarako, objektu zaharkitu hau erabili beharrean.

Ondorengo adibideak metodo zaharkitua erabiltzen du kontu erregistro bat sortzeko, eta lehendik dagoen kontaktu-erregistro bati lotzeko, azken hau mugikorreko bezeroen kontu erregistro berriaren kontaktu nagusi gisa ezartzeko, lineaz kanpoko moduan lan egitean:

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

Sortu taulako errenkada bat Web APIa erabiliz
Xrm.WebApi

  • Last updated on