Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Informationen dazu, wie Duplikatregeln in der Anwendung konfiguriert werden, siehe Administratorhandbuch: Einrichten von Duplikaterkennungsregeln, um Ihre Daten sauber zu halten.
Doppelte Erkennungsregeln werden mithilfe 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 Duplikaterkennungsregeln pro Tabellentyp auf einmal veröffentlichen.
-
DuplicateRuleCondition: Eine Regel kann eine oder mehrere doppelte Erkennungsregelbedingungen aufweisen, die durch die Tabelle dargestellt werden. Die Bedingungen werden vom System als logischer
ANDVorgang kombiniert. Eine Duplikaterkennungsregel gibt einen Basistabellentyp und einen übereinstimmenden Tabellentyp an. Eine doppelte Regelbedingung gibt den Namen einer Basisspalte und den Namen einer übereinstimmenden Spalte an. Geben Sie beispielsweise ein Konto als Basistabelle und einen Kontakt als übereinstimmende 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 mit der DuplicateRule_DuplicateRuleConditions Beziehung verknüpft.
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 kann ein oder mehrere duplizierte Datensätze erstellt werden, wenn sie genau im selben 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 Duplikaterkennungsauftrag ausführen, um Duplikate für Massendaten zu erkennen oder Duplikate für einen bestimmten Tabellendatensatz abzurufen. Um eine Regel zur Erkennung von Duplikaten zu veröffentlichen, verwenden Sie die Nachricht PublishDuplicateRule (PublishDuplicateRule Aktion oder PublishDuplicateRuleRequest). Das Veröffentlichen von Duplikatregeln ist ein asynchroner Vorgang, der im Hintergrund ausgeführt wird.
Die folgenden beschreibbaren Spalten in diesen Tabellen steuern das Verhalten doppelter Erkennungsregeln.
DuplicateRule
| Kolumne | Description |
|---|---|
| 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. Stellen Sie es auf true ein, wenn inaktive Datensätze nicht als Duplikate gekennzeichnet werden sollen, selbst wenn sie die Regeln für die Duplikaterkennung 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 | 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 benutzerdefinierten Tabellen haben zwei StateCode Spaltenoptionen:
-
Value: 0InvariantName:Active -
Value: 1InvariantName:Inactive
Die Beschriftung der Auswahl kann geändert werden, der InvariantName-Wert jedoch nicht.
Einige Systemtabellen weisen mehr als einen aktiven oder inaktiven Zustand auf. In der folgenden Tabelle sind Beispiele für Tabellen mit mehr als einem aktiven oder inaktiven Zustand 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, InvoicedOn Hold |
Canceled, Expired |
| ContractDetail.StateCode |
Existing, Renewed |
Canceled, Expired |
| Email.StateCode | Open |
Completed, Canceled |
| Fax.StateCode | Open |
Completed, Canceled |
| Incident.StateCode | Active |
Resolved, CanceledClosed |
| Rechnung.StateCode | Active |
Closed, PaidCanceled |
| KbArticle.StateCode |
Draft, UnapprovedPublished |
N/A |
| 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, SubmittedInvoiced |
Canceled, Fulfilled |
| ServiceAppointment.StateCode |
Open, Scheduled |
Closed, Canceled |
| Task.StateCode | Open |
Completed, Canceled |
Wenn Sie beispielsweise die ExcludeInactiveRecords-Spalte auf true einstellen, werden nur Active, Submitted, und Invoiced Verkaufsaufträge bei der Erkennung von Duplikaten für den Abgleich berücksichtigt.
Hinweis
Sie können die verfügbaren StateCode Auswahlmöglichkeiten für eine Tabelle mithilfe des unter " Durchsuchen der Tabellen- und Spaltendefinitionen" beschriebenen Metadatenbrowsers für Ihre Organisation überprüfen.
Um die StateCode Auswahlmöglichkeiten für eine Tabelle abzurufen, können Sie die folgende Web-API-Abfrage verwenden, wobei Sie den LogicalName Teil der Tabellenkennung durch den unten verwendeten 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 Vorgänge zum Erstellen, Abrufen, Aktualisieren, Zuweisen und Löschen sind zulässig sowie Vorgänge zum Steuern des Zugriffs. Weitere Informationen: DuplicateRule-Nachrichten
Die folgenden Sondermeldungen können auch verwendet werden:
| Nachricht | Web-API-Vorgang | SDK-Assembly |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRule-Aktion | CompoundUpdateDuplicateDetectionRuleRequest |
| PublishDuplicateRule | PublishDuplicateRule-Aktion | PublishDuplicateRuleRequest |
| PublishXml | PublishXml-Aktion | PublishXmlRequest |
| UnpublishDuplicateRule | UnpublishDuplicateRule-Aktion | UnpublishDuplicateRuleRequest |
DuplicateRuleCondition
| Kolumne | Description |
|---|---|
| BaseAttributeName | Das zu vergleichende Feld. |
| DuplicateRuleConditionId | Eindeutiger Bezeichner der Bedingung. |
| IgnoreBlankValues | Bestimmt, ob leere Werte als nichtduplizierte Werte betrachtet werden sollen. Hinweis: Der Standardwert dieser Spalte ist false. Setzen Sie ihn auf true, wenn die Duplikaterkennungsregel null Werte nicht als gleich betrachten soll. Wichtig: Wenn Sie für eine Duplikaterkennungsregel mit einer Bedingung den Spaltenwert falsefestlegen, wird sie 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 OperatorCode Spalte auf ExactMatch festlegen, legen Sie die OperatorParam Spalte nicht auf einen beliebigen Wert fest. |
| OperatorParam | Parameterwert von 'N', falls der Operator 'Gleiche Anfangszeichen' oder 'Gleiche Endzeichen' ist. Wichtig: Setzen Sie die OperatorParam nicht auf Null bei Erstellungs- oder Aktualisierungsvorgängen. |
| RegardingObjectId | Eindeutiger Bezeichner des Objekts, dem die Bedingung zugeordnet ist. |
DuplicateRuleCondition Spezielle Nachrichten
DuplicateRuleCondition ist eine untergeordnete Tabelle zu DuplicateRule. Der Zugriff auf das Abrufen oder Ändern dieser Tabellen hängt vom Zugriff auf die Entität ab, mit der sie durch DuplicateRule verknüpft ist. Weitere Informationen: DuplicateRuleCondition-Nachrichten
Die folgenden Sondermeldungen können auch verwendet werden:
| Nachricht | Web-API-Vorgang | SDK-Assembly |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRule-Aktion | CompoundUpdateDuplicateDetectionRuleRequest |
Siehe auch
duplicaterule EntityType
duplicaterulecondition EntityType
Erkennen doppelter Daten mithilfe von Code
Aktivieren und Deaktivieren der Duplikaterkennung
Duplikaterkennung ausführen
Duplikaterkennungsmeldungen
Beispiel: Duplikaterkennung aktivieren und Duplikate abrufen
Beispiel: Duplikaterkennung bei der Erstellung und Aktualisierung von Datensätzen verwenden
Beispiel: Mehrere doppelte Datensätze erkennen