Smart Client Linguaggio e limiti dello script
Smart Client Gli script utilizzano un set limitato di C# all'interno di XML. Quando XProtect Smart Client Carica un file di script e lo confronta con un elenco di funzioni e azioni linguistiche consentite. Se una parte qualsiasi dello script non è valida, il corpo dello script e i trigger di eventi non verranno eseguiti; tuttavia, <Login> Il blocco è ancora applicato.
Struttura del file
Salva il file con .scs estensione, codificata come UTF-8. Si consiglia di utilizzare UTF-8 senza DBA.
Elemento | Richiesto | Descrizione |
|---|---|---|
| Sì | Elemento radice. |
| No | Versione del formato del file. La versione predefinita e quella corrente sono |
| No | Informazioni di login. Consultare Automatizza l'accesso con gli script. |
| No | Corpo dello script. Viene eseguito una volta per ogni accesso. |
| No | Attivazione evento. Un file può avere uno per evento. |
Nota
Elementi legacy come <ScriptExtension> e qualsiasi <ScriptLanguage> diverse da C# vengono rifiutate dal motore di script.)
Caratteri speciali
Letture XML <, >e & come markup. Involucro codice script in <![CDATA[ … ]]>, consigliato o sostituire ogni carattere con la relativa entità XML:
Carattere | Entità |
|---|---|
|
|
|
|
|
|
Lingua supportata
Variabili | Dettagli |
|---|---|
Variabili |
|
Condizioni |
|
Loop |
|
Operatori |
|
Stringhe | Si consiglia di utilizzare le virgolette doppie (le virgolette singole vengono accettate dal motore ma generano un avviso e non sono valide C#). Unisci stringhe con |
Commenti |
|
Azioni
Tipo di azione | Sintassi | Note |
|---|---|---|
Azioni integrate |
| Metodi diretti forniti dalla Smart Client motore di script (ad esempio, I gruppi disponibili sono |
Viste, output, eventi e predefiniti PTZ |
| La Esempio: Questi nomi sono identici in tutte le lingue di visualizzazione del client. Se due elementi nello stesso gruppo differiscono solo per caratteri speciali (come Cam 1 e Cam-1), generano lo stesso identificatore e solo uno è raggiungibile; rinominare uno degli elementi per risolvere la collisione. |
Azioni del plugin di MIP, per nome |
| La |
Azioni per ID |
| Identificatore univoco indipendente dalla lingua. Entrambi i nomi e gli ID sono elencati nel file di riferimento dello script generato quando è selezionata l'opzione Includi elementi di configurazione, che consente di copiare l'ID esatto direttamente nello script. |
Per visualizzare tutte le azioni disponibili sul sistema, generare un riferimento allo script.
Funzioni integrate
Funzione | Descrizione |
|---|---|
| Sospende lo script senza bloccarlo XProtect Smart Client. Accetta 0-30.000 ms. |
| Mostra una notifica nell'area di notifica. Non blocca lo script o l'interfaccia utente. |
| Valori di data e ora. Si può leggere |
| Operazioni identificatore univoco. |
| Scrittura su |
| In un'attivazione evento, restituisce l'ID della finestra in cui si è verificato l'evento. Restituisce il testo vuoto per la finestra principale, nel corpo dello script e in Nota: questa funzione può restituire l'ID di una finestra incorporata (come un'area della vista all'interno di una scheda) che non |
Attivazione di eventi
Definisci <OnEvent> blocchi all'interno della <ScriptEngine> Elemento radice per reagire alle azioni dell'utente e alle modifiche dell'area di lavoro.
Evento | Esecuzioni |
|---|---|
| Dopo ogni ricarico di configurazione completato, una volta che le viste e le schede sono state regolate. Non viene eseguito al primo accesso. |
| Dopo aver selezionato una vista diversa, in qualsiasi finestra. |
| Dopo aver selezionato un altro elemento della vista, in qualsiasi finestra. |
| Dopo che la scheda selezionata è cambiata o una finestra passa da Live a Riproduzione. NotaAlcune aree di lavoro, come Alarm Manager ed Exports, contengono le proprie aree di vista integrate. Ogni area della vista incorporata riporta la sua creazione utilizzando un ID che non appartiene a una finestra separata. È quindi possibile passare a una di queste schede ShownWorkSpaceChanged più volte (ad esempio, Alarm Manager ha due aree di vista integrate e Exports ne ha una, quindi il passaggio a Alarm Manager può eseguire l'attivazione fino a tre volte). Lo script dovrebbe ignorare gli ID finestra non riconosciuti. |
I trigger degli eventi vengono controllati insieme al corpo dello script. Un nome di evento sconosciuto è un errore.
I trigger degli eventi diventano attivi prima dell'esecuzione del corpo dello script e rimangono attivi fino al logout.
L'attivazione di un evento non viene rieseguita a causa di una modifica apportata dalle proprie azioni.
I nomi degli eventi fanno distinzione tra maiuscole e minuscole.
Ogni tipo di evento può essere dichiarato al massimo una volta in uno script.
Modifiche alla vista o alla scheda avviate dal corpo dello script (
<Script>) attivano anche questi eventi.
Limiti
Limite | Valore |
|---|---|
Istruzioni per esecuzione | 100,000 |
Tempo di esecuzione per esecuzione | 30 secondi |
| 30 secondi |
Esecuzioni per attivazione evento | 60 al minuto. Le altre corse in quel minuto vengono saltate. |
Iterazioni per loop | 10,000 |
Lunghezza stringa | 65.536 caratteri |
Ogni esecuzione del corpo dello script o di un trigger di evento ha i propri limiti. Se un'esecuzione raggiunge un limite o un'azione non riesce, il resto dell'esecuzione si interrompe e l'evento viene connesso MIPLog.txt, ma XProtect Smart Client e qualsiasi altro evento che si attiva continua a funzionare. Quando si esce o si chiude XProtect Smart Client, arresta l'esecuzione di eventuali script.
Non supportato | Usa invece |
|---|---|
|
|
|
|
| Verifica dello script prima di distribuire lo script |
Operatore condizionale ( |
|
Incremento prefisso | Incremento suffisso |
Interpolazione stringa |
|
Espressioni di virgole, più dichiarazioni variabili in | Istruzioni separate |
Array, valori letterali di raccolta e indicizzazione | Non supportato |
| Non supportato |
Metodi, classi, interfacce, spazi dei nomi, | Plugin di MIP |
| Utilizzare azioni script integrate o un plugin di MIP |
Timer, |
|
Accesso a file, registri, reti e processi, reflection | Plugin di MIP |