Делите путем

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

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

Синтакса

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 ГУИД новог записа.

Примери

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

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

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

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

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

  • Last updated on