Migration - Smarthome-Components

IPS_GetCategoryIDByName
integer IPS_GetCategoryIDByName ( string $KategorieName , integer $ParentID )
Parameterliste
KategorieName Zu suchender KategorieName
ParentID Objekt, in deren Unterobjekten gesucht werden soll
Rückgabewerte
ID der gefundenen Kategorie, sonst FALSE
Beschreibung
Der Befehl versucht die ID der Kategorie mit dem Namen KategorienName, deren übergeordnetes Objekt die ID
ParentID besitzt, zu ermitteln. Es wird die ID der ersten gefundenen Kategorie verwendet, deren Name mit
KategorienName übereinstimmt. Falls eine solche Kategorie gefunden wurde, wird deren ID zurückgemeldet,
andernfalls FALSE.
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
$CatID = @IPS_GetCategoryIDByName("Regenerfassung", $ParentID);
if ($CatID === false)
else
echo "Kategorie nicht gefunden!";
echo "Die Kategorien-ID lautet: ". $CatID;