# Definition-Builder-Leitfaden

> Schritt-für-Schritt-Anleitung zum Erstellen von DQS-Definitionen mit dem 5-Schritte-Assistenten. Objekte, Felder, Schwellenwerte und Dimensionsgewichtungen konfigurieren.

Source: https://dataqualitysense.com/de/resources/using-dqs/definition-builder/
Last updated: 2026-06-03

---

## Was ist eine Definition?

Eine Definition ist Ihre konfigurierte Datenqualitätsprüfung in DQS. Sie legt fest, welches Salesforce-Objekt analysiert wird, welche Felder einbezogen werden, welche Fähigkeiten gemessen werden und welche Schwellenwerte gelten.

Stellen Sie sich eine Definition wie ein Rezept vor. Sie geben DQS vor, welche Zutaten (Felder) zu untersuchen sind und welche Standards (Schwellenwerte) gelten. DQS folgt Ihrem Rezept bei jedem Scan, den Sie ausführen.

## Der 5-Schritte-Assistent

Der Definition Builder führt Sie durch fünf Schritte:

1. **Fähigkeiten auswählen** – festlegen, was gemessen wird
2. **Prüfbereich definieren** – Objekt und Felder bestimmen
3. **Filter hinzufügen** – die Datensatzmenge eingrenzen (optional)
4. **Konfigurieren** – Schwellenwerte und Optionen setzen
5. **Prüfen** – validieren und aktivieren

Jeder Schritt baut auf dem vorherigen auf. Sie können den Fortschritt in jedem Schritt speichern und später fortsetzen.

## Schritt 1: Fähigkeiten auswählen

In diesem Schritt wählen Sie, welche Datenqualitätsdimensionen gemessen werden sollen.

### Verfügbare Fähigkeiten

Der Assistent zeigt zwei Bereiche an:

**Data Quality (operative Datenhygiene)**
- Vollständigkeit – Sind Felder befüllt?
- Gültigkeit – Entsprechen Werte den erwarteten Formaten?
- Eindeutigkeit – Sind Datensätze eindeutig?
- Aktualität – Sind die Daten aktuell?
- Konsistenz – Sind Werte einheitlich?

**AI Readiness (Agentforce-Vorbereitung)**
- PII-Erkennung – Sind sensible Daten geschützt, bevor sie der KI ausgesetzt werden?

### Fähigkeiten auswählen

1. Klicken Sie auf eine Fähigkeits-Karte, um sie auszuwählen
2. Die Karte wird hervorgehoben und ein Häkchen erscheint
3. Wählen Sie mehrere Fähigkeiten für eine umfassende Analyse
4. Klicken Sie erneut, um die Auswahl aufzuheben

> **Tipp:** Beginnen Sie bei Ihrer ersten Definition mit 2–3 Fähigkeiten. Weitere können Sie später ergänzen.

### Best Practice: fokussiert starten

Wählen Sie Fähigkeiten nach Ihrem unmittelbaren Ziel aus:

| Ziel | Empfohlene Fähigkeiten |
|------|--------------------------|
| Qualität der Dateneingabe verbessern | Vollständigkeit, Gültigkeit |
| Duplikate finden | Eindeutigkeit |
| Veraltete Datensätze bereinigen | Aktualität |
| Auf KI/Agentforce vorbereiten | Gesamte AI Readiness |
| Vollständiges Datenaudit | Alle Fähigkeiten |

Klicken Sie auf **Continue**, wenn Sie Ihre Fähigkeiten ausgewählt haben.

## Schritt 2: Prüfbereich definieren

In diesem Schritt wählen Sie, welches Salesforce-Objekt und welche Felder analysiert werden.

### Ein Objekt auswählen

1. Nutzen Sie das Dropdown zur Objektauswahl
2. Suchen Sie nach Objektname oder API-Name
3. Klicken Sie, um das Objekt auszuwählen

DQS unterstützt Standard- und Custom Objects. Der Assistent zeigt das Objekt-Label und den API-Namen an, damit Sie das richtige Objekt auswählen.

> **Tipp:** Beginnen Sie mit einem werthaltigen Objekt wie Contact, Lead oder Account. Diese haben in der Regel die größte Auswirkung auf die Datenqualität.

### Felder auswählen

Nach der Auswahl eines Objekts zeigt der Assistent die verfügbaren Felder an.

1. Felder sind nach Typ gruppiert (Text, Zahl, Datum usw.)
2. Klicken Sie auf eine Feldzeile, um sie auszuwählen
3. Nutzen Sie das Suchfeld, um bestimmte Felder zu finden
4. Wählen Sie mehrere Felder für die Analyse

Der Assistent zeigt auf Basis des Feldtyps, welche Fähigkeiten für jedes Feld gelten:

| Fähigkeit | Kompatible Feldtypen |
|------------|------------------------|
| Vollständigkeit | Die meisten Typen (Text, Zahl, Datum, Picklist usw.) |
| Gültigkeit | Text, Email, Phone, URL, Picklist |
| Eindeutigkeit | Alle Typen |
| Aktualität | Nur Date, DateTime |
| Konsistenz | Text, Picklist, Email |

### Feldspezifische Konfiguration

Sie können für einzelne Felder unterschiedliche Schwellenwerte festlegen. Das ist nützlich, wenn:

- kritische Felder strengere Schwellenwerte benötigen
- einzelne Felder besondere Formatanforderungen haben
- verschiedene Felder unterschiedliche Erwartungen an die Aktualität haben

Klicken Sie auf das Zahnrad-Symbol neben einem Feld, um die feldspezifischen Einstellungen zu öffnen.

Klicken Sie auf **Continue**, wenn Sie Ihre Felder ausgewählt haben.

## Schritt 3: Filter hinzufügen (optional)

Filter grenzen ein, welche Datensätze DQS analysiert. Dieser Schritt ist optional, aber bei großen Datenmengen oder bestimmten Anwendungsfällen nützlich.

### Wann Filter sinnvoll sind

| Szenario | Filterbeispiel |
|----------|----------------|
| Nur aktive Accounts analysieren | Status = 'Active' |
| Auf aktuelle Datensätze fokussieren | CreatedDate = LAST_90_DAYS |
| Testdaten ausschließen | Name does not contain 'Test' |
| Bestimmte Regionen anvisieren | BillingCountry = 'United States' |

### Einen Filter erstellen

1. Klicken Sie auf **Add Condition**
2. Wählen Sie ein Feld aus dem Dropdown
3. Wählen Sie einen Operator (equals, contains, greater than usw.)
4. Geben Sie einen Wert ein
5. Wiederholen Sie dies für weitere Bedingungen

### Filterlogik

Verknüpfen Sie Bedingungen mit AND/OR-Logik:

- **AND** – Alle Bedingungen müssen wahr sein
- **OR** – Eine beliebige Bedingung kann wahr sein

Beispiel: `(Status = 'Active') AND (Industry = 'Technology' OR Industry = 'Finance')`

### Vorschau der Datensatzanzahl

Der Assistent zeigt, wie viele Datensätze auf Ihren Filter passen. Damit prüfen Sie, ob Ihr Filter wie erwartet funktioniert.

- Eine Anzahl von 0 bedeutet, dass kein Datensatz passt (prüfen Sie Ihren Filter)
- Eine sehr hohe Anzahl benötigt bei großen Orgs möglicherweise eine engere Filterung

> **Tipp:** Verzichten Sie bei Ihrer ersten Definition auf Filter, um ein Gesamtbild zu erhalten. Filter können Sie später für eine gezielte Analyse ergänzen.

Klicken Sie auf **Continue**, um fortzufahren (oder überspringen Sie diesen Schritt).

## Schritt 4: Konfigurieren

In diesem Schritt setzen Sie Schwellenwerte und Optionen für jede ausgewählte Fähigkeit.

### Globale vs. feldspezifische Einstellungen

Einstellungen wirken auf zwei Ebenen:

1. **Global** – Standardeinstellungen für alle Felder
2. **Feldspezifisch** – überschreibt die Einstellungen für bestimmte Felder

Konfigurieren Sie zuerst die globalen Einstellungen und passen Sie anschließend bei Bedarf einzelne Felder an.

### Vollständigkeit konfigurieren

| Option | Beschreibung | Standard |
|--------|-------------|---------|
| Leere Werte als unvollständig behandeln | Werte, die nur aus Leerzeichen bestehen, als fehlend zählen | Ja |
| Platzhalter als unvollständig behandeln | N/A, TBD, Unknown als fehlend zählen | Ja |
| Benutzerdefinierte Platzhalterwerte | Eigene Platzhaltermuster hinzufügen | Keine |
| Schwellenwert | Mindestakzeptable Vollständigkeit in % | 95 % |

**Beispieleinstellungen für Contact:**
- Schwellenwert: 90 % für optionale Felder
- Schwellenwert: 99 % für Pflichtfelder wie Email
- Platzhalter: N/A, TBD, Unknown, -, .

### Gültigkeit konfigurieren

| Option | Beschreibung | Standard |
|--------|-------------|---------|
| Mustertyp | Email, URL, Fixed Length, Custom Regex | Email |
| Custom Regex | Eigenes Validierungsmuster | Keines |
| Groß-/Kleinschreibung beachten | Exakte Schreibweise abgleichen | Nein |
| Leere Werte einbeziehen | Leere Werte als ungültig zählen | Nein |

**Integrierte Muster:**
- **Email** – Format gemäß RFC 5322
- **URL** – HTTP/HTTPS-Format
- **Fixed Length** – exakte Zeichenanzahl

### Eindeutigkeit konfigurieren

| Option | Beschreibung | Standard |
|--------|-------------|---------|
| Groß-/Kleinschreibung beachten | „ABC" und „abc" als unterschiedlich behandeln | Nein |
| Schwellenwert | Mindestakzeptable Eindeutigkeit in % | 95 % |

### Aktualität konfigurieren

| Option | Beschreibung | Standard |
|--------|-------------|---------|
| Aktualitätsfenster (Tage) | Tage, bevor Daten als veraltet gelten | 90 |
| Karenzzeit (Tage) | Puffer, bevor als veraltet markiert wird | 7 |
| Operativer Bereich | Min./Max. erwartete Datumsgrenzen | Keiner |

**Beispieleinstellungen je Feld:**
- LastModifiedDate: 30-tägiges Aktualitätsfenster
- LastActivityDate: 90-tägiges Fenster
- BirthDate: keine Aktualitätsprüfung nötig

### Konsistenz konfigurieren

| Option | Beschreibung | Standard |
|--------|-------------|---------|
| Erwartete Werte | Liste gültiger Werte | Keine |
| Aus Picklist importieren | Automatisch aus der Picklist des Feldes befüllen | Nein |
| Groß-/Kleinschreibung beachten | Exakte Schreibweise abgleichen | Nein |
| Top-N dominante Werte | Häufigste Werte anzeigen | 5 |

### PII-Erkennung konfigurieren

| Option | Beschreibung | Standard |
|--------|-------------|---------|
| Mustertyp | Nach welchen PII-Mustern gescannt wird | Alle Muster |
| Benutzerdefinierte Muster | Eigene Regex-Muster für org-spezifische sensible Daten hinzufügen | Keine |

### Indikator für den Verarbeitungsaufwand

Jede Fähigkeit zeigt einen Verarbeitungsaufwand an:

| Aufwand | Fähigkeiten | Auswirkung |
|------|--------------|--------|
| NIEDRIG | Vollständigkeit, Gültigkeit | Schnell, minimale Ressourcen |
| MITTEL | Aktualität, Konsistenz, PII-Erkennung | Moderate Verarbeitungszeit |
| HOCH | Eindeutigkeit | Längere Verarbeitung, mehr Vergleiche |

Berücksichtigen Sie den Aufwand bei der Auswahl von Fähigkeiten für große Datenmengen.

Klicken Sie auf **Continue**, wenn die Konfiguration abgeschlossen ist.

## Schritt 5: Prüfen

Der letzte Schritt zeigt eine Zusammenfassung Ihrer Definition.

### Prüf-Checkliste

Prüfen Sie vor dem Aktivieren Folgendes:

1. **Objekt** – Korrektes Objekt ausgewählt
2. **Felder** – Alle wichtigen Felder einbezogen
3. **Fähigkeiten** – Passende Prüfungen ausgewählt
4. **Filter** – Datensatzanzahl sieht plausibel aus
5. **Schwellenwerte** – Einstellungen entsprechen Ihren Anforderungen

### Definitionszusammenfassung

Die Zusammenfassung zeigt:

- Definitionsname (bearbeitbar)
- Zielobjekt und Datensatzanzahl
- Ausgewählte Fähigkeiten mit Varianten
- Feldanzahl je Fähigkeit
- Geschätzter Verarbeitungsaufwand

### Ihre Definition benennen

Verwenden Sie aussagekräftige Namen, die Folgendes erkennen lassen:
- analysiertes Objekt
- Zweck oder Prüfbereich
- Verantwortlicher (optional)

**Gute Namen:**
- „Contact Data Quality - Sales Team"
- „Lead AI Readiness Check"
- „Account Completeness - EMEA Region"

**Schlechte Namen:**
- „Definition 1"
- „Test"
- „My Definition"

### Speichern und aktivieren

Sie haben zwei Optionen:

1. **Save as Draft** – speichern, ohne zu aktivieren (später bearbeitbar)
2. **Activate** – speichern und für den Scan bereitstellen

Definitionen im Entwurf (Draft) lassen sich bearbeiten. Aktive Definitionen sind gesperrt, aber ausführbereit.

## Beispiel: Eine Contact-Definition erstellen

Gehen wir gemeinsam das Erstellen einer Contact-Data-Quality-Definition durch.

### Schritt 1: Fähigkeiten auswählen

Wählen Sie:
- Vollständigkeit (auf fehlende Daten prüfen)
- Gültigkeit (E-Mail- und Telefonformate verifizieren)
- Aktualität (veraltete Contact-Datensätze finden)

### Schritt 2: Prüfbereich definieren

Objekt: Contact

Felder:
- Email (Text, Email)
- Phone (Phone)
- MailingCity (Text)
- MailingState (Text)
- MailingCountry (Text)
- Title (Text)
- LastActivityDate (Date)

### Schritt 3: Filter hinzufügen

Bedingung: `AccountId != null` (nur Contacts mit Account)

Vorschau der Datensatzanzahl: 15.234 Datensätze

### Schritt 4: Konfigurieren

**Vollständigkeit:**
- Schwellenwert: 90 %
- Leere Werte als unvollständig behandeln: Ja
- Platzhalter: N/A, Unknown, TBD

**Gültigkeit:**
- Email-Feld: Email-Muster
- Phone-Feld: Phone-Muster (falls verfügbar)

**Aktualität:**
- LastActivityDate: 60-tägiges Aktualitätsfenster
- Karenzzeit: 14 Tage

### Schritt 5: Prüfen

Name: „Contact Data Quality - Active Accounts"

Zusammenfassung:
- 7 Felder
- 3 Fähigkeiten
- 15.234 Datensätze
- Geschätzter Aufwand: NIEDRIG

Klicken Sie auf **Activate**, um den Vorgang abzuschließen.

## Definitionen verwalten

### Alle Definitionen anzeigen

Auf dem DQS-Startbildschirm sehen Sie:
- Alle Ihre Definitionen
- Status (Draft, Active, Archived)
- Datum des letzten Scans
- Schnellaktionen

### Definitionen bearbeiten

- **Draft** – vollständig bearbeitbar
- **Active** – zum Bearbeiten eine neue Version erstellen
- **Archived** – nur lesbar

### Definitionen archivieren

Archivieren Sie Definitionen, die Sie nicht mehr benötigen:
1. Klicken Sie auf das Dropdown-Menü
2. Wählen Sie **Archive**
3. Bestätigen Sie

Archivierte Definitionen bleiben einsehbar, können aber nicht ausgeführt werden.

## Fehlerbehebung

### „No fields available"

**Ursache:** Die ausgewählten Fähigkeiten passen nicht zu den verfügbaren Feldtypen.

**Lösung:** Wählen Sie andere Fähigkeiten oder ein Objekt mit kompatiblen Feldtypen.

### „0 records match filter"

**Ursache:** Die Filterbedingungen sind zu restriktiv.

**Lösung:** Passen Sie die Filterwerte an oder entfernen Sie Bedingungen.

## Nächste Schritte

- [Scans ausführen](/de/resources/using-dqs/running-scans/): Ihre Definition ausführen
- [Ergebnisse verstehen](/de/resources/using-dqs/understanding-results/): Scan-Ergebnisse interpretieren