Migration - Smarthome-Components

IPS_GetScriptIDByName
integer IPS_GetScriptIDByName ( string $SkriptName , integer $ParentID )
Parameterliste
SkriptName zu suchender SkriptName
ParentID Objekt in deren Unterobjekten gesucht werden soll
Rückgabewerte
ID des gefundenen Skripts, sonst FALSE
Beschreibung
Der Befehl versucht die ID des Skripts mit dem Namen SkriptName, dessen übergeordnetes Objekt die ID ParentID
besitzt, zu ermitteln. Es wird die ID des ersten gefundenen Skripts verwendet, dessen Name mit SkriptName
übereinstimmt. Falls ein solches Skript gefunden wurde, wird dessen ID zurückgemeldet, andernfalls FALSE.
Da hier im Gegensatz zu IPS_GetScriptID ein zusätzliches Kriterium (ParentID) bei der Suche verwendet wird, ist die
Wahrscheinlichkeit die richtige ID zu finden erheblich größer. Trotzdem gilt:
Vorsicht: Da Namen in IP-Symcon beliebig vergeben werden können, und damit nicht eindeutig sind, kann der
Befehl eine falsche ID zurückmelden.
Diese Funktion generiert eine Warung, sollte der Name nicht gefunden werden. Benutzen Sie den @ Operator, falls
Sie diese Meldung unterdrücken wollen. Die genau Funktionsweise dieses Operators können Sie dem PHP Handbuch
entnehmen.
Beispiel
$ScriptID = @IPS_GetScriptIDByName("Regenerfassung", $ParentID);
if ($ScriptID === false)
else
echo "Skript nicht gefunden!";
echo "Die Skript-ID lautet: ". $ScriptID;