Dokumentation
RegisterScript
Benötigt: IP-Symcon >= 4.0
variant RegisterScript (string $Ident, string $Name, string $Inhalt, int $Position)
Parameterliste
| Ident | Ident des Skripts |
| Name | Name des Skripts |
| Inhalt | Inhalt, welcher in das Skript eingetragen werden soll. //Autogenerated script" |
| Position | Position im Objektbaum und somit auch in der Visualisierung. |
Rückgabewert
| Klasse | Typ | Beschreibung |
|---|---|---|
| IPSModule | integer | Gibt die ObjektID des erstellten oder bereits vorhandenen Skripts zurück. |
| IPSModuleStrict | boolean | Gibt zurück, ob das Script erstellt wurde. Der Rückgabewert kann genutzt werden, um z.B. initiale Konfigurationen vorzunehmen. |
Beschreibung
Erstellt ein Skript mit dem Ident Ident, Namen Name, Inhalt Inhalt und der Position Postion, sofern der angegebene Ident nicht schon vorhanden ist.
In beiden Fällen wird die ObjektID des erstellten oder bereits vorhanden Skripts zurückgegeben.
Der Inhalt von Inhalt wird jedes mal überschrieben, sodass auch nach Änderungen immer der korrekte Inhalt garantiert werden kann. Für Skripte welche bearbeitet werden sollen, ist es empfohlen ein Konfigurationsformular mit SelectScript-Auswahl zu nutzen
Beispiel
// IPSModuleStrict
$erstellt = $this->RegisterScript("TestSkript", "Mein TestSkript");
if ($erstellt) {
// Dinge tun, wenn Skript frisch erstellt wurde
}
// IPSModule
$skriptID = $this->RegisterScript("TestSkript", "Mein TestSkript");