Netzweg

Verwaltung von Netzwegen.

Seitenverzeichnis:

cable.route.read

Beschreibung

Gibt alle Netzwege zurück.

Beispielaufruf

Lesen eines speziellen Netzweges:

{
	"method":"cable.route.read",
	"params":{
		"apikey":"24174j3tqj",
		"id": 4
	},
	"version":"2.0",
    "id": 1
}

Filtern von Netzwegen:

{
	"method":"cable.route.read",
	"params":{
		"apikey":"24174j3tqj",
		"filter": {
			"description": "Typ %"
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Typ

Beschreibung

Version

id

int

Optional: ID des Netzweges

ab Version 1.0

filter

array

Optional: Filter für Netzwege

Der Filter unterstützt alle Eigenschaften des Netzweges (siehe Rückgabewerte).

Als Suchkriterium kann das Prozent-Zeichen "%" als Wildcard verwendet werden.

ab Version 1.0

Rückgabewert

Liste aller Netzwege.

Wert	Typ	Beschreibung	Version
id	int	ID des Netzweges	ab Version 1.0
obj_id	int	ID des referenzierten Netzweg-Objektes	ab Version 1.0
description	string	Beschreibung des Netzweges	ab Version 1.0
connection_count	int	Anzahl Verbindungen	ab Version 1.0
current_connection_count	int	Aktuelle Anzahl der Verbindungen	ab Version 1.0
permission	string	Berechtigung	ab Version 1.0
location	string	Standort	ab Version 1.0
room	string	Raum	ab Version 1.0
device_type	string	Endgerätetyp	ab Version 1.0
device_number	string	Geräte Nummer	ab Version 1.0
phone_number	string	Rufnummer	ab Version 1.0
phone_subscriber	string	Teilnehmer	ab Version 1.0
hint	string	Hinweis	ab Version 1.0
start_obj_id	int	ID des ersten Streckenelementes	ab Version 1.0
end_obj_id	int	ID des letzten Streckenelementes	ab Version 1.0
tka_participant	string	Name des TKA-Teilnehmers	ab Version 1.0

cable.route.create

Beschreibung

Legt einen neuen Netzweg an.

Beispielaufruf

{
	"method":"cable.route.create",
	"params":{
		"apikey":"24174j3tqj",
		"data": {
			"obj_id": 14,
			"description":"Netzweg A",
			"connection_count":40
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
obj_id	int	ID des referenzierten Netzweg-Objektes	ab Version 1.0
description	string	Beschreibung des Netzweges	ab Version 1.0
connection_count	int	Optional: Anzahl Verbindungen	ab Version 1.0
current_connection_count	int	Optional: Aktuelle Anzahl der Verbindungen	ab Version 1.0
permission	string	Optional: Berechtigung	ab Version 1.0
location	string	Optional: Standort	ab Version 1.0
room	string	Optional: Raum	ab Version 1.0
device_type	string	Optional: Endgerätetyp	ab Version 1.0
device_number	string	Optional: Geräte Nummer	ab Version 1.0
phone_number	string	Optional: Rufnummer	ab Version 1.0
phone_subscriber	string	Optional: Teilnehmer	ab Version 1.0
hint	string	Optional: Hinweis	ab Version 1.0
start_obj_id	int	Optional: ID des ersten Streckenelementes	ab Version 1.0
end_obj_id	int	Optional: ID des letzten Streckenelementes	ab Version 1.0
tka_participant	string	Optional: Name des TKA-Teilnehmers	ab Version 1.0

Rückgabewert

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0

cable.route.update

Beschreibung

Aktualisiert einen bestehenden Netzweg.

Beispielaufruf

{
	"method":"cable.route.update",
	"params":{
		"apikey":"24174j3tqj",
		"id":4,
		"data": {
			"description":"Netzweg A",
			"connection_count":40
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID des Netzweges	ab Version 1.0
description	string	Beschreibung des Netzweges	ab Version 1.0
connection_count	int	Anzahl Verbindungen	ab Version 1.0
current_connection_count	int	Aktuelle Anzahl der Verbindungen	ab Version 1.0
permission	string	Berechtigung	ab Version 1.0
location	string	Standort	ab Version 1.0
room	string	Raum	ab Version 1.0
device_type	string	Endgerätetyp	ab Version 1.0
device_number	string	Geräte Nummer	ab Version 1.0
phone_number	string	Rufnummer	ab Version 1.0
phone_subscriber	string	Teilnehmer	ab Version 1.0
hint	string	Hinweis	ab Version 1.0
start_obj_id	int	ID des ersten Streckenelementes	ab Version 1.0
end_obj_id	int	ID des letzten Streckenelementes	ab Version 1.0
tka_participant	string	Name des TKA-Teilnehmers	ab Version 1.0

Rückgabewert

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0

cable.route.get_connected_objects

Beschreibung

Gibt alle freien Verbindungen zu direkt verbundenen Objekten zurück.

Beispielaufruf

{
	"method":"cable.route.get_connected_objects",
    "params":{
        "apikey":"24174j3tqj",
        "obj_id": 1234
    },
    "version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
obj_id	int	ID des Ausgangs-Objektes	ab Version 1.0
wire_id	int	Optional: ID der Ader, von welcher aus das Ausgangs-Objekt verbunden ist	ab Version 1.0
section_id	int	Optional: ID der Strecke, von welcher aus das Ausgangs-Objekt verbunden ist	ab Version 1.0

Rückgabewert

Wert	Typ	Beschreibung	Version
element	array	Informationen zum Ausgangs-Objekt	ab Version 1.0
objects	array	Auflistung aller freien Verbindungen	ab Version 1.0

cable.route.get_route_elements

Beschreibung

Gibt eine Liste aller Elemente eines Netzweges zurück.

Beispielaufruf

{
	"method":"cable.route.get_route_elements",
	"params":{
		"apikey":"24174j3tqj",
		"obj_id":4
	},
	"version":"2.0",
    "id": 1
}

Parameter

Typ

Beschreibung

Version

obj_id

int

ID des Netzweg-Objektes

ab Version 1.0

add_connection_information

int

Optional: Listet alle weiteren, freien Verbindungen zwischen den beiden Netzweg-Elementen auf.

Zulässige Werte:

1 (Verbindungen werden angezeigt - Standardeinstellung)
0 (Verbindungen werden nicht angezeigt)

ab Version 1.0

Rückgabewert

Wert	Typ	Beschreibung	Version
result	array	Auflistung der Netzweg-Elemente	ab Version 1.0

cable.route.delete

Beschreibung

Löscht einen Netzweg.

Beispielaufruf

{
	"method":"cable.route.delete",
	"params":{
		"apikey":"24174j3tqj",
		"id":4
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID des zu löschenden Netzweges	ab Version 1.0

Rückgabewert

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0