цреатеРецорд (референца клијентског АПИ-ја)

Креира запис табеле.

Синтакса

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

Параметре

Име Тип Потребно Опис
entityLogicalName String Да Логички назив табеле коју желите да креирате. На пример: account
data Објекат Да ЈСОН објекат који дефинише колоне и вредности за нови запис табеле. Погледајте примере
successCallback Function Не Функција која се позива када се створи запис. Погледајте повратну вредност
errorCallback Function Не Функција за позивање када операција не успе. Објекат са следећим особинама је прошао:
- errorCode:Број. Код грешке као позитиван децимални број. На пример, код грешке документован као 0x80040333 ће бити враћен као 2147746611.
- message:Ниске. Порука о грешци која описује проблем.

Враћена вредност

На успех, враћа објекат обећања на следећим successCallback својствима:

Име Тип Опис
entityType String Табела логичко име новог записа.
id String ГУИД новог записа.

Примери

Ови примери користе исте објекте захтева као и следећи чланак: Креирајте ред табеле користећи Веб АПИ. У чланку је приказано како дефинисати објекат података за креирање записа табеле.

Пример Показује Пример веб АПИ-ја
Основно креирање Како креирати запис рачуна са вредностима колона. Основно креирање
Креирајте повезане записе табеле заједно са примарним записом Како креирати налог и сродне контакте, прилике и записе задатака у једној операцији. Креирајте сродне редове табеле у једној операцији
Повежите табеле приликом креирања нових записа Како повезати нови налог са постојећим контактом користећи @odata.bind. Повежите редове табеле на креирању

Основни пример креирања

Креира запис о узорку рачуна.

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

Белешка

Креирање записа са примарном сликом није подржано за оффлине режим. Можете подесити примарне слике само помоћу креирања у онлине моду. Не можете подесити друге колоне слика помоћу креирања. Сазнајте више о примарним сликама

Можете креирати табеле које се односе једна на другу тако што ћете их дефинисати као вредности својстава навигације. Овај образац је познат као дубоко уметање . У овом примеру, креирате запис узорка рачуна заједно са записом примарног контакта и повезаним записом о могућностима.

Белешка

Креирање повезаних записа табеле у једној операцији креирања није подржано за оффлине режим.

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

Повежите табеле приликом креирања нових записа пример

Да бисте повезали нове записе табеле са постојећим записима табеле, подесите вредност појединачних својстава навигације помоћу напомене @odata.bind .

Белешка

Имена једновредних својстава навигације нису увек иста као LogicalName атрибут за претрагу. Уверите се да користите Name вредност атрибута елемента NavigationProperty у Веб АПИ-ју $ метадата сервисном документу. За више информација, погледајте Веб АПИ Навигатион Пропертиес .

Ево примера кода:

Следећи пример креира запис налога и повезује га са постојећим записом контакта да би га поставио као примарни контакт за нови запис налога:

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

Застарела метода за мобилни оффлине сценарио

Белешка

Уместо коришћења примера напомена приказаног @odata.bind раније, застарели објекат претраге са особинама осетљивим на велика и мала слова ( logicalname и id) је и даље подржан за постојеће прилагођавања. Међутим , користите напомену @odata.bind за онлине и оффлине сценарије уместо да користите овај застарели објекат.

Следећи пример користи застарели метод за креирање записа налога и повезивање са постојећим записом контакта да би се потоњи поставио као примарни контакт за нови запис налога са мобилних клијената када се ради у оффлине режиму:

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

Креирајте ред табеле користећи Веб АПИ
Српскохрватски / српскохрватски

  • Последњи пут ажурирано у