An example Add dialog in the Niagara File Manager is shown in Figure 140
Properties of file import descriptors available in the Add (or Edit) dialog are as follows:
-
Name
Name for file import descriptor component. Often left at default, i.e. “
NiagaraFileImport” (appending numerals if needed to keep unique). Editing name does not affect names of imported file(s). -
Execution Time
Either Daily (default), Interval, or Manual. If Manual, properties below are not available:
-
Time of Day (Daily)
Configurable to any daily time. Default is 2:00am.
-
Randomization (Daily)
When the next execution time calculates, a random amount of time between zero milliseconds and this interval is added to the Time of Day. May prevent “server flood” issues if too many file imports are executed at the same time. Default is zero (no randomization).
-
Days of Week (Daily and Interval)
Select (check) days of week for import execution. Default is all days of week.
-
Interval (Interval)
Specifies repeating interval for import execution. Default is every minute.
-
Time of Day (Interval)
Specifies start and end times for interval. Default is 24-hours (start 12:00am, end 11:59pm).
-
-
Enabled
Default is
true. If set tofalse, file import does not occur. -
File Overwrite Policy
The File Overwrite Policy property determines how existing files are overwritten upon any execution, with two choices available:
-
Checksum
(Default) Checksums for all files are compared for differences. Any files found with differences are re-imported, overwriting the existing files.
-
Last Modified
Date/timestamps for all files are compared. Any remote files found with more recent date/timestamps are re-imported, overwriting the existing files.
-
-
Files
Specifies the selected “Remote file” (or directory) and the “Local file” (or directory), as a pair.
Click the 
. (add) icon, if needed, for additional pairs, or the 
(delete) icon to remove a pair.
Both fields in any pair should begin with “
file:^”, denoting the root of the station’s file space. The two Files fields are:-
Local file
File path for directory or file to be written in the local station’s file space. If adding from a Discover, this matches the initially selected “Remote File” value. If local directories used in the file path do not exist, they are created upon import execution.
To change, you can click one of the right-side controls, either:
-
if a single file, the folder
control for the File Chooser dialog.
-
if a directory, the adjacent drop-down
control, then choose Directory Ord Chooser from the menu for the Directory Chooser dialog.
Or, you may simply edit the file path text, say to add a folder named for the remote station somewhere within the file path. For example, from
file:^billReportstofile:^billReports/subJACE_C -
-
Remote File
File path for directory or file to be imported from the remote station’s file space. This reflects the selected directory or file for that . You typically do not edit this value.
If a selected directory, the entire contents (all contained files, plus subdirectories and files) are imported upon execution.
If already existing, the File Overwrite Policy must be met before each write.
-
Additional properties for any file import descriptor are on its property sheet. For details, see About Niagara FileImport properties.