Smart Client שפת סקריפט ומגבלות
Smart Client סקריפטים משתמשים בקבוצה מוגבלת של C# בתוך XML. כאשר XProtect Smart Client טוען קובץ סקריפט, הוא בודק את הקובץ מול רשימה של תכונות שפה ופעולות מותרות. אם חלק כלשהו של הסקריפט אינו חוקי, גוף הסקריפט ומפעילי האירועים לא יפעלו; עם זאת, המאפיין <Login> החסימה עדיין מוחלת.
מבנה הקובץ
שמור את הקובץ עם .scs הרחבה, מקודדת כ- UTF-8. UTF-8 ללא BOM מומלץ.
רכיב | חובה | תיאור |
|---|---|---|
| כן | רכיב בסיס. |
| לא | גירסת תבנית קובץ. גרסת ברירת המחדל והגירסה הנוכחית הן |
| לא | פרטי התחברות. ראה כניסה אוטומטית עם סקריפטים. |
| לא | גוף ה־ Script. פועל פעם אחת לכל כניסה. |
| לא | גורם מפעיל של אירוע. קובץ יכול לכלול קובץ אחד לכל אירוע. |
שים לב
אלמנטים מדור קודם כגון <ScriptExtension> וכל <ScriptLanguage> מנוע הסקריפט מסרב לאשר פעולות אחרות פרט ל־ C#.)
תווים מיוחדים
קריאות XML <, >,וגם & כסימון. גלישה של קוד סקריפט ב- <![CDATA[ … ]]>, מומלץ, או החלף כל תו ביישות ה-XML שלו:
תו | היישות |
|---|---|
|
|
|
|
|
|
שפה נתמכת
משתנים | פרטים |
|---|---|
משתנים |
|
תנאים |
|
לולאות |
|
מפעילים |
|
מחרוזות | מומלץ להשתמש בגרשיים כפולים (גרשיים בודדים מתקבלים על ידי המנוע אך יוצרים אזהרה ואינם תקפים C#). צרף מחרוזות עם |
הערות |
|
פעולות
סוג פעולה | תחביר | פתקים |
|---|---|---|
פעולות מובנות |
| שיטות ישירות שמספקת Smart Client script engine (לדוגמה, הקבוצות הזמינות הן |
תצוגות, יציאות, אירועים ו-PTZ קבועים מראש |
| ה דוגמה: שמות אלה זהים בכל שפות התצוגה של הלקוח. אם שני פריטים באותה קבוצה נבדלים זה מזה רק בתווים מיוחדים (כגון Cam 1 ו- Cam-1), הם יוצרים את אותו מזהה, וניתן להגיע רק לאחד מהם; שנה את השם של אחד הפריטים כדי לפתור את ההתנגשות. |
MIP פעולות תוסף, לפי שם |
| ה |
פעולות לפי מזהה |
| מזהה ייחודי שאינו תלוי בשפה. שני השמות והמזהים מפורטים בקובץ ההפניה של הסקריפט שנוצר בשעת סימון האפשרות 'כלול פריטי תצורה׳, המאפשרת להעתיק את המזהה המדויק ישירות לסקריפט. |
כדי לראות את כל הפעולות הזמינות במערכת, צור הפניה לסקריפט.
פונקציות מובנות
פונקציה | תיאור |
|---|---|
| השהיית הסקריפט ללא קיפאון XProtect Smart Client. מקבל 0-30,000 מילישניות. |
| הצגת הודעה באזור ההודעות. הוא לא חוסם את הסקריפט או את ממשק המשתמש. |
| ערכי תאריך ושעה. אתה יכול לקרוא |
| פעולות מזהה ייחודי. |
| כותב אל |
| בגורם מפעיל של אירוע, החזרת מזהה החלון שבו התרחש האירוע. מחזיר טקסט ריק עבור החלון הראשי, בגוף הסקריפט וב הערה: פונקציה זו יכולה להחזיר את הזיהוי של חלון מוטבע (כגון אזור תצוגה בתוך כרטיסיה) אשר לא |
גורמי אירוע
הגדר <OnEvent> בלוקים בתוך <ScriptEngine> רכיב בסיס ל- react לפעולות משתמש ולשינויים בסביבת העבודה.
אירוע | ריצות |
|---|---|
| לאחר כל טעינה מחדש של התצורה שהושלמה, לאחר שהתצוגות והלשוניות יסתדרו. לא מופעל בכניסה הראשונה. |
| לאחר בחירת תצוגה אחרת, בכל חלון. |
| לאחר בחירת פריט תצוגה אחר, בכל חלון. |
| לאחר שהלשונית שנבחרה משתנה, או חלון עובר בין שידור חי להצגת הקלטות. שים לבסביבות עבודה מסוימות, כגון מנהל ההתראות ו- פעולות יצוא, מכילות אזורי תצוגה מוטבעים משלהן. כל אזור תצוגה מוטבע מדווח על יצירתו באמצעות מזהה שאינו שייך לחלון צף. מעבר לאחת מהכרטיסיות האלה יכול אפוא לפעול ShownWorkSpaceChanged מספר פעמים (לדוגמה, מנהל ההתראות כולל שני אזורי תצוגה מוטבעים ו פעולות ייצוא יש אחד כזה, לכן מעבר אל מנהל ההתראות ניתן להפעיל את ההדק עד שלוש פעמים). על הסקריפט להתעלם מזהי חלונות לא מזוהים. |
מפעילי אירועים נבדקים יחד עם גוף הסקריפט. שם אירוע לא ידוע הוא שגיאה.
מפעילי אירועים הופכים לפעילים לפני שגוף הסקריפט מופעל ונשארים פעילים עד היציאה מהמערכת.
גורם מפעיל של אירוע אינו פועל שוב עקב שינוי שבוצע על-ידי הפעולות שלו עצמו.
שמות אירועים הם תלויי רישיות.
ניתן להצהיר על כל סוג אירוע פעם אחת לכל היותר בסקריפט.
שינויים בתצוגה או בכרטיסייה שגוף הסקריפט יזם (
<Script>) גם להפעיל אירועים אלה.
מגבלות
מגבלה | ערך |
|---|---|
הצהרות להרצה | 100,000 |
זמן ריצה לכל ריצה | 30 שניות |
| 30 שניות |
פועל לפי גורם מפעיל של אירוע | 60 לדקה. המערכת תדלג על ריצות נוספות בדקה זו. |
איטראציות לכל לולאה | 10,000 |
אורך מחרוזת | 65,536 תווים |
לכל הפעלה של גוף הסקריפט או של מפעיל אירוע יש גבולות משלו. אם ריצה מגיעה למגבלה או פעולה נכשלת, שאר הריצה מפסיקה והאירוע מחובר למערכת MIPLog.txt, אך XProtect Smart Client וכל אירוע אחר מפעיל להמשיך לרוץ. בעת יציאה או סגירה XProtect Smart Client, הוא מפסיק כל תסריטים הפועלים.
לא נתמך | השתמש במקום זאת |
|---|---|
|
|
|
|
| אמת סקריפט... לפני שתפרוס את הסקריפט |
אופרטור מותנה ( |
|
תוספת קידומת | תוספת Postfix |
אינטרפולציה של מחרוזת |
|
ביטויי פסיק, הצהרות על משתנים מרובים ב- | הצהרות נפרדות |
מערכים, ליטרלי איסוף ויצירת אינדקס | לא נתמך |
| לא נתמך |
שיטות, סיווגים, ממשקים, מרחבי שמות, | תוסף MIP |
| השתמש בפעולות סקריפט מובנות או בתוסף MIP |
קוצבי זמן, |
|
קובץ, רישום, גישה לרשת ולתהליך, השתקפות | תוסף MIP |