Attribute

Mit der neuen Attributverwaltung in NetCord können individuelle Eigenschaften für Geräte, Racks, Kabel, Gebäude, Etagen und Räume definiert und verwaltet werden. Diese Attribute ermöglichen es, spezifische Informationen zu erfassen und gezielt zuzuweisen. Dabei können verschiedene Feldtypen und Validierungen genutzt werden, um sicherzustellen, dass die eingegebenen Daten den gewünschten Anforderungen entsprechen.

Diese Anleitung beschreibt, wie neue Attribute erstellt und bestehende Attribute bearbeitet werden und welche verschiedenen Validierungstypen zur Verfügung stehen. Ob einfache Textfelder oder komplexe Validierungen wie reguläre Ausdrücke benötigt werden – diese Anleitung hilft, die Attributverwaltung effizient zu nutzen.

Anzeigebereich

Attribute können für alle "Geräte" erfasst werden, einschliesslich Gruppen wie Gebäude, Racks, Kabel, Etagen, Räume und mehr. Nach der Erstellung und Zuweisung werden die Attribute im mittleren Übersichtsbereich (1) angezeigt.

Erstellen neuer Attribute

Um neue Attribute hinzuzufügen, sind die folgenden Schritte auszuführen:

Oben auf das Menü klicken. Im Menü auf "Attribute" klicken.

Übersicht der Attribute

1. Hier werden alle erfassten Attribute aufgelistet.
2. Hier können neue Attribute erstellt werden, abhängig von den Berechtigungen.

Neues Attribut erstellen

Um ein neues Attribut hinzuzufügen, sind diese Schritte auszuführen:

1. Einen eindeutigen Namen für das Attribut eingeben.

2. Das Attribut beschreiben.

3. Das Modell auswählen, dem das neue Attribut hinzugefügt werden soll.

4. „Read Only“ kann ausgewählt werden, wenn dieses Attribut über die Schnittstelle automatisch befüllt wird (Feld kann nicht mehr im NetCord bearbeitet werden).

5. Soll das Attribut zwingend ausgefüllt werden müssen, „Required“ auswählen. Ohne das Ausfüllen kann der User den Eintrag nicht speichern.

Auswahl von Feld-Typen

1. Hier werden alle Attributfeldtypen aufgelistet.

Es stehen folgende zur Auswahl:

• Text (Min/Max Length, Picklist und Regular Expression )
• Integer
• Decimal
• Boolean
• Date
• Time
• DateTime

2. Die Auswahl "Validation Type" ändert sich je nach ausgewähltem Feld-Typ.

Validation Type Text und Min/Max Length

Wenn der Typ 'Text' ausgewählt (1) und der Validierungstyp (2) 'Min/Max Length' ist, können unter (3) die minimale Textlänge und unter (4) die maximale Textlänge eingegeben werden.

Validation Type Text und Picklist

Wenn der Typ 'Text' ausgewählt und der Validierungstyp (1) 'Picklist' ist, können unter (2) die Picklist mit durch Kommas getrennten Werten erstellt werden, um eine Auswahl an möglichen Werten zu ermöglichen.

Validation Type Text und Regular Expression

Wenn der Typ 'Text' ausgewählt und der Validierungstyp (1) 'Regular Expression' ist, kann unter (2) die Regex eingegeben werden, um die Eingaben entsprechend einem definierten Muster zu validieren.

Validation Type Integer

Wenn der Typ 'Integer' (1) ausgewählt ist, kann sichergestellt werden, dass nur ganze Zahlen (positive oder negative) in das Eingabefeld eingegeben werden. Über den Integer min Value (2) wird die niedrigste erlaubte Zahl festgelegt, während über den Integer max Value (3) die höchste erlaubte Zahl definiert werden kann.

Validation Type Decimal

Wenn der Typ 'Decimal' (1) ausgewählt ist, können nur Dezimalzahlen (positive oder negative) eingegeben werden. Zusätzlich können folgende Parameter festgelegt werden:

2. Decimal min value: Mindestwert der Eingabe.
3. Decimal max value: Höchstwert der Eingabe.
4. Decimal precision: Anzahl der zulässigen Dezimalstellen. Es steuert, wie präzise die Eingabe sein darf, z. B. auf zwei Nachkommastellen (z. B. 12.34).

Validation Type Boolean

Wenn der Typ 'Boolean' (1) ausgewählt ist, kann sichergestellt werden, dass nur die Werte 'Wahr' oder 'Falsch' in das Eingabefeld eingegeben werden. Dies geschieht über ein Häkchenfeld, das aktiviert werden kann, um 'Wahr' auszuwählen, während das Deaktivieren des Feldes 'Falsch' bedeutet.

Validation Type Date

Wenn der Typ 'Date' (1) ausgewählt ist, kann sichergestellt werden, dass nur gültige Datumsangaben in das Eingabefeld eingegeben werden. Dies erfolgt über ein Datumsfeld, in dem der Benutzer ein Datum auswählen kann, um sicherzustellen, dass das Format korrekt ist.

Validation Type Time

Wenn der Typ 'Time' (1) ausgewählt ist, kann sichergestellt werden, dass nur gültige Zeitangaben in das Eingabefeld eingegeben werden. Dies erfolgt über ein Zeitfeld, in dem der Benutzer eine Uhrzeit auswählen kann, um sicherzustellen, dass das Format korrekt ist.

Validation Type DateTime

Wenn der Typ 'DateTime' (1) ausgewählt ist, kann sichergestellt werden, dass nur gültige Datums- und Zeitangaben in das Eingabefeld eingegeben werden. Dies erfolgt über ein Datums- und Zeitfeld, in dem der Benutzer sowohl ein Datum als auch eine Uhrzeit auswählen kann, um sicherzustellen, dass das Format korrekt ist.

Validation Type Link

Wenn der Typ 'Link' (1) ausgewählt ist, kann eine URL im Eingabefeld hinzugefügt werden. Diese Validierung ermöglicht es, eine direkte URL oder einen angepassten Link-Text anzugeben. Möglichkeiten zur Eingabe im Link-Feld:

• Einfacher Link: Hier eine URL eingeben, die automatisch als Link angezeigt wird.

• Angepasster Display-Text: Für einen benutzerdefinierten Link-Text die URL im Markdown-Format eingeben. Der Anzeigetext steht in eckigen Klammern, die URL in runden Klammern.

Um die Benutzerfreundlichkeit zu erhöhen, gibt es ein Info-Flag im Link-Feld, das beim Überfahren mit der Maus eine kurze Erklärung anzeigt.

Übersicht, nach erstellen und zuweisen der Attribute

Wenn die Attribute einmal erstellt sind, sind in der Übersicht (von Geräten, Gebäuden, Etagen usw.) die erstellten Attribute (1) sichtbar.

Attributverwaltung

Beim Neuanlegen erscheinen die Attribute direkt bei Liegenschaft hinzugefügt. Wenn ein Attribut neu erstellt wird, wird es dem Modell hinzugefügt. Attribute bestehender Modelle können über die Aktionen (1) und 'Edit' (2) bearbeitet werden.

Attribute Eingeben und Bearbeiten

Beim Bearbeiten oder Hinzufügen von Attributen erscheinen diese unten in der Maske und können je nach gewähltem Validierungstyp ausgefüllt werden.

1. Hier erscheinen die Attribute.
2. Hier einen Wert aus der Pickliste auswählen.
3. Auch hier einen Wert aus der Pickliste auswählen.
4. Hier das entsprechende Datum und die Uhrzeit eingeben.
5. Zum Abschluss auf Update Building drücken, um die Änderungen zu speichern.

Übersicht der Attribut-Eingabewerte

Die Attribut-Eingabewerte erscheinen in der Übersicht. Wie gewohnt können diese Werte über die Suche gefunden werden.

Ausnahmeverhalten bei Attributen für Ports

Wenn mehrere Ports gleichzeitig erstellt werden (z. B. über Port Count), werden die in diesem Schritt gesetzten Attribute auf alle erstellten Ports identisch angewendet.

Beispiel: Ein Port besitzt ein benutzerdefiniertes Attribut displayname. Wird im Erstellungsdialog Port Count = 5 angegeben und als displayname der Wert „Mein Name 1“ eingetragen, erhalten alle fünf Ports diesen Wert.

Dieses Verhalten gilt sowohl für die API als auch für das Web-Interface.

Anpassungsmöglichkeiten:

• Die Ports können nachträglich einzeln bearbeitet werden, um etwa beim zweiten Port den Wert „Mein Name 2“ zu setzen.
• Alternativ können die Ports einzeln erstellt werden (Port Count = 1). Dies ist besonders bei der automatisierten Erstellung über die API zu empfehlen, um zusätzliche Update-Requests zu vermeiden.