Open Office Hours Staffel 1: Session 5 - Feldzuordnungen
Feldzuordnungen sind das Herzstück jeder Datenintegration. Sie steuern, wie Daten von einem System in ein anderes gelangen und was unterwegs mit ihnen geschieht. Rapidi bietet Ihnen eine Reihe integrierter Formeln, mit denen Sie Ihre Daten konvertieren, filtern, nachschlagen und transformieren können, ohne eigenen Code zu schreiben.
Dieser Leitfaden behandelt Best Practices für beide Plattformen und zeigt Ihnen Schritt für Schritt, wie Sie Ihre Feldzuordnungen in MyRapidi einrichten.
In der 5. Session unserer Open Office Hours-Reihe erklären wir, wie Sie Feldzuordnungen über Rapidi einrichten.
So richten Sie Feldzuordnungen ein
In dieser Open Office Hours Session zeigen wir, wie Sie Formeln in den Feldzuordnungen von Rapidi für Situationen nutzen, in denen eine einfache 1:1-Zuordnung nicht ausreicht.
Behandelte Themen:
- Konvertierungen – Datenformate zwischen Quell- und Zielsystem angleichen (z. B. Datum zu Datum mit Uhrzeit)
- Bedingte Logik – Mit der CASE-Formel Werte zuordnen, die sich zwischen den Systemen unterscheiden, mit Standardwerten als Rückfalloption
- Lookups – Daten aus anderen Tabellen oder Views abrufen, mit Lookups auf das Ziel (DDS), die Quelle (SourceDS) und den Link Storage (LS)
- Textbearbeitung – Feldlängen mit der COPY-Formel kürzen, um Fehler im Zielsystem zu vermeiden
- Umgang mit leeren Werten – Leere Felder überspringen oder ersetzen, damit Transfers reibungslos laufen
- Protokollierung – Mit der MESSAGE-Formel Feldwerte in den Transfer-Logs festhalten, um die Fehlersuche zu erleichtern
Außerdem geben wir praktische Tipps: Beginnen Sie mit einfachen Formeln, testen Sie diese und erhöhen Sie die Komplexität dann nach Bedarf durch Verschachtelung. Die vollständige Formelreferenz finden Sie im Rapidi-Wiki.
Sehen Sie sich die Aufzeichnung unserer fünften Session an: Feldzuordnungen
Präsentationsfolien
Feldzuordnungen in RAPIDI: Formeln, Lookups und Best Practices
Feldzuordnungen können einfache 1:1-Beziehungen zwischen einem Quellfeld und einem Zielfeld sein. In vielen Integrationen reicht dieser Ansatz nicht aus, weil Daten womöglich aus unterschiedlichen Quellen abgerufen, umformatiert, validiert, gekürzt oder bedingt zugeordnet werden müssen. Für diese Fälle gibt es RAPID-Formeln (auch Ausdrücke genannt).
Wo Formeln in RAPID hinzugefügt werden
Formeln werden in den Field List Mappings hinzugefügt.
Verbindliche Syntaxregeln
- Jede Formel beginnt mit zwei Rautezeichen:
## - Textzeichenfolgen stehen in einfachen Anführungszeichen:
'text' - Feldnamen stehen in doppelten Anführungszeichen:
"FieldName"
Diese Struktur gilt für Formeln und für fest codierte Werte.
Formelkategorien für Feldzuordnungen
RAPID-Formeln sind in Kategorien gegliedert, die typischen Anforderungen an Zuordnungen entsprechen.
1) Konvertierungen (Formatangleichung)
Konvertierungen greifen, wenn zwei Systeme dieselben Daten in unterschiedlichen Formaten speichern. Ziel ist es, die Formate so anzugleichen, dass das Zielsystem die erwartete Struktur erhält.
Ein typisches Beispiel ist die Konvertierung eines Datums aus der Quelle in ein Format aus Datum und Uhrzeit, das das Zielsystem verlangt.
2) Bedingte Logik und Standardwerte
Bedingte Logik kommt zum Einsatz, wenn:
- Quelldaten fehlen oder leer sind
- ein Feld je nach Wert unterschiedlich zugeordnet werden muss
- ein Standardwert gesendet werden muss, wenn es keine Übereinstimmung gibt
CASE-Formel (Wertezuordnung mit Standardwert)
Ein häufiges Szenario ist die Zuordnung von Werten, die zwischen den Systemen nicht übereinstimmen.
Beispielmuster:
- Quellfeld: Abteilungscode mit Werten wie
east,west,north - Das Zielsystem erwartet numerische Werte:
east→1west→2north→3
- Ein Standardwert ist erforderlich, wenn keiner der erwarteten Werte gefunden wird
Der Standardwert steht am Ende, damit der Transfer korrekt läuft.
Umgang mit leeren Werten (Ersatzaktionen)
Eine Blank-Value-Formel wird häufig mit Lookups kombiniert:
- Ist das Ergebnis eines Lookups leer, wird eine zweite Aktion ausgeführt
- Typische Ersatzaktionen sind:
- einen Standardwert senden
- das Feld mit einer Skip-Field-Formel überspringen
Beispielverhalten:
- Ist ein Sprachcode-Feld leer, überspringt die Zuordnung das Feld
- Andernfalls wird der vorhandene Wert gesendet
3) Lookups (Abfragen anderer Tabellen, Views oder des Link Storage)
Lookups rufen Daten aus anderen Tabellen, Listen oder Views ab und senden sie an das Zielsystem.
Lookup-Typen
- DB-Lookups: führen eine Abfrage auf der Quelle oder dem Ziel aus
- LS-Lookup: fragt den Link Storage ab
Zentrale Voraussetzung: ein gemeinsamer Identifikator
Ein Lookup setzt eine Gemeinsamkeit voraus zwischen:
- der zugeordneten Tabelle
- der abgefragten Tabelle
Beispielstruktur (Lookup auf das Ziel):
- Zieltabelle bzw. -objekt abfragen
- Ein Feld wie External ID mit einem Feld der Transfertabelle wie Owner ID abgleichen
- Bei Übereinstimmung einen Wert wie Code zurückgeben und an das Zielfeld senden
Ziel, Quelle und Link Storage im Vergleich
DDSwird für Lookups auf das Ziel verwendetSourceDSwird für Lookups auf die Quelle verwendetLS lookupwird für Werte aus dem Link Storage verwendet, die aktuell gehalten werden müssen, damit sie zuverlässig sind
Lookup-Beispiele in Zuordnungen
- Zuweisung des Owners: einen Benutzer im Zielsystem anhand seines Alias nachschlagen, prüfen, ob der Benutzer aktiv ist, und dann die Benutzer-ID zurückgeben; ist das Ergebnis leer, eine Standard-Benutzer-ID senden oder überspringen
- Referenzfelder: ein Objekt im Zielsystem (etwa einen Standort) nachschlagen, um die ID des Zielsystems abzurufen, die ein Referenzfeld benötigt
- ERP-Anreicherung: zugehörige Werte (etwa offene Rechnungen) über einen gemeinsamen Identifikator (etwa die Kundennummer) aus einer anderen ERP-Seite bzw. -Tabelle abrufen und dann an ein Zielfeld senden; Änderungen in der Quelltabelle werden beim nächsten Lauf in das zugeordnete Zielfeld übernommen
4) Textbearbeitung (Längenkontrolle, Aufteilen, Verketten)
Formeln zur Textbearbeitung passen Zeichenfolgen an die Vorgaben des Zielsystems an.
COPY-Formel (auf eine maximale Länge kürzen)
Ein typischer Einsatzzweck ist es, Fehler im Zielsystem durch zu lange Zeichenfolgen zu verhindern.
Beispiel:
- Das Quellfeld
nameerlaubt bis zu 50 Zeichen - Das Zielfeld erlaubt nur 6 Zeichen
- COPY übernimmt nur die ersten 6 Zeichen, damit das Zielsystem den Datensatz nicht ablehnt
Werte in Zuordnungen fest codieren
Fest codierte Werte folgen denselben Syntaxregeln:
- Beginnen Sie mit
## - Setzen Sie den Wert in einfache Anführungszeichen
Fest codierte Werte werden eingesetzt, um stets einheitliche Werte zu senden oder Standardwerte bereitzustellen.
Operative Formeln für Fehlersuche und Steuerung
Message-Formel (Kontext pro Datensatz protokollieren)
Die Message-Formel protokolliert ausgewählte Feldwerte während der Transferläufe.
Beispielverhalten:
- Ein Kundennummernfeld wird in die Message-Formel aufgenommen
- Jeder übertragene Datensatz schreibt seine Kundennummer in die Logs
- Bei Fehlern zeigen die Logs dann, welcher Datensatz fehlgeschlagen ist, was die Fehlersuche erleichtert, wenn Systeme nur wenige Fehlerdetails liefern
Error-Formel (harter Stopp)
Die Error-Formel stoppt die Ausführung eines Transfers. Sie wird eingesetzt, wenn eine strikte Validierung erforderlich ist und fehlende oder ungültige Daten die Verarbeitung blockieren müssen.
Validierungsformeln
Validierungsformeln können Feldformate prüfen, bevor Daten gesendet werden:
- Die Formel zur E-Mail-Validierung prüft, ob ein E-Mail-Wert gültig ist
- Die Formel zur Telefonnummern-Validierung prüft, ob eine Telefonnummer dem erwarteten Format entspricht
Best Practices für Formeln in Feldzuordnungen
- Beginnen Sie mit einfachen Formeln und möglichst wenigen Bedingungen
- Testen Sie das Verhalten und ergänzen Sie dann nach Bedarf weitere Bedingungen und Verschachtelungen
- Verwenden Sie Standardwerte, wenn Zuordnungen vom Abgleich von Werten abhängen
- Kombinieren Sie Lookups mit dem Umgang mit leeren Werten, um festzulegen, was bei leeren Ergebnissen passiert
- Stellen Sie sicher, dass Lookups über einen verlässlichen gemeinsamen Identifikator zwischen der zugeordneten und der abgefragten Tabelle verfügen
- Nutzen Sie die Protokollierung per Message-Formel, um Datensatz-Identifikatoren in den Logs festzuhalten und Fehler schneller zu finden
- Setzen Sie die Error-Formel nur ein, wenn ein Transfer bei einer fehlgeschlagenen Validierung stoppen muss
- Halten Sie die Syntax konsequent ein: Präfix
##, einfache Anführungszeichen für Zeichenfolgen, doppelte Anführungszeichen für Feldnamen - Verschachteln Sie Formeln, wenn mehrere Schritte nötig sind (Lookup + Umgang mit leeren Werten + Standardwert/Überspringen)
Zusammenfassung
RAPID-Feldzuordnungen können mehr als 1:1-Feldübertragungen. Formeln ermöglichen Formatkonvertierungen, bedingte Zuordnungen mit Standardwerten, Lookups über Quelle, Ziel und Link Storage, die Kontrolle von Textlängen, Validierung, Protokollierung und eine Fehlerbehandlung mit hartem Stopp. Korrekte Syntax und ein schrittweiser Aufbau der Logik verringern Zuordnungsfehler und machen Transfers zuverlässiger.
Wie geht es weiter?
Die Session behandelt Zeitstempel und RTI, Formeln und Transformationen. Erfahren Sie, wie Sie konfigurieren, wie Ihre Daten zwischen Systemen fließen.
Sie können nicht live dabei sein? Melden Sie sich trotzdem an, und wir senden Ihnen die Aufzeichnung und die Unterlagen im Anschluss zu.
Open Office Hours
Jede Woche veranstalten unsere Integrationsspezialisten eine kostenlose 30-minütige Schulung zu einem bestimmten MyRapidi-Thema.
Häufig gestellte Fragen
Was ist eine Feldzuordnung in der Datenintegration?
Bei der Feldzuordnung wird ein Feld in einem System mit dem entsprechenden Feld in einem anderen System verbunden. Sie legt fest, welche Daten wohin gehören. Ein einfaches Beispiel: Das Feld „Customer Name“ in Ihrem ERP muss dem Feld „Account Name“ in Salesforce zugeordnet werden. Ohne korrekte Zuordnung landen Daten an der falschen Stelle oder werden gar nicht übertragen.
Was ist der Unterschied zwischen einer 1:1-Zuordnung und einer formelbasierten Zuordnung?
Eine 1:1-Zuordnung sendet einen Wert unverändert direkt von einem Quellfeld an ein Zielfeld. Eine formelbasierte Zuordnung transformiert die Daten unterwegs. Eine Formel verwenden Sie, wenn die beiden Systeme Daten in unterschiedlichen Formaten speichern, für dieselbe Sache unterschiedliche Werte verwenden oder wenn Sie Daten aus einer verknüpften Tabelle abrufen müssen, die nicht Teil des Haupttransfers ist.
Was passiert, wenn ein Feld in meinem Quellsystem leer ist?
Wenn Sie leere Felder nicht berücksichtigen, schlägt Ihr Transfer entweder fehl oder überträgt leere Werte ins Zielsystem, die vorhandene Daten überschreiben können. In Rapidi können Sie eine Blank-Value-Formel in Kombination mit Skip Field verwenden, um dem System mitzuteilen: „Ist dieses Feld leer, bleibt das Zielfeld unverändert.“ Das ist besonders nützlich für Felder, die Endanwender nicht immer ausfüllen.
Warum erhalte ich Fehler wegen abweichender Feldlängen oder Datentypen?
Systeme definieren dieselbe Art von Daten oft unterschiedlich. Ein Namensfeld erlaubt in Ihrem ERP vielleicht 50 Zeichen, in Salesforce aber nur 30. Ein Datumsfeld verwendet in einem System womöglich ein Format (DD/MM/YYYY) und im anderen ein anderes (YYYY-MM-DD). Solche Abweichungen führen auf der Empfängerseite zu Validierungsfehlern. Mit den Formeln COPY und FORMAT von Rapidi können Sie Feldlängen kürzen und Formate konvertieren, bevor die Daten das Zielsystem erreichen.
Wann sollte ich einen Lookup statt einer direkten Zuordnung verwenden?
Verwenden Sie einen Lookup, wenn die benötigten Daten nicht in der Tabelle vorliegen, die Sie übertragen. Wenn Sie beispielsweise Kundendatensätze synchronisieren, aber auch den offenen Rechnungsbetrag mitgeben müssen, liegt dieser Wert möglicherweise in einer separaten Statistiktabelle. Mit einem Lookup können Sie eine andere Tabelle abfragen, über einen gemeinsamen Identifikator (etwa eine Kundennummer) abgleichen und den Wert in Ihren Transfer übernehmen. In Rapidi können Sie Lookups auf dem Quellsystem, dem Zielsystem oder dem Link Storage ausführen.