Strecke

Verwaltung von Strecken.

Seitenverzeichnis:

cable.section.read

Beschreibung

Gibt alle Strecken zurück.

Beispielaufruf

Lesen einer speziellen Strecke:

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

Filtern von Strecken:

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

Parameter

Typ

Beschreibung

Version

id

int

Optional: ID der Strecke

ab Version 1.0

filter

array

Optional: Filter für Strecken

Der Filter unterstützt alle Eigenschaften der Strecke (siehe Rückgabewerte).

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

ab Version 1.0

Rückgabewert

Liste aller Strecken.

Wert	Typ	Beschreibung	Version
id	int	ID der Strecke	ab Version 1.0
obj_id	int	ID des referenzierten Strecken-Objektes	ab Version 1.0
description	string	Beschreibung der Strecke	ab Version 1.0
user_state_id	int	Nutzer-Status der Strecke	ab Version 1.0
channel_count	int	Anzahl logischer Kanäle	ab Version 1.0
current_channel_count	int	Aktuelle Anzahl logischer Kanäle	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
length	int	Länge der Strecken in Meter Hinweis: Die Streckenlänge wird automatisch berechnet.	ab Version 1.0

cable.section.create

Beschreibung

Legt eine neue Strecke an.

Beispielaufruf

{
	"method":"cable.section.create",
	"params":{
		"apikey":"24174j3tqj",
		"data": {
			"obj_id": 14,
			"description":"Strecke A"
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
obj_id	int	ID des referenzierten Strecken-Objektes	ab Version 1.0
description	string	Optional: Beschreibung der Strecke	ab Version 1.0
user_state_id	int	Nutzer-Status der Strecke	ab Version 1.0
channel_count	int	Optional: Anzahl logischer Kanäle	ab Version 1.0
current_channel_count	int	Optional: Aktuelle Anzahl logischer Kanäle	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

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.section.update

Beschreibung

Aktualisiert eine bestehende Strecke.

Beispielaufruf

{
	"method":"cable.section.update",
	"params":{
		"apikey":"24174j3tqj",
		"id":4,
		"data": {
			"description":"Strecke A"
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID der Strecke	ab Version 1.0
description	string	Beschreibung der Strecke	ab Version 1.0
user_state_id	int	Nutzer-Status der Strecke	ab Version 1.0
channel_count	int	Anzahl logischer Kanäle	ab Version 1.0
current_channel_count	int	Aktuelle Anzahl logischer Kanäle	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

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.section.find_usages

Beschreibung

Findet die Objekte (Netzwege), in denen eine angegebene Strecke verwendet wird.

Beispielaufruf

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

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID des referenzierten Strecken-Objektes	ab Version 1.0

Rückgabewert

Auflistung der Netzwege, in denen die Strecke verwendet wird.

Wert	Typ	Beschreibung	Version
id	int	ID der Netzweg-Kategorie	ab Version 1.0
obj_id	int	ID des Netzweg-Objektes	ab Version 1.0
title	string	Name des Netzweges	ab Version 1.0
type_id	int	ID des Objekttyps (ID des Objekttyps "Netzweg")	ab Version 1.0
type_title	string	Name des Objekttyps (Name des Objekttyps "Netzweg")	ab Version 1.0

cable.section.get_connected_objects

Beschreibung

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

Beispielaufruf

{
	"method":"cable.section.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

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.section.get_section_elements

Beschreibung

Gibt eine Liste aller Elemente einer Strecke zurück.

Beispielaufruf

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

Parameter

Typ

Beschreibung

Version

obj_id

int

ID des Strecken-Objektes

ab Version 1.0

add_connection_information

int

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

Zulässige Werte:

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

ab Version 1.0

add_capacity_information

int

Optional: Gibt die Auslastung des verwendeten Kabels zwischen den beiden Strecken-Elementen an.

Zulässige Werte:

1 (Auslastung wird angezeigt - Standardeinstellung)
0 (Auslastung wird nicht angezeigt)

ab Version 1.0

Rückgabewert

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

cable.section.delete

Beschreibung

Löscht eine Strecke.

Beispielaufruf

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

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID der zu löschenden Strecke	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