Search Text Ex VI

Owning Palette: DataFinder Toolkit

Requires: LabVIEW DataFinder Toolkit

Uses the DataFinder to search in all of the text properties of the indexed files.

Use the text search if you only have parts of the information you are searching for, or if you do not know whether the information you are searching for is in a file, a group, or a channel. Enter the search terms separated by a space. When the search is complete, the DataFinder returns the complete paths of the files that contain the search terms, regardless of whether the DataFinder found the search terms in the properties of a file, a group, or a channel.

	DataFinder reference is the reference to the DataFinder that is to be used to execute the search. To connect a registered DataFinder, select the DataFinder from the DataFinder named control.
	search text is the text to be searched for. When you search for text properties, you can use the wildcard ? for one letter and the wildcard * for any number of letters. The text search ignores wildcards at the beginning of a search term. If you search for extracts of search terms, the extract must be at the beginning of the term, for example, exa*. If you enter quotation marks within a search term, DataFinder replaces the quotation marks with a space.
	DataPlugin name specifies whether the DataFinder searches only for files that are loaded with a specific DataPlugin. By default, the DataFinder searches in all files. You can connect several DataPlugin names with OR. Note  If you are connected to a federation, DataFinder ignores the DataPlugin name. The error out connector then shows a warning.
	fill results elements? (F) specifies wether the results elements cluster will be filled with the accordant information (TRUE). If the value is FALSE an empty results elements cluster will be returned. The default value is FALSE.
	error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.
	max results count specifies the maximum number of search results that the DataFinder determines. You can enter values from 1 to 32,768 The default maximum number of determined search results is 200.
	DataFinder reference out is the reference to the DataFinder that is also at the respective input of the VI.
	result references out is the array of the references of which the property values were determined.
	results elements specifies the paths, the DataPlugin names, the names of the channel groups, and channels, depending on the search result. fullpaths specifies the complete path of the search results. DataPlugin names specifies the DataPlugin names of the search results. channel group names specifies the names of the channel groups found. channel names specifies the names of the channels found.
	error out contains error information. This output provides standard error out functionality.
	incomplete results? is TRUE if more search results exist than the maximum number of search results that are requested. If you want to display more search results, you must increase the value of the Max results count parameter. The more search results that are to be displayed, the lower the search performance.

Example

Refer to the DataFinder_Search Text VI in the labview\examples\DataFinder\DataFinder_Examples.lvproj for an example of using the Search Text Ex VI.