Tablas de reglas duplicadas

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 tablas siguientes:

• DuplicateRule: para detectar duplicados en el sistema, cree una regla de detección de duplicados para un tipo de tabla específica. Puede crear múltiples reglas de detección para el mismo tipo de tabla. Sin embargo, puede publicar un máximo de cinco reglas de detección de duplicados por tipo de tabla a la vez.
• DuplicateRuleCondition: una regla puede tener una o más condiciones de la regla de detección de duplicados representadas por la tabla. El sistema combina las condiciones como en la operación lógica AND. Una regla de detección de duplicados especifica un tipo de tabla base y un tipo de tabla coincidente. Una condición de regla de duplicados especifica el nombre de una columna base y el nombre de una columna coincidente. Por ejemplo, especifique una cuenta como la tabla base y un contacto como la tabla coincidente para comparar apellidos y direcciones. Los criterios de coincidencia constan de operadores como coinciden exactamente, primer número n de caracteres o último número n de caracteres.

Estas dos tablas están relacionadas mediante la relación DuplicateRule_DuplicateRuleConditions.

Trabajos de detección de duplicados contrastando códigos de correspondencia generados de registros existentes con cada nuevo registro creado. Estos códigos de correspondencia se crean con la creación de cada nuevo registro. Por lo tanto, hay posibilidad de que se creen uno o más registros duplicados si se procesan en el mismo momento. Además de detectar duplicados según se crean, debe programar trabajos de detección de duplicados para comprobar si hay otros posibles registros duplicados.

Las reglas de detección de duplicados son para todo el sistema. Debe publicarlas antes de ejecutar un trabajo de detección de duplicados para detectar duplicados de datos en masa o recuperar duplicados de un registro de tabla específico. Para publicar una regla de detección de duplicados, use el mensaje PublishDuplicateRule (PublishDuplicateRule Action o PublishDuplicateRuleRequest). La publicación de reglas de duplicados es una operación asincrónica que se ejecuta en segundo plano.

Las siguientes columnas escribibles de estas tablas controlan el comportamiento de las reglas de detección de duplicados.

DuplicateRule

Columna	Descripción
BaseEntityName	Tipo de registro del registro que se está evaluando en busca de duplicados posibles.
Descripción	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, incluso si cumplen 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 tablas del sistema y todas las tablas personalizadas tienen dos elecciones de columna StateCode :

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

Puede cambiar la elección de la opción, pero no cambiará el valor de InvariantName.

Algunas tablas del sistema tienen más de un estado activo o inactivo. La siguiente tabla enumera ejemplos de tablas con más de un estado activo o inactivo.

Código de estado	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 la columna ExcludeInactiveRecords en true, solo los pedidos de ventas 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 elecciones de StateCode disponibles para una tabla con el Explorador de metadatos que se describe en Examinar las definiciones de taba y columna para su organización.

Para recuperar las elecciones de StateCode para una tabla puede usar la siguiente consulta a la API web mediante la sustitución del LogicalName de la tabla por la appointment utilizada a continuación:

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

Mensajes especiales de DuplicateRule

DuplicateRule es una tabla 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 la API web	Ensamblado del SDK
CompoundUpdateDuplicateDetectionRule	CompoundUpdateDuplicateDetectionRule Action	CompoundUpdateDuplicateDetectionRuleRequest
PublishDuplicateRule	PublishDuplicateRule Action	PublishDuplicateRuleRequest
PublishXml	PublishXml Action	PublishXmlRequest
UnpublishDuplicateRule	UnpublishDuplicateRule Action	UnpublishDuplicateRuleRequest

DuplicateRuleCondition

Columna	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 esta columna 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 de la columna 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 la columna OperatorCode en ExactMatch, no establezca la columna OperatorParam en ningún valor
OperatorParam	Valor del parámetro de N si el operador es Mismos caracteres iniciales o Mismos caracteres finales. Importante: No establezca 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 tabla secundaria de DuplicateRule. El acceso para recuperar o modificar estas tablas 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 la API web	Ensamblado del SDK
CompoundUpdateDuplicateDetectionRule	CompoundUpdateDuplicateDetectionRule Action	CompoundUpdateDuplicateDetectionRuleRequest

Consulte también

duplicaterule EntityType
duplicaterulecondition EntityType
Detección de datos duplicados con código
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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).