Export-Optionen festlegen

Neben Feldern und Suchkriterien können weitere Optionen für einen Datenexport festgelegt werden (z.B. der Änderungs-Zeitraum berücksichtigter Datensätze oder die Behandlung von zugehörigen Dokument-Dateien).

• Der Datenexport steht nur zur Verfügung, wenn das Modul Import/Export eingesetzt wird.

Anleitung

So bearbeiten Sie Suchkriterien für den Export:

• Stellen Sie sicher, dass das Dialogfenster Export-Optionen für das gewünschte Export-Kriterium geöffnet ist!
• Legen Sie im Reiter Zeitliche Auswahl fest, ob Datensätze abhängig vom letzten Änderungsdatum berücksichtigt werden sollen und ob , bei Verwendung der Versionskontrolle, auch unterschiedliche Versionen berücksichtigt werden sollen.
  Standardmäßig spielt das Änderungsdatum keine Rolle und es wird nur die aktuelle Version aller Datensätze berücksichtigt.
Wie wird die "Zeitliche Auswahl" festgelegt?

Feld	Bedeutung
Alle selektierten Datensätze	Diese Option berücksichtigt alle Datensätze, unabhängig vom letzten Änderungsdatum (Standard).
Nur Datensätze, die geändert wurden ab... dem Datum	Diese Option berücksichtigt nur solche Datensätze, die seit dem angegebenen Datum geändert wurden.
Nur Datensätze, die geändert wurden ab... dem letzten Export	Diese Option berücksichtigt nur solche Datensätze, die seit dem letzten Export auf Basis desselben Export-Kriteriums geändert wurden. Diese Option steht nur zur Verfügung, wenn bereits ein Export auf Basis dieses Export-Kriteriums durchgeführt wurde. In diesem Fall wird das Exportdatum automatisch vorgegeben.
Anzahl Versionen	In diesem Feld kann die Anzahl an Versionen eines Datensatzes angegeben werden, die beim Export berücksichtigt werden sollen. Ohne Angabe wird immer nur die aktuellste Version berücksichtigt. Bei Angabe einer Anzahl wird immer die aktuellste Version plus entsprechend viele direkt vorangegangene Versionen berücksichtigt. Diese Option steht nur zur Verfügung, wenn das Modul Versionskontrolle eingesetzt wird. Wenn Sie mehrere Version exportiert haben und diese wieder importieren wollen, müssen Sie beachten, dass die einzelnen Versionen jeweils als neue Version des Datensatzes importiert wird. Die Reihenfolge ergibt sich dabei aus der sequenziellen Anordnung in der Importdatei (die letzte enthaltene Version wird zur neuesten, aktuellsten Version).

• Legen Sie im Reiter Dokumentdateien fest, ob Dokumentdateien exportierter Datensätze ebenfalls exportiert werden sollen und wie das geschehen soll.
  Standardmäßig werden Dokumentdateien nicht exportiert.
Wie wird die Behandlung von "Dokumentdateien" festgelegt?

Feld	Bedeutung
Dokumentdateien kopieren nach	Dokumentdateien von exportierten Datensätzen werden ebenfalls exportiert, wenn an dieser Stelle der Speicherpfad angegeben wird. Der Speicherpfad muss existieren, er wird vom Export nicht automatisch angelegt. Für einen späteren Import wird neben den internen Feldern _DateiID und _Dateispeicher auch der vollständige Pfad der exportierten Dokumentdatei in ein Extrafeld _Datei der Exportdatei geschrieben.   Ohne Angabe eines Pfades werden Dokumentdateien grundsätzlich ignoriert.
Dateien dekomprimieren	Exportierte Dokumentdateien werden im Dateispeicher komprimiert abgelegt. Mithilfe von Dateien dekomprimieren werden exportierte Dokumentdateien automatisch dekomprimiert und damit in einem Unterverzeichnis "lesbar" gespeichert. Für dekomprimierte Dateien wird neben den oben genannten Feldern auch das Feld _Hauptdatei exportiert. Wenn die exportierten Daten von einem anderen Programm verarbeitet werden sollen, muss diese Option gesetzt werden, da andere Programme in der Regel nicht mit der komprimierten Form der IQ-Dateispeicherung umgehen können.

• Legen Sie im Reiter Dateiformatierung fest, wie die Exportdatei formatiert werden soll.
Wie wird die Formatierung für eine CSV-Datei festgelegt?

Feld	Bedeutung
Felder-Trennzeichen	Legt das Zeichen fest, welches zur Trennung der einzelnen Feldinhalte in die Exportdatei eingetragen wird. Als Standard wird das Zeichen ^ verwendet. Generell können beliebige Zeichen oder Zeichenkombinationen für den Export verwendet werden. Sie müssen jedoch darauf achten, dass solche Zeichen unter Umständen auch innerhalb der Feldinhalte vorkommen können! Wenn die Daten auch wieder von regisafe importiert werden sollen, sind allerdings nur die folgenden Zeichen erlaubt: # , ; / @ ^ (vor und/oder nach dem Zeichen darf maximal ein Leerzeichen stehen).
Anführungszeichen	Legt das Zeichen fest, das als Anführungszeichen zu verwenden ist. Ohne Angabe wird standardmäßig " (= #34) verwendet. Generell können beliebige Zeichen oder Zeichenkombinationen verwendet werden. Sie müssen jedoch darauf achten, dass solche Zeichen unter Umständen auch innerhalb der Feldinhalte vorkommen können! Wenn die Daten auch wieder von regisafe importiert werden sollen, ist allerdings nur der Standardwert erlaubt.
Anführungszeichen innerhalb Anführungszeichen	Legt das Zeichen fest, das als Anführungszeichen zu verwenden ist, wenn dieses sich innerhalb anderer Anführungszeichen befindet. Ohne Angabe wird standardmäßig \" verwendet. Generell können beliebige Zeichen oder Zeichenkombinationen verwendet werden. Sie müssen jedoch darauf achten, dass solche Zeichen unter Umständen auch innerhalb der Feldinhalte vorkommen können! Wenn die Daten auch wieder von regisafe importiert werden sollen, ist allerdings nur der Standardwert erlaubt.
Feldinhalte immer in Anführungszeichen	Legt fest, dass Feldinhalte generell in Anführungszeichen exportiert werden. Ohne diese Option werden Anführungszeichen nur verwendet, wenn im Feldinhalt das festgelegte Trennzeichen (siehe oben) vorkommt.
Zeilenumbruch-Format	Legt fest, welches Format der Zeilenumbruch in der Exportdatei haben soll. Folgende Werte stehen zur Verfügung: Windows Internes Format: \r\n Vorgabe für CSV-Dateien IQ Internes Format: || Mac (alt) Internes Format: \r Unix/Linux Internes Format: \n (entspricht auch dem aktuellen Mac-Format)
Felder-Trennzeichen in Feldinhalten ersetzen	Sobald das unter Felder-Trennzeichen festgelegte Trennzeichen (z.B. '@') in einem zu exportierenden Feldinhalt vorkommt, wird das Trennzeichen dort automatisch durch einen Code ersetzt, der sich zusammensetzt aus '&0x', gefolgt vom Hex-Code des Trennzeichens und einer eckigen Klammer ']'. Der Feldinhalt 'maier@regisafe.de' würde demnach als 'maier&0x40]regisafe.de' exportiert.   Durch dieses Vorgehen kann das Trennzeichen nicht mehr in Feldinhalten vorkommen und Fehler beim Weiterverarbeiten der Exportdatei werden somit vermieden. Beim Re-Import solcher CSV-Dateien in regisafe werden entsprechende Ersetzungen automatisch wieder zurückgesetzt.   Diese Option ist als Vorgabe aktiviert.

Wie wird diese Formatierung für eine XML-Datei festgelegt?

Feld	Bedeutung
Wohlgeformte XML-Datei erstellen	Standardmäßig ist diese Option nicht aktiviert. Dadurch werden die Einträge in der Form <Schlüssel>Wert</Schlüssel> in die XML-Datei geschrieben. Da die Schlüssel in einer IQ-Datenbank auch Umlaute enthalten oder mit Unterstrichen und Ziffern beginnen, können auf diese Weise XML-Dateien entstehen, welche nicht allen XML-Regeln entsprechen (= nicht wohlgeformt sind). Wenn diese Option aktiviert ist, werden die Einträge dagegen in der Form <Item Name="Schlüssel">Wert</Item> in die XML-Datei geschrieben, wodurch generell wohlgeformte XML-Dateien entstehen, die somit z.B. in allen XML-Browsern problemlos angezeigt werden können.   Der Datenbank-Import in eine IQ-Datenbank verarbeitet beide Varianten, kommt also auch mit nicht wohlgeformten XML-Dateien zurecht.
Zeilenumbruch-Format	Legt fest, welches Format der Zeilenumbruch in der Exportdatei haben soll. Folgende Werte stehen zur Verfügung: Unix/Linux Internes Format: \n Vorgabe für XML-Dateien, entspricht auch dem aktuellen Mac-Format Windows Internes Format: \r\n IQ Internes Format: || Mac (alt) Internes Format: \r

Wie wird diese Formatierung für eine JSON-Datei festgelegt?

Feld	Bedeutung
Leerzeichen nach ':'	Standardmäßig fügt regisafe beim Export in das JSON-Format ein Leerzeichen nach einem Doppelpunkt ein. Dieser Effekt kann bei Bedarf hier deaktiviert werden.
Zeilenumbruch-Format	Legt fest, welches Format der Zeilenumbruch in der Exportdatei haben soll. Folgende Werte stehen zur Verfügung: Unix/Linux Internes Format: \n Vorgabe für JSON-Dateien, entspricht auch dem aktuellen Mac-Format Windows Internes Format: \r\n IQ Internes Format: || Mac (alt) Internes Format: \r

• Legen Sie im Reiter Weitere Optionen fest, ob Sie einen zeitgesteuerten Export ausführen wollen, ob Sie Angaben zu Datentypen und Feldtypen exportieren wollen und ob anschließend ein weiterer Export automatisch durchgeführt werden soll.
  In der Regel benötigen Sie höchstens die Zeitsteuerung. Die übrigen Optionen wurden nur in Zusammenhang mit älteren regisafe-Versionen gebraucht.
Wie werden "Weitere Optionen" eingegeben?

Feld	Bedeutung
Datensatztypen exportieren	Trägt Angaben zu den enthaltenen Datensatztypen in die Exportdatei ein. Zu diesem Zweck werden die Felder DS_TYPNAME und DS_FELDER in die Kopfzeile eingefügt. Pro Datensatztyp wird darunter je eine Zeile eingefügt, die den Namen des Datensatztyps und dahinter alle Felder des Datensatztyps mit Feldtypen enthält. Die einzelne Felder werden durch Leerzeichen getrennt. Zusätzlich erscheinen die beiden Felder am Anfang jeder Datensatzzeile. Bei normalen Datensätzen sind diese Felder allerdings leer.   Diese Option ist nur für einen späteren Import sinnvoll, bei dem die Zieldatenbank die Datensatztypen noch nicht enthält. Mithilfe dieser Export-Option können die Datensatztypen beim Import automatisch registriert werden. Diese Option steht bei einem Export in das XML- oder JSON-Format nicht zur Verfügung
Feldtypen exportieren	Trägt bei einem Export im CSV-Format in die Kopfzeile neben den Datenfeldnamen auch den Feldtyp ein. Beispiel: Betreff[Text250]   Bei einem Export im XML-Format werden bei gesetzter Option die Feldtypen innerhalb des XML-Tags als Attribute in Textform eingetragen (in Zahlenform werden sie immer hinzugefügt).
Dateigröße	Legt die maximale Größe einer Exportdatei fest (in MB, nur ganze Zahlen sind erlaubt). Wenn die zu exportierenden Daten mehr als die angegebene Dateigröße benötigen, werden mehrere Exportdateien erstellt. Der minimale Wert der Dateigröße beträgt 16 MB. Wird keine Dateigröße festgelegt, gilt 50 MB als maximale Größe.
Weiterer Export	Hier kann ein Export-Kriterium angegeben werden, das im Anschluss an den Export zur Ausführung eines weiteren Exports verwendet wird.
Zeitsteuerung	Dieser Export soll zeitgesteuert ausgeführt werden. Geben Sie hier an, wann der Export durchgeführt werden soll (z.B. MO-FR=23:00).   Diese Option steht nur zur Verfügung, wenn das Modul QDataAdmin auf dem IQ-Server eingebunden ist. Grund: Ein zeitgesteuerter Import kann ausschließlich auf dem Server durchgeführt werden. Alle geänderten oder neu definierten, zeitgesteuerten Export-Kriterien werden sofort aktiviert, wenn sie in der Benutzeroberfläche des IQ-Servers bearbeitet wurden. Wenn sie dagegen in der Benutzeroberfläche des regisafe-Clients bearbeitet wurden, muss zur Aktivierung der IQ-Server neu gestartet oder der tägliche Aktivierungslauf um 02:20 Uhr abgewartet werden.

• Speichern Sie Ihre Export-Optionen mit OK.