Tabelle delle regole duplicate

Per informazioni su come configurare regole duplicate nell'applicazione, vedere Guida agli amministratori: Configurare regole di rilevamento duplicate per mantenere puliti i dati.

Le regole di rilevamento duplicate vengono definite usando le tabelle seguenti:

• DuplicateRule: per rilevare i duplicati nel sistema, creare una regola di rilevamento duplicata per un tipo di tabella specifico. È possibile creare più regole di rilevamento per lo stesso tipo di tabella. Tuttavia, è possibile pubblicare un massimo di cinque regole di rilevamento duplicati per ogni tipo di tabella alla volta.
• DuplicateRuleCondition: una regola può avere una o più condizioni delle regole di rilevamento duplicate rappresentate dalla tabella. Le condizioni vengono combinate dal sistema come nell'operazione logica AND . Una regola di rilevamento di duplicati specifica un tipo di tabella di base e un tipo di tabella corrispondente. Una condizione di regola duplicata specifica il nome di una colonna di base e il nome di una colonna corrispondente. Ad esempio, specificare un account come tabella di base e un contatto come tabella corrispondente per confrontare i nomi e gli indirizzi. I criteri di corrispondenza sono costituiti da operatori come la corrispondenza esatta, il primo numero n di caratteri o l'ultimo n numero di caratteri.

Queste due tabelle sono correlate tramite la relazione DuplicateRule_DuplicateRuleConditions .

Il rilevamento dei duplicati funziona confrontando i codici di corrispondenza generati dei record esistenti con ogni nuovo record creato. Questi codici di corrispondenza vengono creati durante la creazione di ogni nuovo record. Pertanto, è possibile creare uno o più record duplicati se vengono elaborati nello stesso momento. Oltre a rilevare i duplicati mentre vengono creati, è consigliabile pianificare i lavori di rilevamento duplicati per controllare la presenza di altri potenziali duplicati di record.

Le regole di rilevamento dei duplicati sono a livello di sistema. È necessario pubblicarli prima di eseguire un processo di rilevamento duplicato per rilevare i duplicati per i dati in blocco o recuperare duplicati per un determinato record di tabella. Per pubblicare una regola di rilevamento duplicata, usare il PublishDuplicateRule messaggio (Azione PublishDuplicateRule o PublishDuplicateRuleRequest). La pubblicazione di regole duplicate è un'operazione asincrona eseguita in background.

Le colonne scrivibili seguenti in queste tabelle controllano il comportamento delle regole di rilevamento duplicate.

DuplicateRule

colonna	Description
BaseEntityName	Tipo di record esaminato per l'individuazione dei potenziali duplicati.
Descrizione	Descrizione della regola di rilevamento duplicati.
DuplicateRuleId	Identificatore univoco della regola per il rilevamento di duplicati.
EscludiRecordInattivi	Stabilisce se contrassegnare i record inattivi come duplicati. Nota: Il valore predefinito è false. Impostarla su true se non si desidera che i record inattivi vengano contrassegnati come duplicati, anche se soddisfano i criteri delle regole di rilevamento della duplicazione. Altre informazioni: Stati inattivi
IsCaseSensitive	Indica se l'operatore fa distinzione tra maiuscole e minuscole.
MatchingEntityName	Tipo di record dei record valutati come potenziali duplicati.
Nome	Nome della regola di rilevamento di duplicati.
OwnerId	Identificatore univoco dell'utente o del team proprietario della regola di rilevamento duplicati.
OwnerIdType	Indica se il proprietario è un utente o un team.
statuscode	Motivo dello stato della regola di rilevamento duplicati.

Stati inattivi

La maggior parte delle tabelle di sistema e di tutte le tabelle personalizzate dispone di due StateCode opzioni di colonna:

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

L'etichetta della scelta può essere modificata, ma il InvariantName valore non verrà modificato.

Alcune tabelle di sistema hanno più di uno stato attivo o inattivo. Nella tabella seguente sono elencati esempi di tabelle con più di uno stato attivo o inattivo.

StateCode	Stati attivi	Stati inattivi
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	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, Submitted, Invoiced	Canceled, Fulfilled
ServiceAppointment.StateCode	Open, Scheduled	Closed, Canceled
Task.StateCode	Open	Completed, Canceled

Ad esempio, se si imposta la ExcludeInactiveRecords colonna su true, solo Activegli ordini di vendita , Submittede Invoiced vengono considerati per la corrispondenza durante il rilevamento dei duplicati.

Annotazioni

È possibile esaminare le opzioni disponibili StateCode per una tabella usando il Visualizzatore metadati descritto in Esplorare le definizioni di tabella e colonna per l'organizzazione.

Per recuperare le StateCode scelte per una tabella, è possibile usare la query API Web seguente sostituendo l'oggetto LogicalName della tabella con appointment usato di seguito:

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

Messaggi speciali DuplicateRule

DuplicateRule è una tabella di proprietà dell'utente e le normali operazioni di creazione, recupero, aggiornamento, assegnazione ed eliminazione sono consentite nonché operazioni per controllare l'accesso. Altre informazioni: Messaggi di DuplicateRule.

È anche possibile usare i messaggi speciali seguenti:

Message	Operazione dell'API Web	Assembly SDK
CompoundUpdateDuplicateDetectionRule	Azione CompoundUpdateDuplicateDetectionRule	CompoundUpdateDuplicateDetectionRuleRequest
PublishDuplicateRule	Azione PublishDuplicateRule	PublishDuplicateRuleRequest
PublishXml	Azione PublishXml	PublishXmlRequest
UnpublishDuplicateRule	Azione UnpublishDuplicateRule	UnpublishDuplicateRuleRequest

DuplicateRuleCondition

colonna	Description
BaseAttributeName	Campo che viene confrontato.
DuplicateRuleConditionId	Identificatore univoco della condizione.
IgnoreBlankValues	Determina se considerare valori vuoti come valori non duplicati. Nota: Il valore predefinito di questa colonna è false. Impostarlo su true se non si vuole che la regola di rilevamento dei duplicati consideri i valori null uguali. Importante: Per una regola di rilevamento duplicata con una condizione, se si imposta il valore della colonna su false, viene considerato dal sistema come true valore.
MatchingAttributeName	Campo che viene confrontato rispetto al campo di base.
OperatorCode	Operatore per questa condizione della regola. Importante: Se imposti la colonna OperatorCode su ExactMatch, non impostare la colonna OperatorParam su alcun valore
OperatorParam	Valore del parametro di N se l'operatore è Same First Characters o Same Last Characters. Importante: Non impostare il OperatorParam su zero durante le operazioni di creazione o aggiornamento.
RegardingObjectId	Identificatore univoco dell'oggetto a cui è associata la condizione.

Messaggi speciali DuplicateRuleCondition

DuplicateRuleCondition è una tabella figlio in DuplicateRule. L'accesso per recuperare o modificare queste tabelle dipende dall'accesso all'oggetto DuplicateRule a cui è associato. Maggiori informazioni: Messaggi DuplicateRuleCondition.

È anche possibile usare i messaggi speciali seguenti:

Message	Operazione dell'API Web	Assembly SDK
CompoundUpdateDuplicateDetectionRule	Azione CompoundUpdateDuplicateDetectionRule	CompoundUpdateDuplicateDetectionRuleRequest

Vedere anche

duplicaterule EntityType
duplicaterulecondition EntityType
Rilevare i dati duplicati usando il codice
Abilitare e disabilitare il rilevamento dei duplicati
Esegui il rilevamento dei duplicati
Messaggi di rilevamento duplicati
Esempio: Abilitare il rilevamento dei duplicati e recuperare i duplicati
Esempio: Usare il rilevamento duplicati durante la creazione e l'aggiornamento di record
Esempio: Rilevare più record duplicati