Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Création d'un flux de travail de correspondance basé sur des règles avec le type de règle simple **Conditions préalables** Avant de créer un flux de travail de correspondance basé sur des règles, vous devez : 1. Créez un mappage de schéma. Pour de plus amples informations, veuillez consulter [Création d'un mappage de schéma](create-schema-mapping.md). 1. Si vous utilisez les profils clients Amazon Connect comme destination de sortie, assurez-vous que les autorisations appropriées sont configurées. La procédure suivante explique comment créer un flux de travail de correspondance basé sur des règles avec le type de règle **simple** à l'aide de la Résolution des entités AWS console ou de l'`CreateMatchingWorkflow`API. ------ #### [ Console ] **Pour créer un flux de travail de correspondance basé sur des règles avec le type de règle **simple** à l'aide de la console** 1. Connectez-vous à la Résolution des entités AWS console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/). 1. Dans le volet de navigation de gauche, sous **Workflows**, choisissez **Matching**. 1. Sur la page **des flux de travail correspondants**, dans le coin supérieur droit, choisissez **Créer un flux de travail correspondant**. 1. Pour **l'étape 1 : Spécifier les détails du flux de travail correspondants**, procédez comme suit : 1. Entrez un **nom de flux de travail correspondant** et une **description** facultative. 1. Pour la **saisie de données**, choisissez une **Région AWSAWS Glue ****base de données**, la **AWS Glue table**, puis le **mappage de schéma** correspondant. Vous pouvez ajouter jusqu'à 19 entrées de données. 1. L'option **Normaliser les données** est sélectionnée par défaut afin que les entrées de données soient normalisées avant la mise en correspondance. Si vous ne souhaitez pas normaliser les données, désélectionnez l'option **Normaliser les données**. **Note** La normalisation n'est prise en charge que pour les scénarios suivants dans **Créer un mappage de schéma** : Si les sous-types de **nom** suivants sont regroupés : **prénom**, **deuxième prénom, **nom**** de famille. Si les sous-types d'**adresse** suivants sont regroupés **: adresse 1**, **adresse 2**, **adresse 3**, **ville**, **État**, **pays**, **code postal**. Si les sous-types de **téléphone** suivants sont regroupés : **numéro de téléphone**, **code de pays du téléphone**. 1. Pour spécifier les autorisations **d'accès au service**, choisissez une option et prenez les mesures recommandées. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/rule-based-mw-simple.html) 1. (Facultatif) Pour activer les **balises** pour la ressource, choisissez **Ajouter une nouvelle balise**, puis entrez la paire ****clé/valeur****. 1. Choisissez **Suivant**. 1. Pour **l'étape 2 : Choisissez la technique de correspondance** : 1. Pour **Méthode de correspondance**, choisissez Correspondance **basée sur des règles**. 1. Pour **Type de règle**, choisissez **Simple**. ![Choisissez l'écran de technique de correspondance avec l'option de correspondance simple basée sur des règles sélectionnée.](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/images/choose-matching-method-rule-based-simple.PNG) 1. Pour **Cadence de traitement**, sélectionnez l'une des options suivantes. + Choisissez **Manuel** pour exécuter un flux de travail à la demande pour une mise à jour groupée + Choisissez **Automatique** pour exécuter un flux de travail dès que de nouvelles données se trouvent dans votre compartiment S3 **Note** Si vous choisissez **Automatique**, assurez-vous que EventBridge les notifications Amazon sont activées pour votre compartiment S3. Pour obtenir des instructions sur l'activation EventBridge d'Amazon à l'aide de la console S3, consultez la section [Activation d'Amazon EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) *dans le guide de l'utilisateur Amazon S3*. 1. (Facultatif) Pour **Index uniquement pour le mappage des identifiants**, vous pouvez choisir d'**activer** la possibilité d'indexer uniquement les données et de ne pas les générer IDs. Par défaut, le flux de travail correspondant est généré une IDs fois les données indexées. 1. Pour les **règles de correspondance**, entrez un **nom de règle**, puis choisissez les **clés de correspondance** pour cette règle. Vous pouvez créer jusqu'à 15 règles et appliquer jusqu'à 15 clés de correspondance différentes à vos règles pour définir des critères de correspondance. ![Interface de règles de correspondance avec des champs permettant de saisir le nom de la règle et de sélectionner les clés de correspondance.](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/images/matching-rules.PNG) 1. Pour le **type de comparaison**, choisissez l'une des options suivantes en fonction de votre objectif. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/rule-based-mw-simple.html) ![Options de type de comparaison : plusieurs champs de saisie pour trouver des correspondances entre les données stockées dans plusieurs champs, ou champ de saisie unique pour limiter la comparaison au sein d'un champ.](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/images/comparison-type.PNG) 1. Choisissez **Suivant**. 1. Pour l'**étape 3 : Spécifier la sortie et le format des données** : 1. Pour la **destination et le format de sortie des données**, choisissez l'**emplacement Amazon S3** pour la sortie des données et indiquez si le **format des données** sera des **données normalisées ou des données** **d'origine**. 1. Pour **le chiffrement**, si vous choisissez de **personnaliser les paramètres de chiffrement**, entrez l'ARN de la **AWS KMS clé**. 1. Affichez la **sortie générée par le système**. 1. Pour la **sortie de données**, choisissez les champs que vous souhaitez inclure, masquer ou masquer, puis prenez les mesures recommandées en fonction de vos objectifs. [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/rule-based-mw-simple.html) 1. Choisissez **Suivant**. 1. Pour **l'étape 4 : révision et création** : 1. Passez en revue les sélections que vous avez effectuées lors des étapes précédentes et modifiez-les si nécessaire. 1. Choisissez **Créer et exécuter**. Un message apparaît, indiquant que le flux de travail correspondant a été créé et que le travail a commencé. 1. Sur la page des détails du flux de travail correspondant, sous l'onglet **Mesures**, consultez les informations suivantes sous **Dernières mesures de travail** : + Le **Job ID**. + **État** **de la tâche de flux de travail correspondante : En **file d'attente**, **en cours**, **terminée**, échouée** + **Durée d'exécution de** la tâche de flux de travail. + Le nombre d'**enregistrements traités**. + Le nombre d'**enregistrements non traités**. + La **correspondance unique IDs générée**. + Le nombre d'**enregistrements en entrée**. Vous pouvez également consulter les statistiques des tâches correspondant aux tâches de flux de travail précédemment exécutées dans l'**historique des tâches**. 1. Une fois la tâche de flux de travail correspondante **terminée (le **statut** est terminé**), vous pouvez accéder à l'onglet **Sortie de données**, puis sélectionner votre **site Amazon S3** pour afficher les résultats. 1. (Type de traitement **manuel** uniquement) Si vous avez créé un flux de travail de **correspondance basé sur des règles** avec le type de traitement **manuel**, vous pouvez exécuter le flux de travail correspondant à tout moment en choisissant **Exécuter le flux de travail** sur la page des détails du flux de travail correspondant. ------ #### [ API ] **Pour créer un flux de travail de correspondance basé sur des règles avec le type de règle **simple** à l'aide de l'API** **Note** Par défaut, le flux de travail utilise un traitement standard (par lots). Pour utiliser le traitement incrémentiel (automatique), vous devez le configurer de manière explicite. 1. Ouvrez un terminal ou une invite de commande pour effectuer la demande d'API. 1. Créez une requête POST pour le point de terminaison suivant : ``` /matchingworkflows ``` 1. Dans l'en-tête de la demande, définissez le type de contenu sur application/json. **Note** Pour obtenir la liste complète des langages de programmation pris en charge, consultez la *[référence des Résolution des entités AWS API](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)*. 1. Pour le corps de la demande, fournissez les paramètres JSON obligatoires suivants : ``` { "description": "{{string}}", "incrementalRunConfig": { "incrementalRunType": "{{string}}" }, "inputSourceConfig": [ { "applyNormalization": {{boolean}}, "inputSourceARN": "{{string}}", "schemaName": "{{string}}" } ], "outputSourceConfig": [ { "applyNormalization": {{boolean}}, "KMSArn": "{{string}}", "output": [ { "hashed": boolean, "name": "{{string}}" } ], "outputS3Path": "{{string}}" } ], "resolutionTechniques": { "providerProperties": { "intermediateSourceConfiguration": { "intermediateS3Path": "{{string}}" }, "providerConfiguration": {{JSON value}}, "providerServiceArn": "{{string}}" }, "resolutionType": "RULE_MATCHING", "ruleBasedProperties": { "attributeMatchingModel": "{{string}}", "matchPurpose": "{{string}}", "rules": [ { "matchingKeys": [ "{{string}}" ], "ruleName": "{{string}}" } ] }, "ruleConditionProperties": { "rules": [ { "condition": "{{string}}", "ruleName": "{{string}}" } ] } }, "roleArn": "{{string}}", "tags": { "string" : "{{string}}" }, "workflowName": "{{{{string}}}}" } ``` Où : + `workflowName`(obligatoire) — Doit être unique et correspondre au modèle [a-za-Z\_0-9-] \* + `inputSourceConfig`(obligatoire) — Liste des configurations de 1 à 20 sources d'entrée + `outputSourceConfig`(obligatoire) — Exactement une configuration de source de sortie + `resolutionTechniques`(obligatoire) — Réglé sur « RULE\_MATCHING » pour une correspondance basée sur des règles + `roleArn`(obligatoire) — ARN du rôle IAM pour l'exécution du flux de travail + `ruleConditionProperties`(obligatoire) — Liste des conditions de règle et nom de la règle correspondante. Les paramètres facultatifs incluent : + `description`— Jusqu'à 255 caractères + `incrementalRunConfig`— Configuration du type d'exécution incrémentielle + `tags`— Jusqu'à 200 paires clé-valeur 1. (Facultatif) Pour utiliser le traitement incrémentiel au lieu du traitement standard (par lots) par défaut, ajoutez le paramètre suivant au corps de la demande : ``` "incrementalRunConfig": { "incrementalRunType": "AUTOMATIC" } ``` 1. Envoyez la demande . 1. En cas de succès, vous recevrez une réponse avec le code d'état 200 et un corps JSON contenant : ``` { "workflowArn": "string", "workflowName": "string", // Plus all configured workflow details } ``` 1. Si l'appel échoue, l'un des messages d'erreur suivants peut s'afficher : + 400 — ConflictException si le nom du flux de travail existe déjà + 400 — ValidationException si l'entrée échoue à la validation + 402 — ExceedsLimitException si les limites du compte sont dépassées + 403 — AccessDeniedException si vous ne disposez pas d'un accès suffisant + 429 — ThrottlingException si la demande a été limitée + 500 — en InternalServerException cas de panne du service interne ------