Dokumentation
IPS_GetStatusVariableID
int IPS_GetStatusVariableID (int $InstanzID, string $VariableIdent)
Parameterliste
InstanzID | ID der Instanz |
VariableIdent | Status Variable Identifikator. Eine Auflistung kann über IPS_GetStatusVariableIdents abgerufen werden. |
Rückgabewert
VariablenID der Variable, die der Status Variable zugeordnet ist
Beschreibung
Die Dokumentation dieser Funktion ist nur noch aus Kompatibilitätsgründen vorhanden und sollte ab IP-Symcon 2.5 nicht mehr verwendet werden. Diese Funktion wird ab Version 2.5 nur noch emuliert und sollte durch die entsprechenden Ersatzfunktionen ausgetauscht werden. Eine Ersatzfunktion befindet sich im Beispiel (siehe unten).
Die Funktion gibt die VariablenID der Variable zurück, die mit der Status Variable der Instanz InstanzID und dem Status Variablen Identifikator VariableIdent verknüpft ist.
Beispiel
//Zustand von z.B. einem FS20 Gerät darstellen ohne die ID der "Status" Variable zu kennen
echo GetValue(IPS_GetStatusVariableID(12345, "StatusVariable"));
// ab Version 2.6 Ersatzfunktion
$InstanceID = "StatusVariable";
$VariableIdent = 12345;
$migrateIdents = Array(
"F05_StatusVar" => "Status",
"F10_TemperatureVar" => "Temperature",
"F12_Var0" => "Status0",
"F12_Var1" => "Status1",
"F1D_CounterVar1" => "Counter1",
"F1D_CounterVar2" => "Counter2",
"F20_Var0" => "Port0",
"F20_Var1" => "Port1",
"F20_Var2" => "Port2",
"F20_Var3" => "Port3",
"F26_TemperatureVar" => "Temperature",
"F26_VDDVar" => "VDD",
"F26_VADVar" => "VAD",
"F26_XSENSVar" => "XSENS",
"F28_TemperatureVar" => "Temperature",
"F29_Var0" => "Status0",
"F29_LatchVar0" => "Latch0",
"F29_Var1" => "Status1",
"F29_LatchVar1" => "Latch1",
"F29_Var2" => "Status2",
"F29_LatchVar2" => "Latch2",
"F29_Var3" => "Status3",
"F29_LatchVar3" => "Latch3",
"F29_Var4" => "Status4",
"F29_LatchVar4" => "Latch4",
"F29_Var5" => "Status5",
"F29_LatchVar5" => "Latch5",
"F29_Var6" => "Status6",
"F29_LatchVar6" => "Latch6",
"F29_Var7" => "Status7",
"F29_LatchVar7" => "Latch7",
"F2C_PositionVar" => "Position",
"F3A_Var0" => "Status0",
"F3A_Var1" => "Status1"
);
if(isset($migrateIdents[$VariableIdent]))
{
$VariableIdent = $migrateIdents[$VariableIdent];
}
$result = IPS_GetObjectIDByIdent($VariableIdent, $InstanceID);
echo $result;