معَالجَات الأحدَاث

مكتمل

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

التسجيل عبر خصَائص النموذج

يؤدي تسجيل معَالج الأحدَاث با‏‫‏‫‏‫‫‏‫‏ستخدَام خصَائص النموذج إلى إنشَاء تكوين ثَابت لمعَالج الأحدَاث فِي وقت التصميم. فِي كل مرة يتم فيهَا تحميل النموذج، يتم تشغيل نفس معَالجَات الأحدَاث. على عكس تسجيل معَالج الحدث با‏‫‏‫‏‫‫‏‫‏ستخدَام التعليمَات البرمجية، يمكن للمنطق تحديد مَا يجب تسجيله.

فِي مصمم النموذج، يمكنك تسجيل معَالجَات الأحدَاث للأحدَاث التَالية:

• النموذج - يسمح لك هَذا المعَالج بتسجيل معَالجَات الأحدَاث OnLoad وOnSave.

• علامَات التبويب - يتيح لك هَذا المعَالج تسجيل الأحدَاث لكل علامة تبويب فِي النموذج لتغيير حَالة علامة التبويب. عَادةً مَا يُستخدم هَذا لمعرفة مَا إذَا تم توسيع علامة التبويب حتى تتمكن مِن القيَام بشيء مثل تحميل البيَانَات دينَاميكيًا.

• الأعمدة - يسمح لك هَذا المعَالج بتسجيل معَالج الأحدَاث إذَا تم تغيير بيَانَات العمود.

مَا يلي هو مثَال عَلى تسجيل معَالج حدث OnLoad لجدول الحسَاب. هَذَا مِثَالٌ عَلى مُعَالِج حَدث النَمُوذَج.

أحد الأنمَاط الشَائعة هو تسجيل معَالج OnLoad ثم تسجيل معَالجَات الأحدَاث المتبقية عبر التعليمَات البرمجية فِي منطق معَالج الأحدَاث OnLoad. وتتمثل فائدة هَذا الأسلوب فِي أنه عندمَا تحتَاج إلى تشغيل المنطق الخَاص بك عَلى نمَاذج متعددة، فلن تحتَاج إلى تسجيل كافة معَالجَات الأحدَاث فِي كل نموذج. ميزة أخرى هي أنه إذَا كنت بحَاجة إلى تحديد بعض معَالجَات الأحدَاث دينَاميكيًا، فيمكنك ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫استخدَام المنطق لتحديد مَا إذَا كنت تريد تسجيل المعَالج أم لا. على سبيل المثَال، قد ترغب فِي تخطي تسجيل معَالج الأحدَاث لعمود إذَا كان بإمكانك تحديد متى يتم تحميل النموذج ومَا إذَا كان هَذا العمود للقرَاءة فقط أو مخفيًا.

سجل با‏‫‏‫‏‫‫‏‫‏ستخدَام الرمز

من الممكن تسجيل معَالجَات الأحدَاث با‏‫‏‫‏‫‫‏‫‏ستخدَام التعليمَات البرمجية لجَمِيع المعَالجَات باستثنَاء OnLoad، الذي يجب تسجيله با‏‫‏‫‏‫‫‏‫‏ستخدَام التكوين. يمكنك بَعد ذلك ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫استخدَام معَالج OnLoad لتسجيل معَالجَات أخرى با‏‫‏‫‏‫‫‏‫‏ستخدَام التعليمَات البرمجية. فيمَا يلي مثَال عَلى تسجيل معَالج OnChange عَلى عمود رقم العميل فِي جدول العميل مع تنفيذ الخطوَات التَالِية:

• قم بإنشَاء دَالة يتم تشغيلهَا فِي حدث OnLoad لنموذج الحسَاب.

• فِي هذه الوظيفة، اتصل بـ addOnChange لتسجيل الوظيفة التي سيتم الاتصَال بهَا عِندَ تغيير عمود رقم الحسَاب.

• قم بتسجيل معَالج الأحدَاث OnLoad فِي خصَائص نموذج الحسَاب.

function LearnLab_handleAccountOnLoad(executionContext)
{
    var formContext = executionContext.getFormContext();
    formContext.getAttribute('accountnumber').addOnChange(LearnLab_handleOnChangeAccountNumber)
}
function LearnLab_handleOnChangeAccountNumber(executionContext)
{
    var formContext = executionContext.getFormContext();
    formContext.ui.setFormNotification('Check other systems', 'INFO', 'AcctNumber');
}

يعرض هَذا الرمز إشعَارًا عَلى مستوى النموذج كلمَا تغيرت بيَانَات عمود رقم الحسَاب.

هنَاك العديد مِن الأحدَاث الجَانبية الأخرى الخَاصة بالعميل والتي يمكنك تسجيل معالجاتهَا.