Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Lesen einer speziellen Ader:

Codeblock
languagebash
themeRDark
{
	"method":"cable.wire.read",
	"params":{
		"apikey":"24174j3tqj",
		"id": 4
	},
	"version":"2.0",
    "id": 1
}

Filtern von Adern:

Codeblock
languagebash
themeRDark
{
	"method":"cable.wire.read",
	"params":{
		"apikey":"24174j3tqj",
		"filter": {
			"description": "Ader %"
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

ParameterTypBeschreibungVersion
idintOptional: ID des Datenbankeintragesab Version 1.0
filterarray

Optional: Filter für Adern

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

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

ab Version 1.0

...

WertTypBeschreibungVersion
idintID des Datenbankeintragesab Version 1.0
obj_idintID des referenzierten Kabelsab Version 1.0
descriptionstringBeschreibung der Aderab Version 1.0
colorstringFarbe der Aderab Version 1.0
scopestringLeiter-Bereichab Version 1.0
scope_indexintBereichs-Indexab Version 1.0
reservedint

Ader ist reserviert oder nicht

Zulässige Werte:

  • 0
  • 1
ab Version 1.0
user_state_idintID des Nutzer-Statusab Version 1.0
user_statestringNutzer-Statusab Version 1.0
connection_type_idintVerbindungs-Typab Version 1.0
dampingstringDämpfung der Aderab Version 1.0
noticestringBemerkungab Version 1.0


...

cable.wire.create

...

Legt eine neue Ader zu einem Kabel an.

Beispielaufruf

Codeblock
languagebash
themeRDark
{
	"method":"cable.wire.create",
	"params":{
		"apikey":"24174j3tqj",
		"data": {
			"obj_id":19,
			"description":"Ader 1",
			"number":1
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

ParameterTypBeschreibungVersion
obj_idintID des referenzierten Kabelsab Version 1.0
descriptionstringBeschreibung der Aderab Version 1.0
colorstringOptional: Farbe der Aderab Version 1.0
scopestringOptional: Leiter-Bereichab Version 1.0
scope_indexintOptional: Bereichs-Indexab Version 1.0
reservedint

Optional: Ader ist reserviert oder nicht

Zulässige Werte:

  • 0
  • 1
ab Version 1.0
user_state_idintOptional: ID des Nutzer-Statusab Version 1.0
user_statestringOptional: Nutzer-Statusab Version 1.0
connection_type_idintOptional: Verbindungs-Typab Version 1.0
dampingstringOptional: Dämpfung der Aderab Version 1.0
noticestringOptional: Bemerkungab Version 1.0

Rückgabewert

WertTypVersion
current_datestringab Version 1.0
idintab Version 1.0
messagestringab Version 1.0

...

Aktualisiert eine bestehende Ader zu einem Kabel.

Beispielaufruf

Codeblock
languagebash
themeRDark
{
	"method":"cable.wire.update",
	"params":{
		"apikey":"24174j3tqj",
		"id":4,
		"data": {
			"description":"Ader 1",
			"number":1
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

ParameterTypBeschreibungVersion
idintID des Datenbankeintragesab Version 1.0
descriptionstringBeschreibung der Aderab Version 1.0
colorstringFarbe der Aderab Version 1.0
scopestringLeiter-Bereichab Version 1.0
scope_indexintBereichs-Indexab Version 1.0
reservedint

Ader ist reserviert oder nicht

Zulässige Werte:

  • 0
  • 1
ab Version 1.0
user_state_idintID des Nutzer-Statusab Version 1.0
user_statestringNutzer-Statusab Version 1.0
connection_type_idintVerbindungs-Typab Version 1.0
dampingstringDämpfung der Aderab Version 1.0
noticestringBemerkungab Version 1.0

Rückgabewert

WertTypVersion
current_datestringab Version 1.0
idintab Version 1.0
messagestringab Version 1.0

...

Generiert automatisch alle Adern eines Kabels, basierend auf dessen Kabeltyp.

Beispielaufruf

Codeblock
languagebash
themeRDark
{
	"method":"cable.wire.generate_wires",
	"params":{
		"apikey":"24174j3tqj",
		"id":123,
		"data": {
			"prefixgenerator_id":"MyWire" 4,
			"start_pattern": "01/01-10",
			"end_pattern": "01/03-14"
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

ParameterTypBeschreibungVersion
idintID des referenzierten Kabelsab Version 1.0
prefixstringOptional: Vorsilbe, welche vor den Namen jeder Ader angefügt wirdgenerator_idint

ID des entsprechenden Generators

Weitere Informationen zu Generatoren finden Sie hier: Generator

ab Version 1.0
start_patternstring

Optional: Anfangs-Muster, anhand dessen die laufenden Nummern der Adern gebildet werden.

Unterstützt werden:

  • einzelne numerische Werte
  • Muster im Format: XX-YYY-ZZ mit jeweils beliebiger Länge der einzelnen Teile
  • Folgende Trenner sind für Muster erlaubt:
  • -
  • ,
  • /

    Startwert

    z.B.: 01/02/1

    ab Version 1.0
    end_patternstring

    Endwert

    z.B.: 02/04/4

    ab Version 1.0

    Rückgabewert

    end_pattern
    WertTypVersion
    current_datestringab Version 1.0
    idstring

    Optional: End-Muster, bis zu welchem die laufenden Nummern der Adern gebildet werden.

    Unterstützt werden:

    • einzelne numerische Werte
    • Muster im Format: XX-YYY-ZZ mit jeweils beliebiger Länge der einzelnen Teile
    • Folgende Trenner sind für Muster erlaubt:
      • -
      • ,
      • /

    Beispiel 1:

    • Anfangs-Muster: "4"
    • End-Muster: "8"
    • Vorsilbe: "Ader-"
    • Ergebnis: Es werden fünf Adern generiert
      • "Ader-4"
      • "Ader-5"
      • "Ader-6"
      • "Ader-7"
      • "Ader-8"

    Beispiel 2:

    • Anfangs-Muster: "01-010"
    • End-Muster: "03-012"
    • Vorsilbe: "Ader-"
    • Ergebnis: Es werden neun Adern generiert
      • "Ader-01-010"
      • "Ader-01-011"
      • "Ader-01-012"
      • "Ader-02-010"
      • "Ader-02-011"
      • "Ader-02-012"
      • "Ader-03-010"
      • "Ader-03-011"
      • "Ader-03-012"
    ab Version 1.0

    Rückgabewert

    WertTypVersion
    current_datestringintab Version 1.0
    messagestringab Version 1.0


    ...

    cable.wire.find_usages

    Beschreibung

    Findet die Objekte, in denen eine angegebene Ader verwendet wird.

    Beispielaufruf

    Codeblock
    languagebash
    themeRDark
    {
    	"method":"cable.wire.find_usages",
    	"params":{
    		"apikey":"24174j3tqj",
    		"id":4
    	},
    	"version":"2.0",
        "id": 1
    }

    Parameter

    ParameterTypBeschreibungVersion
    idintID der Aderab Version 1.0

    Rückgabewert

    Auflistung der Objekte, in denen die Ader verwendet wird.

    WertTypBeschreibungVersion
    idintKategorie-ID des Objektesab Version 1.0
    obj_idintID des Objektesab Version 1.0
    titlestringName des Objektesab Version 1.0
    type_idint

    ID des Objekttyps

    ab Version 1.0
    messagetype_titlestring

    Name des Objekttyps

    ab Version 1.0


    ...

    cable.wire.delete

    Beschreibung

    Löscht eine Ader eines Kabels.

    Beispielaufruf

    Codeblock
    languagebash
    themeRDark
    {
    	"method":"cable.wire.delete",
    	"params":{
    		"apikey":"24174j3tqj",
    		"id":4
    	},
    	"version":"2.0",
        "id": 1
    }

    Parameter

    ParameterTypBeschreibungVersion
    idintID des zu löschenden Datenbankeintragesab Version 1.0

    Rückgabewert

    WertTypVersion
    current_datestringab Version 1.0
    idintab Version 1.0
    messagestringab Version 1.0


    ...

    cable.wire.delete_all

    Beschreibung

    Löscht alle Adern eines Kabels.

    Beispielaufruf

    Codeblock
    languagebash
    themeRDark
    {
    	"method":"cable.wire.delete_all",
    	"params":{
    		"apikey":"24174j3tqj",
    		"id":123
    	},
    	"version":"2.0",
        "id": 1
    }

    Parameter

    ParameterTypBeschreibungVersion
    idintID des referenzierten Kabelsab Version 1.0

    Rückgabewert

    WertTypVersion
    current_datestringab Version 1.0
    idintab Version 1.0
    messagestringab Version 1.0

    ...