View a markdown version of this page

Recherche d'un identifiant de correspondance 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 correspondance 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 montre 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 à Console de gestion AWS et ouvrez la Résolution des entités AWS console à 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 correspondant basé sur des règles qui a été traité (le statut de la tâche est Terminé).

  4. Sur la page des détails du flux de travail correspondant, choisissez l'onglet Identifiants correspondants.

  5. Choisissez Look up match ID.

    Note

    L'option Rechercher l'identifiant de correspondance n'est disponible que pour les flux de travail correspondants qui utilisent la cadence de traitement automatique. Si vous avez sélectionné la cadence de traitement manuel, cette option apparaîtra inactive. Pour utiliser cette option, modifiez votre flux de travail afin d'utiliser la cadence de traitement automatique. Pour plus d'informations sur la modification des flux de travail, consultezModifier un flux de travail correspondant.

  6. Effectuez l’une des actions suivantes :

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

  7. Pour Attributs d'enregistrement, entrez la valeur d'une clé de correspondance existante afin de rechercher chaque enregistrement existant.

    Astuce

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

  8. L'option Normaliser les données est sélectionnée par défaut, de sorte que les entrées de données soient normalisées avant d'être mises 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 s'affiche, indiquant que le Match ID a été trouvé.

  11. Affichez l'ID de correspondance correspondant et la règle associée qui a été trouvée.

API
Pour rechercher un identifiant de correspondance à 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 vers le point de terminaison suivant : 

    /matchingworkflows/workflowName/matches

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

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

    Le workflowName must :

    • Comporter entre 1 et 255 caractères

    • Correspond au modèle [a-z A-Z _0-9-] *

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

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

    Où :

    applyNormalization(facultatif) - Paramétrez true pour normaliser les attributs définis dans le schéma

    record(obligatoire) - L'enregistrement pour lequel récupérer l'identifiant de correspondance

  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 validation de l'entrée échoue

    • 500 - en InternalServerException cas de panne de service interne