Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 en double sont définies à l’aide des tableaux suivants :
- DuplicateRule : pour détecter les doublons dans le système, créez une règle de détection en double 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 avoir une ou plusieurs conditions de règle de détection en double 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 en double spécifie un type de table de base et un type de table correspondant. Une condition de règle en double 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 comme table correspondante pour comparer les noms et 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 lié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 de créer un ou plusieurs enregistrements dupliqués s’ils sont traités au même moment. En plus de détecter les doublons à mesure qu’ils sont créés, vous devez planifier des travaux de détection en double 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 un travail de détection en double pour détecter les doublons pour les données en bloc ou récupérer des doublons pour un enregistrement de table particulier. 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 modifiables suivantes dans ces tables contrôlent le comportement des règles de détection des doublons.
DuplicateRule
| Colonne | Descriptif |
|---|---|
| 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. Note : La valeur par défaut est false. Définissez-le true si vous ne souhaitez pas que les enregistrements inactifs soient marqués comme des doublons, même s’ils répondent aux critères de règle de détection de duplication. 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. |
| Nom | 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 StateCode choix de colonnes :
-
Value: 0InvariantName:Active -
Value: 1InvariantName:Inactive
L’étiquette du choix peut être modifiée, mais la InvariantName valeur ne le sera pas.
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 |
| DétailsDuContrat.CodeÉtat |
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/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 |
| 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.
Note
Vous pouvez consulter les choix disponibles StateCode pour une table à l’aide du navigateur de métadonnées décrit dans Parcourir la table et les définitions de colonnes pour votre organisation.
Pour récupérer les StateCode choix d’une table, vous pouvez utiliser la requête d’API web suivante en remplaçant la table LogicalName par celle 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'affectation et de suppression sont autorisées, ainsi que les opérations pour contrôler 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 | Action CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
| PublishDuplicateRule | Action PublishDuplicateRule | PublishDuplicateRuleRequest |
| PublishXml | PublishXml Action | PublishXmlRequest |
| UnpublishDuplicateRule | UnpublishDuplicateRule Action | UnpublishDuplicateRuleRequest |
DuplicateRuleCondition
| Colonne | Descriptif |
|---|---|
| BaseAttributeName | Champ en cours de comparaison. |
| DuplicateRuleConditionId | Identificateur unique de la condition. |
| IgnoreBlankValues | Détermine s’il faut considérer les valeurs vides comme des valeurs nondupliquées. Note : La valeur par défaut de cette colonne est false. Définissez-la true si vous ne souhaitez pas que la règle de détection dupliquée considère null les valeurs comme égales. Important: Pour une règle de détection des duplicatas avec une condition, si vous définissez la valeur de colonne false sur, 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 aucune 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 la OperatorParam valeur 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 à la récupération ou à la modification de ces tables dépend de l'accès au système DuplicateRule 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 des doublons
Exécuter la détection dupliquée
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 : Identifier plusieurs enregistrements en double