Salesforce-IDs verstehen & richtig nutzen

Salesforce-IDs sind das Rückgrat jeder Salesforce-Instanz. Sie geben jedem Datensatz – sei es ein Account, ein Kontakt oder eine Opportunity – eine eindeutige Identität, ähnlich wie ein Personalausweis. Ohne sie wäre es unmöglich, Daten präzise zu identifizieren, zu verknüpfen oder zu bearbeiten. Doch wie funktionieren sie genau, wie findet man sie, und wie setzt man sie effektiv ein? Dieser Artikel richtet sich an Salesforce-Admins und Berater, die ihr Wissen vertiefen und praxisnahe Lösungen für den Umgang mit IDs finden möchten. Wir gehen Schritt für Schritt vor, erklären den Aufbau, zeigen Einsatzmöglichkeiten und geben Tipps, um typische Stolpersteine zu vermeiden.

Was sind Salesforce-IDs und warum sind sie wichtig?

Salesforce-IDs sind alphanumerische Codes, die jedem Datensatz in einer Salesforce-Instanz zugeteilt werden. Sie sind so etwas wie die DNA eines Records: einzigartig und unveränderlich. Egal ob Sie Daten migrieren, Berichte erstellen oder Integrationen mit anderen Systemen aufbauen – ohne das Verständnis dieser IDs kommen Sie nicht weit. Sie sind in zwei Versionen verfügbar: 15 Zeichen (case-sensitive) und 18 Zeichen (case-insensitive), was je nach Anwendungsfall entscheidend ist.

Warum das wichtig ist? Stellen Sie sich vor, Sie müssen Daten zwischen zwei Salesforce-Orgs übertragen oder einen Datensatz in einem externen Tool eindeutig referenzieren. Ohne die ID geht das nicht. Sie ist der Schlüssel, um sicherzustellen, dass Sie genau den richtigen Datensatz ansprechen – kein Duplikat, keine Verwechslung.

💡

Praxistipp: Wenn Sie eine ID kopieren, überprüfen Sie immer ihre Länge (15 oder 18 Zeichen). Eine falsche Länge deutet oft auf einen Tippfehler oder ein Problem beim Kopieren hin.

Wo finde ich eine Salesforce-ID?

Die einfachste Methode, eine Salesforce-ID zu finden, ist ein Blick in die URL. Öffnen Sie einen Datensatz – etwa einen Account – und schauen Sie in die Adressleiste Ihres Browsers. Die URL könnte so aussehen:

https://deineorgmydomain.lightning.force.com/lightning/r/Account/001j000000HWb16AAD/view

Die ID ist der Teil zwischen „/r/“ und „/view“ – hier: 001j000000HWb16AAD. Mit einem Doppelklick auf diesen Abschnitt können Sie die ID markieren und kopieren.

Manchmal reicht diese Methode nicht aus, etwa wenn Sie die ID in einem Bericht oder einer Automatisierung anzeigen möchten. Hier hilft ein Formelfeld: Erstellen Sie ein neues Feld mit der Formel Id, und Salesforce zeigt die ID direkt im Datensatz an. Das ist besonders praktisch, wenn Sie regelmäßig mit IDs arbeiten und sie schnell zugänglich haben möchten.

💡

Best Practice: Speichern Sie wichtige IDs in einer separaten Tabelle oder einem benutzerdefinierten Objekt, falls Sie sie später für Analysen oder Datenabgleiche brauchen. Das erspart Ihnen das ständige Suchen in URLs.

Den Aufbau einer Salesforce-ID entschlüsseln

Eine Salesforce-ID ist mehr als nur eine zufällige Zeichenfolge – sie hat eine klare Struktur. Lassen Sie uns den Aufbau anhand eines Beispiels wie 001j000000HWb16AAD Schritt für Schritt verstehen.

Zeichen 1-3: Objektpräfix

Die ersten drei Zeichen verraten, um welches Objekt es sich handelt. Hier sind die wichtigsten Präfixe:

001 – Account
003 – Kontakt
006 – Opportunity
00Q – Lead

Eine vollständige Liste aller Präfixe finden Sie in diesem Developer Artikel oder in der offiziellen Salesforce Hilfe.

Zeichen 4-6: Instanz-ID

Diese Zeichen geben Hinweise darauf, auf welchem Salesforce-Server oder welcher Instanz der Datensatz erstellt wurde. Für die meisten praktischen Anwendungen ist das weniger relevant, kann aber bei der Fehlersuche in großen Organisationen nützlich sein.

Zeichen 7: Platzhalter

Dieses Zeichen ist oft ein Reserveplatz und hat keine direkte Bedeutung für den Nutzer.

Zeichen 8-15: Datensatz-ID

Hier liegt der Kern – eine eindeutige Kennung für den spezifischen Datensatz innerhalb des Objekts. Sie stellt sicher, dass kein Datensatz mit einem anderen verwechselt wird.

Zeichen 16-18: Optionaler Suffix

Die letzten drei Zeichen gibt es nur in der 18-stelligen Version. Sie machen die ID case-insensitive und sind essenziell für Integrationen mit Systemen, die Groß- und Kleinschreibung nicht unterscheiden.

💡

Praxistipp: Wenn Sie nicht sicher sind, welches Objekt eine ID repräsentiert, fügen Sie sie einfach hinter https://deineorgmydomain.lightning.force.com/ ein und rufen sie auf. Salesforce leitet Sie automatisch zum richtigen Datensatz – vorausgesetzt, Sie haben die Berechtigungen.

Eine schöne Übersicht der Anatomie einer Salesforce ID von codebycody.com

15 vs. 18 Zeichen: Wann welche ID nutzen?

Die Entscheidung zwischen 15- und 18-stelligen IDs ist kein Detail für Nerds – sie hat praktische Konsequenzen. Die 15-stellige Version ist Groß- und Kleinschreibungssensitiv: 001j000000HWb16 ist nicht dasselbe wie 001J000000hwb16. Das kann in Tools wie Excel oder bei manueller Eingabe zu Problemen führen. Die 18-stellige Version (001j000000HWb16AAD) löst das, indem sie diese Unterschiede ignoriert.

Für Integrationen oder Datenmigrationen ist die 18-stellige ID fast immer die bessere Wahl. Viele APIs und externe Tools wie Data Loader erwarten diese Version. Im Alltag, etwa für Berichte oder Links innerhalb von Salesforce, reicht die 15-stellige oft aus.

💡

Lösung bei Problemen: Wenn ein Datensatz nicht gefunden wird, prüfen Sie, ob die Groß- und Kleinschreibung stimmt (bei 15 Zeichen) oder ob das Zielsystem eine 18-stellige ID erwartet.

Salesforce-IDs konvertieren: So geht’s

Manchmal müssen Sie eine 15-stellige ID in eine 18-stellige umwandeln – etwa für eine Integration oder einen Datenabgleich. Salesforce nutzt dafür einen festen Algorithmus. Für einmalige Konvertierungen zum Testen kleiner Datenmengen können Sie kostenlosen Web-Konvertierer nutzen.

Für alle, die daran interessiert sind, die Logik im Detail zu verstehen oder ein eigenes Skript zu schreiben, gibts nachfolgend mehr Details. So funktioniert die Konvertierung:

Schritt-für-Schritt-Anleitung zur Konvertierung

Nehmen wir die ID 001j000000HWb16 als Beispiel:

Teilen in drei Gruppen: 001j0, 00000, HWb16.
Reihenfolge umkehren: 0j100, 00000, 61bWH.
Bitfolgen erstellen: Jedes Zeichen wird basierend auf seiner Position im Alphabet und Art (Großbuchstaben = 10000, Kleinbuchstaben = 01000, Zahlen = 00100) in eine Binärfolge umgewandelt.
1. Gruppe: 000000100000100000000
  1. o (15. Stelle) = 00000
  2. j (10. Stelle) = 01000
  3. 1 (1. Stelle) = 00100
  4. 0 (26. Stelle) = 00000
2. Gruppe: 000000000000000000000
  1. 5 mal 0 (26. Stelle) = 00000
3. Gruppe: 001100010000100001011
  1. 6 (6. Stelle) = 00110
  2. 1 (1. Stelle) = 00100
  3. b (2. Stelle) = 01000
  4. H (8. Stelle) = 00100
  5. W (23. Stelle) = 01011
Bitfolgen verbinden: Die Ergebnisse werden zusammengeführt.
Prüfsumme berechnen: Ein Algorithmus wandelt die Binärfolge in drei Zeichen um – hier AAD.
Zusammenfügen: Ergebnis ist 001j000000HWb16AAD.

Weitere Details zur Umwandlung finden Sie im Artikel von Code by Cody. Mehr dazu: Salesforce's Algorithm for Converting IDs from 15 to 18 Characters

Für Entwickler: Wenn Sie das automatisieren möchten, bietet Salesforce eine detaillierte Erklärung zur Programmierung dieses Prozesses in Apex.

💡

Praxistipp: Nutzen Sie für regelmäßige Konvertierungen einen kleinen Apex-Script oder eine Flow-Automatisierung, um sich die manuelle Arbeit zu sparen.

Problem 1: Datensatz nicht gefunden

Sie fügen eine ID in die URL ein, und es kommt eine Fehlermeldung? Entweder existiert der Datensatz in dieser Org nicht, oder Ihnen fehlen die Berechtigungen. Prüfen Sie zunächst die Org (Sandbox vs. Produktion) und dann Ihre Zugriffsrechte.

Problem 2: Groß-/Kleinschreibung Chaos

Bei 15-stelligen IDs passieren Fehler, wenn externe Tools die Schreibweise verändern. Lösung: Immer die 18-stellige Version verwenden oder ein Skript schreiben, das die Eingabe normalisiert.

Problem 3: ID-Länge stimmt nicht

Eine ID mit 16 oder 17 Zeichen ist ein deutliches Zeichen für einen Kopierfehler. Kontrollieren Sie die Quelle und kopieren Sie erneut – am besten mit Doppelklick direkt aus der URL.

💡

Best Practice: Erstellen Sie eine Checkliste für ID-Probleme: Länge prüfen, Objekt bestätigen, Berechtigungen checken. Das spart Zeit bei der Fehlersuche.

Das Wichtigste zu Salesforce-IDs auf einen Blick

Immer die Länge überprüfen: Wenn du mit IDs arbeitest, achte darauf, dass sie entweder 15 oder 18 Zeichen lang sind. Andernfalls könnte ein Fehler vorliegen.
Groß- und Kleinschreibung beachten: Denke daran, dass die 15-Zeichen-ID Groß- und Kleinschreibung beachtet. Das bedeutet, dass 'a1B' sich von 'A1b' unterscheidet.
Die richtige ID verwenden: Wenn du mit anderen Systemen integrierst oder benutzerdefinierte Links erstellst, verwende die korrekte Form der ID (15 oder 18 Zeichen), wie es vom System verlangt wird, mit dem du arbeitest.

Häufige Fragen

Warum hat Salesforce sowohl 15-stellige als auch 18-stellige IDs?

15-stellige IDs sind case-sensitive und für die Nutzung in der Benutzeroberfläche gedacht. 18-stellige IDs enthalten eine Prüfzeichenfolge, die sie case-insensitive macht und für den Einsatz in externen Systemen und Datenbankabfragen geeigneter ist.

Kann ich eine Salesforce-ID verwenden, um den Objekttyp zu identifizieren?

Ja, die ersten drei Zeichen einer Salesforce-ID sind der Key Prefix, der den Objekttyp eindeutig identifiziert. "001" steht für Account, "003" für Contact und so weiter. Eine vollständige Liste finden Sie in der Salesforce-Dokumentation.

Wie konvertiere ich eine 15-stellige in eine 18-stellige Salesforce-ID?

In Salesforce Formulas können Sie die CASESAFEID()-Funktion verwenden. In SOQL und Apex werden 18-stellige IDs standardmäßig zurückgegeben. Für externe Konvertierungen gibt es verschiedene Online-Tools.

Warum sollte ich IDs niemals hardcoden?

IDs unterscheiden sich zwischen Sandbox und Production. Hardcodierte IDs führen zu Fehlern nach Deployments oder bei Datenmigration. Verwenden Sie stattdessen Custom Labels, Custom Metadata oder queried IDs.

Fazit: Salesforce-IDs meistern und effizient nutzen

Salesforce-IDs sind keine Hexerei, aber sie erfordern ein grundlegendes Verständnis, um sie effektiv einzusetzen. Vom Finden über den Aufbau bis zur Konvertierung – mit den richtigen Techniken sparen Sie Zeit, vermeiden Fehler und optimieren Ihre Prozesse. Egal ob Sie Datensätze verknüpfen, Migrationen durchführen oder Integrationen aufbauen: Die ID ist Ihr Werkzeug, um Salesforce voll auszuschöpfen. Wenn Sie bei komplexeren Szenarien – wie automatisierten Konvertierungen oder Datenanalysen – Unterstützung brauchen, stehe ich Ihnen gerne zur Verfügung. Kontaktieren Sie mich, um Ihre Salesforce-Herausforderungen gemeinsam zu lösen!