Verwenden Sie diese Anweisungen, um ein UMF_QUERY-Eingabedokument zu erzeugen, mit dem Sie eine bestimmte Entität in der Datenbank suchen können. Das UMF_QUERY-Eingabedokument senden Sie über Web-Services zur Verarbeitung an eine Web-Service-Pipeline. Nachdem die Pipeline die Abfrage verarbeitet hat, gibt Web-Services ein UMF_QUERY_RESULT-Ausgabedokument zurück, das die Details zu der angeforderten Eingabe-Entität enthält.
Vorbereitung:
WebSphere Application Server muss aktiv sein, und mindestenss eine Web-Service-Pipeline muss gestartet und aktiv sein, um das UMF_QUERY-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_QUERY-Eingabedokument.
- Geben Sie im ROOT-Segment die erforderlichen UMF-Tags und Werte 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_QUERY enthalten:
- WS_DETAIL - gibt alle verfügbaren Entitätsdaten für die Eingabe-Entitäts-ID zurück.
- WS_RELATION - gibt eine Liste aller Entitäten zurück, die eine einstufige Beziehung zu der Eingabe-Entität unterhalten.
- WS_ALERT-Abfrage - gibt alle Rollenalerts im System zurück, an denen die Eingabe-Entitäts-ID beteiligt ist.
Wenn Sie einen anderen Formatcode verwenden, muss dieser Formatcode in der Tabelle UMF_OUTPUT_FORMAT konfiguriert sein.
- Geben Sie im Tag ENTITY_ID die Entitäts-ID der Entität ein, für die Informationen zurückgegeben werden sollen.
- Geben Sie eventuelle weitere Abfragekriterien über die optionalen UMF-Segmente <NAME>, <ADDRESS>, <EMAIL>, <ATTRIBUTE> und <NUMBER> ein.
- Senden Sie das UMF_QUERY-Eingabedokument an eine Web-Service-Pipeline.
Die Web-Service-Pipeline empfängt das UMF_QUERY-Dokument und verwendet die angegebenen Kriterien, um in der Datenbank nach Entitäten zu suchen, die der Abfrage entsprechen.
Anschließend verarbeitet die Pipeline die Abfrage, erstellt normale Protokolldateien und gibt die Ergebnisse über Web-Services in einem UMF_QUERY_RESULT-Ausgabedokument an die aufrufende Anwendung zurück.
Beispiel für UMF_QUERY-Suche
Bei dieser UMF_QUERY-Beispielsuche werden alle Informationen zur Entitäts-ID 1223 gesucht:
Anmerkung: Dieses Beispiel ist aus Gründen der Lesbarkeit formatiert. Die Formatvorgabe, dass jeder UMF-Datensatz eine Zeile enthalten muss, wird nicht beachtet.
<UMF_QUERY>
<DSRC_CODE>1589</DSRC_CODE>
<DSRC_REF>546</DSRC_REF>
<FORMAT_CODE>WS_DETAIL</FORMAT_CODE>
<ENTITY_ID>1223</ENTITY_ID>
</UMF_QUERY>