IM Relationship Resolution Information Center, Version 4.2

wsutil.jar usage syntax

Wsutil.jar is a command-line based Java application provided as a test client to test your Relationship Resolution Web services installation and configuration. To use wsutil.jar, you specify a wsutil.jar operator with the corresponding input and output modifiers.

The syntax for wsutil.jar usage is based on which Web services operation you want to test:

java -jar wsutil.jar --operator=URI --input=URI --output=URI

help
Displays online help and command line information for the wsutil.jar test client.
java -jar wsutil.jar --help
load=URI
Specifies pipeline style UMF records and the Uniform Resource Identifier (URI) for the Relationship Resolution Web services interface.
java -jar wsutil.jar --load=URI [--xslt=URI][--input=URI][--output=URI]
This operation loads the UMF records from the specified URI into the Web services pipelines for entity resolution processing. After processing, the operation returns the entity ID and an indicator of whether the inbound entity was merged with an existing entity or caused a new entity to be created.
process=URI
Specifies generic XML or UMF records and the Uniform Resource Identifier (URI) for the Relationship Resolution Web services interface.
java -jar wsutil.jar --process=URI [--xslt=URI][--input=URI][--output=URI]
Use this operation to process any UMF input document and receive a UMF output document as a result. The process method is intended to handle all requests and responses supported by the pipeline. It is usually the method of choice for all operations.
score=URI
Use the process method in place of this method, which remains for backwards compatibility. Specifies dynamic scoring engine style requests and responses with the Uniform Resource Identifier (URI) for the Relationship Resolution Web services interface.
java -jar wsutil.jar --score=URI [--xslt=URI][--input=URI][--output=URI]
This operation searches for an entity in the entity database, runs the requested dynamic scoring engine model against the found entity, and then returns a final score for the found entity. However, you can use the process method to perform this same operation.
search=URI
Specifies pipeline search style UMF requests and responses with the Uniform Resource Identifier (URI) for the Relationship Resolution Web services interface.
java -jar wsutil.jar --score=URI [--xslt=URI][--input=URI][--output=URI]
This operation can either perform a search against the entity database for a specific entity and returns requested information about that entity, or it can query the entity database for entities that match a given attribute and return the list of entities that matched the query.
xslt=URI
Specifies the XSLT transform and the XML file the operation will transform into UMF records.
java -jar wsutil.jar --xslt=URI][--input=URI][--output=URI]
Use this operation to transform XML records into UMF before using one of the Web services operations.

wsutil.jar modifiers

Use these modifiers with wsutil.jar operators to specify the input and output methods for the Web services command.

input=URI
Specifies the input method for UMF records. The default input method is stdin.
output=URI
Specifies the output method for UMF records. The default output method is stdout. You can use this method to specify a location and file name to save the UMF output to a file.

Example wsutil.jar usage

The following wsutil.jar command loads records from a file, transforms those records into UMF, and displays the results on the command line interface console:

java -jar wsutil.jar --load=http://localhost:13510/easws/services/SRDWebService --input=raw_entities.xml --xslt=transform.xsl

The following wsutil.jar command acquires requests from stdin and displays the results on the command line interface console:

java -jar wsutil.jar --process=http://localhost:13510/SRDWebService


Feedback

Last updated: 2009