Zuordnen und Transformieren
Zweck der Funktion
Der Mapping Editor erlaubt das Zuordnen und Transformieren von Attributen, wodurch individuelle Anpassungen der Attributwerte möglich werden. So ist es beispielsweise möglich, mehrere Attribute miteinander zu verbinden oder zusätzliche Zeichen hinzuzufügen.
Einführung
Mithilfe der Zuordnen und Transformieren Funktion können Attributwerte so verändert werden, dass individuelle Werte aus einem oder mehreren Quellattributen erstellt werden können.
Dazu wird ein Transformierungskatalog bereitgestellt, mit welchem diverse Optionen, wie zum Beispiel das Hinzufügen, Auffüllen oder Löschen von Zeichen, ermöglicht werden.
Voraussetzungen und Beziehungen zu anderen Modulen
Die Funktion kann in allen drei Bereichen (Attribut Mapping, Schlüsselattribut Mapping, Klassifikationspfad Mapping) des Mapping Editors ausgeführt werden, sobald ein Attribut ausgewählt wurde.
Verwendung
Sobald die Funktion "Zuordnen und Transformieren" in der Toolbar ausgewählt wurde, öffnet sich ein Dialog.
Dieser ist unterteilt in eine Titlebar, Navigationbar, Toolbar, Statusbar und den Canvas.
Statusbar
In der Statusbar kann, wie im Mapping Editor in der Titlebar, die Wertevorschau mithilfe einer Paginierung verändert werden. Außerdem wird das Ergebnis, d.h. der finale Wert, der in OMN importiert wird, angezeigt.
Canvas
Der Canvas ist grob in zwei Bereiche unterteilt:
Quellattribute
Im oberen Bereich des Dialogs befindet sich ein Tabellen Widget mit der Überschrift "Quellattribute".
Darunter kann via Dropdown - sofern gewünscht - im Transformationskatalog ein Transformationstyp ausgewählt werden. Dadurch ist es dem Nutzer möglich, eine von den folgenden Transformationen auf ein Quellattribut auszuführen:
| Die Transformationen werden weiter unten im Kapitel Transformationskatalog - Transformationen auf dem Attributergebnis näher beschrieben. |
| Eine Transformation kann erst nach dem Hinzufügen eines Quellattributs ausgeführt werden. |
Die Tabelle beinhaltet standardmäßig vier Spalten.
-
Quellattribut
Attribut aus der Mapping Datei, welches dem OMN Attribut zugeordnet werden soll. -
Bezeichner
Automatisch erstellter Bezeichner des Quellattributs (bestehend aus einem "$" und dem Attributnamen in Kleinbuchstaben), welcher als Grundlage für weitere Transformationen im Transformationskatalog - Transformationen auf dem Attributergebnis (als Basis für Skripte) verwendet werden kann. -
Initialer Wert
Zeigt den Ursprungswert, welcher in der Quelldatei ohne Transformationen hinterlegt ist. -
Aktueller Wert
Zeigt den aktuellen Wert, der sich aus der Transformation des Quellattributs ergibt.
| Spalten können je nach Transformationsauswahl variieren. Jede Transformation fügt weitere Spalten hinzu, um weitere Variablen, z.B. Zeichen, die ersetzt werden sollen, hinzuzufügen. |
Die Tabelle ist zunächst leer und beinhaltet keine Attribute, sofern noch keine 1:1 Zuordnung vorgenommen wurde. Mithilfe des Buttons "Quellattribut hinzufügen" können ein oder mehrere Quellattribute hinzugefügt werden.
Falls bereits ein Mapping vorgenommen wurde, wird das verwendete Quellattribut in der Tabelle angezeigt.
Die Reihenfolge der Attribute kann mithilfe der Pfeilsymbole rechts neben dem Button verändert werden.
.png)
.png)
Transformationskatalog - Transformationen auf dem Attributergebnis
Der untere Bereich des Dialogs erscheint erst, sobald ein Quellattribut zum Transformieren hinzugefügt wurde.
In bis zu drei Schritten können hier verschiedene Transformationen auf das Attributergebnis (Ergebnis aus dem oberen Bereich) durchgeführt werden.
Schritte
Der Transformationsbereich beginnt mit einer Übersicht über die Schritte. Es können maximal drei Schritte hinzugefügt werden, wobei der nächste Schritt immer erst dann ergänzt werden kann, sobald eine Transformation im davor gehenden Schritt ausgewählt wurde.
Begonnen wird mit "Schritt 1". Sobald eine Transformation ergänzt wurde, erscheint neben dem "Schritt 1" ein Button "Transformation hinzufügen".
Wenn der Nutzer diesen verwendet, wird "Schritt 2" ergänzt usw.
Sofern ein Schritt gelöscht werden soll, kann die Funktion "Transformation entfernen" benutzt werden. Daraufhin verschwindet der letzte Schritt.
| Schritte können nur chronologisch gelöscht werden, d.h. es kann immer nur der zuletzt hinzugefügte Schritt entfernt werden. |
Der Nutzer kann zwischen den einzelnen Schritten hin- und herspringen, indem der gewünschte Schritt angeklickt wird.
Vorbedingungen
Der Nutzer kann die Transformationen auf das Attributergebnis insofern einschränken, dass diese nur unter bestimmten Voraussetzungen greifen.
Dazu gibt es den Toggle "Vorbedingung aktiv/inaktiv".
Ist dieser inaktiv, werden keine Vorbedingungen bei der Transformation berücksichtigt.
Sobald der Toggle aktiv ist, werden zusätzliche Felder angezeigt, um die Transformationen weiter einzuschränken.
Eine Vorbedingung setzt sich immer aus einer "Wenn … dann" Beziehung zusammen.
Der Nutzer wählt hierzu zunächst ein Quellattribut (z.B. Farbe) mithilfe des ersten Dropdowns aus.
Anschließend wird mit dem zweiten Dropdown der Operator (z.B. entspricht) ausgewählt.
In den meisten Fällen erscheint daraufhin ein Eingabefeld, um die Bedingung (z.B. grün) eintragen zu können.
Daraus ergibt sich folgendes Beispiel:
Wenn die Farbe dem Wert "grün" entspricht, dann…
(mit möglicher Transformation) suche das Wort "grün" und ersetze es durch "dunkelgrün".
Transformationskatalog
Die Transformation via Transformationskatalog startet mit einem Dropdown, welches zunächst leer ist.
Es beinhaltet folgende Transformationsmöglichkeiten:
| Skripte und String Templates können nur im ersten Schritt hinzugefügt werden. |
Sobald eine Transformationsoption im Dropdown ausgewählt wurde, erscheint eine zusätzliche Tabelle, um Detaileinstellungen vornehmen zu können.
Diese sind spezifisch für die jeweiligen Optionen und werden in den nachfolgenden Kapiteln näher erläutert.
Neben den für die Auswahl spezifischen Tabellenspalten befinden sich immer rechts in der Tabelle zwei Spalten, die für alle Optionen gelten:
-
Vorheriges Ergebnis
Anzeige des Ergebnisses des vorherigen Schritts (für den ersten Schritt wird das aktuelle Ergebnis aus dem Quellattribut-Bereich verwendet) -
Zwischenergebnis
Anzeige des Ergebnisses aus der aktuellen Transformation
Zeichen hinzufügen
Diese Transformation dient dazu, ein oder mehrere Zeichen zum aktuellen Wert (Attributergebnis) hinzuzufügen.
Die Tabelle beinhaltet zwei Spalten, die bearbeitet werden können:
-
Hinzugefügter Wert
-
Eingabefeld, es können frei Zeichen eingefügt werden
-
-
Zeichenposition
-
Dropdown mit zwei Optionen
-
Beginn des Strings
-
Ende des Strings
-
-
Beispiel:
Aktuelles Ergebnis: 12345
Hinzugefügter Wert: .abc
Zeichenposition: Ende des Strings
Zwischenergebnis: 12345.abc
Zeichen auffüllen
Diese Transformation dient dazu, ein bestimmtes Zeichen zum aktuellen Wert (Attributergebnis) hinzuzufügen.
Die Tabelle beinhaltet drei Spalten, die bearbeitet werden können:
-
Wertelänge
-
Eingabefeld, es können nur ganze Zahlen eingefügt werden
-
gibt an, wie lang der endgültige Wert sein soll
-
-
Auffüllendes Zeichen
-
Eingabefeld, es kann ein beliebiges Zeichen eingefügt werden
-
hat der Wert beispielsweise 6 Zeichen und soll 8 Zeichen umfassen, wird das auffüllende Zeichen zwei mal an der gewünschten Position aufgefüllt
-
-
Zeichenposition
-
Dropdown mit zwei Optionen
-
Beginn des Strings
-
Ende des Strings
-
-
Beispiel:
Aktuelles Ergebnis: 12345
Wertelänge: 8
Auffüllendes Zeichen: 0
Zeichenposition: Beginn des Strings
Zwischenergebnis: 00012345
Zeichen löschen
Diese Transformation dient dazu, Zeichen vom aktuellen Wert (Attributergebnis) zu löschen.
Die Tabelle beinhaltet zwei Spalten, die bearbeitet werden können:
-
Wertelänge
-
Eingabefeld, es können nur ganze Zahlen eingefügt werden
-
Anzahl der Zeichen, die entfernt werden sollen
-
-
Zeichenposition
-
Dropdown mit zwei Optionen
-
Löschen vom Beginn des Strings
-
Löschen vom Ende des Strings
-
-
Beispiel:
Aktuelles Ergebnis: 12345
Wertelänge: 2
Zeichenposition: Löschen vom Ende des Strings
Zwischenergebnis: 123
Suchen und Ersetzen
Diese Transformation dient dazu, ein bestimmtes Zeichen oder eine Aneinanderreihung von Zeichen im aktuellen Wert (Attributergebnis) zu suchen und dieses durch ein bestimmtes Zeichen oder eine Aneinanderreihung von Zeichen zu ersetzen.
Die Tabelle beinhaltet zwei Spalten, die bearbeitet werden können:
-
Suchen nach
-
Eingabefeld, es können frei Zeichen eingefügt werden
-
es werden nur Werte berücksichtigt, die genau diese Zeichen enthalten
-
-
Ersetzen mit
-
Eingabefeld, es können frei Zeichen eingefügt werden
-
die gefundenen Zeichen werden durch den angegebenen Wert ersetzt
-
Beispiel:
Aktuelles Ergebnis: Midnight Sky Blue
Suchen nach: Midnight
Ersetzen mit: Mid
Zwischenergebnis: Mid Sky Blue
Multiplikation und Division
Diese Transformation dient dazu, den aktuellen Wert (Attributergebnis) durch einen bestimmten Faktor zu teilen oder diesen mit einem bestimmten Faktor zu multiplizieren.
Die Tabelle beinhaltet zwei Spalten, die bearbeitet werden können:
-
Operator
-
Dropdown mit zwei Optionen
-
"X" (Multiplikation)
-
"/" (Division)
-
-
-
Eingabe
-
Eingabefeld, es können nur Zahlenwerte eingefügt werden
-
eingetragen wird der Faktor
-
Beispiel:
Aktuelles Ergebnis: 42,5
Operator: X
Eingabe: 2
Zwischenergebnis: 85
| Diese Transformation ist eine mathematische Transformation und ist daher nur für Zahlenwerte bzw. mathematische Veränderungen sinnvoll zu verwenden. |
Addition und Subtraktion
Diese Transformation dient dazu, zu dem aktuellen Wert (Attributergebnis) einen Wert zu addieren oder vom diesem einen Wert zu subtrahieren.
Die Tabelle beinhaltet zwei Spalten, die bearbeitet werden können:
-
Operator
-
Dropdown mit zwei Optionen
-
"+" (Addition)
-
"-" (Subtraktion)
-
-
-
Eingabe
-
Eingabefeld, es können nur Zahlenwerte eingefügt werden
-
Beispiel:
Aktuelles Ergebnis: 42,5
Operator: +
Eingabe: 3
Zwischenergebnis: 45,5
| Diese Transformation ist eine mathematische Transformation und ist daher nur für Zahlenwerte bzw. mathematische Veränderungen sinnvoll zu verwenden. |
String Template hinzufügen
Diese Transformation dient dazu, ein oder mehrere Quellattribute in ein Template zu übertragen, um somit beispielsweise eine bestimmte Reihenfolge festzulegen, damit für diese Aktion nicht diverse Transformationskombinationen durchgeführt werden müssen.
Die Tabelle beinhaltet eine Spalte (Eingabe), die aus einem großen Eingabefeld besteht.
Um ein Template zu erstellen, können beliebig viele Wörter oder Zeichen eingefügt werden.
Die Grundlage bildet der Bezeichner eines Quellattributs. Dieses setzt sich immer aus einem "$" Zeichen und dem Quellattributnamen in Kleinbuchstaben (z.B. $artikelnummer) zusammen.
Ein oder mehrere Quellattribute können so beliebig kombiniert und positioniert als auch mit weiteren Zeichen verknüpft werden.
Beispiel:
Eingabe: $hoehe cm x $breite cm x $tiefe cm
Zwischenergebnis: 12 cm x 8 cm x 2 cm
Skript hinzufügen
Diese Transformation dient dazu, ein oder mehrere Quellattribute frei via Skript so zu verändern, dass sie zu den kundenspezifischen Anwendungsfällen passt.
Die Tabelle beinhaltet eine Spalte (Codeeingabe), die aus einem großen Code-Eingabefeld besteht.
Ähnlich wie bei dem String Template können auf der Basis von Bezeichnern und Code benutzerdefinierte Ergebnisse erzielt werden.
Die Syntax des eingetragenen Codes kann mithilfe des Buttons "Syntax prüfen" überprüft werden.
Entweder erscheint darunter eine grüne Nachricht, dass die Syntax keine Fehler enthält oder es wird eine rote Fehlermeldung angezeigt.
| Diese Transformationsoption ist eine Expertenfunktion. Der Nutzer benötigt Programmierkenntnisse. |