Was können wir verbessern?

Dokumentation

Skripte

Ein Skript ist eine Aneinanderreihung von mehr oder weniger komplexen Befehlen. IP-Symcon verwendet und unterstützt jegliche Funktionen der Programmiersprache PHP. In unserem Community-Forum oder Internet können zahllose Beispiele und weiterführende Dokumentationen gefunden werden.

Skripte hinzufügen

Über "Objekt erstellen -> Skript hinzufügen" kann einem Projekt ein neues Skript hinzufügt werden. Es wird empfohlen dem Skript einen eindeutigen und aussagekräftigen Namen zu geben. Der Name ist jederzeit änderbar und das Skript kann in der Baumansicht per Drag & Drop an eine andere Position verschoben werden. Alternativ kann die Erstellung per Kontextmenü direkt an der gewünschten Position erfolgen.

Skript hinzufügen

Skripte editieren & ausführen

Grundsätzlich gilt: Ein PHP Skript verlangt, dass Anweisungen innerhalb eines PHP-Tags (<? ... ?>) stehen und am Ende jedes Statements mit einem Semikolon beendet werden.

Wird ein externer Editor genutzt muss das Skript in UTF8 ohne BOM abgespeichert werden.

Hallo Welt Beispiel

Via "Ausführen" kann das Skript zu Testzwecken manuell gestartet werden. Dabei wird es automatisch gespeichert und sowohl der Zeitstempel der letzten Ausführung als auch die Länge der Laufzeit aktualisiert. Die Ansicht kann zwischen [Text] und [HTML] umgeschaltet werden. Fehlerhafte Eingaben können mit „Rückgängig“ oder “Wiederherstellen“ korrigiert werden. Mit „Nach HTML exportieren“ wird das gesamte Skript im Browser angezeigt.

Skripte importieren & umbenennen

Skript importieren

Wenn bereits ein Skript (z.B. aus dem Forum) heruntergeladen wurde, so kann dieses schnell und unkompliziert über den Menüknopf "Importieren" einfügt werden. Beim Drücken von "Importieren" öffnet sich ein Menü, über welches die gewünschte Datei ausgewählt werden kann. Standardmäßig werden in IP-Symcon alle Skripte mit der ID des Skriptes als Dateiname erstellt. Wenn zur besseren Übersicht ein eigener Dateinamen verwendet werden soll, kann jederzeit über den Menüknopf "Umbenennen" dem Skript ein anderer Name gegeben werden.

Befehle hinzufügen

Über „Befehl hinzufügen“ können an der Cursor-Position im Skript neue Befehle eingefügt werden.

Beispiel

Um die Vielfalt der Befehle einzugrenzen, empfiehlt es sich nur das betreffende Gerät anzugeben. Hier als Beispiel für die Soundausgabe des "Media Player":

Beispiel

Als Auswahlmöglichkeit werden dann nur die gerätespezifischen Funktionen angezeigt:

Beispiel

Das Ergebnis ist der Befehl mit der passenden ID-Nummer.

Beispiel

Die Dokumentation zu allen Befehlen die zur Auswahl stehen, befindet sich in der Befehlsreferenz und Modulreferenz. Eine andere Möglichkeit bietet die Suche im oberen rechten Bereich der IP-Symcon Internetseite. Diese bietet einen schnellen Weg die Dokumentation und mögliche Beispiele zu einem Befehl zu durchsuchen.

Befehlsliste anzeigen und nutzen

Um einen beliebigen Befehl direkt eingeben zu können muss die Tastenkombination "Strg + Leertaste" innerhalb eines Skripts gedrückt werden. Die Liste beinhaltet dann alle IP-Symcon-Funktionen. Auch hier kann die Auswahl eingeschränkt werden indem die ersten Buchstaben eines Befehls eingegeben werden. Z.B. zeigt die Eingabe "'f' + 's' + '2' + '0'" alle FS20 Befehle. Der gewünschte Befehl kann dann per Doppelklick oder per Pfeiltasten + Eingabe-Taste ausgewählt werden.

Beispiel

Systemvariablen in Skripten

Eine komplette Auflistung kann unter Systemvariablen gefunden werden.

Tipps & Tricks

Eine Auflistung aller Tastenkombinationen.

English website available
Zum Warenkorb
Haben Sie noch Fragen?