Entidades de regla de duplicados
Para obtener información sobre cómo configurar reglas de duplicados en la aplicación, vea Guía del administrador: Configurar reglas de detección de duplicados para mantener limpios los datos.
Las reglas de detección de duplicados se definen mediante las entidades siguientes:
Estas entidades están relacionadas mediante la relación DuplicateRule_DuplicateRuleConditions.
Los siguientes atributos programables en estas entidades controlan el comportamiento de las reglas de detección de duplicados.
DuplicateRule
| Atributo | Descripción |
|---|---|
| BaseEntityName | Tipo de registro del registro que se está evaluando en busca de duplicados posibles. |
| Description | Descripción de la regla de detección de duplicados. |
| DuplicateRuleId | Identificador único de la regla de detección de duplicados. |
| ExcludeInactiveRecords | Determina si se deben marcar los registros inactivos como duplicados. Nota: El valor predeterminado es false. Establézcalo en true si no desea que los registros inactivos se marquen como duplicados, aunque se cumplan los criterios de la regla de detección de duplicados. Más información: Estados inactivos |
| IsCaseSensitive | Indica si el operador distingue mayúsculas de minúsculas. |
| MatchingEntityName | Tipo de registro de los registros que se están evaluando como duplicados posibles. |
| Name | Nombre de la regla de detección de duplicados. |
| OwnerId | Identificador único del usuario o equipo propietario de la regla de detección de duplicados. |
| OwnerIdType | Si el propietario es un usuario o un equipo. |
| Código de estado | Razón para el estado de la regla de detección de duplicados. |
Estados inactivos
La mayoría de las entidades del sistema y todas las entidades personalizadas tienen dos opciones del atributo StateCode:
-
Value: 0InvariantName:Active -
Value: 1InvariantName:Inactive
Puede cambiar la etiqueta de la opción, pero el valor de InvariantName no.
Algunas entidades del sistema tendrán más de un estado activo o inactivo. La tabla siguiente muestra algunos ejemplos de entidades con más de un estado activo o inactivo.
| Entidad StateCode | Estado(s) activo(s) | Estado(s) inactivo(s) |
|---|---|---|
| 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/D |
| 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 |
Por ejemplo, si establece el atributo ExcludeInactiveRecords en true, solo los pedidos de venta Active, Submitted y Invoiced se tendrán en cuenta para la búsqueda de coincidencias durante la detección de duplicados.
Nota
Puede revisar las opciones de StateCode disponibles para una entidad con el Explorador de metadatos que se describe en Examinar los metadatos de la organización.
Para recuperar las opciones de StateCode para una entidad puede usar la siguiente consulta a la API web mediante la sustitución del LogicalName de la entidad por la appointment utilizada a continuación:
GET [organization URI]/api/data/v9.1/EntityDefinitions(LogicalName='appointment')/Attributes(LogicalName='statecode')/Microsoft.Dynamics.CRM.StateAttributeMetadata/OptionSet?$select=Options
Mensajes especiales de DuplicateRule
DuplicateRule es una entidad propiedad del usuario y permite ejecutar las operaciones normales para crear, recuperar, actualizar, asignar y eliminar, así como las operaciones para controlar el acceso. Más información: Mensajes de DuplicateRule.
También puede usar los siguientes mensajes especiales:
| Mensaje | Operación de API web | Ensamblado del SDK |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | Acción CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
| PublishDuplicateRule | Acción PublishDuplicateRule | PublishDuplicateRuleRequest |
| PublishXml | Acción PublishXml | PublishXmlRequest |
| UnpublishDuplicateRule | Acción UnpublishDuplicateRule | UnpublishDuplicateRuleRequest |
Condición de regla duplicada
| Attribute | Descripción |
|---|---|
| BaseAttributeName | Campo que se está comparando. |
| DuplicateRuleConditionId | Identificador único de la condición. |
| IgnoreBlankValues | Determina si los valores en blanco se deben considerar como valores no duplicados. Nota: El valor predeterminado de este atributo es false. Debe establecerlo en true si no desea que la regla de detección de duplicados considere los valores null como iguales. Importante: Para una regla de detección de duplicados con una condición, si establece el valor del atributo en false, el sistema lo trata como un valor true. |
| MatchingAttributeName | Campo que se está comparando con el campo base. |
| OperatorCode | Operador para esta condición de regla. Importante: Si establece el atributo OperatorCode en ExactMatch, no establezca ningún valor para el atributo OperatorParam |
| OperatorParam | Valor del parámetro de N si el operador es Mismos caracteres iniciales o Mismos caracteres finales. Importante: No puede establecer OperatorParam en cero durante las operaciones de creación o actualización. |
| RegardingObjectId | Identificador único del objeto al que está asociada la condición. |
Mensajes especiales de DuplicateRuleCondition
DuplicateRuleCondition es una entidad secundaria a DuplicateRule. El acceso para recuperar o modificar estas entidades depende del acceso a la DuplicateRule con la que están asociadas. Más información: Mensajes de DuplicateRuleCondition.
También puede usar los siguientes mensajes especiales:
| Mensaje | Operación de API web | Ensamblado del SDK |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | Acción CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
Consulte también
duplicaterule EntityType
duplicaterulecondition EntityType
Detectar datos duplicados
Habilitar y deshabilitar la detección de duplicados
Ejecutar detección de duplicados
Mensajes de detección de duplicados
Ejemplo: habilitar la detección de duplicados y recuperar los duplicados
Ejemplo: Uso de detección de duplicados para crear y actualizar registros
Ejemplo: detectar varios registros duplicados