checkForDup()

This method is used to pass items to the Duplicate Detect engine for checking against the Duplicate Detect database. This method requires two parameters, a DupCheckData object and a flag to call this method synchronously or asynchronously. The DupCheckData object holds all the data required by the API to create the proper XML message and the required RFH2 information. If calling synchronously, use the setSyncWaitTime() method to set the duration the API waits for a response from the Duplicate Detect engine. If no response is received within the given time, the API returns a null object. If responses are received from the engine, the API parses the XML returned by the engine into a DupCheckData object.

Whether calling Duplicate Detect synchronously or asynchronously, review messages must be pulled from the queue. Since Duplicate Detect review is a manual process, the API does not wait for review messages to be received before returning to the caller. Once all items have been reviewed, the engine sends a single dupReviewed message to the reply queue. The client should be sure to process the message to determine the final disposition of items being reviewed by an operator. If items are being reviewed, the initial response from the Duplicate Detect engine has a status of potential for all items that were sent for operator review. The review message has a disposition of nodup (not a duplicate) or dup (duplicate) for all items reviewed. If review has not been enabled, the initial response from the engine has a status of dup for all items found to be a duplicate of another item.