Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Para obter informações sobre como configurar regras de duplicidade no aplicativo, consulte Guia do Administrador: Configurar regras de detecção de duplicidades para manter seus dados limpos.
As regras de detecção duplicadas são definidas usando as seguintes tabelas:
- DuplicateRule: para detectar duplicatas no sistema, crie uma regra de detecção duplicada para um tipo de tabela específico. Você pode criar várias regras de detecção para o mesmo tipo de tabela. Entretanto, poderá publicar no máximo cinco regras de detecção de duplicidades por tipo de tabela ao mesmo tempo.
-
DuplicateRuleCondition: uma regra pode ter uma ou mais condições de regra de detecção duplicadas representadas pela tabela. As condições são combinadas pelo sistema como na operação lógica
AND. Uma regra de detecção duplicada especifica um tipo de tabela base e um tipo de tabela correspondente. Uma condição de regra duplicada especifica o nome de uma coluna base e o nome de uma coluna correspondente. Por exemplo, especifique uma conta como uma tabela base e um contato como uma tabela correspondente para comparar sobrenomes e endereços. Os critérios correspondentes consistem em operadores como correspondência exata, primeiro número n de caracteres ou último número n de caracteres.
Essas duas tabelas estão relacionadas usando a relação DuplicateRule_DuplicateRuleConditions .
A detecção duplicada funciona comparando códigos de correspondência gerados de registros existentes com cada novo registro sendo criado. Esses códigos de correspondência são criados à medida que cada novo registro é criado. Portanto, há potencial para que um ou mais registros duplicados sejam criados se forem processados exatamente no mesmo momento. Além de detectar duplicatas conforme elas são criadas, você deve agendar trabalhos de detecção de duplicatas para verificar outros registros que possam ser duplicados.
As regras de detecção de duplicidades são têm efeito em todo o sistema. Você deve publicá-las antes de executar uma tarefa de detecção de duplicatas para detectar duplicatas em dados em lote ou recuperar duplicatas para um registro específico de uma tabela. Para publicar uma regra de detecção de duplicidades, use a PublishDuplicateRule mensagem(Ação PublishDuplicateRule ou PublishDuplicateRuleRequest). A publicação de regra de duplicidade é uma operação assíncrona executada em segundo plano.
As seguintes colunas graváveis nessas tabelas controlam o comportamento de regras de detecção duplicadas.
DuplicateRule
| Coluna | Description |
|---|---|
| BaseEntityName | Tipo do registro que está sendo avaliado em relação a duplicidades potenciais. |
| Descrição | Descrição da regra de detecção de duplicidades. |
| DuplicateRuleId | Identificador exclusivo da regra de detecção de duplicidades. |
| ExcludeInactiveRecords | Determina se os registros inativos serão sinalizados como duplicados. Observação: O valor padrão é false. Defina-o para true se você não quiser que os registros inativos sejam sinalizados como duplicatas, mesmo que atendam aos critérios de regra de detecção de duplicação. Mais informações: Estados inativos |
| IsCaseSensitive | Indica se o operador diferencia maiúsculas de minúsculas. |
| MatchingEntityName | Tipo dos registros que estão sendo avaliados como duplicidades potenciais. |
| Nome | Nome da regra de detecção de duplicidades. |
| OwnerId | Identificador exclusivo do usuário ou da equipe que possui a regra de detecção de duplicidades. |
| OwnerIdType | Se o proprietário é um usuário ou uma equipe. |
| StatusCode | Razão do status da regra de detecção de duplicidades. |
Estados inativos
A maioria das tabelas do sistema e todas as tabelas personalizadas têm duas StateCode opções de coluna:
-
Value: 0InvariantName:Active -
Value: 1InvariantName:Inactive
O rótulo da escolha pode ser alterado, mas o valor InvariantName não.
Algumas tabelas do sistema têm mais de um estado ativo ou inativo. A tabela a seguir lista exemplos de tabelas com mais de um estado ativo ou inativo.
| StateCode | Estados Ativos | Estados Inativos |
|---|---|---|
| Appointment.StateCode |
Open, Scheduled |
Completed, Canceled |
| Código de Estado da Atividade da Campanha | Open |
Closed, Canceled |
| CampaignResponse.StateCode (Código de Estado da Resposta da Campanha) | 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 |
| Fatura.CódigoEstado | 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 |
| PedidoDeVenda.CódigoDeEstado |
Active, Submitted, Invoiced |
Canceled, Fulfilled |
| ServiceAppointment.StateCode |
Open, Scheduled |
Closed, Canceled |
| Task.StateCode | Open |
Completed, Canceled |
**
Por exemplo, se você definir a coluna ExcludeInactiveRecords como true, somente os pedidos de vendas Active, Submitted e Invoiced são considerados para correspondência durante a detecção de duplicatas.
Observação
Você pode examinar as opções disponíveis StateCode para uma tabela usando o Navegador de Metadados descrito em Procurar as definições de tabela e coluna para sua organização.
Para recuperar as StateCode opções de uma tabela, você pode usar a seguinte consulta de Web API substituindo o LogicalName da tabela pelo appointment usado abaixo:
GET [organization URI]/api/data/v9.0/EntityDefinitions(LogicalName='appointment')/Attributes(LogicalName='statecode')/Microsoft.Dynamics.CRM.StateAttributeMetadata/OptionSet?$select=Options
Mensagens especiais DuplicateRule
DuplicateRule é uma tabela de propriedade do usuário e operações normais de criação, recuperação, atualização, atribuição e exclusão são permitidas, bem como operações para controlar o acesso. Mais informações: Mensagens DuplicateRule.
As seguintes mensagens especiais também podem ser usadas:
| Message | Operação da API Web | SDK Montagem |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | Ação CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
| PublishDuplicateRule | Ação PublishDuplicateRule | PublishDuplicateRuleRequest |
| PublishXml | Ação PublishXml | PublishXmlRequest |
| UnpublishDuplicateRule | Ação UnpublishDuplicateRule | UnpublishDuplicateRuleRequest |
DuplicateRuleCondition
| Coluna | Description |
|---|---|
| BaseAttributeName | Campo que está sendo comparado. |
| DuplicateRuleConditionId | Identificador exclusivo da condição. |
| IgnoreBlankValues | Determina se os valores em branco devem ser considerados como valores sem duplicação. Observação: O valor padrão desta coluna é false. Defina-a como true se você não quiser que a regra de detecção duplicada considere null valores como iguais. Importante: Para uma regra de detecção de duplicidade com uma condição, se você definir o valor da coluna como false, ele será tratado pelo sistema como valor true. |
| MatchingAttributeName | Campo que está sendo comparado com o campo base. |
| OperatorCode | Operador desta condição da regra. Importante: Se você definir a OperatorCode coluna como ExactMatch, não defina a OperatorParam coluna como nenhum valor |
| OperatorParam | Valor de N do parâmetro se o operador tiver os mesmos primeiros caracteres ou últimos caracteres. Importante: Não defina o OperatorParam como zero durante operações de criação ou atualização. |
| RegardingObjectId | Identificador exclusivo do objeto ao qual a condição está associada. |
Mensagens especiais DuplicateRuleCondition
DuplicateRuleCondition é uma tabela filha para DuplicateRule. O acesso para recuperar ou modificar essas tabelas depende do acesso ao DuplicateRule com o qual está associado. Mais informações: Mensagens DuplicateRuleCondition.
As seguintes mensagens especiais também podem ser usadas:
| Message | Operação da API Web | SDK Montagem |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | Ação CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
Consulte também
duplicaterule EntityType
duplicaterulecondition EntityType
Detectar dados duplicados usando código
Habilitar e desabilitar a detecção de duplicidades
Executar detecção duplicada
Mensagens de detecção de duplicidades
Exemplo: Habilitar a detecção de duplicidades e recuperar duplicidades
Exemplo: usar a detecção duplicada ao criar e atualizar registros
Exemplo: detectar vários registros duplicados