IM InfoSphere Identity Insight, Version 8.0

SRDWebService methods

The srd.wsdl file contains the SRDWebService methods that are used to communicate with IBM InfoSphere Identity Insight Web services. SRDWebService includes three methods: one for loading data into the entity database, one for performing a search to query the entity database, and one for processing any pipeline functionality available through UMF.

loadRecord method
LoadResult loadRecord(String umfEntity)
The LoadResult object returned from the loadRecord() method contains two members:
Member Description Type
entityID ID of the returned entity Long
merged Flag indicating if the entity was resolved into an existing entity or was a new entity Boolean
The umfEntity parameter is an XML string in UMF representing the data for a single entity. Use the UMF specification for instructions on how to properly construct a UMF_ENTITY record, making sure to define the appropriate values for DSRC_ACCT and DSRC_REF.
While the load method enables you to process UMF_ENTITY documents, it does not return the raw UMF output document as a result. Instead, it returns a LoadResult object containing the entity ID, and a flag indicating if this was a new entity or if it was resolved with an existing one. You can use the process method in place of the load method, if you do not mind parsing the UMF output document. The load method simply saves you the work of parsing the resultant UMF output document from the load operation.
basicQuery() method
String basicQuery(String umfSearch)
The input string to the basicQuery() method must be in the form of a UMF_SEARCH record. The XML string returned from basicQuery() contains the UMF_SEARCH_RESULT from the query.
There are two types of built-in queries: Summary result-set queries and Detail drill-down queries.
Note: This method exists only for backwards compatibility. In this release, the method functions identical to the process method. Use the process method in place of the basicQuery() method for all new client applications.
process() method
String process(String umfRequestDocument)
Use the process method 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 and should be the method of choice for all operations.
This method takes a String parameter and returns a String result.


Feedback

Last updated: 2011