NI System Configuration API Reference

Import (VI)

  • Updated2023-02-21
  • 3 minute(s) read
Installed With: NI System Configuration

Use this VI to import configuration data from a file into MAX. Not all products are supported; consult your product documentation.

Import

cio.gif

Session in specifies the system to which to import.

cpath.gif

Source File specifies the configuration to copy. This input may point to a configuration file. To specify a configuration file, set Source to an existing file path.

cstr.gif

Experts specifies a case-insensitive comma-separated string specifying which experts' data to copy. If Experts is unwired or blank, this VI copies all configuration data from the specified configuration file. If you specify an expert name, this VI copies only that expert's data. The list of supported experts for a given system is returned from the Get System Experts VI.

Note  

Examples of expert names include daqmx and ni-visa . For a listing of the available experts for this operation and the input strings to use, refer to KnowledgeBase article 5FFA2JBP .

cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

cu32.gif

Import Mode specifies how to treat existing data at the destination.

Merge (0)

(default) Merges the source data in with any existing data at the destination. The source wins by default in the case of overwrite conflicts.

Replace all (1048576)

Replaces all configuration data at the destination with the source data.

Preserve existing (2097152)

Preserves the original data. The destination wins by default in the case of overwrite conflicts.

Example

For this example, consider an initial configuration state with items A1 and B. The configuration file from which you are importing data includes items A2 and C. In this case, it is the same item A with different configuration data.

Action Result
Merge A2, B, C
Replace all A2, C
Preserve existing A1, B, C
iio.gif

Session out returns the refnum for the system.

istr.gif

Detailed Result returns a list of items that were imported or the results of any errors that occurred during the VI execution.

ierrcodeclst.gif

error out returns error information. This output provides standard error out functionality.