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
ANDVorgang 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: 0InvariantName:ActiveValue: 1InvariantName: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).