Smart Client لغة البرنامج النصي وحدوده
Smart Client تستخدم البرامج النصية مجموعة محدودة من C# داخل XML. متى XProtect Smart Client عند تحميل ملف برنامج نصي، فإنه يتحقق من الملف مقابل قائمة ميزات اللغة والإجراءات المسموح بها. إذا كان أي جزء من البرنامج النصي غير صالح، فلن يتم تشغيل نص البرنامج النصي ومشغلات الأحداث ؛ ومع ذلك، فإن <Login> لا يزال الحظر مطبقا.
بنية الملف
احفظ الملف باستخدام .scs امتداد البرنامج، تم ترميزه ك UTF-8. يوصى باستخدام UTF-8 بدون BOM.
العنصر | مطلوب | الوصف |
|---|---|---|
| نعم | العنصر الجذر. |
| لا | إصدار صيغة الملف. الإصدار الافتراضي والحالي هو |
| لا | معلومات تسجيل الدخول. راجع أتمتة تسجيل الدخول باستخدام البرامج النصية. |
| لا | نص البرنامج النصي. يعمل مرة واحدة لكل تسجيل دخول. |
| لا | مشغل الحدث. يمكن أن يحتوي الملف على واحد لكل حدث. |
ملاحظة
العناصر القديمة مثل <ScriptExtension> وأي <ScriptLanguage> يتم رفض البرامج الأخرى غير C# بواسطة محرك البرامج النصية.)
رموز خاصة
قراءات XML <, >,و & كعلامة. التفاف البرنامج النصي في <![CDATA[ … ]]>، وهو ما ينصح به، أو استبدال كل حرف بكيان XML الخاص به:
حرف | الكيان |
|---|---|
|
|
|
|
|
|
اللغة المدعومة
المتغيرات | التفاصيل |
|---|---|
المتغيرات |
|
الشروط |
|
حلقات |
|
المشغلون |
|
سلاسل | يوصى باستخدام عروض أسعار مزدوجة (يقبل المحرك عروض الأسعار الفردية، ولكنها تصدر تحذيرا وتكون غير صالحة في C#). ربط السلاسل ب |
تعليقات |
|
الإجراءات
نوع الإجراء | بناء الجملة | ملاحظات |
|---|---|---|
الإجراءات المضمنة |
| الطرق المباشرة التي يوفرها Smart Client محرك البرنامج النصي (على سبيل المثال، المجموعات المتاحة هي |
طرق العرض والمخرجات والأحداث وإعدادات PTZ المسبقة |
| ال مثال: هذه الأسماء متطابقة عبر جميع لغات عرض العميل. إذا كان عنصران في نفس المجموعة يختلفان فقط في الأحرف الخاصة (مثل Cam 1 وCam-1)، فإنهما يولدان نفس المعرف، ولا يمكن الوصول إلا إلى عنصر واحد؛ أعد تسمية أحد العناصر لحل التصادم. |
إجراءات مكون MIP الإضافي، حسب الاسم |
| ال |
الإجراءات حسب المعرف |
| معرف فريد مستقل عن اللغة. يتم سرد كل من الأسماء والمعرفات في ملف مرجع البرنامج النصي الذي تم إنشاؤه عند تضمين عناصر التكوين تم تحديد هذا الإعداد، مما يتيح لك نسخ المعرف الدقيق مباشرة إلى البرنامج النصي الخاص بك. |
لرؤية جميع الإجراءات المتاحة على نظامك، قم بإنشاء مرجع برنامج نصي.
الوظائف المضمنة
وظيفة | الوصف |
|---|---|
| إيقاف البرنامج النصي مؤقتا دون تجميد XProtect Smart Client. يقبل 0-30,000 مللي ثانية. |
| إظهار إعلام في منطقة الإعلام. لا يحظر البرنامج النصي أو واجهة المستخدم. |
| قيم التاريخ والوقت. يمكنك القراءة |
| عمليات المعرف الفريد. |
| يكتب إلى |
| في مشغل الأحداث، ترجع الدالة VMS معرف النافذة التي وقع فيها الحدث. إرجاع نص فارغ للنافذة الرئيسية، في نص البرنامج النصي، وفي ملاحظة: يمكن أن ترجع هذه الوظيفة معرف الإطار المضمن (مثل منطقة العرض داخل علامة تبويب) والذي يكون بلا |
مشغلات الأحداث
تحديد <OnEvent> كتل داخل <ScriptEngine> عنصر جذر للرد على إجراءات المستخدم وتغييرات مساحة العمل.
الحدث | قيد التشغيل |
|---|---|
| بعد كل تكوين مكتمل، أعد التحميل مرة واحدة بعد استقرار طرق العرض وعلامات التبويب. لا يعمل عند تسجيل الدخول لأول مرة. |
| بعد تحديد طريقة عرض مختلفة، في أي نافذة. |
| بعد تحديد عنصر عرض مختلف، في أي نافذة. |
| بعد تغيير علامة التبويب المحددة، أو تبديل نافذة بين المباشر والتشغيل. ملاحظةبعض مساحات العمل، مثل مجموعة إدارة الإنذار و عمليات التصدير، تحتوي على مناطق العرض المضمنة الخاصة بها. تقوم كل منطقة عرض مضمنة بالإبلاغ عن إنشائها باستخدام معرف لا ينتمي إلى نافذة عائمة. ومن ثم يمكن تشغيل التبديل إلى إحدى علامات التبويب هذه ShownWorkSpaceChanged عدة مرات (على سبيل المثال، مجموعة إدارة الإنذار يحتوي على منطقتي عرض مضمنتين و عمليات التصدير يحتوي على واحد، لذا يجب التبديل إلى مجموعة إدارة الإنذار يمكنك تشغيل المشغل حتى ثلاث مرات). يجب أن يتجاهل البرنامج النصي الخاص بك معرفات النوافذ غير المعروفة. |
يتم فحص مشغلات الأحداث جنبا إلى جنب مع نص البرنامج النصي. اسم حدث غير معروف هو خطأ.
تصبح مشغلات الأحداث نشطة قبل تشغيل نص البرنامج النصي وتظل نشطة حتى تسجيل الخروج.
لا يتم تشغيل مشغل الأحداث مرة أخرى بسبب تغيير تم إجراؤه بواسطة الإجراءات الخاصة به.
أسماء الأحداث حساسة لحالة الأحرف.
يمكن التصريح بكل نوع حدث مرة واحدة على الأكثر في برنامج نصي.
عرض التغييرات أو علامة التبويب التي بدأها نص البرنامج النصي (
<Script>) أيضا تشغيل هذه الأحداث.
الحدود
الحد | قيمة |
|---|---|
كشوف الحساب لكل تشغيل | 100,000 |
وقت التشغيل لكل تشغيل | 30 ثانية |
| 30 ثانية |
تشغيل لكل مشغل حدث | 60 في الدقيقة. يتم تخطي أي أشواط أخرى في تلك الدقيقة. |
التكرارات لكل حلقة | 10,000 |
طول السلسلة | 65,536 حرفا |
لكل تشغيل لنص البرنامج النصي أو مشغل الحدث حدوده الخاصة. إذا وصل التشغيل إلى حد ما أو فشل أحد الإجراءات، فسيتوقف باقي هذا التشغيل وسيتم تسجيل دخول الحدث MIPLog.txt, لكن XProtect Smart Client وتستمر أي مشغلات أحداث أخرى في العمل. عند تسجيل الخروج أو الإغلاق XProtect Smart Client، فإنه يتوقف عن تشغيل أي البرامج النصية.
غير مدعوم | استخدم بدلا من ذلك |
|---|---|
|
|
|
|
| التحقق من البرنامج النصي... قبل نشر البرنامج النصي |
المشغل الشرطي ( |
|
زيادة البادئة | زيادة لاحقة |
إدراج سلسلة |
|
تعبيرات الفاصلة، إقرارات المتغيرات المتعددة في | بيانات منفصلة |
المصفوفات، والمجموعات الحرفية، والفهرسة | غير مدعوم |
| غير مدعوم |
الطرق، والفئات، والواجهات، ومساحات الأسماء، | مكون MIP الإضافي |
| استخدم إجراءات البرنامج النصي المدمج أو مكون MIP الإضافي |
أجهزة ضبط الوقت، |
|
الملف، والتسجيل، والشبكة، وعملية الوصول، والتفكير | مكون MIP الإضافي |