Value Mapping – HowTo

Value Mappings übersetzen eingehende Enrichment-Werte in die Werte, die in Salesforce (Picklisten, Standardfelder) erwartet werden. Sie liegen bewusst in Salesforce (Custom Object Data Enrichment Value Mapping) und nicht in n8n – so kann der Fachbereich das Mapping ohne Workflow-Deployment pflegen.

Warum das Mapping in Salesforce liegt

• Kundenindividuell: Jede Org hat andere Picklisten-Werte (z. B. Industry). Das Mapping gehört damit zu den Salesforce-Daten, nicht zur Integrationslogik.
• Ohne Deployment pflegbar: Admins ändern Werte über die List View, kein n8n-Zugriff nötig.
• Auditierbar: Änderungen laufen über die normale Salesforce-Historie und Berechtigungen.

n8n normalisiert nur technisch (z. B. LinkedIn-Branchen-IDs → grobe Kategorie). Die fachliche Übersetzung auf eure Picklisten-Werte passiert hier.

Felder

Der Abgleich läuft über zwei Felder: Source Field API + Enrichment Value.

Feld	Pflicht	Bedeutung
Source Field API	✓	Ziel-Feld auf Lead/Contact/Account (z. B. Industry). Leer = Wildcard (gilt für jedes Feld mit diesem Enrichment-Wert).
Enrichment Value	✓	Eingehender Enrichment-Wert, auf den geprüft wird (z. B. Manufacturing). Abgleich ist case-insensitiv.
Source Value	✓	Wert, der stattdessen in das Ziel-Feld geschrieben wird (z. B. Fertigung).
Active	✓	Nur aktive Mappings werden angewendet.
Enrichment Field API	–	Rein informativ/Dokumentation. Wird beim Abgleich nicht ausgewertet.
Source Object API	–	Rein informativ/Notiz für den Scope. Wird beim Abgleich nicht gefiltert.

So funktioniert eine Übersetzung

1. Das Enrichment liefert einen Wert für ein Ziel-Feld, z. B. Industry = "Manufacturing".
2. Data Enrichment sucht ein aktives Mapping, dessen Source Field API zum Ziel-Feld passt (oder Wildcard ist) und dessen Enrichment Value (case-insensitiv) dem eingehenden Wert entspricht.
3. Ist eines gefunden, wird stattdessen Source Value geschrieben – also Industry = "Fertigung" auf dem Lead.
4. Gibt es kein Mapping, wird der Originalwert unverändert übernommen.

Standard-Mappings laden

In der Data Enrichment Config legt der Button „Mappings laden" die bekannten LinkedIn-Quellwerte (Branchen + Mitarbeiterzahlen) als Value Mappings an. Vorhandene Einträge bleiben unberührt (idempotent) – der Button kann also gefahrlos mehrfach gedrückt werden. Danach passt ihr die Source Value-Spalte an eure Picklisten an.

Pflege-Tipps

• List View „Active Mappings" zeigt nur die aktiven Einträge.
• Source Field API gezielt setzen, damit ein Mapping nur ein bestimmtes Feld betrifft. Ein leeres (Wildcard) Source Field API greift für jedes Feld mit diesem Enrichment-Wert – sparsam einsetzen, um Überschneidungen zu vermeiden.
• Enrichment Field API und Source Object API dienen nur der Übersicht; nutzt sie als Dokumentation, verlasst euch aber beim Verhalten auf Source Field API + Enrichment Value.