1 Was ist der Universalimport/Universalexport?
2 Konfiguration
- 2.1 Konfiguration eines Felds in der Import/Exportdefinition
  - 2.1.1 Aktionen
3 Anwendung
4 Automatisierung

Was ist der Universalimport/Universalexport?

Mithilfe des Universalimport können Daten aus einer Quelldatei importiert werden und Bestandsdaten im System angelegt oder aktualisiert werden.
Das Modul befähigt Sie die Struktur der Datei eigenständig konfigurieren zu können, sodass Sie vollständig autark hoch individuelle Importdefinitionen anlegen können ohne vorherige Transformationen der Quelldatei oder Angleichung dieser auf ein Standardformat vornehmen zu müssen.

Der Import unterstützt die folgenden Dateiendungen: xls, xlsx, csv, txt.

Konfiguration

Datenaustausch → Definitionen für Import/Export verwalten

Detailansicht einer Importdefinition

Vergabe einer Bezeichnung zur Identifikation der Importdefintion
Auswahl ob es sich um einen Import oder Export handelt
Um welche Daten handelt es sich beim Import / Export
Sofern es sich um Vertragsdaten handelt kann die benötigte Sparte ausgewählt werden
Bei Auswahl des Dateityps kann zwischen variabler Länge (CSV-Datei mit Trennzeichen) und fixer Länge (CSV-Datei ohne Trennzeichen) entschieden werden
Angabe der Länge einer CSV-Zeile, sofern fixe Länge in (5) gewählt wurde
Angabe des CSV-Trennzeichens, sofern variable Länge in (5) gewählt wurde
Angabe des Abschlusszeichens. Standardmäßig wird der Zeilenumbruch verwendet.
Texterkennungszeichen, sofern vorhanden, umschließen Textwerte um sicher zustellen, dass Werte innerhalb des Texts nicht als Trennzeichen erkannt werden.
Angabe, ob die Datei ein Kopfzeile besitzt oder nicht. Je nach Einstellung wird die erste Zeile übersprungen.
Sofern (10) aktiviert ist, kann hier die Anzahl der Kopfzeilen hinterlegt werden, wenn mehr als eine Kopfzeile existiert.
Anzahl der Fußzeilen die übergangen werden sollen
Sofern die Quelldatei eine Excel-Datei ist, kann hier der zu importierende Reiter angegeben werden. Standardmäßig wird der erste Reiter in der Exceldatei importiert.
Angabe einer Protokolldatei, die beim Import gefüllt wird.
Anlage eines neuen Felds für die Import/Exportdefinition
Bearbeiten eines bestehenden Felds aus der Import/Exportdefinition
Löschen eines Felds aus der Import/Exportdefinition

Konfiguration eines Felds in der Import/Exportdefinition

Das System vergibt automatisch eine hochzählende Nummer, welche die Feldreihenfolge in der Definition festlegt
Vergabe einer sprechenden Bezeichnung für dieses Feld
Angabe ob es sich bei dem Feld um ein Merkmal handelt, welches den Datensatz identifiziert, wie z.B. eine Vertragsnummer, AMSIDNR, AMSPK oder ein anderweitiger eindeutiger Schlüssel
Sofern in (3) keine Identifikation stattgefunden hat, kann das System eine Neuanlage durchführen
Angabe in welcher “Spalte” die Information steht, sofern es sich bei den Quelldaten um eine Excel-Datei oder CSV-Datei mit Trennzeichen handelt
Angabe wieviele Zeichen der Wert besitzt, sofern es sich um eine CSV-Datei ohne Trennzeichen handelt
Anzahl der Nachkommastellen, sofern ein numerischer Wert gelesen wird
Angabe des Dezimaltrennzeichen, sofern ein numerischr Wert gelesen wird. Standardmäßig wird das Dezimaltrennzeichen aus der hinterlegten Windows Einstellung übernommen.
Angabe in welche Tabelle der gelesene Quellwert geschrieben werden soll
Angabe in welches Feld innerhalb der Tabellle (9) geschrieben werden soll
Optionale Möglichkeit, das in (10) angegebene Feld mit einem Voreingestellten Wert zu befüllen
Wenn ein Wert mit einem anderen zusammengeführt werden soll, dann kann hier die Nummer (1) des anderes Felds angegeben werden
Bei Angabe wird der Wert in den Datensatz übernommen, auch wenn in der Quelldatei kein Inhalt geliefert wird.
Möglichkeit eine vordefinierte Funktion anzuwenden, um den Quellwert aufzubereiten
Möglichkeit, neben der Übernahme des originalen Quellwerts, weitergehende Manipulationen vorzunehmen
Sofern der Quellwert eine feste Ausprägung besitzt und eine Übersetzung dieser Werte für das System erforderlich ist, kann diese Liste an Ausprägungen definiert werden
Angabe der in (15) weitergehenden Manipulationen (Siehe Aktionen)

Aktionen

Die beiden Aktionen “SQL ausführen” und “Script ausführen” ermöglichen weitgreifende Individualisierungen, sollten jedoch immer auf Performance und Funktionsfähigkeit geprüft werden, da diese auf sachkundiges Verständnis des Erstellers der Import/Exportdefinition im Zusammenspiel mit dem System angewiesen sind.

SQL ausführen

Mithilfe dieser Aktion kann ein eigenerstelltes SQL ausgeführt werden, um Daten aus dem System herauszulesen. Der Zugriff auf die Quelldaten erfolgt mittels SQL-Parameter. Hierbei wird das Schlüsselwort VALUE mit der Feldnummer verbunden.

:VALUE[Feldnummer]

-- Szenario: Wir suchen einen Vertrag anhand seiner internen Nummer,
-- allerdings ist die Nummer in der Quelldatei (Feldposition 1) auf 15 Stellen 
-- mit 0 aufgefüllt. Wir nutzen hier LEFT um nach den ersten 10 Stellen von 
-- links zu suchen und geben die Datensatz des Vertrags zurück.
-- Beispiel: AMS-Wert = 0123456789, Wert Quelldatei = 012345678900000
Select V.AMSIDNR
FROM VERTRAG V
WHERE 1 = 1
AND V.IS_HISTORIE = 0
AND V.FREIFELD = LEFT(:VALUE1, 10)

Script ausführen

Mithilfe dieser Aktion kann eigenerstellter Script-Code (JScript) ausgeführt werden, um Daten aus dem System herauszulesen oder weitergehende Transformationen des Eingabewerts durchzuführen. Der Zugriff auf die Quelldaten erfolgt über das “Datensatz”-DataSet.

Datensatz.FindField(“Feld[Feldnummer]”)

// Szenario: Beim Import werden Privat- und Firmen-Kunden geliefert, welche mit 
// der gleiche Definition importiert werden sollen.
// Beim Import des Vornamens unterscheiden wir nun anhand eines Kriteriums (Feldnummer 8),
// ob es sich um einen Privat- oder Firmen-Kunden handelt um anschließend im Falle
// von einem Firmenkunden keinen Wert zurückzuliefern.
// Zusätzlich wird der Vorname immer in Großbuchstaben geliefert. Wir möchten aber,
// das nur der erste Buchstabe Groß ist.
// Beispiel: Quellwert "TEST", Zielwert für AMS = "Test"

function GetValue(){
  var isFirmenKunde = Datensatz.FindField("Feld8").AsString != "";
  if(isFirmenKunde) {
    return "";
  } else {
    var vornameAlsGrossbuchstaben = Datensatz.FindField("Feld3").AsString;
    var vorname = vornameAlsGrossbuchstaben.substring(0,1).toUpperCase() + vornameAlsGrossbuchstaben.toLowerCase().substring(1);
    return vorname;
  }
}

Anwendung

Nach Erstellung der Import/Exportdefinition kann diese nun verwendet werden. Hierzu dient der Import + Export Bereich.

Mittels Betätigen der jeweiligen Schaltfläche werden nun alle verfügbaren Definitionen von Importen oder Exporten aufgelistet. Nach wählen der gewünschten Definition kann die gewünschte Quelldatei gewählt werden.

Nach erfolgtem Import zeigt das System alle eingelesen Datensätze an, welche nun im Anschluss validiert werden müssen (Schaltfläche “Validieren”). Sofern diese nun erfolgreich für den jeweiligen Datensatz war, kann dieser nun ins System zurückgeschrieben werden (Schaltfläche “Daten schreiben”).

Automatisierung

Die oben vorgestellten Möglichkeiten lassen sich im System automatisieren, sodass diese ohne Eingreifen eines Mitarbeiters ausgeführt werden. Hierzu kann im System eine geplante Aufgabe eingerichtet werden, welche im Hintergrund durch den ASSFINET-Dienst abgearbeitet wird.

Neben der Möglichkeit diese Aufgabe (Art der Aufgabe “Datensaetze_importieren”, “NeuerImport” oder “NeuerExport”) manuell in der Verwaltung von geplanten Aufgaben anzulegen, kann diese Konfiguration auch direkt über die Verwaltung der Import-/Export-Defitionen erfolgen. Hierzu wird als Art der Defintion lediglich “Importdefinition für geplante Aufgaben” oder “Exportdefinition für geplante Aufgaben” ausgewählt und in den sich einblenden Feldern die gewünschte Konfiguration für die geplante Aufgabe gewählt.

Zur Einsicht und Bearbeitung von bestehenden gepl. Importen/Exporten kann die Übersicht der geplanten Aufgaben genutzt werden.