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 للسجل.

الأمثلة

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

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

تحديث سجل حساب موجود بمعرف السجل = 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) مدعوما لتخصيصات exisiting. ومع ذلك، يوصى باستخدام @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