Erstellen der Importdefinition

 

 

Besuchen Sie unsere neue Support Plattform. Dort finden Sie viele hilfreiche Artikel und haben Zugriff auf das Ticketsystem.

Sie erreichen die Support Plattform unter:  https://helpdesk.assfinet.de

 

Beachten Sie bitte, das daher diese Plattform nicht weiter aktualisiert und schrittweise zurückgebaut wird.

 

 

Stand: 20181211

Wir empfehlen das Anlegen eines Datenbankbackups bevor Sie die angepassten Daten in das Assfinet MVP importieren.

Per Neuanlage kann eine neue Definition angelegt werden.

Die Definitionen können auf zwei unterschiedliche Weisen angelegt werden: Entweder auf Basis einer Freien Selektion zum Erzeugen der Felddefinitionen oder manuell unter Auswahl der Herkunft. Folgende Angaben werden als Grundeinstellungen zur Vorlage benötigt.

Bezeichnung

Dies ist ein freies Textfeld, das Sie nach Ihrer Logik zur Beschriftung ausfüllen können.

Art der Definition

Hier wählen Sie Importdefinition aus. Es gibt auch Vorbelegungen, hierzu später mehr.

Datentyp

„freie Selektionsdaten“: Mit dieser Auswahl können Sie eine freie Selektion als Grundlage für die Feldliste heranziehen. Legen Sie hierzu im folgenden Feld „Selektionsname“ fest, welche Freie Selektion Sie verwenden möchten.

Kundendaten – Wählen Sie diese Einstellung, um eigenständig eine Vorlage für z.B. Kundendaten zu erstellen.

Sollten Sie Vertragsdaten gewählt haben, können Sie im weiteren Feld Sparte eine Sparte wählen, um auch Spartendatenfelder mitauswählen zu können.

Dateityp

Fixe Länge erwartet eine .txt Datei - Hierzu müssen dann die Felder rechts gefüllt werden

Variable Länge erzeugt eine .csv Datei. Hier bleibt die Option „Mit Kopfzeile“, die weiteren o.g. entfallen.

Protokolldatei

hier muss ein Speicherort gewählt und ein Dateiname vergeben werden

Satzlänge

(bei Export in eine .txt Datei erforderlich)

Spalten-Trennzeichen

z.B. Semikolon ";" oder senkrechter Strich (Pipe) "|"

Zeilen-Abschlusszeichen

(bei Export in eine .txt Datei erforderlich)

Texterkennungszeichen

(bei Export in eine .txt Datei erforderlich)

Mit Kopfzeile?

Setzt in der ersten Zeile die Feldnamen passend zum Export

Nach den allgemeinen Angaben müssen nun Feldpositionen erstellt werden.

Es müssen nicht alle Felder einer Feldposition gefüllt werden. Folgende Angaben sind erforderlich: Feldnummer, Bezeichnung, Ziel-Tabelle, Ziel-Feld, Aktion

Für Dateien mit fixer Länge sind noch folgende Einträge notwendig: Feldposition, Feldlänge

Erläuterung der Felder:

Feld

Wert

Erklärung

Feldnummer

Integer

Definiert Nummer des Feldes

Bezeichnung

String

Feldbezeichnung

Feld identifiziert Datensatz

Mit/ohne Häkchen

Feldname wird verifiziert

Neuanlage durchführen, wenn keine Identifizierung

 

Wird z.Z. nicht unterstützt

Feldposition im Datensatz

Integer

Nur für Dateien mit fixer Länge

Feldlänge

Integer

Nur für Dateien mit fixer Länge

Nachkommastellen

Integer

Nur für Dezimalzahlen von Bedeutung

Dezimaltrennzeichen

Integer

Nur für Dezimalzahlen von Bedeutung

Ziel-Tabelle

String

Tabelle im ASSFINET MVP

ziel-Feld

String

Feld im ASSFINET MVP

Vorbelegung

String

Vorbelegung des Feldes sofern dieses leer ist.

Zusammenführen mit Feld

Feldnummer

Der Wert dieses Feld kann mit einem anderen Feld verknüpft werden.

Leer überschreiben, wenn ohne Inhalt geliefert

Mit/ohne Häkchen

Ein leerer Wert wird ebenfalls übernommen.

Funktionen

Datum mit Punkten

Fügt in ein Datum Punkte hinter dem Tag u. Monat ein.

Aktion

Wert übernehmen

Wert aus der Datei übernehmen

 

SQL ausführen

Ergebnis der DB-Abfrage übernehmen

 

Script ausführen

Ergebnis des JavaScripts übernehmen

Neuanlage

Übersetzung anlegen

Wert wird durch Übersetzung ersetzt

Löschen

Übersetzung löschen

 

Daten manipulieren

Es gibt mehrere Möglichkeiten die Daten während des Imports zu manipulieren

Übersetzung

Damit Werte, die ggf. als Zahl/Kennzeichen geliefert werden, einen von Assfinet MVP lesbaren Wert erhalten, kann zum gelieferten Feld eine Übersetzungstabelle hinterlegt werden.

Es kann für jedes Feld eine Übersetzungstabelle angegeben werden. Hier einige Beispiele:

Feld Firma/Privat

 

Um den Haken für anwählbare Felder (Checkbox) setzen zu lassen
Ja für „Häkchen setzen“
Nein für „Häkchen nicht setzen“

Geschlecht wird mit: männlich / weiblich belegt

Anrede ist ein Freitext

Datumsfelder TT.MM.JJJJ

Aktion

SQL-Skript

Ist als Aktion SQL ausführen ausgewählt, kann im unteren Bereich der Felddefinition ein SQL-Skript eingetragen werden.

In diesem Beispiel ermittelt das SQL-Skript aus einer Postleitzahl  den Ort. Die Variable muss VALUE heißen und am Ende die Feldnummer (hier 5) enthalten, aus der der Wert ermittelt wird.

JavaScript

Ist als Aktion Script ausführen ausgewählt, kann im unteren Bereich der Felddefinition ein JavaScript eingetragen werden.

Die Funktion muss zwingend GetValue heißen. In diesem Beispiel ermittelt das Skript den Inhalt des Feldes VN_STR aus dem Datensatz.

Assistent

Der Assistent dient als Unterstützung zur Anlage von Felddefinitionen. Er ist insbesondere als Hilfsmittel von Dateien mit fixer Feldlänge geeignet, um automatisiert die Feldpositionen zu ermitteln.

Achtung: Diese Funktion eignet sich nicht zur nachträglichen Bearbeitung, da alle gespeicherten Felddefinitionen beim Speichern überschrieben werden!

Nach dem Aufruf muss ein Dateiname angegeben werden. Nachdem sich der Dateiformat-Assistent geöffnet hat, ist zunächst der Dateityp festzulegen. Ist als Dateityp Fixe Länge definiert, kann im nächsten Schritt im Feld Spaltenformat per Copy&Paste eine Liste der Feldpositionen übergeben werden. Der Assistent formatiert die Datei dann automatisch neu.

Es können für jedes Feld weitere Information angegeben werden, die der manuellen Felddefinition entsprechen. Am Ende werden alle Felder über die Taste Übernehmen gespeichert.

Pflichtfelder

Damit die zu Importierenden Daten auch korrekt angelegt werden können müssen natürlich die Voraussetzungen der Mindestangaben erfüllt sein.

Weiterhin gibt es Felder die für die eindeutige Zuordnung der Daten wichtig sind, damit bestehende Kunden/Verträge aktualisiert werden können.

Folgende Felder sollten deshalb in jeder Importdefinition enthalten sein

Kundendaten:

Kundenstatus (mögliche Werte: KUNDE, EX-KUNDE, INTERESSENT, EX-INTERESSENT)

Kundenzuordnung (mögliche Werte: PRIVAT/FIRMA)

Vorname

Nachname

Firmenname (Feldname = Kundenname)

PLZ

Vertragsdaten:

Gesellschaftskürzel

VNR

Sparte