Migration - Smarthome-Components

Migration - Smarthome-Components Migration - Smarthome-Components

smarthome.components.de
von smarthome.components.de Mehr von diesem Publisher
06.01.2013 Aufrufe

IPS_GetMediaID integer IPS_GetMediaID ( string $MedienName ) Parameterliste MedienName Zu suchender Medienname Rückgabewerte ID des gefundenen Medienobjekts, sonst 0 Beschreibung Der Befehl versucht, die ID des Medienobjekts mit dem Namen MedienName zu ermitteln. Es wird die ID des ersten gefundenen Medienobjekts verwendet, dessen Name mit MedienName übereinstimmt. Falls ein solches Medienobjekt gefunden wurde, wird dessen ID zurückgemeldet, andernfalls 0 (Null). Eine sicherere Methode, die ID zu bestimmen, bietet der Befehl IPS_GetScriptIDByName. Vorsicht: Da Namen in IP-Symcon beliebig vergeben werden können, und damit nicht eindeutig sind, kann der Befehl eine falsche ID zurückmelden. Beispiel $MediaID = IPS_GetMediaID("Regenmenge"); if ($MediaID == 0) else echo "Medienobjekt nicht gefunden!"; echo "Die Medienobjekt-ID lautet: ". $MediaID;

IPS_CreateLink integer IPS_CreateLink ( ) Rückgabewerte ID des neu erstellten Links Beschreibung Der Befehl legt eine neuen Link an. Er benötigt keine Parameter. Nach Ausführung des Befehls erscheint im Kategorienbaum von IP-Symcon ein neues Objekt mit der Bezeichnung z.B. ”Unnamed Object (ID: 48490)”. Mit Hilfe des Befehls IPS_SetName kann dem Objekt (hier der Link) ein aussagefähiger Name gegeben werden. Der Name ist jedoch für die Identifikation irrelevant. Hierfür ist immer die ID zuständig. Weiterhin sollte der Link mit einem anderen Objekt verknüpft werden. Dies kann über die Funktion IPS_SetLinkTargetID gemacht werden. Die Funktion liefert eine ID, mit deren Hilfe der erzeugte Link eindeutig identifiziert werden kann. Beispiel //Anlegen einer neuen Kategorie mit dem Namen "Regenerfassung" $LinkID = IPS_CreateLink(); //Link anlegen IPS_SetName($LinkID, "Regenerfassung"); //Link benennen IPS_SetLinkChildID($LinkID, 12345); //Link verknüpfen Benötigt: IP-Symcon >= 2.1

IPS_GetMediaID<br />

integer IPS_GetMediaID ( string $MedienName )<br />

Parameterliste<br />

MedienName Zu suchender Medienname<br />

Rückgabewerte<br />

ID des gefundenen Medienobjekts, sonst 0<br />

Beschreibung<br />

Der Befehl versucht, die ID des Medienobjekts mit dem Namen MedienName zu ermitteln. Es wird die ID des ersten<br />

gefundenen Medienobjekts verwendet, dessen Name mit MedienName übereinstimmt. Falls ein solches Medienobjekt<br />

gefunden wurde, wird dessen ID zurückgemeldet, andernfalls 0 (Null).<br />

Eine sicherere Methode, die ID zu bestimmen, bietet der Befehl IPS_GetScriptIDByName.<br />

Vorsicht: Da Namen in IP-Symcon beliebig vergeben werden können, und damit nicht eindeutig sind, kann der<br />

Befehl eine falsche ID zurückmelden.<br />

Beispiel<br />

$MediaID = IPS_GetMediaID("Regenmenge");<br />

if ($MediaID == 0)<br />

else<br />

echo "Medienobjekt nicht gefunden!";<br />

echo "Die Medienobjekt-ID lautet: ". $MediaID;

Hurra! Ihre Datei wurde hochgeladen und ist bereit für die Veröffentlichung.

Erfolgreich gespeichert!

Leider ist etwas schief gelaufen!