# Objektverwaltung

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

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/

## IPS_GetChildrenIDs

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getchildrenids/

`array IPS_GetChildrenIDs(int $ObjektID)`

liefert eine Aufstellung aller untergeordneten Objekte

**Parameter**

- `$ObjektID` (int): ID für die die Unterobjekte zurückgegeben werden sollen

**Rückgabewert** (array): Ein Array von Integer-Werten aller IDs der Unterobjekte von Objekt __ObjektID__

ID für die die Unterobjekte zurückgegeben werden sollen

**Beispiel**

```php
print_r(IPS_GetChildrenIDs(32102));

/* liefert z.B.:
Array
(
    [0] => 11650
    [1] => 25578
    [2] => 30202
    usw. ...
)
*/
```

## IPS_GetLocation

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getlocation/

`string IPS_GetLocation(int $ObjektID)`

liefert den kompletten Pfad des Objekts

**Parameter**

- `$ObjektID` (int): ID für die der Pfad/Namen erstellt werden soll

**Rückgabewert** (string): Pfad/Name des Objekts im logischen Objektbaum

ID für die der Pfad/Namen erstellt werden soll

**Beispiel**

```php
echo IPS_GetLocation(47359);
//gibt z.B. zurück: "FHT8b\LowBattery"
```

## IPS_GetName

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getname/

`string IPS_GetName(int $ObjektID)`

liefert den Namen des Objekts

**Parameter**

- `$ObjektID` (int): ID für die der Namen zurückgegeben werden soll

**Rückgabewert** (string): Name des Objekts im logischen Objektbaum

ID für die der Namen zurückgegeben werden soll

**Beispiel**

```php
echo IPS_GetName(47359);
// Gibt z.B. zurück: "Meine Tischlampe"

// Sonderfall bei unbenannten Ereignissen (ab Version 4.0)
echo IPS_GetName(48864 /*[TestSkript\Unbenanntes Objekt (ID: 48864)]*/);
// Gibt z.B. zurück: "Bei Variablenänderung der Variable "Testordner\IRTrans USB/LAN/WLAN\Fernbedienung"
```

## IPS_GetObject

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getobject/

`array IPS_GetObject(int $ObjektID)`

liefert umfassende Informationen über ein Objekt

**Parameter**

- `$ObjektID` (int): Die zu zeigende ObjektID

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

| Index                                      | Typ     | Beschreibung                                                                                                                                                             |
| ------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| __ChildrenIDs__                            | array   | Untergeordnete ObjektIDs. Siehe: [IPS_GetChildrenIDs](management-objects.md)                                                                                |
| __HasChildren__                            | boolean | TRUE, wenn das Objekt Unterobjekte hat. Siehe: [IPS_HasChildren](management-objects.md)                                                                     |
| __ObjectID__                               | integer | ObjektID                                                                                                                                                                 |
| __ObjectIcon__                             | string  | Dateiname ohne Erweiterung des Icons. Siehe: [IPS_SetIcon](management-objects.md)                                                                           |
| __ObjectIdent__                            | string  | Identifikator des Objekts. Siehe [IPS_SetIdent](management-objects.md)                                                                                      |
| __ObjectInfo__                             | string  | Beschreibung, die der Benutzer angeben kann. Siehe: [IPS_SetInfo](management-objects.md)                                                                    |
| __ObjectIsDisabled__ (ab Symcon 4.0)       | boolean | TRUE, wenn das Objekt inaktiv gesetzt ist. Siehe [IPS_SetDisabled](management-objects.md)                                                                   |
| __ObjectIsHidden__                         | boolean | TRUE, wenn das Objekt in der Visualisierung versteckt sein soll. Siehe [IPS_SetHidden](management-objects.md)                                               |
| __ObjectIsHiddenMaximize__ (ab Symcon 9.1) | boolean | TRUE, wenn der Maximieren-Button des Objekts in der Visualisierung versteckt sein soll. Siehe [IPS_SetHiddenMaximize](management-objects.md)                |
| __ObjectIsHiddenTitle__ (ab Symcon 9.1)    | boolean | TRUE, wenn der Titel des Objekts in der Visualisierung versteckt sein soll. Siehe [IPS_SetHiddenTitle](management-objects.md)                               |
| __ObjectIsReadOnly__                       | boolean | TRUE, wenn das Objekt schreibgeschützt ist. (Wird zur Zeit nur für Status Variablen benutzt)                                                                             |
| __ObjectName__                             | string  | Name des Objekts. Siehe: [IPS_SetName](management-objects.md)                                                                                               |
| __ObjectPosition__                         | integer | Position, die das Objekt in der Visualisierung haben soll. Dieser Wert muss nicht unbedingt eindeutig sein. Siehe: [IPS_SetPosition](management-objects.md) |
| __ObjectType__                             | integer | Objekt-Typ (0: Kategorie, 1: Instanz, 2: Variable, 3: Skript, 4: Ereignis, 5: Media, 6: Link)                                                                            |
| __ObjectSummary__                          | string  | Kurzbeschreibung eines Objektes, welches vom Modul zur Laufzeit bei Bedarf generiert wird.                                                                               |
| __ParentID__                               | integer | Übergeordnetes Objekt. 0 = Kein übergeordnetes Objekt. Siehe: [IPS_SetParent](management-objects.md)                                                        |

Die zu zeigende ObjektID

**Beispiel**

```php
print_r(IPS_GetObject(19668));
/* liefert z.B.:
Array
(
    [ParentID] => 26691
    [ObjectID] => 43502
    [ObjectType] => 1
    [ObjectIdent] =>
    [ObjectName] => MX Gerät (ID: 1)
    [ObjectInfo] => Dies ist eine Instanz von einem Gerät
    [ObjectIcon] => IPS
    [ObjectSummary] =>
    [ObjectPosition] => 1
    [ObjectIsReadOnly] =>
    [ObjectIsHidden] =>
    [ObjectIsHiddenTitle] =>
    [ObjectIsHiddenMaximize] =>
    [ObjectIsDisabled] =>
    [ObjectIsLocked] =>
    [HasChildren] => 1
    [ChildrenIDs] => Array
    (
        [0] => 43430
        [1] => 55892
        [2] => 36597
        [3] => 18993
        [4] => 34524
        [5] => 12269
        [6] => 44450
        [7] => 23394
        [8] => 11693
        [9] => 13654
    )
)
*/
```

## IPS_GetObjectIDByIdent

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getobjectidbyident/

`int IPS_GetObjectIDByIdent(string $ObjektIdent, int $ÜbergeordneteID)`

_Benötigt Symcon >= 2.5_

liefert die ID eines Objekts anhand des Identifikators

**Parameter**

- `$ObjektIdent` (string): Zu suchender ObjektIdentifikator
- `$ÜbergeordneteID` (int): Objekt, in dessen direkten Unterobjekten gesucht werden soll

**Rückgabewert** (int): ID des gefundenen Objekts, sonst FALSE

Objekt, in dessen direkten Unterobjekten gesucht werden soll

**Beispiel**

```php
//Diese Funktion kann als Ersatz für IPS_StatusVariableExists verwendet werden.
//Beispiel für IPS_StatusVariableExists($id, "StatusVariable");
echo !(@IPS_GetObjectIDByIdent("StatusVariable", $id) === false);

//Ferner kann diese Funktion auch ein Ersatz für IPS_GetStatusVariableID darstellen.
//Beispiel für IPS_GetStatusVariableID($id, "StatusVariable");
echo IPS_GetObjectIDByIdent("StatusVariable", $id);

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

// Array ab 4.0
$sv = Array(
    "VariableID" => $id,
    "VariableIdent" => $VariableIdent,
    "VariableName" => "N/A",
    "VariablePosition" => 0,
    "VariableProfile" => $v['VariableProfile'],
    "VariableType" => $v['VariableType'],
    "VariableHasAction" => ($v['VariableAction'] > 0),
    "VariableUseAction" => ($v['VariableAction'] > 0)
);

// Array bis 3.4
$sv = Array(
    "VariableID" => $id,
    "VariableIdent" => $VariableIdent,
    "VariableName" => "N/A",
    "VariablePosition" => 0,
    "VariableProfile" => $v['VariableProfile'],
    "VariableType" => $v['VariableValue']['ValueType'],
    "VariableHasAction" => ($v['VariableAction'] > 0),
    "VariableUseAction" => ($v['VariableAction'] > 0)
);
```

## IPS_GetObjectIDByName

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getobjectidbyname/

`int IPS_GetObjectIDByName(string $ObjektName, int $ÜbergeordneteID)`

liefert die ID eines Objekts anhand des Namens

**Parameter**

- `$ObjektName` (string): Zu suchender ObjektName
- `$ÜbergeordneteID` (int): Objekt, in dessen direkten Unterobjekten gesucht werden soll

**Rückgabewert** (int): ID des gefundenen Objekts, sonst FALSE

Objekt, in dessen direkten Unterobjekten gesucht werden soll

**Beispiel**

```php
$ObjektID = @IPS_GetObjectIDByName("Regenerfassung", $ParentID);
if ($ObjektID === false)
    echo "Objekt nicht gefunden!";
else
    echo "Die Objekt-ID lautet: ". $ObjektID;
```

## IPS_GetObjectList

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getobjectlist/

`array IPS_GetObjectList()`

liefert eine Aufstellung aller existierenden Objekte

**Rückgabewert** (array): Ein Array von Integer-Werten aller IDs in IP-Symcon

Die Funktion ermittelt die IDs aller in IP-Symcon registrierten Objekte. Die IDs werden in einem Array aufgelistet.

**Beispiel**

```php
print_r(IPS_GetObjectList());

/* liefert z.B.:
Array
(
    [0] => 0
    [1] => 10573
    [2] => 11363
    [3] => 11650
    [4] => 14114
    usw. ...
)
*/
```

## IPS_GetParent

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-getparent/

`int IPS_GetParent(int $ObjektID)`

liefert die ParentID des Objekts

**Parameter**

- `$ObjektID` (int): ID für die die ParentID zurückgegeben werden soll

**Rückgabewert** (int): ParentID des Objekts im logischen Objektbaum

ID für die die ParentID zurückgegeben werden soll

**Beispiel**

```php
echo IPS_GetParent(47359);
//gibt z.B. zurück: 0 für die Hauptkategorie
```

## IPS_HasChildren

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-haschildren/

`bool IPS_HasChildren(int $ObjektID)`

prüft, ob Objekt untergeordnete Objekte hat

**Parameter**

- `$ObjektID` (int): ID des zu prüfenden Objekts

**Rückgabewert** (bool): __TRUE__, falls das Objekte Unterobjekte hat, andernfalls __FALSE__

ID des zu prüfenden Objekts

**Beispiel**

```php
if (IPS_HasChildren(0))
    echo "Das Root Objekt hat untergeordnete Objekte!";
```

## IPS_IsChild

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-ischild/

`bool IPS_IsChild(int $ObjektID, int $ParentID, bool $Rekursiv)`

prüft, ob Objekt einem anderen Objekt untergeordnet ist

**Parameter**

- `$ObjektID` (int): ID des zu prüfenden Objekts
- `$ParentID` (int): ID des vermeintlichen Elternobjekts
- `$Rekursiv` (bool): False, wenn nur eine Ebene geprüft werden soll, sonst True

**Rückgabewert** (bool): __TRUE__, wenn ObjektID Kind von ParentID ist, sonst __FALSE__

False, wenn nur eine Ebene geprüft werden soll, sonst True

**Beispiel**

```php
if (IPS_IsChild(0, 12345, true))
    echo "Das Objekt 12345 ist dem Root Objekt untergeordnet!";
```

## IPS_ObjectExists

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-objectexists/

`bool IPS_ObjectExists(int $ObjektID)`

prüft, ob ein bestimmtes Objekt existiert

**Parameter**

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

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

Die zu prüfende ObjektID

**Beispiel**

```php
if (IPS_ObjectExists(34881))
    echo "Ein Objekt mit dieser ID existiert!";
```

## IPS_SetDisabled

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-setdisabled/

`bool IPS_SetDisabled(int $ObjektID, bool $Inaktiv)`

_Benötigt Symcon >= 4.0_

Setzt ein Objekt für das WebFront inaktiv

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Inaktiv` (bool): TRUE wenn das Objekt inaktiv gesetzt werden soll; FALSE wenn es aktiv gesetzt werden soll.

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

TRUE wenn das Objekt inaktiv gesetzt werden soll; FALSE wenn es aktiv gesetzt werden soll.

**Beispiel**

```php
// Das Objekt wird inaktiv gesetzt.
IPS_SetDisabled(47381, true);
```

## IPS_SetHidden

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-sethidden/

`bool IPS_SetHidden(int $ObjektID, bool $Versteckt)`

_Benötigt Symcon >= 2.1_

setzt die Sichtbarkeit eines beliebigen Objekts

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Versteckt` (bool): TRUE, wenn unsichtbar

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

TRUE, wenn unsichtbar

**Beispiel**

```php
IPS_SetHidden(47381, true); //Objekt verstecken
```

## IPS_SetHiddenMaximize

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-sethiddenmaximize/

`bool IPS_SetHiddenMaximize(int $ObjektID, bool $Versteckt)`

_Benötigt Symcon >= 9.1_

setzt die Sichtbarkeit des Maximieren-Buttons eines beliebigen Objekts

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Versteckt` (bool): TRUE, wenn Maximieren-Button unsichtbar

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

TRUE, wenn Maximieren-Button unsichtbar

**Beispiel**

```php
IPS_SetHiddenMaximize(47381, true); //Maximieren-Button verstecken
```

## IPS_SetHiddenTitle

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-sethiddentitle/

`bool IPS_SetHiddenTitle(int $ObjektID, bool $Versteckt)`

_Benötigt Symcon >= 9.1_

setzt die Sichtbarkeit des Titels eines beliebigen Objekts

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Versteckt` (bool): TRUE, wenn Titel unsichtbar

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

TRUE, wenn Titel unsichtbar

**Beispiel**

```php
IPS_SetHiddenTitle(47381, true); //Titel verstecken
```

## IPS_SetIcon

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-seticon/

`bool IPS_SetIcon(int $ObjektID, string $Icon)`

_Benötigt Symcon >= 2.1_

ordnet einem beliebigen Objekt ein Icon zu

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Icon` (string): Dateiname des Icons ohne Pfad/Erweiterung

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

Dateiname des Icons ohne Pfad/Erweiterung

**Beispiel**

```php
IPS_SetIcon(47381, "Tree");
```

## IPS_SetIdent

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-setident/

`bool IPS_SetIdent(int $ObjektID, string $Ident)`

_Benötigt Symcon >= 2.5_

ordnet einem beliebigen Objekt einen Identifikator zu

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Ident` (string): Neuer Identifikator für das Objekt

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

Neuer Identifikator für das Objekt

**Beispiel**

```php
IPS_SetIdent(47381, "TEMPERATURE_3");
```

## IPS_SetInfo

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-setinfo/

`bool IPS_SetInfo(int $ObjektID, string $Info)`

ordnet einem beliebigen Objekt erweiterte Informationen zu

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Info` (string): Neuer Beschreibungstext für das Objekt

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

Neuer Beschreibungstext für das Objekt

**Beispiel**

```php
IPS_SetInfo(47381, "USB Soundkarte - Port A, Keller - Grünes Kabel");
```

## IPS_SetName

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-setname/

`bool IPS_SetName(int $ObjektID, string $Name)`

ordnet einem beliebigen Objekt einen Namen zu

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Name` (string): Neuer Name für das Objekt

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

Neuer Name für das Objekt

**Beispiel**

```php
// Setzt den angezeigten Namen des Objekts mit der ID 12345 auf "Sicherheitsvorkehrungen"
IPS_SetName(12345, "Sicherheitsvorkehrungen");
```

## IPS_SetParent

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-setparent/

`bool IPS_SetParent(int $ObjektID, int $ÜbergeordneteID)`

verschiebt ein Objekt im logischen Strukturbaum

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$ÜbergeordneteID` (int): ID des neuen übergeordneten Objekts im logischen Objektbaum

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

ID des neuen übergeordneten Objekts im logischen Objektbaum

**Beispiel**

```php
IPS_SetParent(47381, 15361);
```

## IPS_SetPosition

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/objektverwaltung/ips-setposition/

`bool IPS_SetPosition(int $ObjektID, int $Position)`

_Benötigt Symcon >= 2.1_

ordnet einem beliebigen Objekt eine Position zu

**Parameter**

- `$ObjektID` (int): ID des zu verändernden Objekts
- `$Position` (int): Positionswert des Objekts

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

Positionswert des Objekts

**Beispiel**

```php
IPS_SetPosition(47381, 5);
```