IPS_GetInstance
array IPS_GetInstance (int $InstanzID)
Parameterliste
| InstanzID |
Die zu zeigende InstanzID |
Rückgabewert
Folgende Informationen stehen als key => value Paare zur Verfügung:
| Index |
Typ |
Beschreibung |
| InstanceID |
integer |
InstanzID |
| ConnectionID |
integer |
ID der verbundenen Instanz |
| InstanceStatus |
integer |
Statuscode der Instanz |
| InstanceSupportsSearching |
boolean |
Unterstützt die Instanz den Suchmodus |
| InstanceIsSearching |
boolean |
Die Instanz befindet sich gerade im Suchmodus |
| InstanceVisualizationType |
integer |
Art der Visualisierung der Instanz| 0 | INSTANCE_VISUALIZATION_TYPE_NONE | Keine | | 1 | INSTANCE_VISUALIZATION_TYPE_HTML | HTML | | 2 | INSTANCE_VISUALIZATION_TYPE_HTML_FULLSCREEN | HTML Vollbild | | 3 | INSTANCE_VISUALIZATION_TYPE_FORM | Formular |
|
| InstanceChanged |
integer |
Unix Zeitstempel zu dem das letzte mal die Konfiguration übernommen wurde |
| ModuleInfo |
array |
Modulinformationen |
Status der Instanz
| Code |
Konstante |
Status |
| 101 |
IS_CREATING |
Instanz wird erstellt |
| 102 |
IS_ACTIVE |
Instanz ist aktiv |
| 103 |
IS_DELETING |
Instanz wird gelöscht |
| 104 |
IS_INACTIVE |
Instanz ist inaktiv |
| 105 |
IS_NOTCREATED |
Instanz wurde nicht erstellt |
| 106 |
IS_STANDBY |
Instanz ist im Standby |
| >=200 |
IS_EBASE |
Instanz ist fehlerhaft |
Modulinformationen
| Index |
Typ |
Beschreibung |
| ModuleID |
string |
ModulID zur Instanz |
| ModuleName |
string |
ModulName der Instanz |
| ModuleType |
integer |
ModulTyp der Instanz| 0 | MODULETYPE_CORE | Kern | | 1 | MODULETYPE_IO | I/O | | 2 | MODULETYPE_SPLITTER | Splitter | | 3 | MODULETYPE_DEVICE | Gerät | | 4 | MODULETYPE_CONFIGURATOR | Konfigurator | | 5 | MODULETYPE_DISCOVERY | Discovery | | 6 | MODULETYPE_VISUALIZATION | Visualisierung |
|
Beschreibung
Die Funktion liefert ein Array mit Informationen über die Instanz mit der ID InstanzID. Sollte die Instanz nicht vorhanden sein, wird eine Warnung generiert.
Beispiel
print_r(IPS_GetInstance(19668));
/* liefert z.B.:
Array
(
[InstanceID] => 19668
[ConnectionID] => 29416
[InstanceStatus] => 102
[InstanceSupportsSearching] =>
[InstanceIsSearching] =>
[InstanceVisualizationType] => 0
[InstanceChanged] => 1735686000
[ModuleInfo] => Array
(
[ModuleID] => {48FCFDC1-11A5-4309-BB0B-A0DB8042A969}
[ModuleName] => FS20
[ModuleType] => 3
)
)
*/