Feldmapping
Das Feldmapping legt fest, welche Felder aus dem Eingabeformat (z. B. cXML) in welche Felder des Ausgabeformats (z. B. openTrans) übernommen werden – und wie sie dabei umgewandelt werden.
Überblick
Wenn eine Bestellung bei Orderport eingeht, wird sie Feld für Feld transformiert. Das Mapping bestimmt:
- Welches Quellfeld dem welchem Zielfeld zugeordnet wird
- Welcher Mapping-Typ verwendet wird (direkt, statischer Wert, Transformation)
- Welche Funktion optional auf den Wert angewendet wird
Mapping-Canvas öffnen
Das Feldmapping erreichen Sie auf zwei Wegen:
- Im Wizard – Schritt 2 beim Erstellen einer neuen Pipeline
- Auf der Pipeline-Detailseite – Klicken Sie auf Bearbeiten und dann auf den Mapping-Tab
So funktioniert der Mapping-Canvas
Der Canvas zeigt drei Spalten:
| Spalte | Bedeutung |
|---|---|
| Links (blau) | Quellfelder aus dem Eingabeformat |
| Mitte | Verbindung mit Mapping-Typ |
| Rechts (grün) | Zielfelder des Ausgabeformats |
Felder verbinden
- Klicken Sie auf ein Quellfeld (links) – es wird blau hervorgehoben
- Klicken Sie auf ein Zielfeld (rechts) – die Verbindung wird erstellt
- Das Mapping erscheint in der Mitte
Auto-Mapping
Beim ersten Öffnen schlägt Orderport automatisch die wichtigsten Zuordnungen vor. Diese Vorschläge basieren auf den Feldnamen und können einzeln übernommen oder entfernt werden.
Die vier Mapping-Typen
| Typ | Farbe | Wann verwenden? |
|---|---|---|
| Direct | Grün | Wert 1:1 übernehmen (z. B. Bestellnummer → Bestellnummer) |
| Static | Lila | Festen Wert setzen, unabhängig vom Eingangsdokument (z. B. Währung = "EUR") |
| Transform | Blau | Wert übernehmen und dabei eine Funktion anwenden (z. B. Datum umformatieren) |
| Ignore | Grau | Quellfeld explizit ignorieren (wird nicht übertragen) |
Direct (Grün)
Der Wert aus dem Quellfeld wird exakt in das Zielfeld übernommen. Das ist der häufigste Typ.
Beispiel: OrderID → ORDER_ID – die Bestellnummer wird 1:1 kopiert.
Static (Lila)
Ein fester Wert wird in das Zielfeld geschrieben, ohne ein Quellfeld zu verwenden.
Beispiel: CURRENCY = EUR – jede Bestellung erhält die Währung Euro.
So legen Sie ein Static-Mapping an:
- Klicken Sie auf ein Zielfeld
- Wählen Sie den Typ Static
- Geben Sie den gewünschten Wert ein
Transform (Blau)
Der Wert aus dem Quellfeld wird übernommen, aber vorher durch eine Funktion verarbeitet.
Verfügbare Funktionen:
| Funktion | Beschreibung | Beispiel |
|---|---|---|
uppercase |
In Großbuchstaben umwandeln | "abc" → "ABC" |
lowercase |
In Kleinbuchstaben umwandeln | "ABC" → "abc" |
trim |
Leerzeichen am Anfang/Ende entfernen | " abc " → "abc" |
date_format |
Datumsformat ändern | "2026-03-07T10:30:00" → "2026-03-07" |
multiply |
Zahlenwert multiplizieren | "10" × 100 → "1000" |
Beispiel: OrderDate mit date_format (von Y-m-d\TH:i:s nach Y-m-d) – das Datum wird vom ISO-Format ins kurze Format umgewandelt.
Ignore (Grau)
Das Quellfeld wird bewusst nicht übertragen. Das ist nützlich, um zu dokumentieren, dass ein Feld absichtlich weggelassen wird.
KI-Unterstützung
Orderport bietet zwei KI-Funktionen, die Ihnen beim Mapping helfen:
KI-Vorschläge
Auf der rechten Seite des Canvas finden Sie den Tab KI-Vorschläge. Diese werden automatisch generiert und zeigen:
- Vorgeschlagener Mapping-Typ (direct, static, transform)
- Quell- und Zielfeld
- Begründung, warum diese Zuordnung sinnvoll ist
- Konfidenz (wie sicher sich die KI ist)
Klicken Sie auf Übernehmen, um einen Vorschlag in Ihr Mapping zu übernehmen.
Chat-Assistent
Im Tab Chat können Sie in natürlicher Sprache Anweisungen geben:
- "Setze die Währung auf EUR" → erstellt ein Static-Mapping für CURRENCY
- "Übernimm die Bestellnummer direkt" → erstellt ein Direct-Mapping
- "Formatiere das Datum auf TT.MM.JJJJ" → erstellt ein Transform-Mapping
Der Chat zeigt Ihnen eine Vorschau der Änderung als Karte, die Sie mit einem Klick übernehmen können.
Dokumentvorschau
Am unteren Rand des Canvas können Sie eine Dokumentvorschau aufklappen. Diese zeigt:
- Links: ein Beispiel-Eingangsdokument (z. B. cXML)
- Rechts: ein Beispiel-Ausgangsdokument (z. B. openTrans)
So sehen Sie sofort, welche Felder in welchem Format vorhanden sind.
Mapping speichern
Klicken Sie auf Speichern, um Ihr Mapping zu sichern. Die Änderungen werden sofort wirksam – alle zukünftigen Bestellungen werden mit dem neuen Mapping transformiert.
Bereits transformierte Bestellungen werden nicht rückwirkend geändert.
Nächste Schritte
- Bestellungen verwalten – eingegangene Bestellungen einsehen
- Pipeline einrichten – zurück zur Pipeline-Konfiguration