View a markdown version of this page

Suche nach einer Match-ID für einen regelbasierten Matching-Workflow - AWS Entity Resolution

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Suche nach einer Match-ID für einen regelbasierten Matching-Workflow

Nachdem Sie einen regelbasierten Abgleichsworkflow abgeschlossen haben, können Sie die Match-ID und die zugehörige Regel für jeden verarbeiteten Datensatz abrufen. Anhand dieser Informationen können Sie nachvollziehen, wie Datensätze abgeglichen wurden und welche Regeln angewendet wurden. Das folgende Verfahren zeigt, wie Sie entweder über die AWS Entity Resolution Konsole oder die GetMatchID API auf diese Daten zugreifen.

Console
So suchen Sie mithilfe der Konsole nach einer Match-ID

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS Entity Resolution Konsole unter https://console.aws.amazon.com/entityresolution/.

  2. Wählen Sie im linken Navigationsbereich unter Workflows die Option Matching aus.

  3. Wählen Sie den regelbasierten Matching-Workflow aus, der verarbeitet wurde (Auftragsstatus ist Abgeschlossen).

  4. Wählen Sie auf der Seite mit den passenden Workflow-Details die Registerkarte „IDs abgleichen“.

  5. Wählen Sie Match-ID nachschlagen aus.

    Anmerkung

    Die Option Match-ID nachschlagen ist nur für passende Workflows verfügbar, die den automatischen Verarbeitungsrhythmus verwenden. Wenn Sie den manuellen Verarbeitungsrhythmus ausgewählt haben, wird diese Option als inaktiv angezeigt. Um diese Option zu verwenden, bearbeiten Sie Ihren Arbeitsablauf so, dass der automatische Verarbeitungsrhythmus verwendet wird. Weitere Informationen zum Bearbeiten von Workflows finden Sie unterBearbeitung eines passenden Workflows.

  6. Führen Sie eine der folgenden Aktionen aus:

    Wenn... Dann...
    Diesem Workflow ist nur eine Schemazuordnung zugeordnet. Zeigen Sie die Schemazuordnung an, die standardmäßig ausgewählt ist.
    Diesem Workflow ist mehr als eine Schemazuordnung zugeordnet. Wählen Sie die Schemazuordnung aus der Dropdownliste aus.

  7. Geben Sie für Datensatzattribute den Wert für einen vorhandenen Match-Schlüssel ein, um nach jedem vorhandenen Datensatz zu suchen.

    Tipp

    Geben Sie so viele Werte wie möglich ein, um die Match-ID leichter zu finden.

  8. Die Option Daten normalisieren ist standardmäßig ausgewählt, sodass Dateneingaben vor dem Abgleich normalisiert werden. Wenn Sie Daten nicht normalisieren möchten, deaktivieren Sie die Option Daten normalisieren.

  9. Wenn Sie die Vergleichsregeln anzeigen möchten, erweitern Sie das Feld Übereinstimmungsregeln anzeigen.

  10. Wählen Sie Look up.

    Es wird eine Erfolgsmeldung angezeigt, die besagt, dass die Match-ID gefunden wurde.

  11. Zeigen Sie die entsprechende Match-ID und die zugehörige Regel an, die gefunden wurde.

API
Um mithilfe der API nach einer Match-ID zu suchen
Anmerkung

Um diese API erfolgreich aufrufen zu können, müssen Sie zunächst einen regelbasierten Matching-Workflow mithilfe der StartMatchingJob API erfolgreich ausgeführt haben.

Eine vollständige Liste der unterstützten Programmiersprachen finden Sie im Abschnitt Siehe auch der GetMatch ID-API.

  1. Öffnen Sie ein Terminal oder eine Eingabeaufforderung, um die API-Anfrage zu stellen.

  2. Erstellen Sie eine POST-Anfrage an den folgenden Endpunkt: 

    /matchingworkflows/workflowName/matches

  3. Stellen Sie im Anforderungsheader das Content-type auf ein application/json.

  4. Geben Sie in der Anforderungs-URI Ihre anworkflowName.

    Das workflowName muss:

    • Zwischen 1 und 255 Zeichen lang sein

    • Entspricht dem Muster [a-z A-Z _0-9-] *

  5. Geben Sie für den Anforderungstext den folgenden JSON-Code an: 

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

    Wobei Folgendes gilt:

    applyNormalization(optional) — Auf setzen, true um die im Schema definierten Attribute zu normalisieren

    record(erforderlich) — Der Datensatz, für den die Match-ID abgerufen werden soll

  6. Senden Sie die Anforderung .

    Bei Erfolg erhalten Sie eine Antwort mit dem Statuscode 200 und einem JSON-Text, der Folgendes enthält: 

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

    Das matchId ist der eindeutige Bezeichner für diese Gruppe von übereinstimmenden Datensätzen und matchRule gibt an, nach welcher Regel der Datensatz abgeglichen wurde.

    Wenn der Anruf nicht erfolgreich ist, erhalten Sie möglicherweise eine der folgenden Fehlermeldungen:

    • 403 — AccessDeniedException wenn Sie nicht über ausreichenden Zugriff verfügen

    • 404 — ResourceNotFoundException wenn die Ressource nicht gefunden werden kann

    • 429 — ThrottlingException wenn die Anfrage gedrosselt wurde

    • 400 — ValidationException wenn die Eingabe die Überprüfung nicht besteht

    • 500 — InternalServerException wenn ein interner Servicefehler vorliegt