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 seuraavassa artikkelissa: Taulukon rivin luominen WWW-ohjelmointirajapinnan avulla. Artikkelissa kerrotaan, miten voit määrittää tietoobjektin taulukkotietueen luomista varten.

Esimerkki Osoittaa Esimerkki WWW-ohjelmointirajapinnasta
Perusluonti Tilitietueen luominen sarakearvojen avulla. Perusluonti
Liittyvien taulukkotietueiden luominen ensisijaisen tietueen kanssa Tilin ja siihen liittyvän yhteyshenkilön, mahdollisuuden ja tehtävän tietueiden luominen yhdellä toiminnolla. Luo liittyvät taulukon rivit yhdellä toiminnolla
Liitä taulukot, kun luot uusia tietueita Uuden tilin liilisääminen aiemmin luotuun yhteyshenkilöön :n avulla @odata.bind. Liitä taulukon rivit luotavaksi

Perusluontiesimerkki

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. Voit määrittää ensisijaiset kuvat vain luomalla online-tilassa. Muita kuvasarakkeita ei voi määrittää luontitoiminnolla. Lue lisätietoja ensisijaisista kuvista.

Voit luoda toisiinsa liittyviä taulukoita määrittämällä ne siirtymisominaisuuden arvoiksi. Tätä mallia kutsutaan syvätäykseksi. Tässä esimerkissä luodaan mallitilitietue sekä ensisijainen yhteyshenkilötietue ja siihen liittyvä mahdollisuustietue.

Note

Liittyvien taulukkotietueiden 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, kun luot uusia tietueita esimerkki

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ääritteessä. Varmista, että käytät Name -elementin NavigationProperty -määritearvoa VERKKO-ohjelmointirajapinnan $metadata -palveluasiakirjassa. Lisätietoja on kohdassa WWW-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

Aiemmin näytetyn huomautusesimerkin käyttämisen @odata.bind sijaan aiemmin näytettyjen mukautusten tapauksessa tuetaan edelleen vanhentunutta hakuobjektia , jossa on kirjainkoko huomioon ottava ominaisuus (logicalname ja id). Käytä kuitenkin huomautusta @odata.bind sekä online- että offline-skenaarioissa sen sijaan, että käyttäisit tätä vanhentunyttä objektia.

Seuraavassa esimerkissä luodaan tilitietue vanhentuneen menetelmän avulla ja liitetään se olemassa olevaan yhteystietotietueessa. Näin 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

  • Viimeksi päivitetty