# Linkverwaltung

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

## IPS_CreateLink

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-createlink/

`int IPS_CreateLink()`

_Benötigt Symcon >= 2.1_

legt einen neuen Link an

**Rückgabewert** (int): ID des neu erstellten Links

Die Funktion legt eine neuen Link an. Er benötigt keine Parameter. Nach Ausführung der Funktion erscheint im Kategorienbaum von IP-Symcon ein neues Objekt mit der Bezeichnung z.B. ”Unnamed Object (ID: 48490)”. Mit Hilfe der Funktion [IPS_SetName](management-objects.md) kann dem Objekt (hier der Link) ein aussagefähiger Name gegeben werden. Der Name ist jedoch für die Identifikation irrelevant. Hierfür ist immer die ID zuständig.
Weiterhin sollte der Link mit einem anderen Objekt verknüpft werden. Dies kann über die Funktion [IPS_SetLinkTargetID](management-links.md) gemacht werden.

Die Funktion liefert eine ID, mit deren Hilfe der erzeugte Link eindeutig identifiziert werden kann.

**Beispiel**

```php
// Anlegen eines neuen Links mit dem Namen "Regenerfassung"
$LinkID = IPS_CreateLink();             // Link anlegen
IPS_SetName($LinkID, "Regenerfassung"); // Link benennen
IPS_SetParent($LinkID, 12345); // Link einsortieren unter dem Objekt mit der ID "12345"
IPS_SetLinkTargetID($LinkID, 54321);    // Link verknüpfen
```

## IPS_DeleteLink

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-deletelink/

`bool IPS_DeleteLink(int $LinkID)`

_Benötigt Symcon >= 2.1_

löscht einen bestehenden Link

**Parameter**

- `$LinkID` (int): ID des zu löschenden Links

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

ID des zu löschenden Links

**Beispiel**

```php
//Löschen des Links 47788
IPS_DeleteLink(47788);
```

## IPS_GetLink

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-getlink/

`array IPS_GetLink(int $LinkID)`

_Benötigt Symcon >= 2.1_

liefert umfassende Informationen über einen Link

**Parameter**

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

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

| Index                     | Typ     | Beschreibung                                                                                                                                                 |
| ------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| __LinkID__                | integer | ObjektID                                                                                                                                                     |
| __LinkChildID__ (bis 3.4) | integer | ID des Objektes mit dem dieser Link verknüpft ist. Siehe [IPS_SetLinkTargetID](management-links.md) (ab 4.0 dauerhaft ersetzt durch TargetID) |
| __TargetID__ (ab 2.6)     | integer | ID des Objektes mit dem dieser Link verknüpft ist. Siehe [IPS_SetLinkTargetID](management-links.md)                                           |

Die zu zeigende LinkID

**Beispiel**

```php
// Ab Version 4.0
print_r(IPS_GetLink(19668));
/* Beispielausgabe:
Array
(
    [LinkID] => 19668
    [TargetID] => 14444
)
*/

print_r(IPS_GetLinkCompatibility(19668));
/* Beispielausgabe:
Array
(
    [LinkID] => 19668
    [LinkChildID] => 14444
    [TargetID] => 14444
)
*/

// Bis Version 3.4
print_r(IPS_GetLink(19668));
/* Beispielausgabe:
Array
(
    [LinkID] => 19668
    [LinkChildID] => 14444
    [TargetID] => 14444
)
*/

// Bis Version 2.5
print_r(IPS_GetLink(19668));
/* Beispielausgabe:
Array
(
    [LinkID] => 19668
    [LinkChildID] => 14444
)
*/
```

## IPS_GetLinkIDByName

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-getlinkidbyname/

`int IPS_GetLinkIDByName(string $LinkName, int $ÜbergeordneteID)`

_Benötigt Symcon >= 2.1_

ermittelt die ID eines Links anhand des Namens

**Parameter**

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

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

Objekt, in deren direkten Unterobjekten gesucht werden soll

**Beispiel**

```php
$LinkID = @IPS_GetLinkIDByName("Verlinkte Regenerfassung", $ÜbergeordneteID);
if ($LinkID === false)
    echo "Link nicht gefunden!";
else
    echo "Die Link-ID lautet: ". $LinkID;
```

## IPS_GetLinkList

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-getlinklist/

`array IPS_GetLinkList()`

_Benötigt Symcon >= 2.1_

liefert eine Liste aller existierenden Links

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

Die Funktion ermittelt die IDs aller in IP-Symcon eingerichteten Links . Die IDs werden in einem Array aufgelistet. Falls kein Link existiert, ist das Array leer.

**Beispiel**

```php
$alleLinks = IPS_GetLinkList();
print_r($alleLinks);

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

## IPS_LinkExists

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-linkexists/

`bool IPS_LinkExists(int $LinkID)`

_Benötigt Symcon >= 2.1_

prüft, ob ein Link bereits existiert

**Parameter**

- `$LinkID` (int): ID der zu prüfenden Links

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

ID der zu prüfenden Links

**Beispiel**

```php
if (IPS_LinkExists(45724))
    echo "Link existiert bereits!";
```

## IPS_SetLinkTargetID

Quelle: https://www.symcon.de/de/service/dokumentation/befehlsreferenz/linkverwaltung/ips-setlinktargetid/

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

_Benötigt Symcon >= 2.6_

setzt die Verknüpfung für den Link

**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_SetLinkTargetID($LinkID, 12345); //Auf Objekt 12345 verweisen
```