CLI Reference > Workflows and Documents Commands > im viewduplicates
im viewduplicates
displays a list of potential duplicate items
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]]
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 Windchill RV&S 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 Windchill RV&S 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 Windchill RV&S administrator.
Duplicate item searches are limited to items of the same Windchill RV&S 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 Windchill RV&S administrator (for example, the Summary field could be used).
When searching for duplicates, Windchill RV&S 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, Windchill RV&S displays the search results in the Potential Duplicates View.
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
specifies the name of the item type you want to search for potential duplicates. Windchill RV&S 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, Windchill RV&S will only search items that are of the type you specify here. This option must be specified together with the --searchText option.
specifies the specific text string you want to search for. This option must be specified together with the --searchType option.
searches for potential duplicates based on the configured settings for the individual item you specify here. Windchill RV&S 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