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: 0InvariantName:ActiveValue: 1InvariantName: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).