niagaraDriver-NiagaraFileImport

This component is an import descriptor that specifies a file or folder of files (including all subfolders and files) to be imported to the local station, sourced from the remote Station in a single-tier or multi-tier Niagara system.

Figure 1. Niagara File Import properties


Expand Config > Drivers > NiagaraNetwork > NiagaraStation. double-click Files and click Discover. After the discovery job finds the files, select the ones you wish to add to the Database and click Add. Additionally, you can create a new file import descriptor by clicking New. Switch to the Property Sheet by right-clicking Files and clicking Views > AX Property Sheet. Then, to open the view above, expand the NiagaraFileImport descriptor.

In addition to the standard properties (Status, Enabled and Fault Cause) these properties configure this component.

PropertyValueDescription
Stateread-only
Reports the current state of the data transfer as: Idle, Pending or In Progress.
Execution Timeadditional properties (Trigger Mode 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.

Last Attemptread-only
Reports the date and time of the last attempted execution.
Last Successread-only
Reports the date and time of the last successful execution.
Last Failureread-only
Reports the date and time of the last execution failure.
Route To Stationtext
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.

Filestext
Selects the receiving target and sending source file (or directory) pair(s).
File Overwrite Policydrop-down (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.

Action

Figure 2. File Import actions menu


This component has one action, Execute. This action imports the selected file(s).