Smart Client Limba și limitele scriptului
Smart Client script-urile folosesc un set limitat de C# în interiorul XML. Când XProtect Smart Client Dacă încarcă un fișier script, acesta verifică fișierul în raport cu o listă de funcții și acțiuni lingvistice permise. Dacă orice parte a scriptului este nevalidă, corpul scriptului și declanșatoarele de evenimente nu vor rula; cu toate acestea, <Login> Blocul este încă aplicat.
Structura fișierului
Salvați fișierul cu .scs extensie, codificată ca UTF-8. Se recomandă UTF-8 fără BOM.
Element | Obligatoriu | Descriere |
|---|---|---|
| Da | Element rădăcină. |
| Nu | Versiune în format de fișier. Versiunea implicită și cea curentă este |
| Nu | Informații de conectare. Vedeți Automatizați conectarea cu ajutorul scripturilor. |
| Nu | Corpul scriptului. Rulează o dată per conectare. |
| Nu | Trigger de evenimente. Un fișier poate avea unul pentru fiecare eveniment. |
Notă
Elemente moștenite, cum ar fi <ScriptExtension> și orice <ScriptLanguage> altele decât C# sunt refuzate de motorul de script.)
Caractere speciale
Citiri XML <, >,și & ca marcaj. Încadrați codul de script în <![CDATA[ … ]]>, care se recomandă, sau înlocuiți fiecare caracter cu entitatea sa XML:
Caracter | Entitate |
|---|---|
|
|
|
|
|
|
Limbă acceptată
Variabile | Detalii |
|---|---|
Variabile |
|
Condiții |
|
Bucle |
|
Operatori |
|
Șiruri | Se recomandă ghilimele duble (ghilimelele simple sunt acceptate de motor, dar generează un avertisment și nu sunt C# valide). Alăturați-vă șirurilor cu |
Comentarii |
|
Acțiuni
Tipul acțiunii | Sintaxă | Note |
|---|---|---|
Acțiuni încorporate |
| Metode directe furnizate de Smart Client motor cu script (de exemplu, Grupurile disponibile sunt |
Vizualizări, ieșiri, evenimente și poziții presetate |
| The Exemplu: Aceste nume sunt identice în toate limbile de afișare ale clientului. Dacă două elemente din același grup diferă doar prin caractere speciale (cum ar fi Cam 1 și Cam-1), ele generează același identificator și doar unul este accesibil; redenumiți unul dintre elemente pentru a rezolva coliziunea. |
Comenzi pentru pluginuri MIP, după nume |
| The |
Acțiuni după ID |
| Identificator unic independent de limbă. Atât numele, cât și ID-urile sunt listate în fișierul de referință al scriptului generat atunci când este bifată Includere elemente de configurare, permițându-vă să copiați ID-ul exact direct în script. |
Pentru a vedea toate acțiunile disponibile în sistemul dvs., generați o referință de script.
Funcții încorporate
Funcție | Descriere |
|---|---|
| Întrerupe scriptul fără a îngheța XProtect Smart Client. Acceptă 0–30.000 ms. |
| Afișează o notificare în zona de notificare. Nu blochează scriptul sau interfața utilizator. |
| Valori pentru dată și oră. Puteți citi |
| Operațiuni cu identificator unic. |
| Scriere către |
| Într-un activator de eveniment, returnează ID-ul ferestrei în care s-a întâmplat evenimentul. Returnează textul gol pentru fereastra principală, în corpul scriptului și în Notă: Această funcție poate returna ID-ul unei ferestre încorporate (cum ar fi o zonă de vizualizare în interiorul unei file) care nu |
Declanșatoare de evenimente
Definiți <OnEvent> Blocuri în interiorul <ScriptEngine> Element rădăcină pentru a reacționa la acțiunile utilizatorului și la modificările spațiului de lucru.
Eveniment | Rulează |
|---|---|
| După fiecare reîncărcare finalizată a configurării, odată ce vizualizările și filele s-au stabilit. Nu rulează la prima conectare. |
| După ce este selectată o altă vizualizare, în orice fereastră. |
| După ce este selectat un alt element de vizualizare, în orice fereastră. |
| După ce fila selectată se schimbă sau o fereastră comută între Live și Redare. NotăUnele spații de lucru, cum ar fi Manager de alarme și Exporturi, conțin propriile zone de vizualizare încorporate. Fiecare zonă de vizualizare încorporată raportează crearea sa utilizând un ID care nu aparține unei ferestre separate. Prin urmare, trecerea la una dintre aceste file poate rula ShownWorkSpaceChanged de mai multe ori (de exemplu, Manager de alarmă are două zone de vizualizare încorporate și Exporturi are una, astfel încât trecerea la Manager de alarmă poate rula declanșatorul de până la trei ori). Scriptul trebuie să ignore ID-urile de fereastră nerecunoscute. |
Trigggerele de evenimente sunt verificate împreună cu corpul scriptului. Un nume necunoscut de eveniment este o eroare.
Declanșatoarele de evenimente devin active înainte ca corpul scriptului să ruleze și să rămână activ până la deconectare.
Un activator de eveniment nu rulează din nou, din cauza unei modificări efectuate de propriile acțiuni.
Numele evenimentelor sunt sensibile la litere mari și mici.
Fiecare tip de eveniment poate fi declarat cel mult o dată într-un script.
Vizualizarea sau modificările de filă inițiate de corpul scriptului (
<Script>) declanșează și aceste evenimente.
Limite
Limită | Valoare |
|---|---|
Declarații per rulare | 100,000 |
Timp de rulare per rulare | 30 de secunde |
| 30 de secunde |
Rulează pe activator de eveniment | 60 pe minut. Toate rulările din acel minut sunt omise. |
Iterații per buclă | 10,000 |
Lungime șir | 65.536 caractere |
Fiecare rulare a corpului scriptului sau a unui declanșator de eveniment are propriile limite. Dacă o rulare atinge o limită sau o acțiune eșuează, restul rulării se oprește și evenimentul este conectat MIPLog.txt, dar XProtect Smart Client și orice alte declanșatoare de evenimente continuă să ruleze. Când vă deconectați sau închideți XProtect Smart Client, se oprește orice script-uri care rulează.
Neacceptat | Utilizați în schimb |
|---|---|
|
|
|
|
| Verificați scriptul… înainte de a implementa scriptul |
Operator condițional ( |
|
Incrementare prefix | Increment postfix |
Interpolare șir |
|
Expresii virgulă, declarații multiple de variabile în | Declarații separate |
Matrice, literali de colecție și indexare | Neacceptat |
| Neacceptat |
Metode, clase, interfețe, spații de nume, | Plugin MIP |
| Folosiți comenzi de script încorporate sau un plugin MIP |
Cronometre, |
|
Fișier, registry, rețea și acces la proces, reflecție | Plugin MIP |