Udostępnij przez


Zduplikowane tabele reguł

Aby uzyskać informacje o sposobie konfigurowania zduplikowanych reguł w aplikacji, zobacz Podręcznik administratorów: Konfigurowanie reguł wykrywania duplikatów w celu zachowania czyszczenia danych.

Reguły wykrywania duplikatów są definiowane przy użyciu następujących tabel:

  • DuplicateRule: aby wykryć duplikaty w systemie, utwórz regułę wykrywania duplikatów dla określonego typu tabeli. Można utworzyć wiele reguł wykrywania dla tego samego typu tabeli. Jednakże za jednym razem można opublikować maksymalnie pięciu reguł wykrywania duplikatów dla typu tabeli.
  • DuplicateRuleCondition: Reguła może mieć co najmniej jeden warunek reguły wykrywania duplikatów reprezentowany przez tabelę. Warunki są łączone przez system jak w logicznej operacji AND. Reguła wykrywania duplikatów określa typ tabeli podstawowej i pasujący typ tabeli. Zduplikowany warunek reguły określa nazwę kolumny podstawowej i nazwę pasującej kolumny. Na przykład określ konto jako tabelę podstawową i kontakt jako pasującą tabelę, aby porównać nazwiska i adresy. Kryteria dopasowania składają się z operatorów, np. dokładne dopasowanie, pierwszych n znaków lub ostatnich n znaków.

Te dwie tabele są powiązane przy użyciu relacji DuplicateRule_DuplicateRuleConditions .

Wykrywanie duplikatów polega na porównaniu wygenerowanych kodów dopasowania istniejących rekordów z każdym nowym tworzonym rekordem. Te kody dopasowania są tworzone wraz z tworzeniem każdego nowego rekordu. W związku z tym istnieje możliwość utworzenia co najmniej jednego zduplikowanego rekordu, jeśli są one przetwarzane dokładnie w tym samym momencie. Oprócz wykrywania duplikatów podczas ich tworzenia należy zaplanować zadania wykrywania duplikatów, aby sprawdzić inne potencjalne zduplikowane rekordy.

Reguły wykrywania duplikatów są w całym systemie. Należy je opublikować przed uruchomieniem zadania wykrywania duplikatów, aby wykryć duplikaty dla danych zbiorczych lub pobrać duplikaty dla określonego rekordu tabeli. Aby opublikować regułę wykrywania duplikatów, użyj komunikatu PublishDuplicateRule (PublishDuplicateRule Action lub PublishDuplicateRuleRequest). Publikowanie zduplikowanych reguł jest operacją asynchroniczną uruchamianą w tle.

Następujące kolumny z możliwością zapisu w tych tabelach kontrolują zachowanie reguł wykrywania duplikatów.

DuplicateRule

Kolumna Description
BaseEntityName Typ rekordu ocenianego pod kątem potencjalnych duplikatów.
Opis Opis reguły wykrywania duplikatów.
DuplicateRuleId Unikatowy identyfikator reguły wykrywania duplikatów.
ExcludeInactiveRecords Określa, czy mają być flagowane nieaktywne rekordy jako duplikaty.
Uwaga:
Domyślna wartość to false. Ustaw na true, jeśli nie chcesz, aby nieaktywne rekordy były oflagowane jako duplikaty, nawet jeśli spełniają kryteria reguły wykrywania duplikatów.
Więcej informacji: Stany nieaktywne
IsCaseSensitive Wskazuje, czy operator uwzględnia wielkość liter.
MatchingEntityName Typ rekordu rekordów ocenianych jako potencjalne duplikaty.
Nazwa Nazwa reguły wykrywania duplikatów.
OwnerId Unikatowy identyfikator użytkownika lub zespołu, który jest właścicielem reguły wykrywania duplikatów.
OwnerIdType Czy właściciel jest użytkownikiem, czy zespołem.
StatusCode Przyczyna stanu reguły wykrywania duplikatów.

Stany nieaktywne

Większość tabel systemowych i wszystkie tabele niestandardowe mają dwie StateCode opcje kolumn:

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

Wybrana etykieta może zostać zmieniona, ale wartość InvariantName nie ulegnie zmianie.

Niektóre tabele systemowe mają więcej niż jeden stan aktywny lub nieaktywny. W poniższej tabeli wymieniono przykłady tabel z więcej niż jednym stanem aktywnym lub nieaktywnym.

Kod stanu Aktywne stany Nieaktywne stany
Appointment.StateCode Open, Scheduled Completed, Canceled
CampaignActivity.StateCode Open Closed, Canceled
CampaignResponse.StateCode Open Completed, Canceled
Contract.StateCode Draft, InvoicedOn Hold Canceled, Expired
ContractDetail.KodStanu Existing, Renewed Canceled, Expired
Email.StateCode Open Completed, Canceled
Fax.StateCode Open Completed, Canceled
Incident.StateCode Active Resolved, CanceledClosed
Invoice.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
KodStanuZamówieniaSprzedaży Active, SubmittedInvoiced Canceled, Fulfilled
ServiceAppointment.StateCode Open, Scheduled Closed, Canceled
Task.StateCode Open Completed, Canceled

Na przykład, jeśli ustawisz kolumnę ExcludeInactiveRecords na true, tylko zamówienia sprzedaży Active, Submitted i Invoiced będą brane pod uwagę podczas wykrywania duplikatów.

Uwaga / Notatka

Dostępne opcje tabeli można przejrzeć StateCode , korzystając z przeglądarki metadanych opisanej w temacie Przeglądanie definicji tabeli i kolumn dla organizacji.

Aby pobrać StateCode opcje dla tabeli, możesz użyć następującego zapytania Web API, zastępując LogicalName tabeli użytym appointment poniżej.

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

DuplicateRule komunikaty specjalne

DuplicateRule to tabela należąca do użytkownika i są dozwolone normalne operacje tworzenia, pobierania, aktualizowania, przypisywania i usuwania, a także operacji kontroli dostępu. Więcej informacji: DuplicateRule Messages.

Można również użyć następujących specjalnych komunikatów:

Message Operacja interfejsu API sieci Web Zestaw SDK
CompoundUpdateDuplicateDetectionRule Akcja CompoundUpdateDuplicateDetectionRule CompoundUpdateDuplicateDetectionRuleRequest
PublikujZasadęDuplikatów Akcja PublishDuplicateRule PublishDuplicateRuleRequest
PublishXml Akcja PublishXml PublishXmlRequest
Cofnij publikację reguły duplikatu Akcja Cofnij publikowanie reguły duplikatów UnpublishDuplicateRuleRequest

DuplicateRuleCondition

Kolumna Description
BaseAttributeName Pole, które jest porównywane.
DuplicateRuleConditionId Unikatowy identyfikator warunku.
IgnoreBlankValues Określa, czy wartości puste mają być uwzględniane jako wartości nieduplikowane.
Uwaga:
Wartość domyślna tej kolumny to false. Ustaw ją na true wartość , jeśli nie chcesz, aby reguła wykrywania duplikatów uwzględniała null wartości jako równe.
Ważne:
W przypadku reguły wykrywania duplikatów z jednym warunkiem, jeśli ustawisz wartość kolumny na false, jest ona traktowana przez system jako true wartość.
MatchingAttributeName Pole, które jest porównywane z polem podstawowym.
OperatorCode Operator dla tego warunku reguły.
Ważne:
Jeśli ustawisz kolumnę OperatorCode na ExactMatch, nie ustaw kolumny na dowolną OperatorParam wartość
OperatorParam Wartość parametru N, jeśli operator to „Te same pierwsze znaki” lub „Te same ostatnie znaki”.
Ważne:
Nie ustawiaj OperatorParam wartości na zero podczas operacji tworzenia ani aktualizacji.
RegardingObjectId Unikatowy identyfikator obiektu, z którym jest skojarzony warunek.

DuplicateRuleCondition Specjalne komunikaty

DuplicateRuleCondition to tabela podrzędna dla DuplicateRule. Dostęp do pobierania lub modyfikowania tych tabel zależy od dostępu do skojarzonego z nimi DuplicateRule. Więcej informacji: DuplicateRuleCondition Messages.

Można również użyć następujących specjalnych komunikatów:

Message Operacja interfejsu API sieci Web Zestaw SDK
CompoundUpdateDuplicateDetectionRule Akcja CompoundUpdateDuplicateDetectionRule CompoundUpdateDuplicateDetectionRuleRequest

Zobacz także

duplicaterule EntityType
duplicaterulecondition EntityType
Wykrywanie zduplikowanych danych przy użyciu kodu
Włączanie i wyłączanie wykrywania duplikatów
Uruchamianie wykrywania duplikatów
Komunikaty wykrywania duplikatów
Przykład: włączanie wykrywania duplikatów i pobieranie duplikatów
Przykład: używanie wykrywania duplikatów podczas tworzenia i aktualizowania rekordów
Przykład: wykrywanie wielu zduplikowanych rekordów