Administration Stammdaten
Für die Stammdaten wurde eine eigene Outbar angelegt. In der Regel werden Stammdaten aus dem führenden System importiert. Zu Beginn eines Projekts sollen möglichst schnell Stammdaten zur Verfügung stehen, damit schnell getestet werden kann. Aus diesem Grund können die Stammdaten manuell gepflegt werden. In einigen Projekten müssen spezifische Daten manuell gepflegt werden.
Stammdaten-Anzeige
Die Datenbank DEX_MasterData wird mit diversen Stammdaten-Tabellen ausgeliefert. Auf der Outbar "Stammdaten" werden im Standard diverse Stammdaten-Ordner ausgeliefert. Diese können je nach Bedarf im Projekt passend ein- und ausgeblendet werden. Am Ordner können neue Datensätze hinzugefügt werden und bestehende Datensätze können geändert werden.
Stammdaten-Import Konfigurieren
Zu Beginn eines Projekts sollen möglichst schnell erste Stammdaten zur Verfügung gestellt werden. Häufig können die Stammdaten in einer CSV-Datei zur Verfügung gestellt werden. Für die gängigsten Stammdaten werden vorgefertige CSV-Konfigurationen für die Datei-Import ausgeliefert. Auf dem Ordner "Stammdaten Import" öffnet sich eine Konfiguration für die CSV-Dateien. Pro Konfiguration müssen folgende Angaben gesetzt werden:
- Konfigurationsname
Eindeutige Bezeichnung der Konfiguration. - Tabellenname
Der technische Name der SQL Tabelle in der DEX_MasterData Datenbank. - SQL-Konfigurationsname
Wert für die Datenbank-Verbindung. Standardwert: "DEX_MasterData". - Dateipfad
Gibt den Pfad zur CSV-Datei an. Über %DEXPRO% wird der Pfad zum DEXPRO-Ordner in der Documents-Installation angegeben. Ein %FS% (Forward Slash) setzt automatisch den korrekten Trenner zwischen den Ordner-Angaben (Linux: / Windows: \) - Transkodierung ANSI -> UTF-8
Wenn eine CSV-Datei im ANSI Format geschrieben ist, muss der Text vor dem Import in UTF-8 umgewandelt werden.
Über das Stift-Symbol hinter den Einträgen können Einträge bearbeitet werden und über die Mülltonne können einzelne Konfigurations-Einträge gelöscht werden. Durch einen Klick auf einen Eintrag öffnet sich das Feld-Mapping zur Konfiguration.
Die CSV-Dateien müssen eine Kopfzeile mit Spaltenüberschriften haben. Jeder Spalte in der CSV-Datei kann einer Spalte in der Datenbank-Tabelle zugeordnet werden. Zudem können auch fixe Werte mitgegeben werden. In der Ansicht wird im oberen Bereich der Name der gewählten CSV-Konfiguration angezeigt und daneben steht das Wort "Mapping". Über einen Klick auf den CSV-Konfigurationsnamen springt die Ansicht zurück zur oberen CSV-Konfiguration. In der Mapping-Ansicht können pro Eintrag diverse Werte gesetzt werden:
- Typ (Auswahl: "Fester Wert" / "Wert aus CSV-Feld")
Für eine Datenbank-Spalte kann ein fixer Wert angegeben werden. Ein "ANY" beim Buchungskreis (CompanyCode) ist zum Beispiel für Buchungskreis-übergreifende Stammdaten gedacht. - Ziel
Name der SQL Tabellen-Spalte. Jede Spalte sollte nur einmal gesetzt werden. - Quelle/Wert
Name der CSV-Spaltenüberschrift. Ein Wert kann in mehrere SQL-Spalten geschrieben werden. - Export Spaltennummer
Beim Export der Daten als CSV werden die Spalten in der angegebenen Reihenfolge geschrieben. - Export ORDER BY
Beim Export der Daten werden die Daten nach dieser Spalte sortiert ausgegeben.
Stammdaten-Import
Stammdaten-Import über die Feld-Mapping-Ansicht
Eine CSV-Datei im Format UTF-8-BOM kann nicht verarbeitet werden!
Aus Excel erstellte CSV-Dateien werden im Format UTF-8-BOM erzeugt. Diese Dateien haben zu Beginn ein Sonderzeichen, durch welches das Auslesen der Datei verhindert wird. Die CSV-Dateien müssen zuerst im UTF-8 Format gespeichert werden. Die CSV-Datei kann hierfür zum Beispiel in Notepad++ geöffnet werden. Das Format wird unten rechts angezeigt (siehe Screenshot). Unter "Codierung" kann das Format in UTF-8 gewandelt werden.
Zum initialen Testen größerer CSV-Dateien bietet sich der "TESTEN" Button an. Hier werden weniger Datensätze aus der CSV-Datei verarbeitet.
Stammdaten-Import als Job
Das im Standard ausgelieferte Job-Skript "DEXPRO_JOB_ImportCSV" führt alle Importe zu allen CSV-Konfigurationen aus.
Stammdaten-Import manuell über den CSV Upload/Download Ordner
Der Import kann auch über den Ordner CSV Upload/Download erfolgen. Über den Button mit dem Upload-Symbol öffnet sich ein Pop-Up mit einer Dropzone und einer Auswahlliste der Import-Konfigurationen. Die hochgeladene Datei muss die Dateiendung "csv" haben. Der Dateiname ist egal. Die CSV-Datei wird zum einen an den in den in der Konfiguration angegeben Ort kopiert und erhält den dort konfigurierten Dateinamen. Zum anderen wird die Datei mit einem fix vorgegebenen Namensaufbau in dem Export-Ordner abgelegt, damit die Datei in der Ansicht angezeigt wird.
Zu jedem Import werden Loginformationen geschrieben.
Stammdaten-Export
Über den Ordner CSV Upload/Download und dem Download-Button öffnet sich ein Pop-Up mit einer Auswahlliste der CSV-Konfigurationen. Der Export verwendet das Feld-Mapping mit der hinterlegten Sortierreihenfolge. Fixe Werte werden nicht exportiert. Wenn ein Export ausgewählt wurde und wenn die Auswahl mit "OK" bestätigt wurde, erscheint die Meldung, dass die Skriptausführung gestartet wurde und die Ansicht neu geladen werden muss. Je nach Umfang der Stammdaten kann der Export etwas dauern.
Der Dateiname beginnt mit dem CSV-Konfigurationsnamen gefolgt vom Namen der SQL Tabelle und einem Zeitstempel. Die CSV-Dateien können in einem Pop-Up angezeigt werden und Sie können über das Download-Symbol heruntergeladen werden. Nicht mehr benötigte CSV-Dateien können gelöscht werden.
Damit Stammdaten zum Beispiel von einem Produktivsystem auf ein Testsystem übertragen werden können, müssen beide Systeme dieselbe CSV-Konfiguration mit demselben Feld-Mapping haben. Über die Export-Funktion kann die CSV erstellt und heruntergeladen werden und über die Import-Funktion kann die Datei auf dem Zielsystem eingespielt werden.
Dabei muss berücksichtigt werden, dass die bestehenden Stammdaten zur CSV-Konfiguration bei einem Import zunächst gelöscht werden. Bei einem Transfer von einem Testsystem zu einem Produktivsystem sollte der Import vorab nochmal auf dem Testsystem getestet werden.