# Kategorieverwaltung

> 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/kategorieverwaltung/

## IPS_CategoryExists

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/kategorieverwaltung/ips-categoryexists/

`bool IPS_CategoryExists(int $KategorieID)`

prüft, ob eine Kategorie bereits existiert

**Parameter**

- `$KategorieID` (int): ID der zu prüfenden Kategorie

**Rückgabewert** (bool): Falls die KategorieID im System existiert, wird __TRUE__ zurückgemeldet, andernfalls __FALSE__.

ID der zu prüfenden Kategorie

**Beispiel**

```php
if (IPS_CategoryExists(45724))
    echo "Kategorie existiert bereits!";
```

## IPS_CreateCategory

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/kategorieverwaltung/ips-createcategory/

`int IPS_CreateCategory()`

legt eine neue Kategorie an

**Rückgabewert** (int): ID der neu erstellten Kategorie

Die Funktion legt eine neue Kategorie an. Es wird kein Parameter benötigt. Nach Ausführung der Funktion erscheint im Kategorienbaum von IP-Symcon eine neue Kategorie mit der Bezeichnung z.B. ”Unnamed Object (ID: 48490)”. Mit Hilfe der Funktion [IPS_SetName](management-objects.md) kann der Kategorie ein aussagefähiger Name gegeben werden. Der Name sollte nicht für die Identifikation verwendet werden. Hierfür ist die ID zuständig.

Mit der Funktion [IPS_SetParent](management-objects.md) kann die Kategorie einem anderen Objekt untergeordnet werden und stellt so eine Unterkategorie dar.

Die Funktion liefert eine ID, mit deren Hilfe die erzeugte Kategorie eindeutig identifiziert werden kann.

**Beispiel**

```php
// Anlegen einer neuen Kategorie mit dem namen "Regenerfassung"
$CatID = IPS_CreateCategory();       // Kategorie anlegen
IPS_SetName($CatID, "Regenerfassung"); // Kategorie benennen
IPS_SetParent($CatID, 12345); // Kategorie einsortieren unter dem Objekt mit der ID "12345"
```

## IPS_DeleteCategory

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/kategorieverwaltung/ips-deletecategory/

`bool IPS_DeleteCategory(int $KategorieID)`

löscht eine bestehende Kategorie

**Parameter**

- `$KategorieID` (int): ID der zu löschenden Kategorie

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

ID der zu löschenden Kategorie

**Beispiel**

```php
// Löschen der Kategorie 47788
IPS_DeleteCategory(47788);
```

## IPS_GetCategoryIDByName

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/kategorieverwaltung/ips-getcategoryidbyname/

`int IPS_GetCategoryIDByName(string $KategorieName, int $ÜbergeordneteID)`

sucht und liefert die ID einer bestehenden Kategorie über dessen Namen

**Parameter**

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

**Rückgabewert** (int): ID der gefundenen Kategorie, sonst FALSE

Objekt, in deren direkten Unterobjekten gesucht werden soll

**Beispiel**

```php
$KategorieID = @IPS_GetCategoryIDByName("Regenerfassung", $ÜbergeordneteID);
if ($KategorieID === false)
    echo "Kategorie nicht gefunden!";
else
    echo "Die Kategorien-ID lautet: ". $KategorieID;
```

## IPS_GetCategoryList

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/kategorieverwaltung/ips-getcategorylist/

`array IPS_GetCategoryList()`

liefert eine Liste aller existierenden Kategorien

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

Die Funktion ermittelt die IDs aller in IP-Symcon eingerichteten Kategorien. Die IDs werden in einem Array aufgelistet. Falls keine Kategorie existiert, ist das Array leer.

**Beispiel**

```php
$alleKategorien = IPS_GetCategoryList();
print_r($alleKategorien);

/* liefert z.B.:
Array
(
    [0] => 0
    [1] => 37659
    [2] => 18326
    usw. ...
)
*/
```