Бөлісу құралы:

createRecord (Клиент API сілтемесі)

Кесте жазбасын жасайды.

Синтаксис

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

Параметрлер

Аты Түр Талап етіледі Сипаттама
entityLogicalName String Иә Жасағыңыз келетін кестенің логикалық атауы. Мысалы: account.
data Нысан Иә Жаңа кесте жазбасы үшін бағандар мен мәндерді анықтайтын JSON нысаны. Мысалдарды қарау
successCallback Function Жоқ Жазба жасалғанда қоңырау шалу функциясы. Қайтаратын мәнді қараңыз
errorCallback Function Жоқ Операция істен шыққанда қоңырау шалу функциясы. Келесі қасиеттері бар нысан беріледі:
- errorCode: Сан. Қате коды оң ондық сан ретінде. Мысалы, құжатталған 0x80040333 қате коды ретінде 2147746611қайтарылады.
- message: Жол. Ақауды сипаттайтын қате туралы хабар.

Қайтаратын мән

Сәттілік кезінде келесі қасиеттері бар уәде нысанын successCallback қайтарады:

Аты Түр Сипаттама
entityType String Жаңа жазбаның логикалық атауы.
id String Жаңа жазбаның нұсқауы.

Мысалдар

Бұл мысалдарда кесте жазбасын жасау үшін деректер нысанын анықтау үшін Веб-API арқылы кесте жолын жасау бөлімінде көрсетілгендей сұрау нысандарын пайдаланады.

Негізгі құру

Үлгі тіркелгі жазбасын жасайды.

// 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 бола бермейді. Веб-API $metadata қызмет құжатындағы элементтің атрибуттық мәнін NavigationProperty пайдаланғаныңызға Name көз жеткізуіңіз керек. Қосымша ақпарат: Web API шарлау сипаттары

Міне, код мысалы:

Келесі мысалда тіркелгі жазбасын жасайды және соңғысын жаңа тіркелгі жазбасы үшін негізгі контакт ретінде орнату үшін оны бұрыннан бар контакт жазбасымен байланыстырады:

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

Веб-API арқылы кесте жолын жасау
Xrm.WebAPI

  • Last updated on