createRecord (مرجع واجهة برمجة تطبيقات العميل)

إنشاء سجل جدول.

بناء الجملة

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

المعلمات

الاسم	نوع	مطلوبة	‏‏الوصف
entityLogicalName	سلسلة	‏‏نعم‬	الاسم المنطقي للجدول الذي تريد إنشاءه. على سبيل المثال: account.
data	Object	‏‏نعم‬	كائن JSON يحدد الأعمدة والقيم لسجل الجدول الجديد. راجع الأمثلة
successCallback	الدالة	لا.	دالة للاتصال عند إنشاء سجل. راجع القيمة المرجعة
errorCallback	الدالة	لا.	وظيفة للاتصال عند فشل العملية. يتم تمرير كائن بالخصائص التالية: - errorCode:رقم. رمز الخطأ كرقم عشري موجب. على سبيل المثال، رمز الخطأ الموثق كما 0x80040333 سيتم إرجاعه ك 2147746611. - message:خيط. رسالة خطأ تصف المشكلة.

قيمة الإرجاع

عند النجاح، ترجع عنصر وعد إلى successCallback مع الخصائص التالية:

الاسم	نوع	‏‏الوصف
entityType	سلسلة	الاسم المنطقي للجدول للسجل الجديد.
id	سلسلة	GUID للسجل الجديد.

الأمثلة

تستخدم هذه الأمثلة نفس كائنات الطلب كما هو موضح في إنشاء صف جدول باستخدام واجهة برمجة تطبيقات الويب لتعريف كائن البيانات لإنشاء سجل جدول.

إنشاء أساسي

إنشاء نموذج سجل حساب.

// 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 في مستند خدمة واجهة برمجة تطبيقات الويب $metadata. مزيد من المعلومات: خصائص التنقل في واجهة برمجة تطبيقات الويب

فيما يلي مثال على التعليمات البرمجية:

ينشئ المثال التالي سجل حساب، ويربطه بسجل جهة اتصال موجود لتعيين الأخير كجهة اتصال أساسية لسجل الحساب الجديد:

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

المقالات ذات الصلة

إنشاء صف جدول باستخدام واجهة برمجة تطبيقات الويب
Xrm.WebApi