Dokumentation
SelectInstance
Erstellt einen Auswahldialog mit der Beschriftung caption.
Falls im "elements"-Bereich erstellt, wird bei Übernahme die Eigenschaft name auf die ID der ausgewählten Instanz gesetzt.
Parameter
| Parameter | Beschreibung |
|---|---|
| caption | Sichtbare Beschriftung |
| download (optional) | (default: "") Ist dieser Parameter nicht leer und beinhaltet die Ausgabe des onChange-Skriptes eine Data-URL, so wird die Rückgabe als Textdatei mit dem Namen das download-Parameters heruntergeladen. (ab IP-Symcon 7.0) |
| enabled (optional) | (default: true) Bei true kann die Instanzauswahl verwendet werden, ansonsten wird sie deaktiviert dargestellt (ab IP-Symcon 5.2) |
| link (optional) | (default: false) Ist dieser Parameter true, dann wird die Ausgabe des onChange-Skriptes als Link geöffnet. Ist er false, so wird die Ausgabe als Dialog im Konfigurationsformular angezeigt. (ab IP-Symcon 6.0) |
| name (optional) | Name der Instanzauswahl/der zu setzenden Eigenschaft |
| onChange (optional) | (default: "") Skript, welches bei einer Veränderung des Wertes der Instanzauswahl ausgeführt wird. Sofern das Skript aus mehreren Zeilen besteht, können die einzelnen Zeilen auch als Array übergeben werden (Arrays werden ab Version 6.0 unterstützt). Es hat die gleichen Eigenschaften wie onClick des Button (ab IP-Symcon 5.2) |
| type | SelectInstance |
| validModules (optional) | (default: []) Die Auswahl wird auf Instanzen eingeschränkt, welche eine der definierten ModulIDs haben. Wenn die Liste leer ist sind alle Instanz erlaubt. Entspricht die ausgewählte Instanz keiner der ModulIDs so wird ein Fehler angezeigt und Änderungen können nicht übernommen werden. (ab IP-Symcon 5.5) |
| value (optional) | (default: 0) Der Wert der Instanzauswahl - Sofern es eine dazugehörige Eigenschaft gibt, wird dieser Parameter im elements-Bereich durch die Eigenschaft überschrieben (ab IP-Symcon 5.2) |
| visible (optional) | (default: true) Bei true ist die Instanzauswahl sichtbar, ansonsten ist sie unsichtbar (ab IP-Symcon 5.2) |
| width (optional) | (default: 300px) Feste Breite der Instanzauswahl in Pixel oder % als String, z.B. "40%" oder "250px" (ab IP-Symcon 5.3) |
Beispiel
{ "type": "SelectInstance", "name": "PropertyInstanceID", "caption": "Target" }