Feldzuordnungen

Über den Menüpunt "Feldzuordnungen" haben Sie die Möglichkeit, eine individuelle Zuordnung zwischen dem im jeweiligen Protokoll Ihres Kunden definierten Feldern und den in unserem System vorhandenen Feldern herzustellen.

Auf der linken Seite des Zuordnungswerkzeuges wählen Sie das Zielfeld des gewünschten Protokolls (z. B. OCI) aus, im Anschluss wählen Sie den gewünschten Zuordnungstyp (Datenbank, Festwert, Dynamisch (nur bei Gateway-Modus) aus.

Auf der rechten Seite wählen Sie das Quellfeld das / oder den Wert der dem jeweiligen Protokollfeld zuorgeordnet werden soll.

Datenbank: Wählen Sie im Feld "Quellfeld" ein Feld aus unserem Datenmodell aus, das bei der Übermittlung als Datenquelle für das gewählte Zielfeld genutzt werden soll.

Festwert: Geben Sie im Feld "Quellfeld" einen Festwert an, der bei der Übermittlung in das aufrufende ERP-System in dem gewählten Zielfeld ausgegeben werden soll.

Dynamisch: Dieser Zuordnungstyp ist nur für den Modus Gateway verfügbar. Hier besteht bei der Rückübertragung aus dem aufgerufenen Shop-System die Möglichkeit, weitere Daten im Objekt "product" zu übergeben und zuzuordnen.

...
    "additionalProp1": [
          {
            "label": "string",
            "value": "string"
          },
          {
            "label": "string",
            "value": "string"
          }
    ],
...

Beispiel: Sie übergeben im Objekt "product" zusätzlich das Array "classifications" in dem wiederum Objekte mit den Schlüsseln label und value vorhanden sind. Hier haben Sie die Möglichkeit, im ersten Eingabefeld die Schlüsselbezeichnung classifications zu hinterlegen und im zweiten den Wert des Schlüssels label. Das Feld value des selben Objektes wird ab sofort für die Feldzuordnung verwendet.

Was sind Feldtransformationen?

Feldtransformationen ermöglichen es Ihnen, Werte in Ihren Feldzuordnungen dynamisch zu verändern, bevor sie an das Zielsystem übergeben werden. Mit Hilfe von Transformationen können Sie Eingangswerte in andere Werte umwandeln, basierend auf definierten Regeln.

Zugriff auf Feldtransformationen

  1. Navigieren Sie zu Feldzuordnungen im Hauptmenü.
  2. Wählen Sie eine bestehende Feldzuordnung aus oder erstellen Sie eine neue.
  3. In der Detailansicht der Feldzuordnung sehen Sie eine Liste aller zugeordneten Felder.
  4. Neben jedem Feld befindet sich ein grüner Button mit der Beschriftung "Transformation(en)".

Erstellen und Bearbeiten von Transformationen

Um eine Transformation für ein Feld zu erstellen oder zu bearbeiten:

  1. Klicken Sie auf den grünen "Transformation(en)" Button neben dem gewünschten Feld.
  2. Es öffnet sich ein Seitenbereich mit den Transformationseinstellungen.
  3. Wenn noch keine Transformation existiert, wird automatisch eine leere Zuordnung erstellt.

Konfiguration einer Transformation

Art der Transformation

Aktuell wird der Transformationstyp "Wert ersetzen" (If-Transformation) unterstützt. Diese Transformation prüft, ob der Eingangswert mit einem definierten Wert übereinstimmt und ersetzt ihn gegebenenfalls durch einen anderen Wert.

Zuordnungen hinzufügen

  1. Geben Sie im Feld "Eingangswert" den Wert ein, der ersetzt werden soll.
  2. Geben Sie im Feld "Ersetzen durch" den Zielwert ein, der stattdessen verwendet werden soll.
  3. Klicken Sie auf "Weitere Zuordnung hinzufügen", um weitere Ersetzungsregeln zu definieren.

Fallback-Einstellungen

Payload als Fallback verwenden: Wenn aktiviert, wird der ursprüngliche Wert unverändert übernommen, falls keine Übereinstimmung gefunden wird.

Speichern oder Löschen von Transformationen

  • Klicken Sie auf "Speichern", um die Transformation zu speichern.
  • Klicken Sie auf "Löschen", um die Transformation zu entfernen.

Anwendungsbeispiele

Beispiel 1: Statuswerte umwandeln

Wenn Ihr Quellsystem Statuswerte wie "0" und "1" verwendet, das Zielsystem aber "Inaktiv" und "Aktiv" erwartet:

  1. Erstellen Sie eine Transformation mit folgenden Zuordnungen:
    • Eingangswert: "0" → Ersetzen durch: "Inaktiv"
    • Eingangswert: "1" → Ersetzen durch: "Aktiv"

Beispiel 2: Sprachcodes anpassen

Wenn Ihr Quellsystem Sprachcodes im Format "de-DE" verwendet, das Zielsystem aber nur "de" erwartet:

  1. Erstellen Sie eine Transformation mit folgenden Zuordnungen:
    • Eingangswert: "de-DE" → Ersetzen durch: "de"
    • Eingangswert: "en-US" → Ersetzen durch: "en"

Beispiel 3: Standardwerte setzen

Wenn Sie sicherstellen möchten, dass leere Werte durch einen Standardwert ersetzt werden:

  1. Erstellen Sie eine Transformation mit folgender Zuordnung:
    • Eingangswert: "" → Ersetzen durch: "Standard"
  2. Deaktivieren Sie "Payload als Fallback verwenden" und setzen Sie den Fallback-Wert auf "Standard".

Hinweise

  • Sie können mehrere Transformationen für ein Feld definieren.
  • Die Anzahl der aktiven Transformationen wird unter dem Feld in der Feldzuordnungsansicht angezeigt.
  • Transformationen werden in der Reihenfolge angewendet, in der sie definiert wurden.
  • Stellen Sie sicher, dass alle Eingangswerte und Ersetzungswerte korrekt definiert sind, um unerwartete Ergebnisse zu vermeiden.
PunchCommerce® ist ein Produkt der Netzdirektion GmbH