Execute Query Ex VI

Owning Palette: DataFinder Toolkit

Requires: LabVIEW DataFinder Toolkit

Uses the DataFinder to search the specified properties of the indexed data.

The VI returns the search results as result references. You can use result references to access the waveforms and to access the values of any properties of the search results.

	result object type Enumeration for the object type. {File:0, Channel Group:1, Channel:2}
	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.
	query reference is the reference to the query to execute.
	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,000. 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.
	query reference out is the reference to the query that was executed.
	result references out is the array of the references that the query returns.
	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.

Examples

Refer to the following VIs for examples of using the Execute Query VI:

• DataFinder_ExecuteQuery VI: labview\examples\DataFinder\DataFinder_Examples.lvproj

• DataFinder_Pass_Fail_Analysis VI: labview\examples\DataFinder\DataFinder_Examples.lvproj