View a markdown version of this page

Buscando un ID de coincidencia para un flujo de trabajo de coincidencia basado en reglas - AWS Entity Resolution

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Buscando un ID de coincidencia para un flujo de trabajo de coincidencia basado en reglas

Tras completar un flujo de trabajo de coincidencia basado en reglas, puede recuperar el ID de coincidencia y la regla asociada para cada registro procesado. Esta información le ayuda a comprender cómo se compararon los registros y qué reglas se aplicaron. El siguiente procedimiento muestra cómo acceder a estos datos mediante la AWS Entity Resolution consola o la GetMatchID API.

Console
Para buscar un Match ID desde la consola

  1. Inicia sesión Consola de administración de AWS y abre la AWS Entity Resolution consola en https://console.aws.amazon.com/entityresolution/.

  2. En el panel de navegación izquierdo, en Flujos de trabajo, elija Coincidencia.

  3. Elija el flujo de trabajo coincidente basado en reglas que se haya procesado (el estado del trabajo es Completado).

  4. En la página de detalles del flujo de trabajo coincidente, seleccione la pestaña Identificadores coincidentes.

  5. Selecciona Buscar ID de coincidencia.

    nota

    La opción Buscar el ID de coincidencia solo está disponible para los flujos de trabajo coincidentes que utilizan la cadencia de procesamiento automática. Si ha seleccionado la cadencia de procesamiento manual, esta opción aparecerá inactiva. Para usar esta opción, edite su flujo de trabajo para usar la cadencia de procesamiento automática. Para obtener más información sobre la edición de flujos de trabajo, consulteEditar un flujo de trabajo coincidente.

  6. Realice una de las siguientes acciones:

    Si... Entonces...
    Solo hay una asignación de esquemas asociada a este flujo de trabajo. Vea la asignación de esquemas que está seleccionada de forma predeterminada.
    Hay más de una asignación de esquemas asociada a este flujo de trabajo. Elija la asignación de esquemas en la lista desplegable.

  7. En el caso de los atributos de registro, introduzca el valor de una clave de coincidencia existente para buscar cada registro existente.

    sugerencia

    Introduce tantos valores como puedas para ayudarte a encontrar el ID de coincidencia.

  8. La opción Normalizar datos está seleccionada de forma predeterminada, de modo que las entradas de datos se normalizan antes de la coincidencia. Si no desea normalizar los datos, anule la selección de la opción Normalizar datos.

  9. Si desea ver las reglas coincidentes, expanda la sección Ver reglas coincidentes.

  10. Elija Look up (Buscar).

    Aparece un mensaje de éxito que indica que se encontró el ID de la coincidencia.

  11. Consulta el ID de coincidencia correspondiente y la regla asociada que se encontró.

API
Para buscar un ID de coincidencia mediante la API
nota

Para llamar a esta API correctamente, primero debes haber ejecutado correctamente un flujo de trabajo coincidente basado en reglas mediante la StartMatchingJob API.

Para obtener una lista completa de los lenguajes de programación compatibles, consulta la sección Vea también de la API de GetMatch ID.

  1. Abre una terminal o una línea de comandos para realizar la solicitud a la API.

  2. Crea una solicitud POST para el siguiente punto final: 

    /matchingworkflows/workflowName/matches

  3. En el encabezado de la solicitud, Content-type defina como application/json.

  4. En el URI de la solicitud, especifique suworkflowName.

    workflowNameDeberán:

    • Tener entre 1 y 255 caracteres

    • Coincide con el patrón [a-z A-Z _0-9-] *

  5. Para el cuerpo de la solicitud, proporciona el siguiente JSON: 

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

    Donde:

    applyNormalization(opcional): configúralo true para normalizar los atributos definidos en el esquema

    record(obligatorio): el registro para el que se obtiene el ID de coincidencia

  6. Envíe la solicitud .

    Si tienes éxito, recibirás una respuesta con el código de estado 200 y un cuerpo JSON que contiene: 

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

    matchIdEs el identificador único de este grupo de registros coincidentes e matchRule indica con qué regla coincide el registro.

    Si la llamada no se realiza correctamente, es posible que reciba uno de los siguientes errores:

    • 403: AccessDeniedException si no tienes suficiente acceso

    • 404: ResourceNotFoundException si no se puede encontrar el recurso

    • 429: ThrottlingException si la solicitud fue limitada

    • 400: ValidationException si la entrada no pasa la validación

    • 500: InternalServerException si hay una falla en el servicio interno