New/Edit file import

This window configures the import descriptor used to import files from a remote controller station to a Supervisor station. File import is a function of the niagaraDriver module.

Figure 1. New window for Niagara File Import


To open this window add a Files component from the niagaraDriver palette to the Files node in the station, double-click the added node and click New. To edit an existing file import record, click Edit.

In addition to the standard property, Enabled these properties configure this window.

PropertyValueDescription
Nametext (defaults to NiagaraFileImport)
Provides a name for the object. Editing this property is equivalent to the right-clicking Rename command on the component.
In this case, the object is a file import descriptor. You can leave this value at the default and append numbers as needed to keep the name unique. Editing this name does not affect the names of imported file(s).
Execution Timedrop-down list with additional properties (defaults to Daily)
Configures a time trigger that controls when to perform the function.

Trigger properties are documented in the Getting Started with Niagara guide.

Execution Time, Time Of Dayhours minutes seconds (defaults to 2 am)
Configures when, during the day, to import files. defines start and end times for the interval. The default is 24–hours, that is, start at 12:00 am and end at 11:59 pm.
Execution Time, Randomizationhours minutes seconds (defaults to zero, that is no randomization)
Calculates the next execution time and adds a random amount of time between zero milliseconds to the calculated time. This option may prevent server flood issues if too many file imports are executed at the same time. Default is zero (no randomization).
Execution Time, Days of the Weekcheck boxes (defaults to all days)
Specifies the days of the week to include in the function.
File Overwrite Policydrop-down list (defaults to Checksum)
Selects the criterion to apply to overwrite existing files upon any import execution:

Checksum compares a checksum from the file being imported with the checksum from the existing file. If the app finds a difference, it imports the file again and overwrites the existing file.

Last Modified compares the date and time stamps of the existing and imported files. Any remote files found with a more recent date or time overwrite the existing files.

Route To Station text
As of Niagara 4.13 and later, optionally specifies a route of intermediate station names (delimited by semi-colons) to reach the remote, reachable station from which to perform the file import operation.

If the field remains empty, the file is imported from the directly connected station (just like the pre-Niagara 4.13 behavior).

If a station route is provided, the file is imported from the downstream reachable station (the final station name in the list) and transmitted through all intermediate stations, as indicated by the station route, back up to this station. In order to work, it requires active NiagaraNetwork connections for all intermediate stations specified in the route.

FilesFile Selector
Selects the receiving target and sending source file (or directory) pair(s).
In this case, the receiving file (or directory) is in the local system and the sending file (or directory is in the remote system.
Files, Local Filefile pathDefines the location of the local file in the local station’s file space.

If you used a discovery job to add, this value matches the initially selected remote file value. If the local directories in the path do not exist, the station creates them upon import execution.

Files, Remote Filefile pathDefines the location of the file to be imported from the remote station’s file space. This reflects the selected directory or file for the add job. Typically, you do not edit this value.