Die Funktion „Unique Fields“ stellt sicher, dass bestimmte Feldwerte innerhalb eines Custom Objects eindeutig bleiben. Dadurch wird Datenintegrität gewährleistet, Duplikate werden verhindert und es wird sichergestellt, dass Identifikatoren wie IDs oder Referenznummern nicht versehentlich mehrfach verwendet werden. Dieser Artikel zeigt, wie Unique Fields in Custom Objects verwendet werden.
INHALTSVERZEICHNIS
Was sind Unique Fields für Custom Objects?
Wichtige Vorteile von Unique Fields
Regeln, Limits & unterstützte Feldtypen
So markierst du ein Feld als Unique in Custom Objects
So bearbeitest du Unique Fields
Beispielszenarien
Best Practices
Häufig gestellte Fragen
Verwandte Artikel
Was sind Unique Fields für Custom Objects?
Unique Fields ist eine Datenintegritäts-Einstellung, die du für ausgewählte Custom-Object-Felder aktivieren kannst.
Wenn ein Feld als „unique“ markiert ist, prüft ProfitBoost jeden neuen oder aktualisierten Record und blockiert jeden Wert, der bereits im Sub-Account existiert. Dadurch bleibt jeder Custom-Object-Record eindeutig und Duplikate werden vermieden.
Wichtige Vorteile von Unique Fields
Duplikate verhindern:
Unique Fields blockieren doppelte Werte bei Create- und Update-Prozessen über UI, Forms, Workflows, Imports und API.
Genaues Reporting:
Sichert echte 1:1-Beziehungen für verlässliche Dashboards und Kennzahlen.
Sichere Automationen:
Schützt Bulk Imports und Workflow-Aktionen vor doppelten Einträgen durch automatische Prüfungen.
Zukunftssicher:
Schafft die Grundlage für zukünftige Deduplication- und Merge-Funktionen.
Regeln, Limits & unterstützte Feldtypen
Unique Fields können beim Erstellen eines Custom Fields aktiviert werden
Limit: 10 Unique Fields pro Object (Sub-Account-weit)
Gilt für alle Erstellungswege: UI, Workflows, Forms und API
Unterstützte Feldtypen:
Single Line Text
Multi Line Text
Number
Phone
Ein Unique Field kann auf „non-unique“ herabgestuft werden (irreversibel für erneute Aktivierung)
So markierst du ein Feld als Unique in Custom Objects
Hinweis: Sobald gespeichert, gilt diese Einstellung für alle Records im Sub-Account und kann nach Deaktivierung nicht erneut aktiviert werden.
Option 1: Beim Erstellen eines neuen Custom Fields
Gehe zu Settings.
Klicke auf Custom Fields.
Klicke auf + Add Field.
Wähle einen unterstützten Feldtyp (Single Line, Multi Line, Number oder Phone).
Gib Feldname, Object und Gruppe ein.
Aktiviere „Mark Field as Unique“.
Klicke auf Save.
Option 2: Primary Field beim Erstellen eines Custom Objects als Unique markieren
Gehe zu Settings.
Klicke auf Objects.
Klicke auf + Add Custom Object.
Definiere Name und Primary Display Field.
Aktiviere „Mark Primary Field as Unique“.
Klicke auf Create Custom Object.
Damit wird sichergestellt, dass der Primary Field (z. B. Case No. oder VIN Number) keine Duplikate erlaubt.
So bearbeitest du Unique Fields
Hinweis: Sobald ein Feld von „unique“ auf „non-unique“ geändert wird, kann es nicht wieder auf „unique“ gesetzt werden.
Gehe zu Settings > Custom Fields.
Suche das Unique Custom Field.
Wähle das Field aus.
Klicke auf Bulk Actions > Edit.
Deaktiviere „Mark Field as Unique“.
Beispielszenarien
Szenario | Aktion | Ergebnis |
|---|---|---|
Zwei Records haben denselben Wert im Primary Field | User speichert | Fehler: Duplicate Value existiert |
Duplicate im non-primary Unique Field | User speichert | Teilweise Erfolg, Duplicate wird übersprungen |
Unique Field wird gelöscht | Delete | Warnung – Löschen nicht möglich |
Unique wird auf non-unique geändert | Save | Erlaubt, aber irreversibel |
API sendet Duplicate Value | Update | API Validation Error |
Best Practices
Verwende Unique Fields für IDs oder Schlüssel (z. B. Patient ID, Case No., Employee Code)
Vermeide häufig geänderte Textfelder als Unique Fields
Bereinige Daten vor Imports extern
Plane Unique Fields frühzeitig, da Reaktivierung nicht möglich ist
Häufig gestellte Fragen
F: Gilt Unique über den gesamten Account?
Ja, innerhalb des gesamten Sub-Accounts.
F: Gilt die Prüfung auch bei Updates?
Ja, sowohl Create als auch Update werden geprüft.
F: Welche Fehlermeldung erscheint bei Duplikaten?
„A record with the same value for already exists.“
F: Wo wird die Prüfung angewendet?
UI, Workflows, Forms und API.
F: Kann ich Email oder Dropdown als Unique nutzen?
Nein, nur Single Line, Multi Line, Number und Phone.
F: Was passiert bei CSV-Importen mit Duplikaten?
Der Import läuft weiter, aber betroffene Zeilen werden übersprungen.
F: Verlangsamt das API-Bulk Inserts?
Nein, die Prüfung ist optimiert.
F: Können zwei Sub-Accounts denselben Wert nutzen?
Ja, Unique gilt nur pro Sub-Account.
Verwandte Artikel
Erste Schritte mit Custom Objects
Erstellen und Bearbeiten von Custom Objects
Erstellen und Aktualisieren von Custom Object Records
Custom Objects in Workflows verwenden