createRecord (Rujukan API Klien)

Mencipta rekod jadual.

Sintaks

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

Parameter

Nama Jenis Wajib Keterangan
entityLogicalName String Ya Nama logik jadual yang anda mahu buat. Sebagai contoh: account.
data Objek Ya Objek JSON yang mentakrifkan lajur dan nilai untuk rekod jadual baharu. Lihat Contoh
successCallback Function Tidak Fungsi untuk memanggil apabila rekod dibuat. Lihat Nilai Pulangan
errorCallback Function Tidak Fungsi untuk memanggil apabila operasi gagal. Objek dengan sifat berikut diluluskan:
- errorCode:Nombor. Kod ralat sebagai nombor perpuluhan positif. Sebagai contoh, kod ralat yang didokumentasikan sebagai akan 0x80040333 dikembalikan sebagai 2147746611.
- message:Rentetan. Mesej ralat yang menerangkan isu tersebut.

Nilai pulangan

Apabila berjaya, mengembalikan objek janji kepada dengan successCallback sifat berikut:

Nama Jenis Keterangan
entityType String Nama logik jadual rekod baru.
id String GUID daripada rekod baharu.

Contoh

Contoh-contoh ini menggunakan objek permintaan yang sama seperti artikel berikut: Cipta baris jadual menggunakan Web API. Artikel ini menunjukkan cara untuk mentakrifkan objek data bagi mencipta rekod jadual.

Contoh Menunjukkan Contoh API Web
Cipta asas Cara mencipta rekod akaun dengan nilai lajur. Cipta asas
Cipta rekod jadual berkaitan bersama rekod utama Cara mencipta akaun dan rekod kenalan, peluang, dan tugasan berkaitan dalam satu operasi. Cipta baris jadual berkaitan dalam satu operasi
Kaitkan jadual semasa mencipta rekod baru Cara mengaitkan akaun baru dengan kenalan sedia ada menggunakan @odata.bind. Kaitkan baris jadual semasa penciptaan

Contoh cipta asas

Mencipta rekod akaun sampel.

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

Nota

Mencipta rekod dengan imej utama tidak disokong untuk mod luar talian. Anda hanya boleh menetapkan imej utama dengan menggunakan cipta dalam mod dalam talian. Anda tidak boleh menetapkan lajur imej lain dengan menggunakan create. Ketahui lebih lanjut tentang imej utama

Anda boleh mencipta jadual yang berkaitan antara satu sama lain dengan mentakrifkannya sebagai nilai sifat navigasi. Corak ini dikenali sebagai sisipan dalam. Dalam contoh ini, anda mencipta rekod akaun contoh bersama rekod kenalan utama dan rekod peluang yang berkaitan.

Nota

Mencipta rekod jadual berkaitan dalam satu operasi cipta tidak disokong untuk mod luar talian.

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

Contoh kaitkan jadual semasa mencipta rekod baru

Untuk mengaitkan rekod jadual baharu kepada rekod jadual sedia ada, tetapkan nilai sifat navigasi bernilai tunggal dengan menggunakan @odata.bind anotasi.

Nota

Nama sifat navigasi bernilai tunggal tidak selalu sama dengan LogicalName atribut carian. Pastikan anda menggunakan Name nilai atribut elemen dalam NavigationProperty Web API $metadata dokumen perkhidmatan. Untuk maklumat lanjut, lihat Sifat Navigasi Web API.

Ini adalah contoh kod:

Contoh berikut mencipta rekod akaun dan mengaitkannya dengan rekod kenalan sedia ada untuk menetapkan yang terakhir sebagai kenalan utama bagi rekod akaun baru:

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

Kaedah ditamatkan untuk senario luar talian mudah alih

Nota

Daripada menggunakan @odata.bind contoh anotasi yang ditunjukkan sebelum ini, objek carian yang sudah tidak digunakan dengan sifat sensitif huruf besar (logicalname dan id) masih disokong untuk penyesuaian sedia ada. Walau bagaimanapun, gunakan anotasi untuk @odata.bind kedua-dua senario dalam talian dan luar talian dan bukannya menggunakan objek yang sudah tidak digunakan ini.

Contoh berikut menggunakan kaedah yang sudah tidak digunakan untuk mencipta rekod akaun dan mengaitkannya dengan rekod kenalan sedia ada untuk menetapkan yang terakhir sebagai kenalan utama bagi rekod akaun baru daripada klien mudah alih apabila bekerja dalam mod luar talian:

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

Cipta baris jadual menggunakan API Web
Xrm.WebApi

  • Kali terakhir dikemas kini pada