# Kompatibilitätsfunktionen

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/

Kompatibilitätsfunktionen sind die Funktionen, welche mittlerweile nicht mehr verwendet werden sollen und standardmässig deaktiviert sind. Diese wurden aufgrund von Performance abgeschafft oder durch verbesserte Ersatzfunktionen abgelöst. Aus Kompatibilitätsgründen zu alten IP-Symcon Installationen sind diese aber bei Bedarf über den [Spezialschalter](special-switches.md) "Kompatibilitätsfunktionen" aktivierbar. Dies benötigt aber viele Ressourcen und es wird stark davon abgeraten.

## IPS_GetInstanceChildrenIDs

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getinstancechildrenids/

`array IPS_GetInstanceChildrenIDs(int $InstanzID)`

liefert die InstanzIDs der untergeordneten Instanzen (veraltet)

**Parameter**

- `$InstanzID` (int): ID der zu überprüfenden Instanz

**Rückgabewert** (array): Ein Array von InstanzIDs der Unterinstanzen

ID der zu überprüfenden Instanz

**Beispiel**

```php
print_r(IPS_GetInstanceChildrenIDs(12345));

// Beispiel um die veraltete Funktion "IPS_GetInstanceChildrenIDs" zu ersetzen.
// Dazu wird IPS_GetInstance genutzt

$InstanceIDs = IPS_GetInstanceList();
foreach($InstanceIDs as $IID)
    if(IPS_GetInstance($IID)['ConnectionID'] == 12345)
        echo $IID . PHP_EOL;
```

## IPS_GetInstanceParentID

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getinstanceparentid/

`int IPS_GetInstanceParentID(int $InstanzID)`

liefert die InstanzID der übergeordneten Instanz (veraltet)

**Parameter**

- `$InstanzID` (int): ID der zu überprüfenden Instanz

**Rückgabewert** (int): ID der übergeordneten Instanz

ID der zu überprüfenden Instanz

**Beispiel**

```php
// Bis Version 2.5
echo IPS_GetInstanceParentID(12345);

// Ab Version 2.6
echo IPS_GetInstance(12345)['ConnectionID'];
```

## IPS_GetScriptID

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getscriptid/

`int IPS_GetScriptID(string $SkriptName)`

liefert die ID eines Skripts (veraltet)

**Parameter**

- `$SkriptName` (string): Zu suchender SkriptName

**Rückgabewert** (int): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Zu suchender SkriptName

**Beispiel**

```php
//Fehlermeldung mit @ unterdrücken
$ScriptID = @IPS_GetScriptID("Regenerfassung");
if ($ScriptID === false)
    echo "Skript nicht gefunden!";
else
    echo "Die Skript-ID lautet: ". $ScriptID;
```

## IPS_GetStatusVariable

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getstatusvariable/

`array IPS_GetStatusVariable(int $InstanzID, string $VariableIdent)`

liefert umfassende Informationen zu einer bestimmten Status Variable (veraltet)

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$VariableIdent` (string): Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) abgerufen werden.

**Rückgabewert** (array): Folgende Informationen stehen als __key => value__ Paare zur Verfügung:

| Index                 | Typ     | Beschreibung                                                                                  |
| --------------------- | ------- | --------------------------------------------------------------------------------------------- |
| __VariableID__        | integer | Aktuelle ID der verknüpften IP-Symcon Variable                                                |
| __VariableIdent__     | string  | Status Variablen Identifikator                                                                |
| __VariableName__      | string  | Standard Name der angelegten Variable                                                         |
| __VariablePosition__  | integer | Standard Position der angelegten Variable                                                     |
| __VariableProfile__   | string  | Standard Profilname der angelegten Variable                                                   |
| __VariableType__      | integer | Kompatibler Variablentyp (Siehe [IPS_GetVariable](../functions/management-variables.md))        |
| __VariableHasAction__ | boolean | Gibt an, ob intern eine Aktion definiert ist, die mit dieser Status Variable verknüpft wurde. |
| __VariableUseAction__ | boolean | Gibt an, wie die vorhandene Aktion in der Visualisierung benutzt werden soll.                 |

Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) abgerufen werden.

**Beispiel**

```php
// bis Version 2.5
if(IPS_StatusVariableExists(12345, "StatusVariable"))
{
    print_r(IPS_GetStatusVariable(12345, "StatusVariable"));
}

// ab Version 2.6 Ersatzfunktion
$VariableIdent = "Statusvariable";
$InstanceID = 12345;

$id = IPS_GetObjectIDByIdent($VariableIdent, $InstanceID);
$v = IPS_GetVariable($id);
$result = Array(
    "VariableID" => $id,
    "VariableIdent" => $VariableIdent,
    "VariableName" => "N/A",
    "VariablePosition" => 0,
    "VariableProfile" => $v['VariableProfile'],
    "VariableType" => $v['VariableType'],
    "VariableHasAction" => ($v['VariableAction'] > 0),
    "VariableUseAction" => ($v['VariableAction'] > 0)
);
print_r($result);
```

## IPS_GetStatusVariableID

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getstatusvariableid/

`int IPS_GetStatusVariableID(int $InstanzID, string $VariableIdent)`

liefert alle Status Variablen zu einer bestimmten Instanz (veraltet)

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$VariableIdent` (string): Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) abgerufen werden.

**Rückgabewert** (int): VariablenID der Variable, die der Status Variable zugeordnet ist

Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) abgerufen werden.

**Beispiel**

```php
//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;
```

## IPS_GetStatusVariableIdents

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getstatusvariableidents/

`array IPS_GetStatusVariableIdents(int $InstanzID)`

liefert die VariablenIdents einer Status Variable (veraltet)

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (array): Ein Array von Strings, die die Status Variable Indentifikatoren der Instanz angeben

ID der Instanz

**Beispiel**

```php
print_r(IPS_GetStatusVariableIdents(12345));

// ab Version 2.6 Ersatzfunktion
$InstanceID = 12345

$r = Array();
$cids = IPS_GetChildrenIDs($InstanceID);
foreach($cids as $cid) {
    $o = IPS_GetObject($cid);
    if($o['ObjectIdent'] != "") {
        $r[] = $o['ObjectIdent'];
    }
}
$result = $r;
print_r($result);
```

## IPS_GetUptime

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getuptime/

`int IPS_GetUptime()`

liefert den Zeitpunkt, an dem IP-Symcon gestartet wurde (veraltet)

**Rückgabewert** (int): Zeitpunkt, an dem IP-Symcon gestartet wurde

Die Funktion liefert Datum und Uhrzeit des Startzeitpunkts von IP-Symcon als Unix Timestamp.

> **Achtung:** Diese Funktion ist nur bis Version 3.4 implementiert. Ab Version 4.0 wird diese durch [IPS_GetKernelStartTime](../functions/program-information.md) ersetzt.

**Beispiel**

```php
// liefert z.B. 1204675012
echo IPS_GetUptime();
// liefert z.B. "2008.03.04 23:56:52"
echo date("Y.m.d H:i:s", IPS_GetUptime());
```

## IPS_GetVariableID

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-getvariableid/

`int IPS_GetVariableID(string $VariablenName)`

liefert die ID einer Variablen (veraltet)

**Parameter**

- `$VariablenName` (string): zu suchender VariablenName

**Rückgabewert** (int): ID der gefundenen Variable, sonst __FALSE__ und ein __Warning__

zu suchender VariablenName

**Beispiel**

```php
//Fehlermeldung mit @ unterdrücken
$VarID = @IPS_GetVariableID("Regenmenge");
if ($VarID === false)
    echo "Variable nicht gefunden!";
else
    echo "Die Variablen-ID lautet: ". $VarID;
```

## IPS_HasInstanceChildren

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-hasinstancechildren/

`bool IPS_HasInstanceChildren(bool $InstanzID)`

prüft, ob die Instanz mit untergeordneten Instanzen verbunden ist (veraltet)

**Parameter**

- `$InstanzID` (bool): ID der zu überprüfenden Instanz

**Rückgabewert** (bool): Der Rückgabewert ist __TRUE__, wenn der Instanz eine oder mehrere Instanzen untergeordnet sind. Sonst, __FALSE__.

ID der zu überprüfenden Instanz

**Beispiel**

```php
if(IPS_HasInstanceParent(12345))
{
    echo "Hat eine hat untergeordnete Instanzen";
}
```

## IPS_HasInstanceParent

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-hasinstanceparent/

`bool IPS_HasInstanceParent(int $InstanzID)`

prüft, ob die Instanz mit einer übergeordneten Instanz verbunden ist (veraltet)

**Parameter**

- `$InstanzID` (int): ID der zu überprüfenden Instanz

**Rückgabewert** (bool): Der Rückgabewert ist __TRUE__, wenn die Instanz eine übergeordnete Instanz besitzt. Sonst, __FALSE__.

ID der zu überprüfenden Instanz

**Beispiel**

```php
// Bis Version 2.5
if(IPS_HasInstanceParent(12345))
{
    echo "Hat eine übergeordnete Instanz";
}

// Ab Version 2.6
if(IPS_GetInstance(12345)['ConnectionID'] > 0)
{
     echo "Hat eine übergeordnete Instanz";
}
```

## IPS_IsPersistent

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-ispersistent/

`bool IPS_IsPersistent(int $ObjektID)`

prüft, ob Objekt persistent ist (veraltet)

**Parameter**

- `$ObjektID` (int): zu prüfende ObjektID

**Rückgabewert** (bool): __TRUE__, wenn das Objekt gespeichert wird, sonst __FALSE__

zu prüfende ObjektID

**Beispiel**

```php
if (IPS_IsPersistent(34881))
    echo "Das Objekt wird beim Beenden abgespeichert!";
```

## IPS_SetLinkChildID

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-setlinkchildid/

`bool IPS_SetLinkChildID(int $LinkID, int $VerknüpftesObjekt)`

_Benötigt Symcon >= 2.1_

setzt die Verknüpfung für den Link (veraltet)

**Parameter**

- `$LinkID` (int): ID des zu verändernden Links
- `$VerknüpftesObjekt` (int): ID des zu verknüpfenden Objekts

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID des zu verknüpfenden Objekts

**Beispiel**

```php
IPS_SetLinkChildID($LinkID, 12345); //Auf Objekt 12345 verweisen
```

## IPS_SetStatusVariableUseAction

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-setstatusvariableuseaction/

`bool IPS_SetStatusVariableUseAction(int $InstanzID, string $VariableIdent, bool $BenutzteAktion)`

setzt, ob die Standardaktion einer Status Variable genutzt werden soll (veraltet)

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$VariableIdent` (string): Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) abgerufen werden.
- `$BenutzteAktion` (bool): Gibt an, ob die Aktion in der Visualisierung genutzt werden soll.

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Gibt an, ob die Aktion in der Visualisierung genutzt werden soll.

**Beispiel**

```php
if(IPS_StatusVariableExists(12345, "StatusVariable"))
{
    IPS_SetStatusVariableUseAction(12345, "StatusVariable", false); //Per WebFront nicht mehr schaltbar machen
}

// ab Version 2.6 Ersatzfunktion
$VariableIdent = "Statusvariable";
$InstanceID = 12345;
$UseAction = false;

$id = IPS_GetObjectIDByIdent($VariableIdent, $InstanceID);

if ($UseAction) {
    IPS_SetVariableCustomAction($id, 0); // Standardaktion aktivieren
} else {
    IPS_SetVariableCustomAction($id, 1); // Standardaktion deaktivieren
}
```

## IPS_StatusVariableExists

Quelle: https://www.symcon.de/de/service/dokumentation/entwicklerbereich/kompatibilitaetsfunktionen/ips-statusvariableexists/

`bool IPS_StatusVariableExists(int $InstanzID, string $VariableIdent)`

prüft, ob eine bestimmte Status Variable existiert (veraltet)

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$VariableIdent` (string): Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) geholt werden.

**Rückgabewert** (bool): Der Rückgabewert ist __TRUE__, wenn die Status Variable vorhanden ist, sonst __FALSE__

Status Variable Identifikator. Eine Auflistung kann über [IPS_GetStatusVariableIdents](compatibility-functions.md) geholt werden.

**Beispiel**

```php
if(IPS_StatusVariableExists(12345, "StatusVariable"))
{
    echo IPS_GetStatusVariableID(12345, "StatusVariable");
}

// ab Version 2.6 Ersatzfunktion
$InstanceID = "StatusVariable";
$VariableIdent = 12345;

$result = !(@IPS_GetObjectIDByIdent($VariableIdent, $InstanceID) === false);
echo $result;
```