Import

Das Plugin Import erlaubt die einfache Zuweisung von Quellfeldern zu Zielfeldern innerhalb der CortexEngine. Das Plugin unterstützt einen geführten Import mit Oberflächen, die die Konfiguration vereinfachen. Die im Plugin erzeugten Konfigurationen können für einen regelmäßig ablaufenden automatisierten Import exportiert werden.

Folgende Aktionen sind möglich:

• Datenimport aus CSV-Datei
• Cortex-zu-Cortex-Import
• Importkonfiguration speichern etc.

Voraussetzungen

Beim Datenimport werden neue Datensätze eines Datensatztyps angelegt. Die Inhalte werden in zugewiesene Felder geschrieben.

Wichtig

Voraussetzung für den Datenimport ist ein Datensatztyp mit passenden Feldern. Legen Sie bei Bedarf neue Felder und einen neuen Datensatztyp an.

Nutzerrechte

• ein in der Benutzerverwaltung des Remote-Admin entsprechend gesetztes Recht

  Tipp: ein gesondertes Benutzerkonto einrichten, mit dem Datenimporte durchgeführt werden können

• Benutzername und Passwort dieses Kontos werden in den exportierten Konfigurationsdateien und bei der Nutzung des Plugins benötigt.

Import aus CSV-Datei

Beim ersten Import von Daten in die CortexEngine wird empfohlen, die Daten aus einer CSV-Datei zu importieren.

Hinweis

Beim Import von CSV-Dateien, die mehrere Blätter mit Tabellen enthalten, wird nur die Tabelle des ersten Blatts importiert.

Aus einer Datenquelle können Datensätze in mehreren Datensatztypen erstellt werden.

Ablauf des CSV-Imports

1. Klicken Sie auf der Schnellstartleiste den Button Import

   Das folgende Fenster erscheint:

   

2. wählen Sie Daten aus CSV Datei importieren

   Folgendes Fenster öffnet sich:

   

   Die Abbildung zeigt die CSV-Import-Grundeinstellungen: (1) CSV-Datei auswählen oder Button neu hochladen oder Button bisherige Auswahl zurücksetzen , (2) Auswahl Import-Modus, (3) Auswahl Spaltenmodus, (4) Auswahl Zeichensatz, (5) Auswahl Feldtrenner, (6) Auswahl Feldbegrenzer, (7) Auswahl Wiederholfeldtrenner, (8) Checkbox 0-Zeichen ignorieren, (9) Button CSV-Datei einlesen

   Sobald eine Datei ausgewählt oder hochgeladen wurde, versucht das System, die Voreinstellungen der Datei zu ermitteln und die Auswahl in den Grundeinstellungen entsprechend anzupassen.

   Tabelle mit allen Elementen der Grundeinstellungen

   Bezeichnung	Bedeutung	Anmerkung
   CSV-Datei	Auswahl zwischen im Dropdown bereits vorhandene Datei auswählen eine neue Datei hochladen bisherige Auswahl zurücksetzen	Datei hochladen: bitte Information im nächsten Schritt des Importvorgangs beachten
   Import-Modus	Optionen: Updaten oder Anlegen Anlegen Updaten	Updaten oder anlegen benötigt Referenzwerte Die Felder mit Referenzwerten werden im nächsten Schritt festgelegt.
   Spaltenmodus	Optionen: Header ABC numerisch	CSV-Dateien enthalten meistens in der ersten Zeile Header-Informationen, wie zum Beispiel Name, Vorname und Ort. Diese Informationen sind wichtig, da sie die Zuordnung der Importdaten zu den Zielfeldern ermöglichen. Falls eine CSV-Datei keine Header-Informationen enthält, kann ein virtueller Header für den Import verwendet werden. Statt Feldbezeichnungen können dabei Buchstaben (A, B, C...) oder numerische Werte (1, 2, 3, ...) zur Auswahl stehen.
   Zeichensatz	Optionen: ISO-8859-1 windows-1252 UTF-8	Um Sonderzeichen korrekt darzustellen, muss das System den verwendeten Zeichensatz (Kodierung) erkennen. Damit die Zeichen einer Quelldatei korrekt importiert werden können, muss der Zeichensatz bekannt sein und für den Import festgelegt werden.
   Feldtrenner	Optionen: ; (Semikolon) , (Komma) (TAB) Sonstiges	Damit innerhalb von CSV-Dateien die Inhalte eindeutig voneinander getrennt werden können, sind Feldtrenner notwendig. Ein Trennzeichen trennt zwei Werte voneinander.
   Feldbegrenzer	Optionen: " (Double Quote) ' (Single Quote)	Ein Begrenzungszeichen wird direkt vor und hinter einem Wert gesetzt, um ihn zu begrenzen.
   Wiederholfeldtrenner	Optionen: , (Komma) ; (Semikolon) | (Pipe)	Definierte Felder in einer CortexEngine können mehrfach in einem Datensatz verwendet werden. Innerhalb der Quelldaten können mehrere Werte zu einem Feld gehören, getrennt durch ein Wiederholfeldtrenner. Jeder Wert zwischen den Trennern wird als eigener Feldwert in den neuen Datensatz importiert.
   0-Zeichen ignorieren		Für den Import numerischer Werte gibt es zwei Optionen: Die Null stellt einen echten Wert dar und soll ausgewertet werden: bitte Checkbox leer lassen Null-Angabe ohne weiteren Nutzen, kann ignoriert werden: bitte Checkbox aktivieren

   Achten Sie bitte darauf, dass Sie unterschiedliche Zeichen für Feldtrenner und Wiederholfeldtrenner verwenden.

   Beispiel für einen Datensatz mit Feldtrenner, Feldbegrenzer und Wiederholfeldtrenner

   "Name";"Vorname";"Ort";"Hobbies"
   "Meier";"Max";"Hamburg";"Fußball,Hockey"
   "Müller";"Silvia";"Berlin";"Tanzen,Reiten"
   

3. wählen Sie die CSV-Datei aus, die Sie einlesen wollen

   Laden Sie bei Bedarf eine neue Datei hoch

   Bitte beachten Sie, dass die maximale Größe der CSV-Datei durch den Webserver administrativ begrenzt ist auf 64MB.

   Falls Sie eine Anpassung der Größe wünschen, kontaktieren Sie bitte unseren Kundensupport.

4. überprüfen Sie die Grundeinstellungen und passen Sie sie bei Bedarf an die Einstellungen der zu importierenden Datei an

5. klicken Sie auf den Button CSV-Datei einlesen (9)

   Folgendes Fenster erscheint:

   

   Die Abbildung zeigt eine Liste mit Datensatztypen. Verfügbare Datensatztypen sind erkennbar am Button mit Haken (eingerahmt).

6. klicken Sie auf den Button des Datensatztyps, in den Sie die Daten importieren wollen

   Folgendes Fenster erscheint:

   

   Die Abbildung zeigt die Zuweisung von Quell- und Zielfeldern, links vor der Zuweisung, rechts während der Zuweisung: (1) Liste Quellfelder, (2) Liste Zielfelder, (3) Liste Feldzuweisungen, (4) bereits zugewiesenes Quellfeld, zu erkennen am Haken, (5) Quellfeld, das gerade zugewiesen wird, (6) Datensatz Rollen / Datensatz IID, (7) Checkbox Feld als Referenz setzen, (8) Button Bearbeiten , um die Importfunktion bei Bedarf anzupassen, (9) Button Löschen , (10) Buttons Simulieren und Importieren, (a) Quell- und Zielfeld sind verknüpft, erkennbar am eingerahmten Feldnamen, (b) unverknüpftes Zielfeld ohne Quellfeld

   Tabelle mit Elementen der Quell-Ziel-Zuweisung

   Bezeichnung	Bedeutung	Anmerkung
   Liste Quellfelder	Felder, die die Importdatei enthält
   Liste Zielfelder	Felder, in die die Inhalte der Importdatei geschrieben werden	Die Liste enthält den Buchstaben des Feldtyps, die Bezeichnung des Feldes und in Klammern das Feldsynonym.
   Feldzuweisungen	zeigt in jeder Zeile an, welche Importfunktion welchen Inhalt in ein Zielfeld importiert	Die Spalten zeigen von links nach rechts folgende Inhalte an: Synonym des Zielfelds, Bezeichnung des Zielfelds, Importfunktion inkl. Spaltenkopf des Quellfelds.
   Zielfeld Datensatz Rollen	Möglichkeit, allen Datensätzen eines Datensatztyps Rolle(n) zuzuweisen
   Zielfeld Datensatz IID	Möglichkeit, über die IID bei allen Datensätzen eines Datensatztyps z.B. einem neuen Feld Inhalte zuzuweisen
   Checkbox Feld als Referenz setzen	Möglichkeit, doppelte Datensätze zu vermeiden, in dem das Referenzfeld der Datensätze vor dem Import geprüft wird
   Feldzuweisung bearbeiten	Möglichkeit, eine andere Importfunktion zu wählen und/oder das Quellfeld zu editieren (Text in Single Quotes)
   Feldzuweisung löschen
   Button Simulieren	simuliert den Import
   Button Importieren

   Datensatz Rollen

   Innerhalb der CortexEngine können Rollen zu Benutzerkonten und Datensätzen zugewiesen werden, um Lese- und Schreibrechte einzuschränken, sobald die Rollenprüfung aktiv ist.

   Hinweis

   Es ist möglich, das Zielfeld Datensatz Rollen mehrfach hinzuzufügen, um z.B. den Datensätzen mehrere Rollen zuzuweisen. Datensatz Rollen ist ein Wiederholfeld.

   Datensatz ID

   Jeder Datensatz hat eine eigene ID. Damit können im Falle einer Änderung an allen Datensätzen eines Datensatztyps sicher alle Datensätze bearbeitet werden. Sicher bedeutet, dass es keine Unsauberkeit gibt, die beim Verwenden eines Referenzfelds auftreten kann.

   Beispiel: ein neues Feld im Datensatztyp, in das der Inhalt aus einem oder mehreren anderen Feldern des Datensatztyps geschrieben wird.

   Über die Datensatz ID kann dieses neue Feld automatisch in einem Arbeitsschritt befüllt werden.

   Referenzfelder

   Referenzfelder werden genutzt, um Datensätze eindeutig zu identifizieren. Zur eindeutigen Identifizierung ist es möglich, mehrere Felder als gemeinsame Referenz zu nutzen, z.B. Vorname + Nachname + Geburtsdatum.

   Anhand der Referenzfelder werden eindeutige CortexEngine-Inhalte gesucht:

   • Findet der Implex genau einen einzelnen Datensatz anhand der Referenzfelder, kann dieser Datensatz aktualisiert werden.
   • Findet der Implex mehrere Datensätze, ist keine Aktualisierung möglich.
   • Wird anhand der Referenzfelder kein Datensatz gefunden, legt der Implex je nach Importmodus einen neuen Datensatz an.
   • Wenn kein Referenzfeld gesetzt ist, legt der Implex je nach Importmodus einen neuen Datensatz an.

   Über die Checkbox an der linken Seite markieren Sie die entsprechenden Felder als Referenz.

   Hinweis: Der Import-Vorgang wird langsamer, wenn eine Kombination der markierten Referenzfelder innerhalb der CortexEngine gesucht werden muss.

   Übersicht zu Importfunktionen

   String

   Funktion	Beschreibung	Anmerkung
   getChar(``)	übernimmt die Zeichenkette (characters) eines Strings
   concat(String s1, String s2)	zwei Eingabestrings zu einem Ergebnisstring verbinden (concatenate)
   length(String str)	liefert die Länge eines Strings
   lower(String val)	wandelt einen String in Kleinbuchstaben um
   normHnr(String in)	zur Normierung einer Hausnummer
   pad_left(String in, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings rechtsbündig ausgerichtet sind, indem die linke Seite mit Leerzeichen aufgefüllt wird
   pad_right(String in, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings linksbündig ausgerichtet sind, indem die rechte Seite mit Leerzeichen aufgefüllt wird
   pad_left(String in, String char, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings rechtsbündig ausgerichtet sind, indem die linke Seite mit dem angegebenen Zeichen aufgefüllt wird
   pad_right(String in, String char, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings linksbündig ausgerichtet sind, indem die rechte Seite mit dem angegebenen Zeichen aufgefüllt wird
   replace(String sIn, String sSeek, String sRepl)	ersetzt einen Suchstring im Eingabestring durch einen Ersatzstring
   rsubstring(String in, Integer start)	liefert von dem Eingabestring alle Zeichen, ab dem gewünschten Startzeichen start
   split(String src, String splitStr, Integer n)	liefert das n-te Element aus dem zerlegten Eingabestring
   substring(String in, Integer start, Integer len)	liefert von dem Eingabestring einen Teilstring mit der angegebenen Länge ab der übergebenen Startposition
   trim(String in)	führt einen Trim auf einen String aus
   upper(String val)	wandelt einen String in Großbuchstaben um
   findFirst(in, match) findFirst(in, match, startPos)	findet die erste Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück	nur verfügbar in konsolenbasierter Implex-Applikation
   findLast(in, match) findLast(in, match, startPos)	findet die letzte Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück	nur verfügbar in konsolenbasierter Implex-Applikation

   Numerisch

   Funktion	Beschreibung
   PLUS(v1, v2)	addiert die beiden numerischen Werte
   MINUS(v1, v2)	subtrahiert zwei numerische Werte voneinander
   MUL(v1, v2)	liefert das Produkt der beiden numerischen Werte
   DIV(v1, v2)	liefert den Quotienten zweier numerischer Werte

   DATUM

   Funktion	Beschreibung	Anmerkung
   date(String format, String in)	beliebiges Datumsformat in das CortexEngine-Format konvertieren
   time()	Der Aufruf ohne Parameter liefert den aktuellen, minutengenauen Zeitstempel. Für eine Nutzung als Verlaufsinformation ist eine Konvertierung mit der Date-Funktion notwendig.	nur verfügbar in konsolenbasierter Implex-Applikation

   Konvertierung

   Funktion	Beschreibung	Anmerkung
   cdouble(String in)	String in Double konvertieren; Double (Gleitkommazahl (64 bit) mit mindestens 10 Nachkommastellen)
   cfloat(String in)	String in Float konvertieren; Float (Gleitkommazahl (32 bit) mit mindestens 6 Nachkommastellen)
   cint(String in)	String in Integer konvertieren; Int (Integer = Ganzzahl (mindestens 16 bit, also 65536 mögliche Werte))
   clong(Object in)	long integer value = Ganzzahl mit doppeltem Wertebereich von Integer
   cstring(Object in)	beliebige andere Datentypen in String konvertieren
   date(String format, String in)	beliebiges Datumsformat in das CortexEngine-Format konvertieren
   time(String date)	wandelt ein String im Cortex-Datumsformat in einen Cortex-internen Long Zeitstempel um	nur verfügbar in konsolenbasierter Implex-Applikation

   Dateien

   Funktion	Beschreibung
   file_extension(String file)	liefert die Erweiterung eines übergebenen Dateinamens
   file_woext(String file)	liefert den Dateinamen ohne Erweiterung einer Datei zurück, befreit von Pfadangaben
   file(String sFileName)	importiert eine Datei
   filename(String file)	liefert den Dateinamen einer Datei zurück, befreit von Pfadangaben
   filepath(String file)	liefert den absoluten Pfad einer Datei zurück
   sourceFileName()	liefert den Dateinamen inkl. Extension der aufgerufenen Importdatei

   Check

   Funktion	Beschreibung
   empty(String in)	gibt zurück, ob der übergebene String die Länge 0 besitzt
   endsWith(String str1, String end)	prüft, ob der Eingabestring (str1) mit dem Prüfstring (end) endet
   equals(String str1, String str2)	prüft, ob zwei Strings gleich sind
   notequals(String str1, String str2)	prüft, ob zwei Strings ungleich sind

   Boolean

   Funktion	Beschreibung
   AND(Boolean v1, Boolean v2)	AND Operation auf zwei boolesche Werte ausführen
   NOT(Boolean in)	gibt den übergebenen booleschen Wert negiert zurück
   OR(Boolean v1, Boolean v2)	führt die OR Operation auf zwei boolesche Werte aus
   iif(Boolean ifclause, then, elsedo)	liefert then, wenn ifclause == true, sonst elsedo

   Variablen

   Insbesondere bei umfangreichen Importkonfigurationen ist es hilfreich, wenn bereits definierte Werte per Variable weiterverwendet werden können.

   Funktion	Beschreibung	Anmerkung
   getVar(StringName)	Textwert; Variablen können über zwei Funktionen gesetzt und gelesen werden
   setVar(StringName, StringValue)	Textwert; Variablen können über zwei Funktionen gesetzt und gelesen werden
   getVarDouble(String Name)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden	nur verfügbar in konsolenbasierter Implex-Applikation
   setVarDouble(String Name, String Value)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden	nur verfügbar in konsolenbasierter Implex-Applikation

   Variablen können nur rechtsseitig vom Gleichheitszeichen der Wertzuweisung verwendet werden können. Linksseitig vom Gleichheitszeichen (z.B. für die Bestimmung eines Verlaufsdatums) ist die Verwendung nicht möglich.

   nur verfügbar in konsolenbasierter Implex-Applikation

   Funktion	Beschreibung
   findFirst(in, match) findFirst(in, match, startPos)	findet die erste Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück
   findLast(in, match) findLast(in, match, startPos)	findet die letzte Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück
   time(String date)	wandelt ein String im Cortex-Datumsformat in einen Cortex-internen Long Zeitstempel um
   time()	Der Aufruf ohne Parameter liefert den aktuellen, minutengenauen Zeitstempel. Für eine Nutzung als Verlaufsinformation ist eine Konvertierung mit der Date-Funktion notwendig.
   getVarDouble(String Name)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden
   setVarDouble(String Name, String Value)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden

7. klicken Sie auf ein Quellfeld, um es zuzuweisen

   Es werden die Spaltenüberschriften der Quelle angezeigt (oder numerisch/alphabetisch, wenn diese Option aktiviert ist).

   Die Zeile wird blau (5).

8. klicken Sie auf das entsprechende Zielfeld des ausgewählten Datensatztyps

   • Im Bereich Feldzuweisungen erscheint eine Zeile.
   • Das Quellfeld erhält einen Haken (4).
   • Das Zielfeld ist nicht mehr in der Liste Zielfelder.

9. weisen Sie nacheinander die benötigten Felder zu

   Zuweisung wieder aufheben

   Um eine Feldzuweisung wieder aufzuheben, klicken Sie auf den Button Löschen der entsprechenden Zeile.

10. klicken Sie bei Bedarf auf das Zielfeld Datensatz Rollen

    1. klicken Sie auf den Button Bearbeiten und editieren Sie das Textfeld mit der Importfunktion

       Rolle(n) zuweisen

       Wenn Sie mehrere Rollen zuweisen wollen, fügen Sie das Zielfeld Datensatz Rollen mehrmals hinzu und editieren Sie jeweils das Feld mit der Importfunktion.

       

       Die Abbildung zeigt die die Bearbeitung des Textfelds: Löschen Sie die eigentliche Funktion und schreiben Sie die Rolle in Single Quotes.

11. weisen Sie bei Bedarf Quell- und Zielfeld Datensatz ID zu

    Datensatz ID zuweisen und weiteres Zielfeld bearbeiten

    

    Die Abbildung zeigt die Zuweisung von Quell- und Zielfeldern mit dem Quellfeld Datensatz ID

    1. klicken Sie auf ein Zielfeld, das überschrieben werden soll

    2. klicken Sie auf den Button Bearbeiten des Zielfelds und editieren Sie das Textfeld mit der Importfunktion

       Folgendes Fenster erscheint:

       

       Die Abbildung zeigt links die Bearbeitung über Datensatz ID und rechts das Ergebnis in einem Datensatz des Datensatztyps Zone am Beispiel des neuen Textfelds _ref_Zone: (1) Importfunktion bearbeiten und dabei zwei Feldinhalte in ein Feld zusammenführen, (2) Importfunktion, die den Inhalt eines Felds in das neue Feld schreibt, (3) Ergebnis im Datensatz selbst: als Referenzfelder dieses Datensatztyps werden die Felder zone_id und zone_borough verwendet.

       Die Kombination aus mehreren Feldern erfolgt über ein + (Plus) zwischen den Importfunktionen, z.B. getChar('LocationID')+getChar('Borough')

       Tipp: wenn mehrere Feldinhalte in ein Feld geschrieben werden, wird ein Trennzeichen zwischen den Inhalten empfohlen, im Beispiel _ (underscore): getChar('LocationID')+'_'+getChar('Borough').

12. aktivieren Sie bei Bedarf die Checkbox (7) Feld als Referenz setzen bei der/den entsprechenden Zeilen

    Hinweis: Der Import-Vorgang wird langsamer, wenn eine Kombination der markierten Referenzfelder innerhalb der CortexEngine gesucht werden muss.

13. bearbeiten Sie bei Bedarf die Feldzuweisung einer Zeile (8)

    Wenn Sie mehrere Felder zu einem Zielfeld zusammenfügen wollen, bearbeiten Sie die Feldzuweisung, z.B. die Felder Strasse und Hausnummer werden in das (neue) Feld Adresse geschrieben.

    Feldzuweisung bearbeiten - Optionen

    • eine andere Importfunktion wählen

    • das Quellfeld editieren (Text in Single Quotes)

      • Um festen Text zu importieren, löschen Sie die Importfunktion und schreiben Sie den Text in Single Quotes, z.B. 'Tanja' als Inhalt beim Zielfeld Datensatz Rollen.

      • Die Kombination aus mehreren Feldern erfolgt über ein + (Plus) zwischen den Importfunktionen, z.B. getChar('Strasse')+getChar('Hausnummer').

        Tipp: wenn mehrere Feldinhalte in ein Feld geschrieben werden, wird ein Trennzeichen zwischen den Inhalten empfohlen, im Beispiel _ (underscore): getChar('Strasse')+'_'+getChar('Hausnummer').

14. speichern bzw. exportieren Sie bei Bedarf die Konfiguration über das Auswahlmenü in der Kopfzeile für zukünftige Importvorgänge

15. klicken Sie auf den Button Importieren (oder Simulieren für eine Vorschau) und bestätigen Sie Ihre Login-Daten

    Folgendes Fenster erscheint:

    

    Die Abbildung zeigt den Status des Imports an: Während des Imports wird der Fortschrittsbalken aktualisiert.

    Hinweise zu Simulation und Import

    • Die Simulation prüft nur syntaktisch, ob während des Importes Fehler auftreten können. Eine logische Prüfung der Daten kann nicht erfolgen. Alle zu importierenden Datensätze werden gelesen und durchlaufen. Danach erfolgt eine Ausgabe zum Status der Simulation.
    • Der Datenimport dauert länger als die Simulation, weil die Datensätze in die CortexEngine geschrieben werden.
    • Während der Simulation und des Imports erfolgt die Anzeige eines Fortschrittsbalkens (Progress-Bar).
    • Die Fortschrittsanzeige erfolgt über einen Satzzähler, der permanent angezeigt wird.

    • In der Statusanzeige der Ergebnisse können Sie die Anzahl in den Zeilen Neu angelegte Datensätze und Aktualisierte Datensätze anklicken und erhalten eine Listenansicht der betroffenen Datensätze. Nach dem Import können Sie auf einen Datensatz klicken un die die Datensatzansicht öffnen.

      Bitte beachten Sie, dass die Datensatzansicht nicht nach der Simulation zur Verfügung steht.

16. falls Sie eine Simulation durchgeführt haben: kehren Sie zurück zur Konfiguration und klicken den Button Importieren

17. schließen Sie den Tab

Als Erfolgskontrolle können Sie in der Datensatztyp-Übersicht die aktualisierte Anzahl der Datensätze im Datensatztyp sehen, in den Sie Daten importiert haben. Je nach Import-Art kann die Anzahl der importierten Datensätze von der Anzahl der Quelle abweichen.

Cortex zu Cortex-Import

Das Cortex-Modul des Implex bietet Ihnen die Möglichkeit, innerhalb Ihrer CortexEngine beliebige Änderungen durchführen zu können:

• bestimmte Inhalte korrigieren
• bestimmte Inhalte ergänzen
• das komplette Datenmodell ändern

Änderungen von einer CortexEngine auf eine andere CortexEngine können nur über die konsolenbasierte Implex-Applikation übertragen werden.

Voraussetzungen

Im Verlauf des Imports werden neben dem Datensatztyp eine Listendefinition zugewiesen. Bei Bedarf fügen Sie bitte eine neue Listendefinition hinzu.

Falls Sie den Import über eine Selektion durchführen, fügen Sie bei Bedarf bitte eine neue Selektion hinzu.

Ablauf des Imports

1. Klicken Sie auf der Schnellstartleiste den Button Import

   Das folgende Fenster erscheint:

   

2. wählen Sie Daten aus CORTEX Server importieren

   Folgendes Fenster öffnet sich:

   

   Die Abbildung zeigt die CORTEX-Import-Grundeinstellungen: (1) Button Listenauswahl hinzufügen, (2) Auswahl Datensatztyp / Selektion, (3) Button Hinzufügen, (4) Auswahl Import-Modus, (5) Button Daten einlesen

   Tabelle mit allen Elementen der Grundeinstellungen

   Bezeichnung	Bedeutung
   Listenauswahl
   Datensatztyp
   Selektion
   Import-Modus	Optionen: Updaten oder Anlegen Anlegen Updaten
   Button Daten einlesen

   Das Einlesen erfodert eine zugefügte Liste, einen zugefügten Datensatztyp bzw. Selektion und einen Import-Modus.

3. fügen Sie eine Listendefinition hinzu

4. fügen Sie entweder einen Datensatztyp oder eine Selektion hinzu

5. wählen Sie den Import-Modus

6. klicken Sie auf den Button Daten einlesen

   Folgendes Fenster erscheint:

   

   Die Abbildung zeigt eine Liste mit Datensatztypen. Verfügbare Datensatztypen sind erkennbar am Button mit Haken (eingerahmt).

7. klicken Sie auf den Button des Datensatztyps, in den Sie die Daten importieren wollen und bestätigen Sie Ihre Login-Daten

   Folgendes Fenster erscheint:

   

   Die Abbildung zeigt die Zuweisung von Quell- und Zielfeldern, links vor der Zuweisung, rechts während der Zuweisung: (1) Liste Quellfelder, (2) Liste Zielfelder, (3) Liste Feldzuweisungen, (4) bereits zugewiesenes Quellfeld, zu erkennen am Haken, (5) Quellfeld, das gerade zugewiesen wird, (6) Datensatz Rollen / Datensatz IID, (7) Checkbox Feld als Referenz setzen, (8) Button Bearbeiten , um die Importfunktion bei Bedarf anzupassen, (9) Button Löschen , (10) Buttons Simulieren und Importieren, (a) Quell- und Zielfeld sind verknüpft, erkennbar am eingerahmten Feldnamen, (b) unverknüpftes Zielfeld ohne Quellfeld

   Tabelle mit Elementen der Quell-Ziel-Zuweisung

   Bezeichnung	Bedeutung	Anmerkung
   Liste Quellfelder	Felder, die die Importdatei enthält
   Liste Zielfelder	Felder, in die die Inhalte der Importdatei geschrieben werden	Die Liste enthält den Buchstaben des Feldtyps, die Bezeichnung des Feldes und in Klammern das Feldsynonym.
   Feldzuweisungen	zeigt in jeder Zeile an, welche Importfunktion welchen Inhalt in ein Zielfeld importiert	Die Spalten zeigen von links nach rechts folgende Inhalte an: Synonym des Zielfelds, Bezeichnung des Zielfelds, Importfunktion inkl. Spaltenkopf des Quellfelds.
   Zielfeld Datensatz Rollen	Möglichkeit, allen Datensätzen eines Datensatztyps Rolle(n) zuzuweisen
   Zielfeld Datensatz IID	Möglichkeit, über die IID bei allen Datensätzen eines Datensatztyps z.B. einem neuen Feld Inhalte zuzuweisen
   Checkbox Feld als Referenz setzen	Möglichkeit, doppelte Datensätze zu vermeiden, in dem das Referenzfeld der Datensätze vor dem Import geprüft wird
   Feldzuweisung bearbeiten	Möglichkeit, eine andere Importfunktion zu wählen und/oder das Quellfeld zu editieren (Text in Single Quotes)
   Feldzuweisung löschen
   Button Simulieren	simuliert den Import
   Button Importieren

   Datensatz Rollen

   Innerhalb der CortexEngine können Rollen zu Benutzerkonten und Datensätzen zugewiesen werden, um Lese- und Schreibrechte einzuschränken, sobald die Rollenprüfung aktiv ist.

   Hinweis

   Es ist möglich, das Zielfeld Datensatz Rollen mehrfach hinzuzufügen, um z.B. den Datensätzen mehrere Rollen zuzuweisen. Datensatz Rollen ist ein Wiederholfeld.

   Datensatz ID

   Jeder Datensatz hat eine eigene ID. Damit können im Falle einer Änderung an allen Datensätzen eines Datensatztyps sicher alle Datensätze bearbeitet werden. Sicher bedeutet, dass es keine Unsauberkeit gibt, die beim Verwenden eines Referenzfelds auftreten kann.

   Beispiel: ein neues Feld im Datensatztyp, in das der Inhalt aus einem oder mehreren anderen Feldern des Datensatztyps geschrieben wird.

   Über die Datensatz ID kann dieses neue Feld automatisch in einem Arbeitsschritt befüllt werden.

   Referenzfelder

   Referenzfelder werden genutzt, um Datensätze eindeutig zu identifizieren. Zur eindeutigen Identifizierung ist es möglich, mehrere Felder als gemeinsame Referenz zu nutzen, z.B. Vorname + Nachname + Geburtsdatum.

   Anhand der Referenzfelder werden eindeutige CortexEngine-Inhalte gesucht:

   • Findet der Implex genau einen einzelnen Datensatz anhand der Referenzfelder, kann dieser Datensatz aktualisiert werden.
   • Findet der Implex mehrere Datensätze, ist keine Aktualisierung möglich.
   • Wird anhand der Referenzfelder kein Datensatz gefunden, legt der Implex je nach Importmodus einen neuen Datensatz an.
   • Wenn kein Referenzfeld gesetzt ist, legt der Implex je nach Importmodus einen neuen Datensatz an.

   Über die Checkbox an der linken Seite markieren Sie die entsprechenden Felder als Referenz.

   Hinweis: Der Import-Vorgang wird langsamer, wenn eine Kombination der markierten Referenzfelder innerhalb der CortexEngine gesucht werden muss.

   Übersicht zu Importfunktionen

   String

   Funktion	Beschreibung	Anmerkung
   getChar(``)	übernimmt die Zeichenkette (characters) eines Strings
   concat(String s1, String s2)	zwei Eingabestrings zu einem Ergebnisstring verbinden (concatenate)
   length(String str)	liefert die Länge eines Strings
   lower(String val)	wandelt einen String in Kleinbuchstaben um
   normHnr(String in)	zur Normierung einer Hausnummer
   pad_left(String in, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings rechtsbündig ausgerichtet sind, indem die linke Seite mit Leerzeichen aufgefüllt wird
   pad_right(String in, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings linksbündig ausgerichtet sind, indem die rechte Seite mit Leerzeichen aufgefüllt wird
   pad_left(String in, String char, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings rechtsbündig ausgerichtet sind, indem die linke Seite mit dem angegebenen Zeichen aufgefüllt wird
   pad_right(String in, String char, Integer len)	gibt einen String zurück, bei dem die Zeichen des Eingabestrings linksbündig ausgerichtet sind, indem die rechte Seite mit dem angegebenen Zeichen aufgefüllt wird
   replace(String sIn, String sSeek, String sRepl)	ersetzt einen Suchstring im Eingabestring durch einen Ersatzstring
   rsubstring(String in, Integer start)	liefert von dem Eingabestring alle Zeichen, ab dem gewünschten Startzeichen start
   split(String src, String splitStr, Integer n)	liefert das n-te Element aus dem zerlegten Eingabestring
   substring(String in, Integer start, Integer len)	liefert von dem Eingabestring einen Teilstring mit der angegebenen Länge ab der übergebenen Startposition
   trim(String in)	führt einen Trim auf einen String aus
   upper(String val)	wandelt einen String in Großbuchstaben um
   findFirst(in, match) findFirst(in, match, startPos)	findet die erste Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück	nur verfügbar in konsolenbasierter Implex-Applikation
   findLast(in, match) findLast(in, match, startPos)	findet die letzte Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück	nur verfügbar in konsolenbasierter Implex-Applikation

   Numerisch

   Funktion	Beschreibung
   PLUS(v1, v2)	addiert die beiden numerischen Werte
   MINUS(v1, v2)	subtrahiert zwei numerische Werte voneinander
   MUL(v1, v2)	liefert das Produkt der beiden numerischen Werte
   DIV(v1, v2)	liefert den Quotienten zweier numerischer Werte

   DATUM

   Funktion	Beschreibung	Anmerkung
   date(String format, String in)	beliebiges Datumsformat in das CortexEngine-Format konvertieren
   time()	Der Aufruf ohne Parameter liefert den aktuellen, minutengenauen Zeitstempel. Für eine Nutzung als Verlaufsinformation ist eine Konvertierung mit der Date-Funktion notwendig.	nur verfügbar in konsolenbasierter Implex-Applikation

   Konvertierung

   Funktion	Beschreibung	Anmerkung
   cdouble(String in)	String in Double konvertieren; Double (Gleitkommazahl (64 bit) mit mindestens 10 Nachkommastellen)
   cfloat(String in)	String in Float konvertieren; Float (Gleitkommazahl (32 bit) mit mindestens 6 Nachkommastellen)
   cint(String in)	String in Integer konvertieren; Int (Integer = Ganzzahl (mindestens 16 bit, also 65536 mögliche Werte))
   clong(Object in)	long integer value = Ganzzahl mit doppeltem Wertebereich von Integer
   cstring(Object in)	beliebige andere Datentypen in String konvertieren
   date(String format, String in)	beliebiges Datumsformat in das CortexEngine-Format konvertieren
   time(String date)	wandelt ein String im Cortex-Datumsformat in einen Cortex-internen Long Zeitstempel um	nur verfügbar in konsolenbasierter Implex-Applikation

   Dateien

   Funktion	Beschreibung
   file_extension(String file)	liefert die Erweiterung eines übergebenen Dateinamens
   file_woext(String file)	liefert den Dateinamen ohne Erweiterung einer Datei zurück, befreit von Pfadangaben
   file(String sFileName)	importiert eine Datei
   filename(String file)	liefert den Dateinamen einer Datei zurück, befreit von Pfadangaben
   filepath(String file)	liefert den absoluten Pfad einer Datei zurück
   sourceFileName()	liefert den Dateinamen inkl. Extension der aufgerufenen Importdatei

   Check

   Funktion	Beschreibung
   empty(String in)	gibt zurück, ob der übergebene String die Länge 0 besitzt
   endsWith(String str1, String end)	prüft, ob der Eingabestring (str1) mit dem Prüfstring (end) endet
   equals(String str1, String str2)	prüft, ob zwei Strings gleich sind
   notequals(String str1, String str2)	prüft, ob zwei Strings ungleich sind

   Boolean

   Funktion	Beschreibung
   AND(Boolean v1, Boolean v2)	AND Operation auf zwei boolesche Werte ausführen
   NOT(Boolean in)	gibt den übergebenen booleschen Wert negiert zurück
   OR(Boolean v1, Boolean v2)	führt die OR Operation auf zwei boolesche Werte aus
   iif(Boolean ifclause, then, elsedo)	liefert then, wenn ifclause == true, sonst elsedo

   Variablen

   Insbesondere bei umfangreichen Importkonfigurationen ist es hilfreich, wenn bereits definierte Werte per Variable weiterverwendet werden können.

   Funktion	Beschreibung	Anmerkung
   getVar(StringName)	Textwert; Variablen können über zwei Funktionen gesetzt und gelesen werden
   setVar(StringName, StringValue)	Textwert; Variablen können über zwei Funktionen gesetzt und gelesen werden
   getVarDouble(String Name)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden	nur verfügbar in konsolenbasierter Implex-Applikation
   setVarDouble(String Name, String Value)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden	nur verfügbar in konsolenbasierter Implex-Applikation

   Variablen können nur rechtsseitig vom Gleichheitszeichen der Wertzuweisung verwendet werden können. Linksseitig vom Gleichheitszeichen (z.B. für die Bestimmung eines Verlaufsdatums) ist die Verwendung nicht möglich.

   nur verfügbar in konsolenbasierter Implex-Applikation

   Funktion	Beschreibung
   findFirst(in, match) findFirst(in, match, startPos)	findet die erste Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück
   findLast(in, match) findLast(in, match, startPos)	findet die letzte Position eines Zeichens (optional ab einer bestimmten Stelle) und gibt die Position als Int zurück
   time(String date)	wandelt ein String im Cortex-Datumsformat in einen Cortex-internen Long Zeitstempel um
   time()	Der Aufruf ohne Parameter liefert den aktuellen, minutengenauen Zeitstempel. Für eine Nutzung als Verlaufsinformation ist eine Konvertierung mit der Date-Funktion notwendig.
   getVarDouble(String Name)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden
   setVarDouble(String Name, String Value)	numerische Werte; Variablen können über zwei Funktionen gesetzt und gelesen werden

8. klicken Sie auf ein Quellfeld, um es zuzuweisen

   Es werden die Spaltenüberschriften der Quelle angezeigt (oder numerisch/alphabetisch, wenn diese Option aktiviert ist).

   Die Zeile wird blau (5).

9. klicken Sie auf das entsprechende Zielfeld des ausgewählten Datensatztyps

   • Im Bereich Feldzuweisungen erscheint eine Zeile.
   • Das Quellfeld erhält einen Haken (4).
   • Das Zielfeld ist nicht mehr in der Liste Zielfelder.

10. weisen Sie nacheinander die benötigten Felder zu

    Zuweisung wieder aufheben

    Um eine Feldzuweisung wieder aufzuheben, klicken Sie auf den Button Löschen der entsprechenden Zeile.

11. klicken Sie bei Bedarf auf das Zielfeld Datensatz Rollen

    1. klicken Sie auf den Button Bearbeiten und editieren Sie das Textfeld mit der Importfunktion

       Rolle(n) zuweisen

       Wenn Sie mehrere Rollen zuweisen wollen, fügen Sie das Zielfeld Datensatz Rollen mehrmals hinzu und editieren Sie jeweils das Feld mit der Importfunktion.

       

       Die Abbildung zeigt die die Bearbeitung des Textfelds: Löschen Sie die eigentliche Funktion und schreiben Sie die Rolle in Single Quotes.

12. weisen Sie bei Bedarf Quell- und Zielfeld Datensatz ID zu

    Datensatz ID zuweisen und weiteres Zielfeld bearbeiten

    

    Die Abbildung zeigt die Zuweisung von Quell- und Zielfeldern mit dem Quellfeld Datensatz ID

    Das Quellfeld Datensatz ID kann über eine Hilfsliste erzeugt werden.

    Hilfsliste für Cortex-zu-Cortex-Import

    1. legen Sie eine neue Listendefinition an, die mindestens die Datensatz ID als Spalte enthält

       So geht's: Listendefinition anlegen

    2. wählen Sie in den Grundeinstellungen bei der Listenauswahl diese Hilfsliste

    1. klicken Sie auf ein Zielfeld, das überschrieben werden soll

    2. klicken Sie auf den Button Bearbeiten des Zielfelds und editieren Sie das Textfeld mit der Importfunktion

       Folgendes Fenster erscheint:

       

       Die Abbildung zeigt links die Bearbeitung über Datensatz ID und rechts das Ergebnis in einem Datensatz des Datensatztyps Zone am Beispiel des neuen Textfelds _ref_Zone: (1) Importfunktion bearbeiten und dabei zwei Feldinhalte in ein Feld zusammenführen, (2) Importfunktion, die den Inhalt eines Felds in das neue Feld schreibt, (3) Ergebnis im Datensatz selbst: als Referenzfelder dieses Datensatztyps werden die Felder zone_id und zone_borough verwendet.

       Die Kombination aus mehreren Feldern erfolgt über ein + (Plus) zwischen den Importfunktionen, z.B. getChar('LocationID')+getChar('Borough')

       Tipp: wenn mehrere Feldinhalte in ein Feld geschrieben werden, wird ein Trennzeichen zwischen den Inhalten empfohlen, im Beispiel _ (underscore): getChar('LocationID')+'_'+getChar('Borough').

13. aktivieren Sie bei Bedarf die Checkbox (7) Feld als Referenz setzen bei der/den entsprechenden Zeilen

    Hinweis: Der Import-Vorgang wird langsamer, wenn eine Kombination der markierten Referenzfelder innerhalb der CortexEngine gesucht werden muss.

14. bearbeiten Sie bei Bedarf die Feldzuweisung einer Zeile (8)

    Wenn Sie mehrere Felder zu einem Zielfeld zusammenfügen wollen, bearbeiten Sie die Feldzuweisung, z.B. die Felder Strasse und Hausnummer werden in das (neue) Feld Adresse geschrieben.

    Feldzuweisung bearbeiten - Optionen

    • eine andere Importfunktion wählen

    • das Quellfeld editieren (Text in Single Quotes)

      • Um festen Text zu importieren, löschen Sie die Importfunktion und schreiben Sie den Text in Single Quotes, z.B. 'Tanja' als Inhalt beim Zielfeld Datensatz Rollen.

      • Die Kombination aus mehreren Feldern erfolgt über ein + (Plus) zwischen den Importfunktionen, z.B. getChar('Strasse')+getChar('Hausnummer').

        Tipp: wenn mehrere Feldinhalte in ein Feld geschrieben werden, wird ein Trennzeichen zwischen den Inhalten empfohlen, im Beispiel _ (underscore): getChar('Strasse')+'_'+getChar('Hausnummer').

15. speichern bzw. exportieren Sie bei Bedarf die Konfiguration über das Auswahlmenü in der Kopfzeile für zukünftige Importvorgänge

16. klicken Sie auf den Button Importieren (oder Simulieren für eine Vorschau) und bestätigen Sie Ihre Login-Daten

    Folgendes Fenster erscheint:

    

    Die Abbildung zeigt den Status des Imports an: Während des Imports wird der Fortschrittsbalken aktualisiert.

    Hinweise zu Simulation und Import

    • Die Simulation prüft nur syntaktisch, ob während des Importes Fehler auftreten können. Eine logische Prüfung der Daten kann nicht erfolgen. Alle zu importierenden Datensätze werden gelesen und durchlaufen. Danach erfolgt eine Ausgabe zum Status der Simulation.
    • Der Datenimport dauert länger als die Simulation, weil die Datensätze in die CortexEngine geschrieben werden.
    • Während der Simulation und des Imports erfolgt die Anzeige eines Fortschrittsbalkens (Progress-Bar).
    • Die Fortschrittsanzeige erfolgt über einen Satzzähler, der permanent angezeigt wird.

    • In der Statusanzeige der Ergebnisse können Sie die Anzahl in den Zeilen Neu angelegte Datensätze und Aktualisierte Datensätze anklicken und erhalten eine Listenansicht der betroffenen Datensätze. Nach dem Import können Sie auf einen Datensatz klicken un die die Datensatzansicht öffnen.

      Bitte beachten Sie, dass die Datensatzansicht nicht nach der Simulation zur Verfügung steht.

17. Falls Sie eine Simulation durchgeführt haben: kehren Sie zurück zur Konfiguration und klicken den Button Importieren

18. Schließen Sie den Tab.

Als Erfolgskontrolle können Sie in der Datensatztyp-Übersicht die aktualisierte Anzahl der Datensätze im Datensatztyp sehen, in den Sie Daten importiert haben. Je nach Import-Art kann die Anzahl der importierten Datensätze von der Anzahl der Quelle abweichen.

Import-Konfiguration

Datenimporte können durch Import-Konfigurationen unterstützt werden. Eine Konfiguration beinhaltet die Zuweisung von Quell- und Zielfeldern inkl. Importfunktion, Rollen, IID und den Status der Checkbox Referenzfelder. Das Auswahlmenü für Konfiguration wird angezeigt, nachdem die zu importierenden Daten und der Zieldatensatztyp festgelegt wurden.

Das Auswahlmenü für Import-Konfigurationen ist verfügbar ab dem Importschritt, in dem die Zielzuweisung erfolgt.

Folgende Aktionen sind für Import-Konfigurationen möglich:

• Konfiguration laden
• Konfiguration speichern
• Konfiguration löschen
• Konfiguration importieren
• Konfiguration exportieren
• Konfiguration anpassen

Die Abbildung zeigt die Auswahl, die im Import-Schritt "Quell-Ziel-Zuweisung" angezeigt wird: (1) Konfiguration laden, (2) Konfiguration speichern, (3) Konfiguration löschen, (4) Konfiguration importieren, (5) Konfiguration exportieren, (6) Zurück zu den Grundeinstellungen

Konfiguration laden

Bereits gespeicherte Konfigurationen werden geladen.

1. klicken Sie auf das Auswahlmenü und wählen Sie Konfiguration laden

   Ein Fenster mit einer Liste verfügbarer Konfigurationen öffnet sich.

2. wählen Sie die passende Konfiguration aus und klicken Sie auf den Button Ok

   Die definierten Zuweisungen aus der Konfiguration wurden durchgeführt.

   In der Kopfzeile steht jetzt der Name der geladenen Konfiguration.

   Bei einem Import ohne geladene Konfiguration steht in der Kopfzeile

   • bei CSV-Import: * Neu * und der Titel der CSV-Datei
   • bei Cortex-zu-Cortex-Import: CORTEX Import - Grundeinstellungen

3. bearbeiten Sie bei Bedarf die Konfiguration

   Import-Konfiguration bearbeiten

   • CSV-Import: Folgen Sie den Anweisungen ab Handlungsschritt 6
   • Cortex-zu-Cortex-Import: Folgen Sie den Anweisungen ab Handlungsschritt 7

4. fahren Sie mit dem Import fort

Konfiguration speichern

Es ist möglich, die Konfiguration zu jedem Zeitpunkt der Zuweisung von Quell- und Zielfeldern zu speichern.

1. öffnen Sie das Auswahlmenü in der Kopfzeile und wählen Sie Konfiguration speichern, sobald Sie einen Zuweisungsstand erreicht haben, den Sie wieder verwenden wollen

   Ein Fenster mit dem Speicherdialog erscheint.

2. geben Sie in das Feld einen Namen ein, um eine neue Konfiguration zu speichern

   Die maximale Zeichenlänge ist 220 Zeichen.

3. wenn Sie einen bestehenden Namen aus der Liste auswählen, überschreiben Sie die bisherige Konfiguration

4. klicken Sie auf den Button Ok (oder Abbrechen)

   Die Konfiguration wurde gespeichert.

5. fahren Sie bei Bedarf mit dem begonnenen Import fort

Konfiguration löschen

1. öffnen Sie das Auswahlmenü in der Kopfzeile und wählen Sie Konfiguration löschen

   Ein Fenster mit der Liste der verfügbaren Konfigurationen erscheint.

   Sie können nur Konfigurationen löschen, die für den gerade laufenden Import-Vorgang (CSV oder Cortex-zu-Cortex) vorhanden sind.

2. wählen Sie die zu löschende Konfiguration und klicken Sie auf den Button Löschen

   Ein Fenster mit dem Bestätigungsdialog erscheint.

3. klicken Sie auf den Button Ja (oder Nein)

   Die Konfiguration wird gelöscht und aus der Liste entfernt.

4. löschen Sie bei Bedarf eine weitere Konfiguration

5. klicken Sie auf den Button Abbrechen, um das Fenster zu schließen

6. fahren Sie mit dem begonnenen Import fort oder schließen Sie den Import-Tab

Konfiguration importieren

1. öffnen Sie das Auswahlmenü in der Kopfzeile und wählen Sie Konfiguration importieren

   Ein Fenster mit dem Importdialog erscheint.

2. wählen Sie eine XML-Datei und klicken Sie auf den Button Importieren

3. wählen Sie die passende Konfiguration aus und klicken Sie auf den Button Ok

   Die definierten Zuweisungen aus der Konfiguration wurden durchgeführt.

   In der Kopfzeile steht jetzt importiert.

4. bearbeiten Sie bei Bedarf die Konfiguration

   Import-Konfiguration bearbeiten

   • CSV-Import: Folgen Sie den Anweisungen ab Handlungsschritt 6
   • Cortex-zu-Cortex-Import: Folgen Sie den Anweisungen ab Handlungsschritt 7

5. fahren Sie mit dem Import fort

Konfiguration exportieren

Es ist möglich, die Konfiguration zu jedem Zeitpunkt der Zuweisung von Quell- und Zielfeldern zu exportieren.

1. öffnen Sie das Auswahlmenü in der Kopfzeile und wählen Sie Konfiguration exportieren, sobald Sie einen Zuweisungsstand erreicht haben, den Sie wieder verwenden wollen

   • Der Export startet automatisch.
   • Eine XML-Datei wird im Download-Ordner Ihres Browsers gespeichert.
   • Der Dateiname setzt sich zusammen aus importconfiguration_, dem Tagesdatum und ggf. einer Nummerierung, wenn mehr als ein Export an dem Tag durchgeführt wird, z.B. importconfiguration_2024-06-20(1).xml.

2. editieren Sie den Dateinamen nach dem Export und vergeben Sie einen aussagekräftigen Namen

   Es wird empfohlen, im Dateinamen auch CSV bzw. Cortex zu verwenden, wenn Sie beide Import-Varianten nutzen.

Konfiguration anpassen

Import-Automatismen benötigen Import-Konfigurationen in Form von XML-Dateien. Das Plugin bietet die Möglichkeit, die Basis-Konfiguration bequem zu definieren und als XML-Datei zu exportieren. Diese XML-Datei wird dann in einem externen Programm angepasst.

Vermeidung von grundlegenden Fehlern bei Anpassungen der Import-Konfiguration

• Führen Sie zunächst die allgemeine Konfiguration mithilfe des Plugins durch, bevor Sie die Konfiguration anpassen.
• Exportieren Sie die Konfigurationsdatei, um sie zu bearbeiten.