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

So öffnen Sie das Dialogfenster "Export-Optionen":
- Wählen Sie im Start-Menü den Befehl
Programm |
Datenexport....
- Markieren Sie ein Export-Kriterium und/oder wählen Sie die Schaltfläche Neues Kriterium bzw. Kriterium bearbeiten.
- Wählen Sie die Schaltfläche Optionen... im Dialogfenster Exportkriterium <Name> bearbeiten.
- Um Daten exportieren zu können, müssen Sie über die Berechtigung Datenexport in der Kategorie System verfügen.
- 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. - 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. - 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.
- 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) - 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 - 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. - 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.

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... |
Diese Option berücksichtigt nur solche Datensätze, die seit dem angegebenen Datum geändert wurden. |
Nur Datensätze, die geändert wurden ab... |
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. |

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

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. |
Anführungszeichen innerhalb Anführungszeichen |
Legt das Zeichen fest, das als Anführungszeichen zu verwenden ist, wenn dieses sich innerhalb anderer Anführungszeichen befindet. |
Feldinhalte immer in Anführungszeichen |
Legt fest, dass Feldinhalte generell in Anführungszeichen exportiert werden. |
Zeilenumbruch-Format |
Legt fest, welches Format der Zeilenumbruch in der Exportdatei haben soll. Folgende Werte stehen zur Verfügung: |
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. |

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

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

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

In diesem Beispiel werden nur Datensätze exportiert, die seit dem 4.7.2022 geändert wurden.
Zugehörige Dokumentdateien werden in das Verzeichnis c:\export\dokumente kopiert und dekomprimiert.