Smart Client Scripttaal en -limieten
Smart Client Scripts gebruiken een beperkte set C# in XML. Wanneer XProtect Smart Client Als je een scriptbestand laadt, wordt het bestand gecontroleerd aan de hand van een lijst met toegestane taalfuncties en -acties. Als een gedeelte van het script ongeldig is, worden de hoofdtekst van het script en de gebeurtenisactiveringen niet uitgevoerd. De <Login> Het blok wordt nog steeds toegepast.
Bestandsstructuur
Sla het bestand op met de .scs extensie, gecodeerd als UTF-8. UTF-8 zonder BOM wordt aanbevolen.
Element | Vereist | Beschrijving |
|---|---|---|
| Ja | Root-element. |
| Nee | Versie van bestandsindeling. De standaard en huidige versie is |
| Nee | Aanmeldingsgegevens. Zie Automatisch aanmelden met scripts. |
| Nee | Tekstvak. Draait één keer per aanmelding. |
| Nee | Gebeurtenisactivering. Een bestand kan één gebeurtenis per gebeurtenis bevatten. |
Opmerking
Oude elementen zoals <ScriptExtension> en alle <ScriptLanguage> andere dan C# worden geweigerd door de scriptengine.)
Speciale tekens
XML leest <, >,en & Als markering. Script-code inpakken <![CDATA[ … ]]>, die wordt aanbevolen, of vervang elk teken door de XML-entiteit:
Karakter | Entiteit |
|---|---|
|
|
|
|
|
|
Ondersteunde taal
Variabelen | Details |
|---|---|
Variabelen |
|
Voorwaarden |
|
Lussen |
|
Gebruikers |
|
Strings | Dubbele aanhalingstekens worden aanbevolen (enkele aanhalingstekens worden geaccepteerd door de engine, maar genereren een waarschuwing en zijn niet geldig C#). Word lid met strings |
Opmerkingen |
|
Acties
Type actie | Syntaxis | Aantekeningen |
|---|---|---|
Ingebouwde acties |
| Directe methoden die door de Smart Client Scriptengine (bijvoorbeeld De beschikbare groepen zijn |
Weergaven, uitvoer, gebeurtenissen en PTZ-voorkeurposities |
| De camera Voorbeeld: Deze namen zijn identiek in alle weergavetalen van de client. Als twee items in dezelfde groep alleen verschillen door speciale tekens (zoals Cam 1 en Cam-1), genereren ze dezelfde ID en is er slechts één bereikbaar; hernoem een van de items om de botsing op te lossen. |
MIP-plug-in acties, op naam |
| De camera |
Acties op ID |
| Taal-onafhankelijke unieke ID. Beide namen en ID's worden vermeld in het gegenereerde scriptreferentiebestand wanneer Inclusief configuratie-items is gecontroleerd, zodat u de exacte ID rechtstreeks naar uw script kunt kopiëren. |
Genereer een scriptreferentie om alle beschikbare acties op uw systeem te bekijken.
Ingebouwde functies
Functie | Beschrijving |
|---|---|
| Onderbreekt het script zonder te bevriezen XProtect Smart Client. Accepteert 0-30.000 ms. |
| Toont een melding in het meldingsgebied. Het blokkeert het script of de gebruikersinterface niet. |
| Datum- en tijdwaarden. U kunt lezen |
| Unieke identificatiebewerkingen. |
| Schrijven naar |
| In een gebeurtenistrigger retourneert de ID van het venster waar de gebeurtenis heeft plaatsgevonden. Geeft lege tekst voor het hoofdvenster, de scripttekst en in Opmerking: Deze functie kan de ID van een ingesloten venster (zoals een weergavegebied in een tabblad) retourneren zonder |
Gebeurtenisactiveringen
Definiëren <OnEvent> Blokken binnen de <ScriptEngine> rootelement om te reageren op gebruikersacties en wijzigingen in de werkruimte.
Gebeurtenis | Draait |
|---|---|
| Na elke voltooide configuratie wordt de configuratie opnieuw geladen, zodra weergaven en tabbladen zijn opgelost. Wordt niet uitgevoerd bij de eerste aanmelding. |
| Nadat een andere weergave is geselecteerd, in een willekeurig venster. |
| Nadat een ander weergave-item is geselecteerd, wordt dit in een willekeurig venster weergegeven. |
| Nadat het geselecteerde tabblad is gewijzigd of een venster is geschakeld tussen Live en Afspelen. OpmerkingSommige werkruimten, zoals Alarmbeheer en Exports, bevatten hun eigen ingesloten weergavegebieden. Elk ingesloten weergavegebied meldt het maken ervan met een ID die niet bij een zwevend venster hoort. Overschakelen naar een van deze tabbladen kan daarom worden uitgevoerd ShownWorkSpaceChanged meerdere keren (Alarmbeheer heeft bijvoorbeeld twee ingesloten weergavegebieden en Exports heeft er één, dus overschakelen naar Alarmbeheer kan de activering tot drie keer uitvoeren). Je script moet niet-herkende venster-ID's negeren. |
Gebeurtenisactiveringen worden samen met de scripttekst gecontroleerd. Een onbekende gebeurtenisnaam is een fout.
Gebeurtenisactiveringen worden actief voordat het script wordt uitgevoerd en blijven actief tot het afmelden.
Een gebeurtenistrigger wordt niet meer uitgevoerd vanwege een wijziging die door de eigen acties is aangebracht.
Gebeurtenisnamen zijn hoofdlettergevoelig.
Elk gebeurtenistype kan maximaal één keer in een script worden gedeclareerd.
Weergave- of tabbladwijzigingen die door de scripttekst zijn gestart (
<Script>) ook deze gebeurtenissen activeren.
Limieten
Limiet | Waarde |
|---|---|
Verklaringen per uitvoering | 100,000 |
Uitvoeren om de tijd per uitvoering | 30 seconden |
| 30 seconden |
Draait per gebeurtenistrigger | 60 per minuut. Alle runs in die minuut worden overgeslagen. |
Iteraties per lus | 10,000 |
Snaarlengte | 65.536 tekens |
Elke uitvoering van het script of een gebeurtenistrigger heeft zijn eigen grenzen. Als een uitvoering een limiet bereikt of een actie mislukt, stopt de rest van de uitvoering en wordt de gebeurtenis aangemeld MIPLog.txt, maar XProtect Smart Client en alle andere gebeurtenisactiveringen blijven actief. Wanneer u zich afmeldt of afsluit XProtect Smart Client, worden alle draaiende scripts gestopt.
Niet ondersteund | In plaats daarvan gebruiken |
|---|---|
|
|
|
|
| Verifieer het script voordat u het implementeert |
Voorwaardelijke gebruiker ( |
|
Voorvoegsel increment | Verhoging van suffix |
Snaarinterpolatie |
|
Komma-expressies, meerdere variabele declaraties in | Aparte verklaringen |
Arrays, letterlijke collecties en indexering | Niet ondersteund |
| Niet ondersteund |
Methoden, klassen, interfaces, naamruimten, | MIP-plug-in |
| Ingebouwde scriptacties of een MIP-plug-in gebruiken |
Timers, |
|
Toegang tot bestand, register, netwerk en proces, reflectie | MIP-plug-in |