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

تحديث سجل جدول.

بناء الجملة

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

المعلمات

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

قيمة الإرجاع

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

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

الأمثلة

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

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

مثال التحديث الأساسي

تحديث سجل حساب موجود بمعرف السجل = 5531d753-95af-e711-a94e-000d3a11e605.

// define the data to update a record
var data =
    {
        "name": "Updated Sample Account ",
        "creditonhold": true,
        "address1_latitude": 47.639583,
        "description": "This is the updated description of the sample account",
        "revenue": 6000000,
        "accountcategorycode": 2
    }
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Account updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

تحديث الاقترانات إلى مثال الجداول ذات الصلة

لتحديث الاقتران بسجلات الجدول ذات الصلة (عمليات البحث)، قم بتعيين قيمة خصائص التنقل ذات القيمة الواحدة باستخدام @odata.bind التعليق التوضيحي للإشارة إلى سجل آخر.

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

يحدث المثال التالي سجل حساب لإقران سجل جهة اتصال آخر كجهة اتصال أساسية للحساب:

// define the data to update a record
var data =
    {
        "primarycontactid@odata.bind": "/contacts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
    }
// update the record
Xrm.WebApi.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Account updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

أسلوب مهمل لسيناريو الهاتف المحمول دون اتصال

إشعار

بدلا من استخدام التعليق التوضيحي @odata.bind في المثال السابق، لا يزال كائن البحث المهمل ذو الخصائص الحساسة لحالة الأحرف (logicalname و id) مدعوما للتخصيصات الموجودة. ومع ذلك، يوصى باستخدام التعليق التوضيحي @odata.bind لكل من السيناريوهات المتصلة وغير المتصلة بدلا من استخدام هذا الكائن المهمل.

يستخدم المثال التالي الأسلوب المهمل لتحديث سجل حساب لإقران سجل جهة اتصال آخر كجهة اتصال أساسية للحساب من عملاء الأجهزة المحمولة عند العمل في وضع عدم الاتصال:

// define the data to update a record
var data =
    {
        "primarycontactid":
        {
            "logicalname": "contact",
            "id": "61a0e5b9-88df-e311-b8e5-6c3be5a8b200"
        }
    }
// update the record
Xrm.WebApi.offline.updateRecord("account", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Account updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

تحديث الاقترانات إلى الجداول ذات الصلة من نوع مثال النشاط

لتحديث الاقترانات إلى الجداول ذات الصلة من نوع النشاط، قم بتعيين قيمة خصائص التنقل ذات القيمة الواحدة باستخدام @odata.bind التعليق التوضيحي للإشارة إلى سجل آخر.

تحديث عمود الفرصة ذات الصلة في المهمة

// define the data to update a record
var data =
    {
        "new_relatedopportunities_task@odata.bind": "/opportunities(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
    }
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
    function success(result) {
        console.log("Task updated");
        // perform operations on record update
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

تحديث فيما يتعلق بالعمود في المهمة

// define the data to update a record
var data =
   {
       "regardingobjectid_account_task@odata.bind": "/accounts(61a0e5b9-88df-e311-b8e5-6c3be5a8b200)"
   }
// update the record
Xrm.WebApi.updateRecord("task", "5531d753-95af-e711-a94e-000d3a11e605", data).then(
   function success(result) {
       console.log("Task updated");
       // perform operations on record update
   },
   function (error) {
       console.log(error.message);
       // handle error conditions
   }
);

مثال على تحديث الاقترانات لخصائص التنقل ذات القيمة المجمعة

استخدم واجهة برمجة تطبيقات Xrm.WebApi.online.execute لربط خصائص التنقل ذات القيمة المجمعة وفصلها. هذه الميزة غير مدعومة لسيناريوهات عدم الاتصال بالهاتف المحمول.

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

Xrm.WebApi