IM Relationship Resolution-Informationszentrale Version 4.2

Eingabedokument UMF_SEARCH

Das Eingabedokument UMF_SEARCH enthält die Anforderungs- und Suchkriterien für eine Web-Service-Pipeline-Suche. Es enthält die Sammlung von UMF-Segmenten, die die ankommenden Daten strukturieren, um die Entitätendatenbank nach Entitäten zu durchsuchen, die den Suchkriterien entsprechende Attributwerte enthalten, und um dann die Liste der Entitäten an die aufrufende Anwendung zurückzusenden. Die Ergebnisse dieser Web-Service-Pipeline-Suche werden in einem Ausgabedokument UMF_SEARCH_RESULT an die aufrufende Anwendung zurückgegeben.

Das Rootsegment für das Eingabedokument UMF_SEARCH besteht aus folgenden UMF-Tags:
DSRC_CODE
UMF-Tag des Datenquellencodes, der erforderlich ist, weil er auf die aufrufende Anwendung verweist und sie angibt. Dieser Datenquellencode wird während der normalen Pipelineprotokollierung für jedes verarbeitete Dokument UMF_SEARCH in der Tabelle UMF_LOG protokolliert.
Das System ist bereits mit dem Datenquellencode 1589 konfiguriert, der für alle Web-Service-Pipeline-Suchen verwendet werden kann. Dieser Datenquellencode führt die Entitätsauflösungsverarbeitung durch, ohne die ankommenden Suchkriterien in die Entität in der Entitätendatenbank aufzulösen, die mit der Suche übereinstimmt. Sie können Ihren eigenen Datenquellencode für eine bestimmte aufrufende Anwendung erstellen. Nur müssen Sie dazu sicherstellen, dass der Datenquellencode so eingestellt ist, dass er keine Entitäten auflöst.
DSRC_REF
UMF-Tag des Datenquellenverweises, der erforderlich ist, weil er auf die anfordernde Nachrichtentransaktion verweist und an die aufrufende Anwendung zurückgegeben wird.
SRC_CREATE_DT
Der UMF-Tag für das Quellenerstellungsdatum ist optional. Wenn dieser Tag einen Wert enthält, wird er für die Protokollierung verwendet.
SRC_LSTUPD_DT
Der UMF-Tag für das Datum der letzten Aktualisierung der Quelle ist optional. Wenn dieser Tag einen Wert enthält, wird er für die Protokollierung verwendet.
SRC_LSTUP_US
Der UMF-Tag für den Benutzer, der die letzte Aktualisierung der Quelle vorgenommen hat, ist optional. Wenn dieser Tag einen Wert enthält, wird er für die Protokollierung verwendet.
MIN_LIKE_SCORE
UMF-Tag für die Mindestauflösungsbewertung (oder Ähnlichkeitsbewertung), der für die Erstellung des niedrigsten übereinstimmenden Werts für die anderen angegebenen UMF-Segmente und -Tags erforderlich ist. Diese numerische Bewertung legt fest, was zwischen den angeforderten Attributwerten und den Entitäten in der Entitätendatenbank, die dieselben Attribute enthalten, als Übereinstimmung betrachtet wird. Je höher die Bewertung ist, umso genauer muss die Übereinstimmung sein. Eine Bewertung von 100 zeigt eine exakte Übereinstimmung an.
Sollen bei der Suche beispielsweise alle Entitäten mit einer bestimmten Sozialversicherungsnummer gefunden werden, legt MIN_LIKE_SCORE fest, wie groß die Übereinstimmung zwischen einer Sozialversicherungsnummer und dem in der Abfrage angegebenen Wert für die Sozialversicherungsnummer sein muss, damit eine Entität in der Datenbank in der Ergebnismenge für diese Abfrage enthalten ist.
FORMAT_CODE
UMF-Tag, der zu einem UMF-Ausgabedokumentformat in Wechselbeziehung steht, das in der Tabelle UMF_FORMAT_CODE angegeben ist. Im Lieferumfang von IBM Relationship Resolution sind drei integrierte Formatcodes für Web-Service-Pipeline-Suchen mit UMF_SEARCH enthalten:
  • WS_SUMMARY_TOP10, gibt die 10 Entitäten zurück, die am besten mit den Suchkriterien übereinstimmen
  • WS_SUMMARY_TOP100, gibt die 100 Entitäten zurück, die am besten mit den Suchkriterien übereinstimmen
  • Abfrage WS_SUMMARY, gibt alle Entitäten zurück, die mit den Suchkriterien übereinstimmen
Der einzige Unterschied zwischen diesen Abfragen liegt in der Anzahl der zurückgegebenen Datensätze, die im Abfragenamen angegeben ist.
Nach dem Rootsegment geben Sie die Suchkriterien mit Hilfe der anderen verfügbaren UMF-Segmente und ihrer gültigen Tags für Namen, Adressen, Nummern, Merkmale und E-Mail-Adressen an.

UMF_SEARCH-Beispielabfrage

Diese UMF_SEARCH-Beispielabfrage gibt die ersten 5 Entitäten in der Entitätendatenbank zurück, die eine Sozialversicherungsnummer haben, die exakt mit der Sozialversicherungsnummer 555-09-8761 übereinstimmt. Auch wenn mehr Entitäten gefunden werden, werden nur die ersten 5 Entitäten in der Liste zurückgegeben.
Anmerkung: Dieses Beispiel ist aus Gründen der Lesbarkeit formatiert. Die Formatvorgabe, dass jeder UMF-Datensatz eine Zeile enthalten muss, wird nicht beachtet.
<UMF_SEARCH>
	<DSRC_CODE>1589</DSRC_CODE>
	<DSRC_REF>1223</DSRC_REF>
	<MIN_LIKE_SCORE>100</MIN_LIKE_SCORE>
	<MAX_RETURN_CNT>5</MAX_RETURN_CNT>
	<FORMAT_CODE>WS_SUMMARY</FORMAT_CODE>
	<NUMBER>
		<NUM_TYPE>SSN</NUM_TYPE>
		<NUM_VALUE>555-09-8761</NUM_VALUE>
	</NUMBER>
</UMF_SEARCH>
Zugehörige Verweise
Formatcodes WS_SUMMARY


Feedback

Letzte Aktualisierung: 2007