Verwenden Sie diese Anweisungen, um ein UMF_SEARCH-Eingabedokument zu erzeugen, mit dem Sie Entitäten in der Entitätendatenbank suchen können, die den Datenwerten der in den Suchkriterien angegebenen Attributen entsprechen. Das UMF_SEARCH-Eingabedokument senden Sie über Web-Services zur Verarbeitung an eine Web-Service-Pipeline. Nachdem die Pipeline die Abfrage verarbeitet hat, geben die Web-Services ein UMF_SEARCH_RESULTS-Ausgabedokument zurück, das eine Liste der Entitäten enthält, die den Suchkriterien entsprechen.
Vorbereitung:
WebSphere Application Server muss aktiv sein, und mindestens eine Web-Service-Pipeline muss gestartet und aktiv sein, um das UMF_SEARCH-Eingabedokument zu empfangen und zu verarbeiten.
Informationen zu dieser Task:
Da die Suchanforderung ein UMF-Eingabedokument ist, müssen die Kriterien mit gültigen UMF-Tags formatiert werden. Sie können jeden Texteditor bzw. jedes Dienstprogramm verwenden, das UMF erstellt.
Vorgehensweise:
- Erstellen Sie ein neues UMF_SEARCH-Eingabedokument.
- Geben Sie im ROOT-Segment die erforderlichen UMF-Tags und die zugehörigen Werte sowie eventuelle optionale UMF-Tags und die zugehörigen Werte ein, die Sie für die Angabe der Suchkriterien verwenden wollen. Geben Sie mindestens Werte für die folgenden UMF-Tags ein:
- Geben Sie den Datenquellencode in den Tag DSRC_CODE ein. Der Standarddatenquellencode für Web-Service-Pipeline-Suchen ist 1589. Wenn Sie einen anderen Datenquellencode verwenden als den Standarddatenquellencode für Web-Service-Pipeline-Suchen, müssen Sie sicherstellen, dass dieser andere Code so konfiguriert ist, dass er keine Entitäten auflöst.
- Geben Sie den Datenquellenreferenzcode, der auf die anfordernde Nachrichtentransaktion verweist, in den Tag DSRC_REF ein. Der Datenquellenreferenzcode sollte aussagekräftig sein, weil er an die aufrufende Anwendung zurückgegeben wird.
- Geben Sie den Formatcode mit dem Tag FORMAT_CODE ein, um das Ausgabeformat der Ergebnisse anzugeben. 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
Wenn Sie einen anderen Formatcode verwenden, muss dieser Formatcode in der Tabelle UMF_OUTPUT_FORMAT konfiguriert sein.
- Geben Sie die Mindestauflösungsbewertung in den Tag MIN_LIKE_SCORE ein. Damit legen Sie die niedrigste numerische Bewertung fest, die als Übereinstimmung zwischen den Attributwerten in den Suchkriterien und den Entitäten in der Entitätendatenbank, die dieselben Attribute enthalten, angesehen wird. Je höher die Bewertung ist, umso genauer muss die Übereinstimmung sein. Eine Bewertung von 100 zeigt eine exakte Übereinstimmung an.
- Verwenden Sie die übrigen gültigen Segmente des UMF-Eingabedokuments, um die Datenwerte für die Attribute einzugeben, die die Suchkriterien bilden. Diese Werte sind die Attribute, die bei der Pipelinesuche über Web-Services verglichen werden, um die Liste der Entitäten mit übereinstimmenden oder ähnlichen Werten zu erzeugen. Die Genauigkeit der Übereinstimmung ist vom Wert in MIN_LIKE_SCORE abhängig.
- Senden Sie das UMF_SEARCH-Eingabedokument über Web-Services.
Die Web-Service-Pipeline empfängt das UMF_SEARCH-Dokument und verwendet den Entitätsauflösungsprozess, um gemäß den angegebenen Kriterien in der Datenbank nach Entitäten zu suchen.
Anschließend verarbeitet die Pipeline die Abfrage, erstellt normale Protokolldateien und gibt die Ergebnisse über Web-Services in einem UMF_SEARCH_RESULTS-Dokument im ausgewählten Format an die aufrufende Anwendung zurück.
Beispiel für UMF_SEARCH-Dokumentabfrage
Bei diesem UMF_SEARCH-Beispieleingabedokument wird der Formatcode WS_SUMMARY_TOP10 für die Abfrage der Entitätendatenbank verwendet. Es sollen die 10 Entitäten gesucht werden, deren Datenwerte für die Sozialversicherungsnummer dem Datenwert 555-09-8761 am genauesten entsprechen:
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>
<FORMAT_CODE>WS_SUMMARY_TOP10</FORMAT_CODE>
<NUMBER>
<NUM_TYPE>SSN</NUM_TYPE>
<NUM_VALUE>555-09-8761</NUM_VALUE>
</NUMBER>
</UMF_SEARCH>