createRecord (Referensi API Klien)

Membuat rekaman tabel.

Syntax

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

Parameter-parameternya

Nama Tipe Diperlukan Description
entityLogicalName String Yes Nama logis tabel yang ingin Anda buat. Misalnya: account.
data Objek Yes Objek JSON yang menentukan kolom dan nilai untuk rekaman tabel baru. Lihat Contoh
successCallback Function Tidak. Fungsi untuk memanggil saat rekaman dibuat. Lihat Mengembalikan Nilai
errorCallback Function Tidak. Fungsi untuk memanggil saat operasi gagal. Objek dengan properti berikut diteruskan:
- errorCode:Angka. Kode kesalahan sebagai angka desimal positif. Misalnya, kode kesalahan yang didokumenkan sebagai 0x80040333 akan dikembalikan sebagai 2147746611.
- message:Tali. Pesan kesalahan yang menjelaskan masalah.

Mengembalikan nilai

Setelah berhasil, mengembalikan objek janji ke successCallback dengan properti berikut:

Nama Tipe Description
entityType String Nama logis tabel dari rekaman baru.
id String GUID rekaman baru.

Examples

Contoh-contoh ini menggunakan objek permintaan yang sama dengan artikel berikut: Membuat baris tabel menggunakan API Web. Artikel ini memperlihatkan cara menentukan objek data untuk membuat rekaman tabel.

Contoh Mendemonstrasikan Contoh API Web
Pembuatan dasar Cara membuat catatan akun dengan nilai kolom. Pembuatan dasar
Membuat rekaman tabel terkait bersama dengan rekaman utama Cara membuat akun dan kontak terkait, kesempatan, dan catatan tugas dalam satu operasi. Membuat baris tabel terkait dalam satu operasi
Mengaitkan tabel saat membuat rekaman baru Cara mengaitkan akun baru dengan kontak yang sudah ada menggunakan @odata.bind. Mengaitkan baris tabel saat dibuat

Contoh pembuatan dasar

Membuat rekaman akun 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

Membuat rekaman dengan gambar utama tidak didukung untuk mode offline. Anda hanya dapat mengatur gambar utama dengan menggunakan buat dalam mode online. Anda tidak dapat mengatur kolom gambar lain dengan menggunakan buat. Pelajari selengkapnya tentang Gambar utama

Anda dapat membuat tabel yang terkait satu sama lain dengan menentukannya sebagai nilai properti navigasi. Pola ini dikenal sebagai penyisipan mendalam. Dalam contoh ini, Anda membuat rekaman akun sampel bersama dengan rekaman kontak utama dan rekaman peluang terkait.

Nota

Membuat rekaman tabel terkait dalam satu operasi pembuatan tidak didukung untuk mode offline.

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

Mengaitkan tabel saat membuat contoh rekaman baru

Untuk mengaitkan rekaman tabel baru ke rekaman tabel yang sudah ada, atur nilai properti navigasi bernilai tunggal dengan menggunakan @odata.bind anotasi.

Nota

Nama properti navigasi bernilai tunggal tidak selalu sama dengan LogicalName untuk atribut pencarian. Pastikan Anda menggunakan Name nilai NavigationProperty atribut elemen dalam dokumen layanan api web $metadata. Untuk informasi selengkapnya, lihat Properti Navigasi API Web.

Berikut adalah contoh kode:

Contoh berikut membuat catatan akun dan mengaitkannya ke rekaman kontak yang sudah ada untuk mengatur yang terakhir sebagai kontak utama untuk catatan akun 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
    }
);

Metode yang tidak digunakan lagi untuk skenario offline seluler

Nota

Alih-alih menggunakan @odata.bind contoh anotasi yang ditunjukkan sebelumnya, objek pencarian yang tidak digunakan lagi dengan properti peka huruf besar/kecil (logicalname dan id) masih didukung untuk kustomisasi yang ada. Namun, gunakan @odata.bind anotasi untuk skenario online dan offline alih-alih menggunakan objek yang tidak digunakan lagi ini.

Contoh berikut menggunakan metode yang tidak digunakan lagi untuk membuat rekaman akun dan mengaitkannya ke rekaman kontak yang ada untuk mengatur yang terakhir sebagai kontak utama untuk rekaman akun baru dari klien seluler saat bekerja dalam mode offline:

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

Membuat baris tabel menggunakan API Web
Xrm.WebApi

  • Terakhir diperbarui pada