Datenexport

Die Funktion Datenbank-Export ermöglicht es, sämtliche regisafe-Objekte (bzw. Teile davon) in eine auch von anderen Programmen lesbare Datei zu schreiben. Welche Objekte exportiert werden und in welcher Form dies geschehen soll, kann mithilfe sogenannter Export-Kriterien festgelegt werden. Dabei ist eine Mehrfach-Auswahl möglich. Bei der daraufhin erzeugten Export-Datei handelt es sich um eine CSV-, XML oder JSON-Datei.

Die Export-Funktion verfügt zusätzlich über die Möglichkeit, beim Export von Dokumenten die zugehörigen Dokument-Dateien (z.B. Word-Dateien) in ein Verzeichnis kopieren zu lassen. Die Selektion der zu exportierenden Objekte erfolgt durch die Angabe von bis zu 6 verschiedenen Suchkriterien, ähnlich der "erweiterten Suche" in regisafe. Zusätzlich kann der Export vom Änderungsdatum eines Objekts abhängig gemacht werden (z.B. für einen Datenabgleich).

Exportdatei im CSV-Format

Die CSV-Datei enthält in der Kopfzeile die Namen aller Felder, die in der Exportdatei berücksichtigt sind. Die einzelnen Felder des Datensatzes sind jeweils durch ein Trennzeichen, z.B. ein "Dach" (^), voneinander getrennt.
Unterhalb der Kopfzeile folgt pro Zeile genau ein Datensatz, für den die Feldinhalte auf Basis der Kopfzeile zwischen den Trennzeichen eingetragen sind.

In der Kopfzeile sind die via Export-Kriterium ausgewählten Datenbankfelder aufgeführt:

  • OBJTYP

    Dieses "Feld" bezeichnet den Datensatztyp (in diesem Fall: Sitzungen). Meist wird nur ein einziger Datensatztyp exportiert. In diesem Fall ist die Angabe OBJTYP überflüssig.
  • ^

    Beim Zeichen ^ handelt es sich um das Trennzeichen, das die einzelnen Felder voneinander trennt. Das Trennzeichen kann aus einer Reihe vorgegebener Zeichen ausgewählt werden. Bei der Auswahl ist darauf zu achten, dass das Trennzeichen zur Vermeidung von Problemen nicht in Feldinhalten vorkommen sollte.
  • Benutzer, Farbe, ObjID usw.

    Bei diesen Namen handelt es sich um die Namen der Datenbankfelder, die zum einen für den betreffenden Datensatztyp zur Verfügung stehen und zum anderen via Export-Kriterium ausgewählt wurden.

In den anschließenden Zeilen ist jeweils genau ein Datensatz nach folgenden Regeln enthalten:

  • Die Anzahl und die Reihenfolge der Felder entspricht immer genau der Vorgabe aus der Kopfzeile.
  • Das Trennzeichen ist dasselbe, wie es in der Kopfzeile vorgegeben ist.
  • Die Feldinhalte werden jeweils als lesbarer Text eingetragen.
    Einige Felder enthalten statt "lesbarem Klartext" einen nur in der entsprechenden regisafe-Umgebung verwendbaren Objektschlüssel (z.B. Berechtigungen im Feld _Rechte)
  • Für Felder, die im betreffenden Datensatz ohne Inhalt sind, bleibt der Raum zwischen den Trennzeichen leer.

Exportdatei im XML-Format 

Die XML-Datei enthält im Gegensatz zur CSV-Datei keine Kopfzeile. Stattdessen werden die einzelnen Datensätze strukturiert nach XML-Konventionen eingetragen - die zugehörigen Felder werden jeweils mit Namen und Inhalt in Form einzelner "Tags" aufgelistet.
Diese Form der Darstellung entspricht dem üblichen XML-Schema. Auf Wunsch sorgt regisafe auch dafür, dass die XML-Datei den Anforderungen an eine "wohlgeformte" XML-Datei entspricht.

In einer "wohlgeformten" XML-Datei sind Datensätze wie folgt aufgeführt:

  • <IQDaten>
    Alle exportierten Datensätze sind unter dem Tag IQDaten zusammengefasst.
  • <Item Name="Sitzungen" nTyp="14">
    Einzelne Datensätze, jeweils gruppiert nach dem Datensatztyp (hier: "Sitzungen")
  • <Item Name="FELDNAME" nTyp="X">
    Gruppiert unterhalb der Datensatz-Kennung befinden sich die Namen und Werte der Datenbankfelder, die zum einen für den betreffenden Datensatztyp zur Verfügung stehen und zum anderen via Export-Kriterium ausgewählt wurden.
  • Die Feldinhalte werden jeweils als lesbarer Text eingetragen.
    Einige Felder enthalten statt "lesbarem Klartext" einen nur in der entsprechenden regisafe-Umgebung verwendbaren Objektschlüssel (z.B. Berechtigungen im Feld _Rechte)

In einer "nicht wohlgeformten" XML-Datei sind Datensätze wie folgt aufgeführt: 

  • <IQDaten>

    Alle exportierten Datensätze sind unter dem Tag IQDaten zusammengefasst.
  • <Sitzungen nTyp="14">
    Einzelne Datensätze, jeweils gruppiert nach dem Datensatztyp (hier: "Sitzungen")
  • <FELDNAME nTyp="X">
    Gruppiert unterhalb der Datensatz-Kennung befinden sich die Namen und Werte der Datenbankfelder, die zum einen für den betreffenden Datensatztyp zur Verfügung stehen und zum anderen via Export-Kriterium ausgewählt wurden.
  • Die Feldinhalte werden jeweils als lesbarer Text eingetragen.
    Einige Felder enthalten statt "lesbarem Klartext" einen nur in der entsprechenden regisafe-Umgebung verwendbaren Objektschlüssel (z.B. Berechtigungen im Feld _Rechte)
  • regisafe kann sowohl wohlgeformte als auch nicht wohlgeformte XML-Dateien importieren. Daher müssen die XML-Dateien für den Import nicht zwingend wohlgeformt sein. Der regisafe-Datenexport erlaubt aber den Export in eine wohlgeformte XML-Datei, um damit die Verwendung durch andere Programme zu erleichtern (z.B. auch die Anzeige in einem Internet-Browser).

Exportdatei im JSON-Format 

Die JSON-Datei ähnelt im Wesentlichen dem XML-Format, berücksichtigt aber die besonderen Anforderungen von JavaScript. Nähere Informationen erhalten Sie bei Bedarf über den regisafe-Support.

Dokumentdateien

Beim Export von Dokumenten kann als zusätzliche Option ein Verzeichnis angegeben werden, in das alle zugehörigen Dokumentdateien exportiert werden - wahlweise komprimiert oder dekomprimiert. Zur Verwendung in anderen Programmen muss hier in jedem Falle die dekomprimierte Variante ausgewählt werden. In der Exportdatei wird das individuell festgelegte Exportverzeichnis für einen späteren Import in ein spezielles Datenfeld eingetragen.