Das Erstellen und Verwalten von Docusnap Connect Paketen erfolgt im Bereich Connect. Dieser Bereich kann über die Navigationsleiste aufgerufen werden.
Durch Klick auf die Schaltfläche Neu wird ein neuen Docusnap Connect Paket erstellt. Im Anschluss wird der Titel, Text Deutsch und Text Englisch befüllt und die Angaben gespeichert.
In der Liste Tabellenname werden alle bereits definierten Tabellen angezeigt. Beim ersten Öffnen eines Pakets wird bereits eine leere Tabelle angelegt. Im Feld Tabellenname wird der Name eingegeben, den die Tabelle nach dem Export erhalten soll.
Die Objekte, welche die zu exportierenden Daten enthalten, müssen ausgewählt werden. Durch Klick auf Docusnap Objekte hinzufügen wird dazu die bereits bekannte Baumstruktur eingeblendet und ermöglicht eine Navigation und Auswahl der Informationen.
Wenn Daten einer Inventarisierung ausgewählt werden, werden immer nur die aktuellen Daten der letzten Inventarisierung exportiert. |
Zusätzlich können zu den Werten aus der Tabelle auch statische Werte mit exportiert werden. Durch Klick auf die Schaltfläche Statische Felder hinzufügen wird der Dialog für die statischen Felder geöffnet. Der angegeben Name wird als Spaltenüberschrift verwendet und der Wert wird in der Tabelle angegeben. Sobald ein statischer Wert angelegt wird, wird er beim Export berücksichtigt. Nicht mehr benötigte Werte können durch Klick auf die Schaltfläche Löschen wieder entfernt werden.
Um mehrere Tabellen zu exportieren, können über die Schaltfläche Neu weitere Tabellen hinzugefügt werden, für die die Daten konfiguriert werden. Durch Klick auf die den Tabellenname wird dieser ausgewählt und kann geändert werden. Wenn nach dem Export in eine Datenbank die Daten der unterschiedlichen Tabellen verknüpfen zu können, sollten die Primär- und Fremdschlüssel zusätzlich ausgewählt werden.
Nachdem die Objekte und Spalten ausgewählt wurden, kann durch Klick auf die Schaltfläche Vorschau (Test) die Ausgabe der Tabelle kontrolliert werden. Standardmäßig werden die ersten zehn Datensätze der Tabelle in der Vorschau ausgegeben. Im Feld Datensätze begrenzen auf kann diese Anzahl verändert werden.
Beim Export der Daten wird eine zusätzliche Spalte ONC ausgegeben. Durch diese Spalte wird ein Objekt eindeutig identifizierbar, um bei der Aktualisierung der SQL-Datenbank die Objekte zuordnen zu können. Diese Spalte wird auch für DocusnapLink verwendet, um aus einer anderen Anwendung zu diesem Knoten in Docusnap zu wechseln.
Die Exportzeit bei größeren Datenmenge kann wegen der rekursiven Abfrage für die Erstellung des ONCs erheblich erhöht sein. Wenn der ONC nicht benötigt wird, kann die Ausgabe des ONC mit der Option ONC anzeigen bei den Tabellen deaktiviert werden um die Performance zu verbessern.
Wenn beim Test des Exports ein Fehler auftritt wird dieser im unteren Bereich als Fehlermeldung ausgegeben.
Im unteren Bereich kann durch Klick auf die Schaltfläche ein Union erstellt werden. Der Union funktioniert wie ein Union in SQL. Dabei werden die Daten von verschiedenen Objekten in einer Tabelle zusammengefasst. Wenn für Spalten in den verschiedene Definitionen der gleiche Alias Name vergeben wird, werden die Daten in einer Spalte ausgegeben. Wenn es für eine Spalte keinen passenden Alias Namen in der anderen Definition gibt, bleibt diese Spalte bei den Einträgen der anderen Tabelle leer.
Beispielsweise kann der Union verwendet werden um die Systeme vom Knoten Arbeitsstationen und vom Knoten Server in einer Tabelle auszugeben.
Wenn eine UNION Spalte aus mehreren Spalten gebildet wird, dürfen diese nicht unterschiedliche Referenzen verwenden. Die Referenzen können Initialwerte, Referenzen auf Tabellen, Listen bei IT Assets, etc. sein. Es ist nicht möglich die Daten richtig aufzulösen, wenn Spalten mit unterschiedlichen Referenzen mit dem UNION in einer Spalte vereint werden. Wenn zwei Tabellen, die den UNION bilden, beispielsweise jeweils eine Spalte Typ haben, aber diese mit zwei verschiedenen Initialwerten übersetzt werden, dann können diese nicht in der gleichen Spalte ausgegeben werden. Um diese Daten ausgeben zu können, müssen diese im UNION mit verschiedenen Alias Namen als zwei Spalten ausgegeben werden. |
Definition der Server
Definition der Arbeitsstationen
In diesem Beispiel wurde ein Union hinzugefügt für den Knoten Server. Es wurden für die Spalten dieselben Namen vergeben. Dadurch werden die Daten der beiden Definitionen anschließend wie in der Vorschau ausgegeben.
Durch Doppelklick auf bzw. kann ein andere Name angegeben werden. Vor allem wenn mehrerer Unions verwendet werden, werden die Definitionen dadurch übersichtlicher.
Benutzerdefinierte Objekte und Tabellen können mit Docusnap Connect exportiert werden. Wurde eine eigene Tabelle erstellt, für die ein Primär- und ein Fremdschlüssel definiert wurden, dann kann dieses Objekt exportiert werden. Wenn es sich um eine benutzerdefinierten Sicht handelt aus der die Daten exportiert werden sollen, müssen einige Punkte beachtet werden.
Das SQL Statement der Sicht muss während des Exports verändert werden, um für das Connect verwendet werden zu können. Au diesem Grund muss die Spalte, die für die Filterung auf {FilterID} verwendet wird, im Select Teil der Sicht enthalten sein. Dieser Wert wird dann mit dem Primärschlüssel des übergeordneten Objekts abgeglichen. Die Spalte muss den gleichen Namen haben, wie der Primärschlüssel der übergeordneten Tabelle oder Sicht, damit der Abgleich stattfinden kann. Das bedeutet zum Beispiel, wenn eine Sicht mit benutzerdefinierten Tabellen erstellt wurde, in der die Spalte xAccountID und nicht AccountID heißt, diese Sicht sich aber unterhalb der Docusnap Tabelle tAccounts befindet in der der Primärschlüssel AccountID heißt, müsste in der Sicht im Select Teil die xAccountID mit as AccountID umbenannt werden.