CSV-Vorlagen für Salesforce-Datenmigration erstellen

Die Vorbereitung von Kundendaten für den Import in Salesforce ist ein entscheidender Schritt, um sicherzustellen, dass die Daten korrekt und effizient verarbeitet werden. Eine gut durchdachte CSV-Vorlage kann hier wahre Wunder bewirken. In diesem Artikel erfährst Sie, wie Sie eine solche Vorlage erstellst und welche Tipps dabei zu beachten sind.

Warum sind CSV-Vorlagen wichtig?

CSV-Dateien (Comma-Separated Values) sind eines der meistgenutzten Formate, um Daten in Salesforce zu importieren, insbesondere mit dem Data Loader. Ohne klare Richtlinien für die Dateneingabe kommt es jedoch häufig zu Problemen wie fehlerhaften Datenformaten oder unvollständigen Einträgen.

💡

Praxistipp: Ich verwende bei Datenmigrationsprojekten immer eine zweite Tabellenzeile mit Beispieldaten direkt unterhalb der Kopfzeile. Der Kunde sieht sofort, welches Format erwartet wird — das reduziert Rückfragen um mindestens die Hälfte.

Schritt-für-Schritt-Anleitung zur Erstellung einer CSV-Vorlage

Definiere die benötigten Felder:

Liste alle Felder auf, die importiert werden sollen, z. B. Name, E-Mail-Adresse, Telefonnummer, etc.
Nutze die Salesforce-Felder als Referenz, um sicherzustellen, dass die Spaltennamen übereinstimmen.

Formatvorgaben festlegen:

E-Mails: Sicherstellen, dass alle Einträge ein korrektes E-Mail-Format haben (z. B. user@domain.com).
Telefonnummern: Einheitliches Format, z. B. +49 für Deutschland.
Daten: Datumsformat wie YYYY-MM-DD.

Validierungsregeln implementieren:

Verwende Excel- oder Google-Tabellen-Funktionen, um die Einhaltung der Formate sicherzustellen.

Beispieldaten hinzufügen:

Gib in der Vorlage Beispiele ein, damit die Nutzer verstehen, wie die Daten korrekt eingegeben werden.

⚠️

Wichtig: Importieren Sie niemals direkt in die Produktionsumgebung. Ein fehlerhafter Massenimport von 50.000 Datensätzen lässt sich in Salesforce nicht einfach rückgängig machen — der Data Loader hat keine Undo-Funktion. Sandbox zuerst, immer.

Testlauf durchführen:

Lade die Datei in eine Sandbox-Umgebung, um sicherzustellen, dass der Import fehlerfrei funktioniert.

Best Practices

Dokumentation bereitstellen: Erstelle ein Begleitdokument, das die Nutzung der Vorlage erklärt.
Regelmäßige Updates: Halte die Vorlage aktuell, insbesondere bei Änderungen in den Salesforce-Felder.
Kommunikation mit Kunden: Kläre alle offenen Fragen zur Datenaufbereitung frühzeitig.

Häufige Fragen

Typische Fehler bei CSV-Vorlagen

In meiner Beratungspraxis sehe ich immer wieder dieselben Fehler bei CSV-Dateien, die für Salesforce-Importe vorbereitet werden. Der häufigste: Spaltenüberschriften stimmen nicht mit den API-Namen der Salesforce-Felder überein. Das klingt banal, kostet aber bei gro��en Datenmengen schnell einen halben Tag Fehlersuche.

Ein weiteres Problem sind inkonsistente Datumsformate. Wenn in einer Spalte sowohl "01.03.2026" als auch "2026-03-01" stehen, scheitert der Import. Salesforce erwartet ein einheitliches Format, idealerweise YYYY-MM-DD. Ich empfehle, Datumsfelder immer als Text zu formatieren, bevor Sie die CSV exportieren.

Besonders tückisch sind Lookup-Felder. Wenn Sie Kontakte importieren und diese einem Account zuordnen wollen, brauchen Sie entweder die Salesforce-ID des Accounts oder ein External-ID-Feld. Ohne diese Zuordnung landen Ihre Kontakte als Waisen im System.

Schritt-für-Schritt: CSV-Vorlage erstellen

Bevor Sie eine einzige Zeile in Ihre CSV schreiben, exportieren Sie die Feldstruktur aus Salesforce. Gehen Sie dazu in Setup, wählen Sie den Object Manager und das gewünschte Objekt. Unter "Fields & Relationships" sehen Sie alle verfügbaren Felder mit ihren API-Namen.

Erstellen Sie Ihre CSV-Vorlage mit exakt diesen API-Namen als Spaltenüberschriften. Nicht die Labels, die Sie in der Oberfläche sehen, sondern die technischen Feldnamen wie "Account__c" oder "CloseDate". Das spart Ihnen das Mapping im Data Loader.

Für Picklist-Felder tragen Sie ausschließlich die definierten Werte ein. Ein "Aktiv" statt "Active" führt zu einem Importfehler, wenn Ihre Org auf Englisch konfiguriert ist. Prüfen Sie die erlaubten Werte vorab im Setup.

Fügen Sie eine Spalte für External IDs hinzu, wenn Sie regelmäßig Daten aktualisieren wollen. Ohne External ID müssen Sie bei jedem Update die Salesforce-ID mitliefern, was den Prozess deutlich komplizierter macht.

Tools und Automatisierung

Für einmalige Importe reicht der Data Loader völlig aus. Sobald Sie aber regelmäßig Daten migrieren, lohnt sich ein Blick auf Tools wie Dataloader.io oder Jitterbit. Diese bieten Scheduling, Fehlerprotokollierung und automatisches Mapping.

Mein Tipp aus der Praxis: Erstellen Sie für jedes Objekt eine Vorlage mit Beispielzeilen und hinterlegen Sie die erlaubten Werte als Kommentar in der ersten Datenzeile. So kann auch ein Kollege ohne Salesforce-Erfahrung die CSV korrekt befüllen.

Bei einem Kunden im Maschinenbau haben wir über 50.000 Kontakte aus einem Legacy-CRM migriert. Ohne standardisierte CSV-Vorlagen wäre das Projekt um Wochen verzögert worden. Die Investition in saubere Templates zahlt sich bei jeder Migration aus.

📬

Dieser Artikel gefällt Ihnen? Jeden Dienstag teile ich Praxiswissen zu Salesforce, CRM und Automatisierung. Kostenlos per Newsletter.

Validierung vor dem Import

Bevor Sie Ihre CSV-Datei in den Data Loader laden, sollten Sie eine Validierungsrunde einlegen. Öffnen Sie die Datei in einem Texteditor, nicht in Excel. Excel interpretiert Daten beim Öffnen und verändert dabei manchmal Formate. Im Texteditor sehen Sie die Rohdaten so, wie Salesforce sie lesen wird.

Prüfen Sie drei Dinge: Erstens, stimmt die Anzahl der Spalten in jeder Zeile? Eine fehlende Trennung durch Semikolon oder Komma verschiebt alle folgenden Werte. Zweitens, gibt es Anführungszeichen um Textfelder, die selbst Kommas enthalten? Drittens, sind Leerzeilen am Ende der Datei? Salesforce interpretiert diese als leere Records.

Für große Dateien mit mehr als 10.000 Zeilen empfehle ich ein Validierungsskript. Ein einfaches Python- oder Node.js-Skript kann Spaltenzahl, Pflichtfelder und Datentypen prüfen, bevor Sie den Import starten. Das spart Ihnen die Fehlersuche nach einem gescheiterten Batch-Job.

CRM-Checkliste für den Mittelstand Kostenlos

7 Punkte, die Sie vor jeder CRM-Entscheidung prüfen sollten. Kompakt, praxisnah, sofort anwendbar.

Vorlagen für verschiedene Objekte

Account-Import

Für Accounts sind die wichtigsten Felder: Name (Pflicht), BillingStreet, BillingCity, BillingPostalCode, BillingCountry, Phone, Website und Industry. Wenn Sie Accounts mit einer Parent-Account-Hierarchie importieren, brauchen Sie zusätzlich eine External-ID-Spalte und eine ParentId-Spalte.

Achten Sie bei Account-Importen besonders auf Duplikate. Salesforce erlaubt standardmäßig mehrere Accounts mit demselben Namen. Aktivieren Sie Duplicate Rules vor dem Import oder verwenden Sie ein External-ID-Feld für das Upsert.

Contact-Import

Kontakte brauchen eine Zuordnung zum Account. Entweder über die Salesforce Account-ID oder über ein External-ID-Feld auf dem Account. Die Mindestfelder sind: LastName (Pflicht), FirstName, Email, AccountId oder Account-External-ID, Title und Phone.

Ein häufiger Fehler: E-Mail-Adressen mit Leerzeichen am Anfang oder Ende. Diese sind unsichtbar in Excel, führen aber zu Validierungsfehlern in Salesforce. Trimmen Sie alle Textfelder vor dem Import.

Opportunity-Import

Opportunities sind komplexer, weil sie Pflichtfelder wie CloseDate, StageName und Amount haben. Die StageName-Werte müssen exakt mit den definierten Sales Stages in Ihrer Org übereinstimmen. Prüfen Sie die Werte im Setup unter Path Settings oder Opportunity Stages.

Automatisierung mit Data Loader CLI

Für wiederkehrende Importe bietet der Salesforce Data Loader einen Kommandozeilen-Modus. Sie definieren Mapping-Dateien und Prozess-Konfigurationen einmalig und können den Import dann per Cron-Job oder Windows Task Scheduler automatisieren.

Das Setup erfordert etwas Einarbeitungszeit, aber der Aufwand lohnt sich. Bei einem Kunden im Energiesektor haben wir tägliche Datenimporte von einem ERP-System vollständig automatisiert. Was vorher zwei Stunden manuelle Arbeit pro Tag war, läuft jetzt unbeaufsichtigt in 15 Minuten.

Welches Format müssen CSV-Dateien für den Salesforce Data Loader haben?

Der Salesforce Data Loader erwartet UTF-8-kodierte CSV-Dateien mit Komma als Trennzeichen. Spaltennamen müssen exakt den Salesforce-API-Namen entsprechen, nicht den Anzeigebeschriftungen.

Wie gehe ich mit Pflichtfeldern um, die ich in der Quelldatei nicht habe?

Pflichtfelder müssen in der CSV-Datei vorhanden sein, auch wenn sie leer sind. Entweder befuellen Sie diese mit Standardwerten oder klaeren vorab, ob die Felder für den Import temporaer deaktiviert werden können.

Wie teste ich meine CSV-Vorlage, bevor ich produktive Daten importiere?

Importieren Sie zuerst eine kleine Stichprobe von 5 bis 10 Datensaetzen in eine Sandbox. Überprüfen Sie Feldwerte, Beziehungen und ob alle Pflichtfelder korrekt befuellt sind, bevor Sie den vollständigen Import starten.

Was tun, wenn beim Import Fehler auftreten?

Der Data Loader erstellt nach jedem Import eine Fehlerprotokoll-Datei. Diese enthaelt den genauen Fehlertyp pro Datensatz. Typische Fehler sind falsche Lookup-Referenzen, Feldwertfehler oder zu lange Texte.

Wie bereite ich Datumswerte korrekt in der CSV-Datei vor?

Salesforce erwartet Datumsangaben im Format YYYY-MM-DD, Zeitstempel im Format YYYY-MM-DDTHH:MM:SS.000Z. Andere Formate wie DD.MM.YYYY führen zu Importfehlern.

Eine gut gestaltete CSV-Vorlage ist der Schlüssel zu einer reibungslosen Dateneingabe und spart Zeit sowie Nerven. Mit diesen Tipps sind Sie bestens vorbereitet, um Kunden und Teams optimal zu unterstützen.