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

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

بناء الجملة

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

المعلمات

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

قيمة الإرجاع

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

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

الأمثلة

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

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

مثال إنشاء أساسي

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

// 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