Die yuuvis Komponente Import ermöglicht es Daten in yuuvis zu importieren.

Die Import-Komponente benötigt zwingend einen eingehenden Datenfluss, um zu funktionieren.

Konfiguration

Die Konfiguration der Import-Komponente funktioniert wie folgt dargestellt.

Basic Settings

Auf der Component-Reiter in Talend können die meisten Einstellungen unter Basic settings vorgenommen werden.

Component Basic Settings

Folgend werden die hier möglichen Einstellungen dokumentiert. Die Einträge sind pro Zeile, wie sie in Talend dargestellt werden zusammengefasst.

Connection Die mithilfe der `enaioRedConnection`-Komponente aufgebaute Verbindung wird hier ausgewählt.
Mode Im Feld Mode stehen 3 verschiedene Modi zur Auswahl

  1. Insert
    Der Insert fügt ein Objekt in enaio ein. Bei Insert in einen Ordner ist zwingend erforderlich, dass die Parent ID gefüllt ist.

  2. Update
    Update aktualsiert ein bereits im Sytem vorhandenes Objekt. Bei einem Update wird nur die ID des Objekts benötigt, das ein Update erfahren soll.

  3. Import
    Sobald Import gewählt wird sind auf der Maske weitere Felder möglich zu befüllen:

    • Action 0:
      Über dieses Feld kann gesteuert werden, wie sich das System im Fall von 0 Treffern verhalten soll. Der Standard wäre hier Insert (Also dass das Objekt eingefügt wird). Die beiden anderen Möglichkeiten sind None, also das nichts getan werden soll und Error, also dass ein Fehler ausgegeben werden soll.

    • Action 1:
      Hier kann bestimmt werden, was passieren soll, sobald nur ein 1 Treffer in enaio gefunden wurde. Der Standard-Wert hier ist Update, also dass das eine gefundene Objekt mit den Werten aus der Tabelle Fields aktualisiert werden soll.

    • Action M:
      Bei mehreren Treffern in enaio ist der Default-Wert Error, also die Ausgabe eines Fehlers. Es kann über dieses Feld aber auch spezifiziert werden, dass über Update First nur der erste gefundene Treffer aktualisiert werden soll, über Update All, dass sämtliche Treffer mit den Werten aus Fields aktualisiert werden sollen oder über None, dass einfach nichts geschehen soll.
Object Type `Object Type` ist der zu importierende Objekttyp aus Enaio. Der Typ muss in der Implementation von Red, zu der die Verbindung aufgebaut wurde, aufgesetzt sein.
Parent ID Die `ParentID` ist bei allen Objekten nötig, die nicht Ordner sind. Im Falle von zu importierenden Ordnern kann das Feld auf `No Parent` gesetzt werden.
Bei Registern oder Dokumenten kann die `ParentID` entweder aus dem Flow (Dropdown wird auf `Flow` gesetzt) entnommen werden oder via Java-Code mitgegeben werden (Dropdown wird auf `Java` gesetzt). So ist via Java beispielsweise möglich die `Parent-ID` aus zuvor definierten globalen Variablen innerhalb der Talend Strecke zu beziehen.
Wurde im Feld `Parent ID` der Wert `Flow` gewählt, kann im nächsten Feld per Dropdown ausgewählt werden, aus welchem Feld aus dem Flow der Wert kommt.
Wurde im Feld `Parent ID` der Wert `Java` gewählt, kann im nächsten Feld nun der Java-Code, über den die `Parent ID` identifiziert wird, eingegeben werden.
`Parent Type` enthält den internen Namen des Parent Typs aus enaio.
Mapping Die Tabelle `Mapping` soll die zu importierenden Felder und ihr Mapping auf enaio Felder enthalten. die Felder `IMPORT_ID` , `IMPORT_ACTION`, `IMPORT_ERROR_MESSAGE`, und `IMPORT_HITS` sind immer zu importieren. Alle Felder aus dem Schema des eingehenden Datenflusses werden ebenfalls automatisch hier aufgeführt.

Die Spalte Column enthält den technischen Namen des Feldes im Eingangsflow.
Die Spalte Name enaio enthält den Namen in enaio.
Die Spalte Mode kann auf 3 verschiedene Werte gesetzt werden:

  1. Import:
    Das Feld soll importiert werden.
  2. Search:
    Das Feld ist ein Suchfeld. Nach diesem Wert wird in enaio gesucht um festzustellen, ob das Objekt bereits existiert.
  3. Import and Search:
    Es soll nach dem im Feld enthaltenen Wert gesucht werden und der Wert soll importiert werden.
    Die Spalte Ignore Null/Empty gibt an, wie sich das System verhalten soll, falls der einzufügende Wert leer ist. Wird das Häkchen hier gesetzt, so wird der Wert ignoriert und ein Wert, der bereits in Enaio für das Feld vorhanden ist bleibt erhalten. Ist das Feld nicht gesetzt werden alle Werte zu diesem Feld in Enaio ersetzt.
Static Mapping Im Static Mapping eingeträgene Werte werden immer fest in ein Feld in Enaio eingetragen. Unter `Name enaio` wird wie schon bei `Mapping` der Name aus enaio vermerkt. `Value` soll den Wert enthalten, den dieses enaio-Feld enthalten soll. `Mode` und `Ignore Null/Empty` werden wie oben bei `Mapping` bedient.
File Path Unter `File Path` kann per Dropdown ausgewählt werden, ob der Pfad zum tatsächlichen Dokument via `Java`oder via `Flow` angegeben werden soll. Ist `Java` ausgewählt, kann der Pfad in Form von Code im Eingabefeld dahinter hinterlegt werden. Wurde `Flow` ausgewählt, erscheint statt dem Eingabefeld ein Dropdown, indem ein Item aus der gerade verwendeten Talend-Strecke ausgewählt werden kann.
User Comment Unter `User Comment` kann ein Kommentar hinterlegt werden, der in enaio an das importierte Objekt angeheftet wird.

Advanced Settings

Weitere Einstellungen können unter Advanced settings vorgenommen werden.

Component Advanced Settings

  • Max Search Hits:
    Bei einer sehr grossen Zahl an Treffern kann es passieren, dass die Performance der Talend-Strecke leidet. Dies kann verhindert werden, indem in diesem Feld die maximale Anzahl der Treffer eingeschränkt wird. Der Default-Wert ist 1000; Um keine Einschränkung zu haben muss -1 hier eingetragen werden.
  • Die on Error:
    Diese Checkbox steuert, ob im Falle eines Fehlers abgebrochen werden soll, oder versucht werden soll, weiterzumachen.

Beispiel

Im folgenden Beispiel wird die yuuvis Komponente Import mit Beispieldaten aus einem Datengenerator versorgt.

Beispielanbindung der Import-Komponente

Hier sind die zugehörigen Basic Settings beispielhaft ausgefüllt. Es werden Personalakten mit den generierten Daten in enaio angelegt.

Component Basic Settings mit Beispielwerten