Paket bearbeiten

Durch Klick auf die Schaltfläche Paket bearbeiten in der Multifunktionsleiste Allgemein in der Gruppe Docusnap Connect wird die Registerkarte für die Konfiguration der DocusnapConnect-Pakete geöffnet.

Im Kombinationsfeld Paket werden alle definierten Connect Pakete aufgelistet. Nachdem ein Paket ausgewählt wurde, kann der Inhalt dieses Pakets konfiguriert werden.

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

Durch Klick auf die Schaltfläche Docusnap Objekte hinzufügen werden alle Einträge aus dem Explorer Inventar angezeigt. Über das Kontrollkästchen vor dem Eintrag werden die Daten ausgewählt, die exportiert werden sollen. Durch Klick auf die Schaltfläche Speichern wird der Dialog geschlossen und die Spalten der ausgewählten Objekte können verwendet werden.

• 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.
• Reihenfolge: Über die Liste Reihenfolge kann die Reihenfolge der Spalten definiert werden.
• 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.
• 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.

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

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 Arbeitsstationen

Definition der Server

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

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.

Damit Änderungen am Metaschema neu geladen werden, muss der Administrationsbereich verlassen werden und dann erneut der Administrationsbereich geöffnet werden. Anschließend stehen die Änderungen für das Connect Paket zur Verfügung.