CLI Reference > Workflows and Documents Commands > im viewduplicates
 
im viewduplicates
displays a list of potential duplicate items
Synopsis
im viewduplicates [--issueID=value] [--searchText=value] [--searchType=type] [--hostname=value] [--port=value] [--password=value] [--user=value] [(-?|--usage)] [(-g|--gui)] [(-F value|--selectionFile=value)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]]
Description
im viewduplicates runs a search to display a list of potential duplicate items. You can use duplicate detection to find possible duplicate items before submitting a new item, or to identify and clean up existing duplicates in the Integrity Lifecycle Manager database.
For example, specify the search text and item type to search:
im viewduplicates --searchType=Defect --searchText="engine problems"
to display a list of potential duplicate defects containing the text string "engine problems".
Or run the search according to a single item ID number:
im viewduplicates --issueID=314159
to display a list of items that contain similar search text to the text contained in Item 314159. All potential duplicates are of the same item type as Item 314159.
Note the following:
To identify existing duplicates, the Integrity Lifecycle Manager administrator must first enable duplicate detection for the item type you want to search. If duplicate detection is not enabled for the type, an error occurs when running the im viewduplicates command. For more information, contact your Integrity Lifecycle Manager administrator.
Duplicate item searches are limited to items of the same Integrity Lifecycle Manager type.
Only the text you enter in the defined search field is used as the basis for the search. The search field is defined by your Integrity Lifecycle Manager administrator (for example, the Summary field could be used).
When searching for duplicates, Integrity Lifecycle Manager returns a maximum of 20 items by default.
If your administrator makes duplicate detection mandatory for the item type you are creating, the search runs automatically when you are finished entering text in the defined search field (when you move focus away from the defined search field). If duplicates are found, the list is displayed in the command output.
When you use the -g or --gui option, Integrity Lifecycle Manager displays the search results in the Potential Duplicates View.
Options
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
--searchType=type
specifies the name of the item type you want to search for potential duplicates. Integrity Lifecycle Manager uses the value you set here to obtain the search settings from the type (such as the defined search field and any mandatory settings). When searching for potential duplicates, Integrity Lifecycle Manager will only search items that are of the type you specify here. This option must be specified together with the --searchText option.
--searchText="value"
specifies the specific text string you want to search for. This option must be specified together with the --searchType option.
--issueID=value
searches for potential duplicates based on the configured settings for the individual item you specify here. Integrity Lifecycle Manager uses the text in the defined search field of the specified item and searches for similar text in items of the same type. This option must be specified on its own, and cannot be specified with either the --searchType or --searchText options.
See Also
Miscellaneous: options