Recherche d'un identifiant de match pour un flux de travail de correspondance basé sur des règles - Résolution des entités AWS

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.

Recherche d'un identifiant de match pour un flux de travail de correspondance basé sur des règles

Après avoir terminé un flux de travail de correspondance basé sur des règles, vous pouvez récupérer l'ID de correspondance et la règle associée pour chaque enregistrement traité. Ces informations vous aident à comprendre comment les enregistrements ont été mis en correspondance et quelles règles ont été appliquées. La procédure suivante explique comment accéder à ces données à l'aide de la Résolution des entités AWS console ou de l'GetMatchIDAPI.

Console
Pour rechercher un Match ID à 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/.

  2. Dans le volet de navigation de gauche, sous Workflows, choisissez Matching.

  3. Choisissez le flux de travail de correspondance basé sur des règles qui a été traité (le statut du Job est terminé).

  4. Sur la page des détails du flux de travail correspondant, choisissez l' IDsonglet Match.

  5. Choisissez Rechercher l'identifiant du match.

  6. Effectuez l’une des actions suivantes :

    Si... Alors...
    Un seul mappage de schéma est associé à ce flux de travail. Affichez le mappage du schéma sélectionné par défaut.
    Plusieurs mappages de schéma sont associés à ce flux de travail. Choisissez le mappage du schéma dans la liste déroulante.

  7. Pour les attributs d'enregistrement, entrez la valeur d'une clé de correspondance existante pour rechercher chaque enregistrement existant.

    Astuce

    Entrez autant de valeurs que possible pour aider à trouver le Match ID.

  8. 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.

  9. Si vous souhaitez consulter les règles de correspondance, développez la section Afficher les règles de correspondance.

  10. Choisissez Recherche.

    Un message de réussite apparaît, indiquant que le Match ID a été trouvé.

  11. Affichez le Match ID correspondant et la règle associée qui ont été trouvés.

API
Pour rechercher un Match ID à l'aide de l'API
Note

Pour appeler cette API avec succès, vous devez d'abord avoir exécuté avec succès un flux de travail de correspondance basé sur des règles à l'aide de l'StartMatchingJob API.

Pour obtenir la liste complète des langages de programmation pris en charge, consultez la section Voir aussi de l'API GetMatch ID.

  1. Ouvrez un terminal ou une invite de commande pour effectuer la demande d'API.

  2. Créez une requête POST pour le point de terminaison suivant : 

    /matchingworkflows/workflowName/matches

  3. Dans l'en-tête de la demande, définissez le type de contenu sur application/json.

  4. Dans l'URI de demande, spécifiez votreworkflowName.

    Le workflowName must :

    • Comporter entre 1 et 255 caractères

    • Correspond au modèle [A-za-Z_0-9-] *

  5. Pour le corps de la requête, fournissez le code JSON suivant : 

    {
   "applyNormalization": boolean,
   "record": { 
      "string" : "string" 
   }
}

    Où :

    applyNormalization(facultatif) - Définissez sur true pour normaliser les attributs définis dans le schéma

    record(obligatoire) - L'enregistrement pour lequel récupérer le Match ID

  6. Envoyez la demande .

    En cas de succès, vous recevrez une réponse avec le code d'état 200 et un corps JSON contenant : 

    {
   "matchId": "string",
   "matchRule": "string"
}

    matchIdIl s'agit de l'identifiant unique de ce groupe d'enregistrements correspondants et matchRule indique à quelle règle l'enregistrement correspond.

    Si l'appel échoue, l'un des messages d'erreur suivants peut s'afficher :

    • 403 - AccessDeniedException si vous ne disposez pas d'un accès suffisant

    • 404 - ResourceNotFoundException si la ressource est introuvable

    • 429 - ThrottlingException si la demande a été limitée

    • 400 - ValidationException si la saisie échoue à la validation

    • 500 - en InternalServerException cas de panne du service interne