Paket erstellen

Paket erstellen

Das Erstellen und Verwalten von Docusnap Connect Paketen erfolgt im Bereich Connect. Dieser Bereich kann über die Navigationsleiste aufgerufen werden.

Neues Paket erstellen

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.

Docusnap Objekte

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.

-Element: Im Kombinationsfeld Element wird das Objekt ausgewählt, dessen Daten exportiert werden sollen.

-Spalte: Durch Klick in ein Feld in der Liste Spalte werden die Spalten der ausgewählten Objekte angezeigt und können ausgewählt werden. Wenn eine Spalte nicht mehr benötigt wird, muss diese Zeile ausgewählt werden und durch Klick auf die Schaltfläche Eintrag löschen oder über die Taste Entfernen gelöscht werden.

-Alias: In der Spalte Alias kann die Bezeichnung der Spalten in der exportierten Tabelle angegeben werden. Jeder Name in der Spalte Alias muss eindeutig sein.

-Anzeigen: Durch das Kontrollkästchen Anzeigen wird bestimmt, ob eine Spalte in der exportierten Tabelle angezeigt werden soll. Dadurch können Felder, die nur für die Filterung der Daten benötigt werden, ausgeblendet werden.

-Referenz verwenden: Bei Spalten, für die eine Referenz hinterlegt wurde, kann auch beim Export die Referenz ausgegeben werden. Wenn das Kontrollkästchen Referenz verwenden aktiviert wurde, wird die Zahl in der Spalte durch den jeweiligen Referenztext ersetzt. Beim Export kann ausgewählt werden, in welcher Sprache die Referenzen geschrieben werden sollen.

-Gruppierung: Bei der Gruppierung kann ausgewählt werden, ob die Daten nach dieser Spalte gruppiert werden sollen oder ob die Anzahl, das Maximum, das Minimum, die Summe oder der Durchschnitt der Spalte berechnet werden soll.

-Reihenfolge: Über die Liste Reihenfolge kann die Reihenfolge der Spalten definiert werden.

-Filter: In diesem Feld sind alle zulässigen SQL-Bedingungen erlaubt (z.B. = 1). Um die Spalte, nach der gefiltert wird, nicht anzuzeigen, kann in der Liste Anzeigen das Kontrollkästchen deaktiviert werden. Die Klausel kann durch weitere Felder oder Bedingungen erweitert werden. Auf eine andere Spalte kann der Filter nur über den Alias zugreifen. Dieser muss mit {Alias:Aliasname der Spalte} angegeben werden.

-Nur Datensätze ausgeben, die dem Filterkriterium entsprechen: Diese Option wird direkt bei der Tabelle gesetzt. Diese Option legt fest, ob Daten nur angezeigt werden, wenn sich in allen angegebenen Knoten entsprechende Daten befinden. Wenn diese Option nicht aktiviert ist und beispielsweise für Arbeitsstationen die inventarisieren Drucker ausgegeben werden sollen, dann werden zusätzlich auch Arbeitsstationen ausgegeben, für die kein Drucker gefunden wurde. Wenn die Option aktiviert ist, werden in diesem Beispiel nur Arbeitsstationen gelistet, für die ein Drucker inventarisiert wurde. Diese Option wird vor allem dann benötigt, wenn eine Gruppierung verwendet und auf diese gefiltert wird. Damit der angegeben Filter auf alle Daten angewendet wird, muss die Option aktiviert werden. Andernfalls werden nur die Daten vom Knoten gefiltert und die Daten der anderen Knoten werden alle ausgegeben. Zum Beispiel kann in der Gruppierung das neuste Installationsdatum gesucht werden und dann gefiltert werden, dass nur Systeme gelistet werden, deren letztes Update vor mehr als 90 Tagen war.

Statische Felder

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.

Weitere Tabellen

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 den Tabellennamen 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.

Vorschau (Test)

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.

Union

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.

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 mehrere Unions verwendet werden, werden die Definitionen dadurch übersichtlicher.

Benutzerdefinierte Objekte

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.