Configuration Import

The Configuration Import action imports previously exported application definition and system configuration information, such as projects, triggers, devices, transport maps, transports, network configuration, security configuration, etc.

For information on a complete node Back Up and a node Restore, see Backing up and Restoring a node's configuration.

For information on the Import and Export function for items, see Exporting a project or trigger.

Parameter descriptions

Parameter Description
File Name Input The options are:
  • Static - The File Name parameter becomes available and is selected from the existing files in the Staging Browser area.
  • Dynamic - The File Name parameter becomes available on the Input tab and can be specified from a variable.
File Name Available when the File Names option is Static. This is the complete path and file name of a previously exported system Export file (.DWX). You can type the path and file name, or use *Browse. If you click Browse, the Staging Browser window appears.
Maximum Error Items Sets the maximum number of error messages stored for a failed Import. Works in conjunction with the Output tab Failed Items parameter. Setting the number too high might cause performance problems.
Start Imported Item(s) The options are:
  • True - Any imported item (such as a project, trigger, device) that was in a started state when it was exported, will be imported in a started state.
  • False - All imported items put in a stopped state.

Input tab (Dynamic)

Available when the File Names option is Dynamic.


Parameter Description
File Name The path and file name in the Staging Browser area of a previously exported system Export file (*.DWX).

Output tab

The Output tab is the same for Dynamic and Static options.


Parameter Description
Failed Items An array of strings to store the error messages that describe an item that failed during import.
The maximum number of error messages to store is determined by the Maximum Error Items parameter.
Success Count The number of successfully imported items.
Failure Count The number items that filed during import.

Example Configuration Import action

The Configuration Import action imports previously exported application definition and system configuration information into a node. To understand the process, the following scenario is used:

  • There are four nodes: A, B, C, and D.
  • Node A has a trigger that needs to be distributed to nodes B, C, and D.
    The following describes the export and import process for this scenario.
From node A:
  1. Create a trigger (ExampleExportTriggerA).

    This is the trigger to be distributed to appropriate nodes: B, C, and D.
  2. Export the trigger.

    The name of the export file is ExampleExportTriggerA.dwx.
  3. Using FTP, put the exported ExampleExportTriggerA.dwx file into the Staging Browser area nodes B, C, and D.
From nodes B, C, and D:
  1. Create a trigger with a Configuration Import action.

    The Configuration Import action will include the name of the file to import. For this example: ExampleExportTriggerA.dwx.
  2. Save this trigger, and then start the trigger.
    When the action executes, it will check the Staging Browser area for the file specified in the File Name parameter (in this case ExampleExportTriggerA.dwx).
    The data specified in ExampleExportTriggerA.dwx is imported into the node and the state of the state of trigger is set as appropriate.