Grundlagen

Die Baumstruktur kann in der Docusnap Administration im Bereich Customizing durch Klick auf die Schaltfläche Objekte verwalten angepasst werden. Die Registerkarten stellen alle notwendigen Einstellungen bereit, um eigene Strukturen anlegen zu können.

Docusnap-Extras-Objekte-Verwalten

Innerhalb von Docusnap existieren fünf verschiedene hierarchische Strukturen, mit denen die erfassten Daten organisiert werden können.

Hierarchie
InventarAlle durch einen Scan erfassten oder manuell eingegeben Daten
DatenimportDiese Hierarchie bestimmt die Struktur für den Datenimport aus anderen Datenbanken.
LizenzmanagementDarstellung der Hierarchie für das Lizenzmanagement
IT-SicherheitStruktur für das Modul IT-Sicherheit
DokumentationDie erstellten Dokumente werden in dieser Hierarchie übersichtlich dargestellt.

In jedem Metaobjekt wird zur Laufzeit ein Primärschlüssel zur eindeutigen Identifizierung hinterlegt. Objekte ohne eigenen Primärschlüssel (z.B. Überschriften) erben den Primärschlüssel des letzten übergeordneten Daten-Metaobjektes.

Vereinfacht gesagt wird jede untergeordnete Ebene durch einen Wert aus der übergeordneten Ebene gefiltert. So wird z.B. die Ebene der Domänen durch den Inhalt der Spalte AccountID gefiltert, der einen eindeutigen Wert auf der Ebene des Mandanten darstellt.

Alle Hierarchien können erweitert werden. Bestimmte Eigenschaften und Einstellungen gelten für alle Typen von Metaobjekten. Diese werden im Anschluss erläutert. In Unterkapiteln wird anschließend auf die spezifischen Eigenschaften der verschiedenen Objekttypen (Überschriften, Daten, Berichte, Verknüpfungen, Ausgabe, Diagramm) eingegangen.

Allgemeine Optionen der Metaobjekte

EigenschaftBeschreibung
ObjektnameDer Objektname bestimmt den Namen des Objektes. Der Objektname setzt sich aus Präfix + Hersteller (_D_) / Kunden (_U_) Definition + Objektname zusammen. Das Präfix ist abhängig davon, in welcher Baumstruktur das Metaobjekt eingetragen wird. Folgende Präfixe werden verwendet:
- Inventar (EXP)
- Datenimport (IMP)
- Lizenzen (LIC)
- IT-Sicherheit (RIG)
- Dokumentation (DOC)

Beispiel: Ein neues Objekt für eine Überschrift im Inventarbaum (z.B. Service Level Agreement) erhält folgenden Namen: EXP_U_SLA
KategorieKategorie bzw. Typ eines Objektes (Überschrift, Daten, Bericht, Verlinkung, Ausgabe oder Diagramm)
TexteSichtbarer Name für das Objekt in jeweils Deutsch oder Englisch (sichtbar im Baum nur bei Überschriften)
PrioritätWenn mehrere Metaobjekte in einer Ebene angelegt werden, bestimmt nicht eine alphabetische Sortierung die Reihenfolge, sondern die Zahl im Feld Priorität. So hat z.B. das Metaobjekt Server unter einer Domäne eine höhere Zahl als das Metaobjekt Arbeitsstationen.
AusrichtungDie Art der Ausrichtung der Ergebnisse in der Liste auf der rechten Seite in Docusnap.
Objecttyp IDEindeutige ID für ein Metaobjekt. Diese IDs werden von Docusnap automatisch vergeben. Prinzipiell sind alle IDs unter 1.000.000 für herstellerseitige Definitionen reserviert.
Standard IconDefinition des Icons, das vor den Objekten im Baum angezeigt wird.
Vorschau IconDefinition des Icons, das für die Erstellung der Diagramme verwendet wird. Wenn durch Customizing eigene Objekte angelegt werden, empfiehlt es sich auch Icons mit der Größe 100x100 px zu verwendet werden, damit alle Icons ein einheitliche Größe haben.
DokumentpfadMit Hilfe dieser Eigenschaft können externe Dokumente wie z.B. Word- oder HTML-Dokumente in die Hierarchie verlinkt werden. Docusnap überprüft automatisch bei der Selektion eines Objektes, ob Dokumente in diesem Pfad vorhanden sind. Wenn Dokumente gefunden werden, werden diese in einer eigenen Registerkarte Dokumente im Docusnap-Datenbereich angezeigt.
Der Pfad in dieser Eigenschaft wird immer relativ zum Dokumentationsverzeichnis angegeben. Um Pfade flexibel bilden zu können, können in der Pfadangabe Variablen verwendet werden. Folgende Variablen stehen zur Verfügung:

%Account%: Firmenname
%Domain%: Domainname
%Object%: Objektname
%ParentObject%: Objektname des übergeordneten Knotens

Docusnap erweitert jeden Pfad automatisch mit dem Kürzel _EN.html bzw. _DE.html, um die Dateinamen zu komplementieren.

Beispiel:
Die Angabe %Account%%Domain%\Datasheets\Workstations%Object%%Object% wird, falls das Dokumentationsverzeichnis auf c:\Doku gesetzt ist, auf folgende Datei gesetzt:
c:\Doku\Docusnap AG\test.local\Datasheets\Workstations\Notebook1\Notebook1_de.html
NamespaceBeim Anlegen neuer Knoten kann im Kombinationsfeld ein Namespace eingetragen oder ein bestehender Namespace ausgewählt werden. Durch den Namespace kann beim Export der benutzerdefinierten Knoten definiert werden, welche Knoten exportiert werden sollen. Wenn für einen Knoten ein Namespace gesetzt wurde, kann bei den untergeordneten Knoten nur dieser Namespace gewählt werden. Diese Einschränkung ist notwendig, um die Vollständigkeit des Baumes im exportierten Customizing zu bewahren. Wenn für einen Knoten der Namespace geändert wurde, werden auch alle untergeordneten Knoten, diesem Namespace zugeordnet.
Anzeige ohne SubknotenObjekte vom Typ dieses Metaobjektes werden auch angezeigt, wenn keine weiteren Daten unterhalb des Objektes vorhanden sind. Docusnap blendet standardmäßig Objekte aus, unter denen keine Daten enthalten sind. Das Aktivieren dieser Option bewirkt ebenfalls eine Performancesteigerung, da in diesem Fall Überprüfungen entfallen können.
Nicht vergleichenDer Docusnap-Datenvergleich ignoriert Objekte, bei denen diese Option aktiviert ist. Objekte auf unteren Ebenen werden ebenfalls nicht mehr miteinander verglichen.
BerichtstitelBei der Ausführung eines Berichtes wird das erste Objekt, das höher in der Hierarchie liegt und bei dem diese Option aktiviert ist, als Untertitel für den Bericht verwendet.
Statisches ObjektDurch diese Option werden für ein bestimmtes Metaobjekt die Erweiterungen (z.B. Kommentare, Passwörter usw.) freigegeben.
Werden für ein benutzerdefiniertes Objekt Einträge im Baum erstellt, können diese nur gelöscht werden, wenn die Option Statisches Objekt aktiviert wurde.