Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

General

LabVIEW 2009 DataFinder Toolkit

Edition Date: June 2009

Part Number: 372745A-01

»View Product Info

DataFinder and Remote DataFinder

The DataFinder searches for data files in the search areas you specify. Search areas are file system folders that are on your local computer or on the network. Click the Search Areas tab in the DataFinder configuration dialog box to specify the search areas. To open the DataFinder configuration dialog box, right-click the DataFinder symbol on the task bar and select Configure.

For the DataFinder to search for data in the search areas, the indexer must first index the data. DataPlugins enable the DataFinder to index many different file formats and to browse in these files. Click the DataPlugins tab in the DataFinder configuration dialog box to specify which filename extensions the DataFinder recognizes when searching for data.

You can search for data on the desktop DataFinder "My DataFinder" and on a remote DataFinder. Use "My DataFinder" to run a search with the desktop DataFinder on your computer or on the network. The DataFinder index is on your computer. You cannot delete or export the MyDataFinder DataFinder and you cannot create an additional desktop DataFinder. You can specify which search areas this DataFinder uses for a search.

In addition to your desktop DataFinder, you also can use any number of remote DataFinders that are usually on other computers on your network. A remote DataFinder is a DataFinder from the DataFinder Server Edition. The DataFinder Server Edition enables you to configure a DataFinder and to make the DataFinder available to multiple users on the network. In the DataFinder Server Edition configuration you can assign rights to clients.

Search Text or Execute Query

Search for text 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 property.

Execute a query if you want to search in specific file, group, or channel properties. You can specify, for example, that you want to search for channels or files named Time. You can run more complex search queries if you combine several query conditions. If all search areas are completely indexed, executing a query returns reproducible results.

The entries involved in searching for text and executing a query are not case-sensitive.

Features of Search Text

If you work with the text search, separate the search terms with spaces. After you run the search, the DataFinder returns all files that contain these search terms regardless of whether the DataFinder found the search term in the property of a file, a group, or a channel.
The text search also searches for parts of search terms. The part of the search term must be at the beginning of the search term, for example, exa*.
If you enter quotation marks within a search term, DataFinder replaces the quotation marks with a space.
If the wildcards * or ? are at the beginning of a search term, the text search ignores them.

Special Features of Execute Query

The advanced search consists of one or more search conditions. A search condition comprises the file property, the channel group property, or the channel property the DataFinder searches for, and the operator and the value with which the DataFinder compares the property. Before the search starts you can specify whether the DataFinder returns files, channel groups, or channels as the search results.

By default the DataFinder connects all query conditions with an AND operator. However, you can specify a logical operator yourself and connect the query conditions with AND and OR as you like.

Please note the following characteristics when you execute a query:

  • By default, the DataFinder executes a logical AND operation on the query conditions. This means that, for example, the query for groups that contain channels with the name Channel1 AND channels that contain the name Channel2, can never return a result.

  • You can execute OR operations on single values of a query condition, or on entire query conditions, for example, to search for several filenames. If you search for the text Or, you must enter /Or as the search text, instead of Or.

  • You only can use wildcards (* and ?) when you search for text properties. If you search for text that contains spaces, you must enter a question mark (?) as a wildcard for each space, in the search.

  • Use the operators =, <>, <, <=, >, and >= to search for numeric properties.

  • When you search for text properties, you can use only the operators = and <>.

  • If you search for a text property, the property must not be longer than 256+ characters.

  • In the query for date/time properties, for example, for the file property Modify date, the DataFinder provides the following operators: =, >=, <=, and #. If you select the # operator, you can use the following operands: Today, Yesterday, Last 7 days, Last 14 days, Last 30 days. The DataFinder executes the query in relation to the current date. For example, if you use the operator # to search for the creation date Today, and you save the search, the search uses the current date if you run the search again at a later date.

  • If you want to search for Date type custom properties, you must first optimize the custom properties.

  • If you use the = operator when you search for date and time properties, you can search for the exact date, otherwise for the exact second.

  • In the query for floating point numbers, for example, for the channel property Maximum, you cannot use NoValue as the operand.

Indexing the Search Areas

For the DataFinder to run a search for data from the search area, the indexer must index the data first. Click the Indexer tab in the DataFinder configuration dialog box to specify when and how often the DataFinder indexes the search areas. The DataFinder does not start indexing until the time you specified in the dialog box elapses without a mouse movement or a key action.

The indexing process or the indexing update works under the following conditions:

  • Indexing and the indexing update run automatically at the times you set on the Indexer tab in the Configure My DataFinder dialog box.
  • Indexing or the indexing update run automatically when contents of the local search areas change or when you delete a file or create a new file.

  • Open the Configure My DataFinder dialog box, click the Indexer tab, and click the Start Now button, to start indexing or reindexing.

Network Drives, CD ROM, and Deleted Folders

If the search areas refer to transient folders, for example, network drives, CD or DVD drives, or memory sticks, the contents of these folders remain in the index although the folders are no longer available. In this case you can search for files, groups, and channels of these folders but you cannot navigate in the folders or load search results from the folders. The file browser identifies folders that are no longer available in a certain search area with a red exclamation mark.

If you delete a search area from the DataFinder, the DataFinder deletes the associated entry from the index. If you delete files or folders from a search area, the DataFinder updates the index.
If you delete a folder from the search area while the DataFinder is not active, the DataFinder treats the folder like a transient folder. If you restore a deleted folder of a search area or if the transient folder is available again, the DataFinder updates the search area and you can load files from the folder.

Building an Application Using the DataFinder Toolkit

If you want to create an application with the DataFinder Toolkit, you need the following components:

  • NI DataFinder Toolkit RE 2009—Contains libraries and files to connect to a DataFinder Desktop Edition or to a DataFinder Server Edition. Requires NI LabVIEW Run-Time Engine 2009 and optionally NI DataFinder Desktop Edition.

  • NI LabVIEW Run-Time Engine 2009—Contains libraries and other files necessary to execute LabVIEW 2009-built applications and shared libraries.

  • NI DataFinder Desktop Edition 2.1 (optional)—Component for mining and managing data from multiple sources and different formats for a single client. Installs "My DataFinder".

Note  If you use a DataFinder server from the DataFinder Server Edition as a remote DataFinder, you need at least Version 2.0 of the DataFinder Server Edition to execute a search. To configure a local remote DataFinder with the property nodes and invoke nodes, you need at least Version 2.1 of the DataFinder Server Edition.

 


 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit