Pripravujeme pre Vás novú dokumentáciu, aktuálny stav nájdete tu

OPTIONALE FUNKTIONEN

In diesem Teil der CMDB können bestehende Eigenschaften bearbeitet und neue erstellt werden. Diese können anschließend zur Erfassung beliebiger ergänzender Daten in den Formularen verschiedener Komponenten des Systems CDESK verwendet werden, wie zum Beispiel:

  • Adressbuch (Unternehmen, Kontakte)
  • Anforderungen (Allgemeine Anforderungen, Anforderungskatalog)
  • Aufträge
  • CMDB (CI types, CI-Datensätze)

Dieser Artikel beschreibt die Erfassung und Erstellung optionaler Eigenschaften und ihrer Bestandteile. Die Arbeit mit optionalen Eigenschaften und die Zuordnung zu den einzelnen Formularen und Objekten ist im Artikel Allgemeine Funktionen->Optionale Eigenschaften näher beschrieben.

Hierarchie der optionalen Eigenschaften

  • Eigenschaften – oder auch optionale Eigenschaften sind eine Menge von einer oder mehreren Basiseigenschaften. Sie ermöglichen die Erfassung ergänzender Daten in den CDESK-Formularen. Enthält eine Eigenschaft mehr als eine Basiseigenschaft, handelt es sich um eine zusammengesetzte Eigenschaft
    • Basiseigenschaften – bestimmen den Typ des Werts, den eine Eigenschaft aufzeichnet – zum Beispiel Text, Zahl, Datum, Kontrollkästchen, einen Wert aus der Datenbank oder eine eigene Auswahlliste
      • Eigene Auswahllisten – eine Menge benutzerdefinierter Werte, die zur Auswahl in einer Eigenschaft verfügbar sind, die eine Basiseigenschaft vom Typ Auswahlliste verwendet

Basiseigenschaften

In diesem Teil sind die Basiseigenschaften und ihre Typen definiert. Jede saubere CDESK-Installation enthält bereits eine Menge häufig verwendeter Basiseigenschaften, deren Detail Sie durch Auswahl der Option aus dem Kontextmenü Detail anzeigen. Diese vordefinierten Eigenschaften können nicht bearbeitet werden. Wenn die vordefinierten Basiseigenschaften für Ihren Zweck nicht ausreichen, können Sie mithilfe der Schaltfläche +Basiseigenschaft hinzufügen eigene hinzufügen. Es öffnet sich ein Formular mit den Optionen:

Basistyp – wählen Sie den Datentyp, den Sie in den optionalen Eigenschaften erfassen möchten:

  • Checkbox (true/false) – Kontrollkästchen
  • Counter – Feld zur Eingabe eines Zahlenwerts zu einem gewählten Datum
  • Custom Enum – Feld zur Auswahl aus einer vordefinierten Wertemenge aus einer benutzerdefinierten Auswahlliste
  • Date – Feld zur Auswahl eines Datums
  • Datetime – Feld zur Auswahl von Datum und Uhrzeit
  • DB relation – Feld zur Auswahl von in der Datenbank gespeicherten Werten
  • File upload – Feld zum Anhängen einer Datei
  • IP – Feld zur Erfassung einer IP-Adresse
  • Long text (65535 chars) – Feld zur Eingabe von langem Text bis 65535 Zeichen
  • Number (decimal) – Feld zur Eingabe einer Dezimalzahl
  • Number (whole number -2mld .. +2mld) – Feld zur Eingabe einer ganzen Zahl
  • String (255 chars) – Feld zur Eingabe von Text mit einer Länge bis 256 Zeichen
  • Time – Feld zur Auswahl einer Uhrzeit
  • Tri-state checkbox (true/false/maybe) – Schalter mit Erfassung von drei möglichen Zuständen
  • Abhängig vom gewählten Basistyp werden weitere Felder des Formulars zugänglich:
  • Eigene Auswahlliste – wird nach der Auswahl des Typs Custom Enum zugänglich – wählen Sie aus den benutzerdefinierten Auswahllisten. Mehr über eigene Auswahllisten erfahren Sie im eigenen Absatz unten
  • API-Pfad – geben Sie den Pfad zur Datenbank an, von der die Werte geladen werden sollen; es gibt zwei Möglichkeiten:
  • Vordefiniert – wählen Sie aus den definierten Pfaden zu den verwendeten Auswahllisten in der CDESK-Datenbank (zum Beispiel die Liste der Aufträge, Computer, Einheiten, Länder..)
  • Eigene – ermöglicht die Verwendung eines Pfades zu weiteren Teilen der CDESK-Datenbank gemäß der API-Dokumentation (zum Beispiel zur Liste der Objekte, die unter CI Main group/CI Type gehören; statt der ID verwenden Sie Slug). Zugleich ermöglicht sie das Laden von Werten aus einer externen Datenbank
  • Query parameter – durch Klicken auf +Query-Parameter hinzufügen fügen Sie eine Zeile zum Ausfüllen des Parameters und des Werts hinzu – die Liste der Parameter finden Sie in der API-Dokumentation von CDESK

Name – geben Sie den Namen der Basiseigenschaft an, er wird im Formularfeld als Platzhaltertext angezeigt (anstelle eines leeren Feldes)

Eigenschaftstyp – wählen Sie, für die Erfassung welcher Daten Sie die Basiseigenschaft erstellen. In der API können gemäß dem gewählten Typ Daten gesucht werden, die unter einem anderen Namen erfasst sind (zum Beispiel finden Sie durch Auswahl des Typs phone alle Telefonnummern, auch wenn sie in der Datenbank einmal unter dem Namen Telefonkontakt, ein anderes Mal als Festnetz erfasst sind)

Slug (Alias) – Alias für die ID – ermöglicht die Arbeit mit Basiseigenschaften in der API-Oberfläche von CDESK, ohne deren ID in der Datenbank kennen zu müssen. Verwenden Sie Ausdrücke ohne Diakritik und Leerzeichen – statt Leerzeichen verwenden Sie einen Bindestrich. Der Slug soll eindeutig sein, d. h. er darf innerhalb der Basiseigenschaften höchstens einmal verwendet werden

Zur Erstellung einer Basiseigenschaft oder zum Anwenden von Änderungen klicken Sie auf Speichern.

Eigenschaften

In diesem Teil sind die Eigenschaften definiert, die zur Erfassung ergänzender Daten in den Formularen verwendet werden. Sie können Formularen wie Unternehmen, Kontakte, Aufträge, Anforderungen oder Objekten zugeordnet werden. Jede CDESK-Installation enthält bereits eine Menge von Eigenschaften, deren Detail Sie durch Auswahl der Option aus dem Kontextmenü Detail anzeigen. Diese vordefinierten Eigenschaften können weder bearbeitet noch gelöscht werden. Sie können auch eigene Eigenschaften mithilfe der Schaltfläche +Eigenschaft hinzufügen hinzufügen. Es öffnet sich ein Formular mit den Optionen:

Name – geben Sie den Namen der Eigenschaft an, er wird im Formular als Name des Feldes bzw. der Feldmenge im Falle einer zusammengesetzten Eigenschaft angezeigt

Beschreibung – Sie können eine kurze Beschreibung der Eigenschaft angeben (zum Beispiel die zugeordneten Basiseigenschaften im Falle einer zusammengesetzten Eigenschaft)

GruppeAllgemein/Technisch/Sonstige – wählen Sie, zu welcher Gruppe die Eigenschaft gehört. Es hat keinen Einfluss auf die Funktionalität der Eigenschaft, die Unterscheidung nach Gruppe hilft bei der visuellen Sortierung der Eigenschaften in der Liste der Eigenschaften

Property type – wählen Sie, für die Erfassung welcher Daten Sie die Eigenschaft erstellen. In der API können gemäß dem gewählten Typ Daten gesucht werden, die unter einem unterschiedlichen Namen erfasst sind (zum Beispiel finden Sie durch Auswahl des Typs phone alle Telefonnummern, auch wenn sie einmal als Telefonkontakt, einmal als Festnetz erfasst sind)

Slug (Alias) – Alias für die ID – ermöglicht die Arbeit mit Eigenschaften in der API-Oberfläche von CDESK, ohne deren ID in der Datenbank kennen zu müssen. Verwenden Sie Ausdrücke ohne Diakritik und Leerzeichen – statt Leerzeichen verwenden Sie einen Bindestrich. Der Slug soll eindeutig sein, d. h. er darf innerhalb der Eigenschaften höchstens einmal verwendet werden

Basiseigenschaften – durch Klicken auf Basiseigenschaft hinzufügen öffnet sich ein Fenster zur Auswahl der Basiseigenschaften, sortiert nach den unter CMDB->Optionale Eigenschaften->Basiseigenschaften definierten Basistypen der Eigenschaften. Durch Klicken auf < fügen Sie eine Basiseigenschaft hinzu. Durch die Auswahl mehrerer Basiseigenschaften können sogenannte zusammengesetzte Eigenschaften erstellt werden (zum Beispiel kann die Eigenschaft Adresse aus den Basiseigenschaften Straße, Nummer, PLZ, Land bestehen)

Zur Erstellung einer Eigenschaft oder zum Anwenden von Änderungen klicken Sie auf Speichern.

Eigene Auswahllisten

In diesem Teil definieren Sie Auswahllisten mit eigenen Wertemengen. Diese können anschließend zur Auswahl bei optionalen Eigenschaften verfügbar sein, die die gewählte Werte-Auswahlliste verwenden.

Eine neue Auswahlliste fügen Sie mit der Schaltfläche +Auswahlliste hinzufügen hinzu.

Name – geben Sie den Namen der Auswahlliste an, er wird im Formularfeld als Platzhaltertext angezeigt (anstelle eines leeren Feldes)

Beschreibung – Sie können eine kurze Beschreibung der Auswahlliste angeben

Mit der Schaltfläche +Hinzufügen fügen Sie eine neue Zeile zur Eingabe eines Auswahllistenwerts hinzu. Durch Klicken auf × entfernen Sie die Zeile – das Entfernen ist nur vor dem Speichern möglich. Nach dem Speichern der Auswahlliste können nicht verwendete Werte durch Umschalten des Schalters in den Zustand deaktiviert deaktiviert werden. Die Reihenfolge der Auswahllistenwerte ändern Sie durch Ziehen am Symbol .

Zur Erstellung einer eigenen Auswahlliste oder zum Anwenden von Änderungen klicken Sie auf Speichern>.

Beispiel für die Erstellung einer zusammengesetzten Eigenschaft

Nehmen wir eine zusammengesetzte Eigenschaft an, deren Aufgabe es ist, Daten über den Zustand eines zum Service übergebenen Geräts zu erfassen.

Zur Aufzeichnung von Informationen über den Gerätezustand erfassen wir, ob das Gerät noch unter Garantie ist, das Verkaufsdatum, Anzeichen von Beschädigung und das übergebene Zubehör. Wir empfehlen, von der niedrigsten Ebene aus zu beginnen, wie in der Vorgehensweise unten:

  1. Eine eigene Auswahlliste mit dem Namen Beschädigungstypen und Optionen, die das Ausmaß der Beschädigung beschreiben, erstellen:
    • Ohne sichtbare Anzeichen von Beschädigung
    • Kleine Kratzer
    • Risse oder Dellen
    • Abgebrochene oder fehlende Teile
  2. Basiseigenschaften erstellen, die den Werttyp definieren
    • Unter Garantie – es werden nur zwei Zustände aufgezeichnet, wir können daher den Feldtyp Checkbox (true/false) – Kontrollkästchen verwenden
    • Verkaufsdatum – Feld vom Typ Date – Auswahl eines Datums
    • Anzeichen von Beschädigung – wird aus vordefinierten Werten ausgewählt – Feld vom Typ Custom Enum – mit der im ersten Schritt erstellten Auswahlliste Beschädigungstypen
    • Übergebenes Zubehör – die erstellte Eigenschaft ist für Geräte verschiedener Typen verwendbar, wobei jedes anderes Zubehör enthalten kann. Für die Universalität eignet sich daher ein Feld vom Typ String (255 chars) – kurzer Text bis 255 Zeichen
  3. Eine Eigenschaft mit dem Namen Gerätezustand erstellen
    • Die im zweiten Schritt erstellten Basiseigenschaften zuordnen

Damit ist die zusammengesetzte Eigenschaft Gerätezustand erstellt und kann zum Beispiel einer Anforderung zugeordnet werden. Dank ihrer Universalität ist sie für Geräte verschiedener Typen verwendbar. Die Zuordnung einer optionalen Eigenschaft zum Anforderungsformular ist im Artikel Allgemeine Funktionen->Optionale Eigenschaften näher beschrieben.