Tables de règle de détection des doublons
Pour plus d’informations sur la configuration des règles de détection des doublons dans l’application, voir Guide pour les administrateurs : configurer des règles de détection des doublons pour garder vos données propres.
Les règles de détection des doublons sont définies à l’aide des tables suivantes :
- DuplicateRule : Pour détecter des doublons dans le système, créez une règle de détection des doublons pour un type de table spécifique. Vous pouvez créer plusieurs règles de détection pour le même type de table. Cependant, un maximum de cinq règles de détection des doublons peut être publié en même temps pour chaque type de table.
- DuplicateRuleCondition : Une règle peut contenir une ou plusieurs conditions de la règle de détection des doublons qui sont représentées par la table. Les conditions sont combinées par le système comme dans l’opération logique
AND. Une règle de détection des doublons spécifie un type de table de base et un type de table correspondante. Une condition de la règle de détection des doublons spécifie le nom d’une colonne de base et le nom d’une colonne correspondante. Par exemple, spécifiez un compte en tant que table de base et un contact en tant que table correspondante afin de comparer les noms et les adresses. Les critères de correspondance sont des opérateurs tels que « correspond exactement », « n-nombre premiers caractères » ou « n-nombre derniers caractères ».
Ces deux tables sont associées à l’aide de la relation DuplicateRule_DuplicateRuleConditions.
La détection des doublons consiste à comparer des codes de correspondance générés d’enregistrements existants avec chaque nouvel enregistrement créé. Ces codes de correspondance sont créés lorsque chaque nouvel enregistrement est créé. Par conséquent, il est possible qu’un ou plusieurs enregistrements en double soient créés s’ils sont traités au même moment. Outre la détection des doublons lorsqu’ils sont créés, vous devez planifier des tâches de détection des doublons pour rechercher d’autres enregistrements en double potentiels.
Les règles de détection des doublons s’appliquent à l’ensemble du système. Vous devez les publier avant d’exécuter une tâche de détection des doublons visant à détecter les doublons pour des données en bloc ou à récupérer les doublons pour un enregistrement de table spécifique. Pour publier une règle de détection des doublons, utilisez le message PublishDuplicateRule (PublishDuplicateRule Action ou PublishDuplicateRuleRequest). La publication d’une règle de détection des doublons est une opération asynchrone qui s’exécute en arrière-plan.
Les colonnes accessibles en écriture ci-après de ces tables contrôlent le comportement des règles de détection des doublons.
Règle dupliquée
| Colonne | Description |
|---|---|
| BaseEntityName | Type de l’enregistrement évalué pour les doublons potentiels. |
| Description | Description de la règle de détection des doublons. |
| DuplicateRuleId | Identificateur unique de la règle de détection des doublons. |
| ExcludeInactiveRecords | Détermine s’il faut marquer les enregistrements inactifs en tant que doublons. Remarque : La valeur par défaut est false. Attribuez-lui la valeur true si vous ne souhaitez pas que les enregistrements inactifs soient marqués comme doublons, même s’ils répondent aux critères de la règle de détection des doublons. Pour plus d’informations, voir États inactifs |
| IsCaseSensitive | Indique si l’opérateur respecte la casse. |
| MatchingEntityName | Type des enregistrements évalués comme doublons potentiels. |
| Name | Nom de la règle de détection des doublons. |
| OwnerId | Identificateur unique de l’utilisateur ou de l’équipe propriétaire de la règle de détection des doublons. |
| OwnerIdType | Indique si le propriétaire est un utilisateur ou une équipe. |
| StatusCode | Raison du statut de la règle de détection des doublons. |
États inactifs
La plupart des tables système et toutes les tables personnalisées ont deux choix de colonnes StateCode :
Value:·0InvariantName:ActiveValue:·1InvariantName:Inactive
L’Étiquette de l’option peut être modifiée, mais pas la valeur InvariantName.
Certaines tables système ont plusieurs états actifs ou inactifs. Le tableau suivant répertorie des exemples de tables avec plusieurs états actifs ou inactifs.
| StateCode | État(s) actif(s) | État(s) inactif(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 |
S.o. |
| 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 |
Par exemple, si vous définissez la colonne ExcludeInactiveRecords sur true, seules les commandes Active, Submitted et Invoiced sont prises en compte pour la correspondance pendant la détection des doublons.
Notes
Vous pouvez examiner les options StateCode disponibles pour une table à l’aide du navigateur de métadonnées décrit dans Accéder aux définitions de table et de colonne de votre organisation.
Pour extraire les options StateCode pour une table, vous pouvez utiliser la requête suivante de l’API web en remplaçant la valeur LogicalName de la table par la valeur appointment utilisée ci-dessous :
GET [organization URI]/api/data/v9.0/EntityDefinitions(LogicalName='appointment')/Attributes(LogicalName='statecode')/Microsoft.Dynamics.CRM.StateAttributeMetadata/OptionSet?$select=Options
Messages spéciaux pour DuplicateRule
DuplicateRule est une table appartenant à l’utilisateur et les opérations normales de création, de récupération, de mise à jour, d’attribution et de suppression sont autorisées ainsi que les opérations de contrôle de l’accès. Pour plus d’informations, voir Messages DuplicateRule.
Les messages spéciaux suivants peuvent également être utilisés :
| Message | Opération de l’API web | Assembly du Kit de développement logiciel (SDK) |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRule Action | CompoundUpdateDuplicateDetectionRuleRequest |
| PublishDuplicateRule | PublishDuplicateRule Action | PublishDuplicateRuleRequest |
| PublishXml | PublishXml Action | PublishXmlRequest |
| UnpublishDuplicateRule | UnpublishDuplicateRule Action | UnpublishDuplicateRuleRequest |
Condition de la règle de détection des doublons
| Colonne | Description |
|---|---|
| BaseAttributeName | Champ en cours de comparaison. |
| DuplicateRuleConditionId | Identificateur unique de la condition. |
| IgnoreBlankValues | Détermine s’il faut considérer les valeurs vides comme valeurs non dupliquées. Remarque : La valeur par défaut de cette colonne est false. Attribuez-lui la valeur true si vous ne souhaitez pas que la règle de détection de doublons considère les valeurs null comme égales. Important : Dans le cas d’une règle de détection des doublons à une seule condition, si vous définissez la valeur de la colonne sur false, elle est traitée par le système comme valeur true. |
| MatchingAttributeName | Champ en cours de comparaison avec le champ de base. |
| OperatorCode | Opérateur de cette condition de règle. Important : Si vous définissez la colonne OperatorCode sur ExactMatch, ne définissez pas la colonne OperatorParam sur n’importe quelle valeur |
| OperatorParam | Valeur de paramètre N si l’opérateur est Mêmes premiers caractères ou Mêmes derniers caractères. Important : Ne définissez pas OperatorParam sur zéro pendant les opérations de création ou de mise à jour. |
| RegardingObjectId | Identificateur unique de l’objet auquel la condition est associée. |
Messages spéciaux pour DuplicateRuleCondition
DuplicateRuleCondition est une table enfant de DuplicateRule. L’accès pour récupérer ou modifier ces tables dépend de l’accès à la règle DuplicateRule à laquelle il est associé. Pour plus d’informations, voir Messages DuplicateRuleCondition.
Les messages spéciaux suivants peuvent également être utilisés :
| Message | Opération de l’API web | Assembly du Kit de développement logiciel (SDK) |
|---|---|---|
| CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRule Action | CompoundUpdateDuplicateDetectionRuleRequest |
Voir aussi
duplicaterule EntityType
duplicaterulecondition EntityType
Détecter les doublons à l’aide de code
Activer et désactiver la détection de doublons
Exécuter la détection des doublons
Messages de détection des doublons
Exemple : Activer la détection des doublons et récupérer les doublons
Exemple : utiliser la détection des doublons lors de la création et la mise à jour des enregistrements
Exemple : rechercher plusieurs enregistrements dupliqués
Notes
Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)
Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).