Entités 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 entités suivantes :
Ces entités sont associées à l’aide de la relation DuplicateRule_DuplicateRuleConditions.
Les attributs accessibles en écriture ci-après de ces entités contrôlent le comportement des règles de détection des doublons.
DuplicateRule
| Attribut | 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 entités système et toutes les entités personnalisées ont deux options d’attribut StateCode :
-
Value: 0InvariantName:Active -
Value: 1InvariantName:Inactive
L’étiquette de l’option peut être modifiée, mais pas la valeur InvariantName.
Certaines entités système ont plusieurs états actifs ou inactifs. Le tableau suivant répertorie les exemples d’entités avec plusieurs états actifs ou inactifs.
| Entité 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 l’attribut ExcludeInactiveRecords sur true, seules les commandes Active, Submitted et Invoiced seront prises en compte pour la correspondance pendant la détection des doublons.
Note
Vous pouvez examiner les options StateCode disponibles pour une entité à l’aide du navigateur de métadonnées décrit dans Accéder aux métadonnées de votre organisation.
Pour extraire les options StateCode pour une entité, vous pouvez utiliser la requête suivante de l’API web en remplaçant la valeur LogicalName de l’entité par la valeur appointment utilisée ci-dessous :
GET [organization URI]/api/data/v9.1/EntityDefinitions(LogicalName='appointment')/Attributes(LogicalName='statecode')/Microsoft.Dynamics.CRM.StateAttributeMetadata/OptionSet?$select=Options
Messages spéciaux pour DuplicateRule
DuplicateRule est une entité 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 | Action CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
| PublishDuplicateRule | Action PublishDuplicateRule | PublishDuplicateRuleRequest |
| PublishXml | Action PublishXml | PublishXmlRequest |
| UnpublishDuplicateRule | Action UnpublishDuplicateRule | UnpublishDuplicateRuleRequest |
Condition de la règle de détection des doublons
| Attribute | 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 cet attribut 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 l’attribut 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 l’attribut OperatorCode sur ExactMatch, ne définissez pas l’attribut 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 entité enfant de DuplicateRule. L’accès pour récupérer ou modifier ces entités 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 | Action CompoundUpdateDuplicateDetectionRule | CompoundUpdateDuplicateDetectionRuleRequest |
Voir aussi
duplicaterule EntityType
duplicaterulecondition EntityType
Détecter les données dupliquées
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