|
|
# enaio Komponente: Import
|
|
|
|
|
|
Die enaio Blue Komponente `Import` dient dazu, Daten in enaio einzulesen und aus diesen Daten Objekte anzulegen.
|
|
|
|
|
|
<img src="images/enaioBlueImport.svg" width="64" style="float: right;">
|
|
|
|
|
|
## Konfiguration
|
|
|
|
|
|
|
|
|
### Basic Settings
|
|
|
|
|
|
Auf der `Component`-Reiter in Talend können die meisten Einstellungen unter `Basic settings` vorgenommen werden.
|
|
|
|
|
|
![Der Import wird über die Basic Settings konfiguriert.](images/2018-06-12-Talend-blueline-import-basic-settings.png)
|
|
|
|
|
|
*Der Import wird über die Basic Settings konfiguriert.*
|
|
|
|
|
|
Folgend werden die hier möglichen Einstellungen dokumentiert. Die Einträge sind pro Zeile, wie sie in Talend dargestellt werden zusammengefasst.
|
|
|
<table>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Enaio Connection
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Die mithilfe der `enaioBlueConnection`-Komponente aufgebaute Verbindung wird hier ausgewählt.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Object Internal Name / Object Type ID
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Je nach Auswahl im Feld `Ident` wird das Feld entweder mit `Object Internal Name` oder `Object Type ID` beschriftet und erwartet entsprechende Eingaben.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Folder ID
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Ist das zu importierende Element innerhalb eines Ordners, kann hier die Ordner ID mitgegeben werden. Es ist möglich hier statt einer konkreten ID auch Java-Code mitzugeben, über den die Ordner-ID ermittelt wird.</br>
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Register ID
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Ist das zu importierende Element innerhalb eines Registers, kann hier die Register ID mitgegeben werden. Es ist möglich hier statt einer konkreten ID auch Java-Code mitzugeben, über den die Register-ID ermittelt wird.</br>
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Action 0
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Ü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.\n
|
|
|
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Action 1
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
|
|
|
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.\n
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Action M
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
|
|
|
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.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Fields
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
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. </br>
|
|
|
Die Spalte `Internal name` enthält den Namen in enaio. \n
|
|
|
Die Spalte `Field type` kann auf 3 verschiedene Werte gesetzt werden:</br>
|
|
|
|
|
|
1. `Import`: </br>
|
|
|
Das Feld soll importiert werden.
|
|
|
2. `Search`: \n
|
|
|
Das Feld ist ein Suchfeld. Nach diesem Wert wird in enaio gesucht um festzustellen, ob das Objekt bereits existiert.
|
|
|
3. `Import and Search`: \n
|
|
|
Es soll nach dem im Feld enthaltenen Wert gesucht werden und der Wert soll importiert werden.</br>
|
|
|
4. `Table field`: \n
|
|
|
Soll eine Tabelle in enaio befüllt werden, muss als Field type `Table field` ausgewählt werden. Als eingehende Daten wird von Talend der Typ `List` erwartet</br>
|
|
|
|
|
|
|
|
|
Die Spalte `Format` enthält entweder den Wert `Default` für Strings oder Zahlen; oder kann auf `Datetime` gesetzt werden, für Datums- und Timestamp-Felder.</br>
|
|
|
Die Spalte `System Field` enthält eine Checkbox über die Systemfelder gekennzeichnet werden können.</br>
|
|
|
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.
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Static Fields
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Im Static Fields eingeträgene Werte werden immer fest in ein Feld in Enaio eingetragen.
|
|
|
Unter `Internal Name` wird wie schon bei `Fields` der Name aus enaio vermerkt. `Value` soll den Wert enthalten, den dieses enaio-Feld enthalten soll.
|
|
|
Die übrigen Felder verhalten sich wie die gleichnamigen Felder in der Tabelle `Fields`.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Ident.
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Unter `Ident.` kann per Dropdown ausgewählt werden, ob der Pfad zu möglichen hinterlegten Dokumenten `Static`, also statisch, oder basierend auf einem Feld aus der Talend-Strecke, also `Flow` gewählt werden soll.
|
|
|
Dieses Feld, sowie das Schwesterfeld `Files` muss nur dann befüllt werden, wenn hinter den zu Importierenden Daten auch tatsächliche Dokumente liegen.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Files
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
Wurde bei `Ident.` der Wert `Static` ausgewählt, kann hier zwischen doppelte Anführungszeichen der Pfad zu einem File angegeben werden. Wurde im Feld `Ident.` jedoch `Flow` ausgewählt, verwandelt sich das Feld in ein Dropdown und es kann ein Feld aus dem Schema gewählt werden.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
<tr>
|
|
|
<th VALIGN="TOP">
|
|
|
Maintype
|
|
|
|
|
|
</th>
|
|
|
<td>
|
|
|
`Maintype` ist ein Dropdown Feld in dem der Typ der Dokumente mitgegeben wird. Mögliche Werte sind `System default, Image(Gray), Image(Black & White), Image(Color), Windows, Multimedia, Mail, XML,` und `ZIP container`.
|
|
|
|
|
|
</td>
|
|
|
</tr>
|
|
|
</table>
|
|
|
|
|
|
|
|
|
### Advanced Settings
|
|
|
|
|
|
Weitere Einstellungen können unter `Advanced settings` vorgenommen werden. Die Komponente ist lauffähig mit den unten dargestellten Default-Werten. Zur Erläuterung der Optionen kann das enaio Server API Handbuch herangezogen werden. Die Einstellungen sind im Kapitel "DMS-Engine (Namespace dms)" im Unterkapitel "Der Parameter 'Options'".
|
|
|
|
|
|
|
|
|
![Import Component Advanced Settings](images/2018-06-12-Talend-blueline-import-advanced-settings.png)
|
|
|
|
|
|
*Import Component Advanced Settings*
|
|
|
|
|
|
|
|
|
## Beispiel
|
|
|
|
|
|
In diesem Beispiel sind die `Basic Settings` so ausgefüllt, dass damit neue Objekt im Ordner `Personalakte` angelegt werden. Das Suchfeld zur Identifikation bereits vorhandener Einträge ist hier `Personalnummer`.
|
|
|
|
|
|
|
|
|
![Die Basic Settings der Import-Komponente wird hier verwendet um neue Personalakten in enaio anzulegen.](images/2018-06-12-Talend-blueline-import-basic-settings-filled.png)
|
|
|
|
|
|
*Die Basic Settings der Import-Komponente wird hier verwendet um neue Personalakten in enaio anzulegen.*
|
|
|
|