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