Storage/DataPlugin VIs

LabVIEW 2018 Help


Edition Date: March 2018
Part Number: 371361R-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help
LabVIEW 2020 Help

Owning Palette: File I/O VIs and Functions

Requires: Base Development System (Windows). This topic might not match its corresponding palette in LabVIEW depending on your operating system, licensed product(s), and target.

Use the Storage/DataPlugin VIs to read measurement data from a variety of file formats, write data to .tdm or .tdms files, or manage DataPlugins installed on the local computer. You must download appropriate DataPlugins and register them on the local computer before you can access the corresponding file formats. Refer to the National Instruments website at ni.com/dataplugins to download DataPlugins.

Note  If you build an installer for a stand-alone application or shared library that uses the Storage/DataPlugin VIs, you must include the NI USI installer. To include the NI USI installer, on the Additional Installers page of the Installer Properties dialog box, remove the checkmark from the Automatically select recommended installers checkbox and place a checkmark in the NI USI checkbox.

The VIs on this palette can return storage error codes.

Palette ObjectDescription
Close Data StorageCloses a data file. You must use this Express VI to close a data file after you finish reading from or writing to the file. Memory leakage might occur if you do not close the data file.
Convert to TDM or TDMSConverts the specified file to the .tdm or .tdms file format.
Data File ViewerOpens the data file specified in the file path input and presents the data in the Data File Viewer dialog box.
Delete DataRemoves a channel group or channel you specify. If you choose to delete a channel group, this VI deletes all channels associated with that channel group. Wire data to the storage refnum input to determine the polymorphic instance to use or manually select the instance.
Get PropertiesReads property values from a file, channel group, or channel. If you configure this Express VI before you wire a refnum to storage refnum, the configuration might change depending on the refnum you wire. For example, if you configure this Express VI for a channel and then wire a channel group refnum, this Express VI returns broken wires on the block diagram because the same properties are not available for a channel group.
Open Data StorageOpens data files with different storage formats for reading or writing. You also can use this Express VI to create a new file or replace an existing file. Use the Close Data Storage Express VI to close the reference to the file.
Read DataReturns an array of refnums that represent channel groups or channels in the file. If you select Channel as the Object type to read in the configuration dialog box, this Express VI can return the channel data formatted as dynamic data or arrays of specific data types. You also can use this Express VI to return channel groups or channels that meet query conditions you specify.
Set PropertiesDefines the properties of an existing file, channel group, or channel. If you configure this Express VI before you wire a refnum to storage refnum, the configuration might change depending on the refnum you wire. For example, if you configure this Express VI for a channel and then wire a channel group refnum, this Express VI returns broken wires on the block diagram because the same properties are not available for a channel group.
Write DataAdds a channel group or channel to a file you specify. If you select Channel as the Object type in the configuration dialog box, this Express VI also creates a Signal block diagram input that enables you to add a signal to an existing channel. You also can use this Express VI to define properties for the channel group or channel that you want to add.


SubpaletteDescription
Advanced Storage VIsUse the Advanced Storage VIs to read, write, and query data when object types or property names are determined at run time.
Manage DataPlugins VIsUse the Manage DataPlugins VIs to list, export, register, or unregister DataPlugins installed on the local computer.

WAS THIS ARTICLE HELPFUL?

Not Helpful