Jaa

createRecord (asiakkaan ohjelmointirajapinnan viittaus)

Luo taulukkotietueen.

Syntaksi

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

Parametrit

Nimi Tyyppi Pakollinen Description
entityLogicalName String Kyllä Luotavan taulukon looginen nimi. Esimerkki: account.
data Objekti Kyllä JSON-objekti, joka määrittää uuden taulukkotietueen sarakkeet ja arvot. Katso esimerkkejä
successCallback Function Ei Funktio, jota kutsutaan tietueen luomisen yhteydessä. Katso Palautusarvo
errorCallback Function Ei Funktio, jota kutsutaan, kun toiminto epäonnistuu. Objekti, jolla on seuraavat ominaisuudet, välitetään:
- errorCode:Numero. Virhekoodi positiivisena desimaalilukuna. Esimerkiksi virhekoodi, joka on dokumentoitu muodossa 0x80040333 , palautetaan muodossa 2147746611.
- message:Merkkijono. Ongelmaa kuvaava virheilmoitus.

Palautusarvo

Kun onnistuminen onnistuu, palauttaa lupausobjektin kohteeseen successCallback seuraavilla ominaisuuksilla:

Nimi Tyyppi Description
entityType String Uuden tietueen looginen nimi taulukkoon.
id String Uuden tietueen GUID-tunnus.

Esimerkit

Näissä esimerkeissä käytetään samoja pyyntöobjekteja kuin kohdassa Taulukon rivin luominen WWW-ohjelmointirajapinnan avulla taulukkotietueen luomisessa käytettävän tieto-objektin määrittämiseksi.

Perusluonti

Luo mallitilitietueen.

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

Note

Ensisijaisen kuvan sisältävien tietueiden luomista ei tueta offline-tilassa. Ensisijaiset kuvat voidaan määrittää luonnin yhteydessä vain online-tilassa. Muita kuvasarakkeita ei voi määrittää luonnin yhteydessä. Lue lisätietoja ensisijaisista kuvista.

Voit luoda toisiinsa liittyviä taulukoita määrittämällä ne siirtymisominaisuuksien arvoiksi. Tätä mallia kutsutaan syvätäykseksi. Tässä esimerkissä luomme mallitilitietueen sekä ensisijaisen yhteyshenkilötietueen ja siihen liittyvän mahdollisuustietueen.

Note

Liittyvän taulukon tietueiden luomista yhdessä luontitoiminnossa ei tueta offline-tilassa.

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

Liitä taulukot uusien tietueiden luomiseen

Jos haluat liittää uusia taulukkotietueita aiemmin luotuihin taulukkotietueisiin, määritä yksiarvoisten siirtymisominaisuuksien arvo huomautuksella @odata.bind .

Note

Yksiarvoisten siirtymisominaisuuksien nimet eivät aina ole samat kuin LogicalName hakumääritteen nimet. Varmista, että käytät Name elementin NavigationProperty määritearvoa WWW-ohjelmointirajapinnan $metadata -palveluasiakirjassa. Lisätietoja: Verkko-ohjelmointirajapinnan siirtymisominaisuudet

Tässä on esimerkki koodista:

Seuraava esimerkki luo tilitietueen ja liittää sen olemassa olevaan yhteyshenkilötietueessa, jotta jälkimmäisestä voidaan määrittää uuden tilitietueen ensisijainen yhteyshenkilö:

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

Vanhentunut menetelmä mobiililaitteiden offline-skenaariossa

Note

Sen sijaan, että käyttäisit @odata.bind aiemmin näytettyä huomautusesimerkkiä, vanhentunutta hakuobjektia , jossa on kirjainkoko huomioon ottava ominaisuus (logicalname ja id), tuetaan edelleen olemassa olevissa mukautuksissa. On kuitenkin suositeltavaa käyttää @odata.bind huomautusta sekä online- että offline-skenaariossa sen sijaan, että käyttäisit tätä vanhentunyttä objektia.

Seuraavassa esimerkissä luodaan tilitietue vanhentuneen menetelmän avulla ja liitetään se aiemmin luotuun yhteystietotietueessa siten, että jälkimmäiset asetetaan mobiiliasiakkaiden uuden tilitietueen ensisijaiseksi yhteyshenkilöksi offline-tilassa toimittaessa:

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

Taulukkorivin luominen WWW-ohjelmointirajapinnan avulla
Xrm.WebApi

  • Last updated on