Tabellen für doppelte Regeln

Informationen dazu, wie Duplikatregeln in der Anwendung konfiguriert werden, siehe Administratorhandbuch: Einrichten von Duplikaterkennungsregeln, um Ihre Daten sauber zu halten.

Regeln zur Erkennung von Duplikaten werden mit Hilfe der folgenden Tabellen definiert:

• DuplicateRule: Um Duplikate im System zu erkennen, erstellen Sie eine Duplikaterkennungsregel für einen bestimmten Tabellentyp. Sie können mehrere Erkennungsregeln für denselben Tabellentyp erstellen. Sie können jedoch maximal fünf Dublettenerkennungsregeln pro Tabellentyp auf einmal veröffentlichen.
• DuplicateRuleCondition: Eine Regel kann eine oder mehrere Duplikat-Erkennungsregel-Bedingungen haben, die durch die Tabelle repräsentiert werden. Die Bedingungen werden vom System als logischer AND Vorgang kombiniert. Eine Regel zur Duplikaterkennung gibt einen Basistabellentyp und einen passenden Tabellentyp an. Eine Bedingung für eine Dublettenregel gibt den Namen einer Basisspalte und den Namen einer passenden Spalte an. Geben Sie z.B. ein Konto als Basistabelle und einen Kontakt als passende Tabelle an, um Nachnamen und Adressen zu vergleichen. Die Entsprechungskriterien bestehen aus Operatoren wie genauer Entsprechung, erster N-Anzahl von Zeichen oder letzten N-Zahl von Zeichen.

Diese beiden Tabellen sind über die Beziehung DuplicateRule_DuplicateRuleConditions miteinander verbunden.

Die Duplikaterkennung arbeitet durch Vergleichen von Webressourcen generierten Übereinstimmungscodes der vorhandenen Datensätze mit jedem neuen Datensatz, der erstellt wird. Diese Übereinstimmungscodes werden erstellt, wenn der neue Datensatz erstellt wird. Daher ist es möglich, dass mindestens doppelten Datensätze erstellt werden sollen, wenn sie genau im gleichen Moment verarbeitet werden. Zusätzlich zum Erkennen von Duplikaten während der Erstellung können Sie einen Auftrag zur Duplikaterstellung planen, um nach anderen möglichen doppelten Datensätze zu suchen.

Die Duplikaterkennungsregeln gelten systemweit. Sie müssen sie veröffentlichen, bevor Sie einen Job zur Erkennung von Duplikaten ausführen, um Duplikate für Massendaten zu erkennen oder Duplikate für einen bestimmten Datensatz der Tabelle abzurufen. Um eine Duplikaterkennungsregel zu veröffentlichen, verwenden Sie die PublishDuplicateRule-Message (PublishDuplicateRule Action oder PublishDuplicateRuleRequest). Das Veröffentlichen von Dupplikatregeln ist ein asynchroner Vorgang, der im Hintergrund ausgeführt wird.

Die folgenden beschreibbaren Spalten in diesen Tabellen steuern das Verhalten der Regeln für die Duplikaterkennung.

Duplikatregel

Spalte	Beschreibung
BaseEntityName	Datensatztyp des Datensatzes, der in Bezug auf potenzielle Duplikate ausgewertet wird.
Beschreibung	Beschreibung der Duplikaterkennungsregel.
DuplicateRuleId	Eindeutiger Bezeichner der Duplikaterkennungsregel.
ExcludeInactiveRecords	Legt fest, ob inaktive Datensätze als Duplikate gekennzeichnet werden. Hinweis: Der Standardwert ist false. Setzen Sie ihn auf true, wenn Sie nicht wollen, dass inaktive Datensätze als Duplikate gekennzeichnet werden sollen, auch wenn sie Kriterien der Duplikaterkennungsregel erfüllen. Weitere Informationen: Inaktive Zustände
IsCaseSensitive	Gibt an, ob bei dem Operator die Groß-/Kleinschreibung beachtet wird.
MatchingEntityName	Datensatztyp der Datensätze, die als potenzielle Duplikate ausgewertet werden.
Name des Dataflows	Name der Duplikaterkennungsregel.
OwnerId	Eindeutiger Bezeichner des für die Duplikaterkennungsregel zuständigen Benutzers oder Teams.
OwnerIdType	Ob der Besitzer ein Benutzer oder ein Team ist.
StatusCode	Grund für den Status der Duplikaterkennungsregel.

Inaktive Status

Die meisten Systemtabellen und alle angepassten Tabellen haben zwei StateCode-Spalten zur Auswahl:

• Value: 0 InvariantName: Active
• Value: 1 InvariantName: Inactive

Die Beschriftung der Auswahl kann geändert werden, der InvariantName-Wert jedoch nicht.

Einige Systemtabellen haben mehr als einen aktiven oder inaktiven Status. In der folgenden Tabelle sind Beispiele für Tabellen mit mehr als einem aktiven oder inaktiven Status aufgeführt.

StateCode	Aktive(r) Status	Inaktive(r) Status
Appointment.StateCode	Open, Scheduled	Completed, Canceled
CampaignActivity.StateCode	Open	Closed, Canceled
CampaignResponse.StateCode	Open	Completed, Canceled
Contract.StateCode	Draft, Invoiced, On Hold	Canceled, Expired
ContractDetail.StateCode	Existing, Renewed	Canceled, Expired
Email.StateCode	Open	Completed, Canceled
Fax.StateCode	Open	Completed, Canceled
Incident.StateCode	Active	Resolved, Canceled, Closed
Invoice.StateCode	Active	Closed, Paid, Canceled
KbArticle.StateCode	Draft, Unapproved, Published	Nicht zutreffend
Lead.StateCode	Open	Qualified, Disqualified
Letter.StateCode	Open	Completed, Canceled
Opportunity.StateCode	Open	Won, Lost
PhoneCall.StateCode	Open	Completed, Canceled
Quote.StateCode	Draft, Active	Won, Closed
SalesOrder.StateCode	Active, Submitted, Invoiced	Canceled, Fulfilled
ServiceAppointment.StateCode	Open, Scheduled	Closed, Canceled
Task.StateCode	Open	Completed, Canceled

Wenn Sie z. B. die Spalte ExcludeInactiveRecords auf true festlegen, werden nur Active, Submitted und Invoiced Vertriebsaufträge für den Abgleich bei der Duplikaterkennung berücksichtigt.

Hinweis

Sie können die verfügbaren StateCode-Auswahlen für eine Tabelle mit dem Metadaten-Browser überprüfen, der in Durchsuchen der Tabellen- und Spalten-Definitionen für Ihre Organisation beschrieben wird.

Um die StateCode-Auswahlen für eine Tabelle abzurufen, können Sie die folgende Web-API-Abfrage verwenden, indem Sie die LogicalName der Tabelle durch die unten verwendete appointment ersetzen:

GET [organization URI]/api/data/v9.0/EntityDefinitions(LogicalName='appointment')/Attributes(LogicalName='statecode')/Microsoft.Dynamics.CRM.StateAttributeMetadata/OptionSet?$select=Options

DuplicateRule-Sondermeldungen

DuplicateRule ist eine benutzereigene Tabelle und normale Create-, Retrieve-, Update-, Assign- und DELETE-Operationen sind zugelassen, ebenso wie Operationen zur Steuerung des Zugriffs. Weitere Informationen: DuplicateRule-Nachrichten

Die folgenden Sondermeldungen können auch verwendet werden:

Meldung	Web-API-Vorgang	SDK-Assembly
CompoundUpdateDuplicateDetectionRule	CompoundUpdateDuplicateDetectionRule Action	CompoundUpdateDuplicateDetectionRuleRequest
PublishDuplicateRule	PublishDuplicateRule Action	PublishDuplicateRuleRequest
PublishXml	PublishXml Action	PublishXmlRequest
UnpublishDuplicateRule	UnpublishDuplicateRule Action	UnpublishDuplicateRuleRequest

Duplikatregelbedingung

Spalte	Beschreibung
BaseAttributeName	Das zu vergleichende Feld.
DuplicateRuleConditionId	Eindeutiger Bezeichner der Bedingung.
IgnoreBlankValues	Legt fest, ob leere Werte als eindeutige Werte gewertet werden. Hinweis: Der Standardwert dieser Spalte ist false. Setzen Sie ihn auf true fest, wenn Sie nicht wollen, dass die Duplikatserkennungsregel null Werte als gleichgestellt betrachtet. Wichtig: Wenn Sie für eine Duplikaterkennungsregel mit einer Bedingung den Spaltenwert auf false festlegen, wird er vom System als true-Wert behandelt.
MatchingAttributeName	Das Feld, das mit dem Ausgangsfeld verglichen wird.
OperatorCode	Operator für diese Regelbedingung. Wichtig: Wenn Sie die Spalte OperatorCode auf ExactMatch festlegen, dürfen Sie die Spalte OperatorParam auf keinen Wert festlegen
OperatorParam	Parameterwert von 'N', falls der Operator 'Gleiche Anfangszeichen' oder 'Gleiche Endzeichen' ist. Wichtig: Setzen Sie den OperatorParam nicht während Aktualisierungs- oder Erstellungsvorgängen auf Null.
RegardingObjectId	Eindeutiger Bezeichner des Objekts, dem die Bedingung zugeordnet ist.

DuplicateRuleCondition-Sondermeldungen

DuplicateRuleCondition ist eine untergeordnete Tabelle zu DuplicateRule. Der Zugriff zum Abrufen oder Ändern dieser Tabellen ist abhängig vom Zugriff auf die DuplicateRule, mit der sie verknüpft ist. Weitere Informationen: DuplicateRuleCondition-Nachrichten

Die folgenden Sondermeldungen können auch verwendet werden:

Meldung	Web-API-Vorgang	SDK-Assembly
CompoundUpdateDuplicateDetectionRule	CompoundUpdateDuplicateDetectionRule Action	CompoundUpdateDuplicateDetectionRuleRequest

Siehe auch

duplicaterule EntityType
duplicaterulecondition EntityType
Erkennen von doppelten Daten mit Code
Aktivieren und Deaktivieren der Duplikaterkennung
Duplikaterkennung ausführen
Duplikaterkennungsmeldungen
Beispiel: Duplikaterkennung aktivieren und Duplikate abrufen
Beispiel: Verwenden der Duplikaterkennung für die Erstellung und Aktualisierung von Datensätzen
Beispiel: Erkennen von mehreren doppelten Datensätzen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).