الدالة Revert

ينطبق على: تطبيقات اللوحة

تحديث الأخطاء ومحوها للسجلات الخاصة بـ مصدر البيانات.

‏‏الوصف

تقوم وظيفة Revertبتحديث مصدر البيانات بالكامل أو سجل واحد في مصدر البيانات هذا. ستشاهد التغييرات التي قام بها المستخدمون الآخرون.

بالنسبة للسجلات التي تم إرجاعها، تقوم وظيفة Revert أيضًا بمحو أي أخطاء من الجدول الذي أرجعته وظيفة Errors.

إذا أبلغت ظيفة Errors عن تعارض بعد Patch أو عملية بيانات أخرى، فأعد السجل لبدء الإصدار المتعارض وإعادة تطبيق التغيير.

لا تحتوي وظيفة Revert على أي قيمة إرجاع. يمكنك استخدامها فقط في صيغة سلوك.

بناء الجملة

Revert( DataSource [, Record ] )

• DataSource – مطلوب. مصدر البيانات الذي تريد إعادته.
• سجل – اختياري. السجل الذي تريد إعادته. إذا لم تقم بتحديد سجل، يتم إرجاع مصدر البيانات بأكمله.

مثال

في هذا المثال، ستقوم بإرجاع مصدر البيانات المسمى IceCream والذي يبدأ بالبيانات الموجودة في هذا الجدول:

يقوم أحد المستخدمين علي جهاز آخر بتغيير خاصية Quantity الخاصة بسجل الفراولة إلى 400. في الوقت نفسه، يمكنك تغيير نفس الخاصية من نفس السجل إلى 500، وليس التعرف على التغييرات الأخرى.

يمكنك استخدام وظيفة Patch لتحديث السجل:
Patch( IceCream, LookUp( IceCream, Flavor = "Strawberry" ), { Quantity: 500 } )

يمكنك التحقق من جدول Errors والبحث عن خطأ:

السجل	عمود	رسالة	خطأ
{ ID: 1, Flavor: "Strawberry", Quantity: 300 }	blank	"قام مستخدم آخر بتعديل السجل الذي تحاول تعديله. الرجاء إعادة السجل والمحاولة مرة أخرى."	ErrorKind.Conflict

استنادًا إلى عمود الخطأ، لديك زر إعادة تحميل الذي تم له تعيين خاصية OnSelect إلى هذه الصيغة:
Revert( IceCream, LookUp( IceCream, Flavor = "Strawberry" ) )

بعد تحديد الزر إعادة تحميل، جدول Errors يكون فارغًا، ويكون قد تم تحميل القيمة الجديدة لـ الفراولة:

يمكنك إعادة تطبيق تغييرك أعلى التغيير السابق، ونجح تغييرك لأنه تم حل التعارض.