====== Datenexport======
In Verbindung mit dem Personalmanagement gibt es in HANSALOG flexible Möglichkeiten Daten zu exportieren. \\

Für den Export von Daten sind folgende Informationen relevant: \\
\\
__ **Allgemeine Informationen**__  \\ 
Grundsätzlich besteht ein Datenexport immer zunächst aus einem Selektionskriterium und einer Schnittstellendefinition. \\
In dem Selektionskriterium wird definiert, welche Daten exportiert werden sollen. Hier wird z.B. geprüft, dass nur aktive Mitarbeiter exportiert werden oder ggfs. nur Datensäte, wo heute eine Änderung im Personalstamm stattgefunden hat. \\
In der Schnittstellendefinition werden die Felder für den Export definiert. Hierbei gibt es die Möglichkeit unterschiedliche Satzarten zu hinterlegen. Damit könnte z.B. eine Satzart "KOPF" mit einer Überschriftenzeile und im Anschluss eine Satzart "DATEN" mit den Daten eingestellt werden.\\

__ **Grundsätzlicher Ablauf**__  \\
Der Datenexport erfolgt immer auf Basis des Selektionskriteriums, welches zunächst die zu exportierenden Daten ermittelt. \\
Die zeitliche Taktung des Exports kann frei definiert werden. Es könnte bspw. täglich, wöchentlich oder auch nur einmal im Monat erfolgen. \\
Beim Export werden immer die in dem Moment gültigen Daten aus dem System exportiert. Es gibt keine Funktion für eine Delta-Bildung mit dem zuletzt durchgeführten Export. \\

__ **Welche Daten werden exportiert?**__ \\
Prinzipiell können nahezu alle Daten aus HANSALOG in einem Export selektiert werden. Häufigstes Anwendungsgebiet sind die Mitarbeiterstammdaten.  \\

__ **Aufbau der Datei und Dateiformate**__ \\
Für den Export der Daten können aktuell die Formate Variabel(in der Regel CSV), JSON oder ein fester Satzaufbau ausgewählt werden. \\
Für den Zeichensatz stehen ANSI, UTF-8, UTF-8(Java), UTF16, UTF-16BE und UTF-16LE zur Auswahl. \\
Bei der Verwendung von "Variablen" können das Trennzeichen und auch die Feldüberschriften definiert werden. Bei einem festen Satzaufbau werden die Positionen der einzelnen Felder gesteuert. \\
Grundsätzlich kann der Aufbau der Datei - die Reihenfolge/Anordnung der Felder - flexibel eingestellt werden. \\

__ **Übertragungswege**__ \\
Für die Übertragung kann entweder mit einer Ablage der Datei auf dem Server oder dem Aufruf einer URL bzw. API gearbeitet werden. \\
Bei der Ablage auf dem Server können das Verzeichnis und der Dateiname vorgegeben werden. Zudem kann definiert werden, ob ein Zeitstempel an den Dateinamen angehängt werden soll und ob die vorhandene Daten fortgeschrieben oder jeweils eine neue erstellt werden soll. \\
Bei der Übertragung via API wird zunächst die gewünschte URL sowie Benutzername/Passwort bzw. Token für das Login benötigt. Darüber hinaus kann die Methode des Aufrufs (PUT oder POST) hinterlegt werden. \\
Nicht möglich ist derzeit, dass sich der Datenexport zunächst an der API authentifiziert und mit einem dort generierten Token das Login durchführt. Dies hat den Hintergrund, dass aktuell bei einem Export via API nur ein Aufruf der API erfolgt. \\

__ **Beispielhafter Dateiaufbau**__ \\
In den meisten Fällen wird für den Export von Daten entweder CSV oder JSON als Format verwendet. In der Folge werden nun jeweils ein kleines Beispiel für diesen beiden Formate dargestellt. Dabei werden die folgenden Felder exportiert: Mitarbeiternummer, Vorname, Nachname, E-Mail Adresse, Telefonnummer, Organisationseinheit, Standort, Funktion, Eintrittsdatum. 
Daraus ergeben sich bspw. folgende Beispiele: \\

Format: JSON \\
Schnittstelle: Muster\\
Satzart: Daten\\
<code>
{"Muster": [
{ "DATEN": [
{
"Mitarbeiternummer": "10077", 
"Vorname": "Klaus",
"Nachname": "Hansalog", 
"E-Mail Adresse": "info@hansalog.de", 
"Telefonnummer": "05462-7650", 
"Organisationseinheit": "Buchhaltung", 
"Standort": "Ankum", 
"Funktion": "Betriebswirt", 
"Eintrittsdatum": "01.01.2010"}
]}]}

</code>

Format: CSV\\
Schnittstelle: Muster\\
Satzarten: Kopf und Daten\\
<code>
Mitarbeiternummer;Vorname;Nachname;E-Mail Adresse;Telefonnummer;Organisationseinheit;Standort;Funktion;Eintrittsdatum
10077;Klaus;Hansalog;info@hansalog.de;05462-7650;Buchhaltung;Ankum;Betriebswirt;01.01.2000

</code>