Adding FileImportTags

The FileImportTag lets you import a file (or entire folder of files) from the subordinate (JACE) station to the Supervisor station. This tag creates a Niagara file import descriptor in the Supervisor, under the Files device extension of the NiagaraStation that represents this subordinate (JACE) station, and imports the associated file(s).

NoteWhen using PxViewTags, related file imports are automatically included in an “as-needed” manner, without requiring use of FileImportTags.

To add FileImportTags

  1. Drag the FileImportTag from the exportTags palette and drop anywhere in the JACE station’s component space (under Config)—no particular parentage is necessary.

    The Name dialog appears. Either accept “FileImportTag”, or enter another name and click OK. By default, the resulting Niagara file import descriptor (created on the Supervisor) uses this name.

  2. Double-click the FileImportTag to access its property sheet.

    1. In the Supervisor Station property, click the control and select the Supervisor station, then click Save.

    2. For Station Slot Path, accept the default “slot:files” (for root of Files under the NiagaraStation). This is the only valid parent for the resulting Niagara file import descriptor.

    3. In File Import Name, either accept the default variable (%defaultFileImportName%), or enter an explicit name for the Niagara FileImport descriptor. The default (variable) results in a name that uses the name of source file (or folder) appended to “_import”.

  3. In the File property, you specify the local file or directory to import to the Supervisor. The default value is “file:^”, which imports all objects in the local file space.

    Click 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.

    Navigate to the source file or directory in the dialog and then select it.

    Example File property values are: file:^reports (for a “reports” directory in the local file space) and file:^reports/moreReports/subReport2.txt (for a single file found in a specific subdirectory).

  4. In the Supervisor Directory property, you can accept the default value using ord variables: “file:^stations$(stationName)$(currentLocation)”, which replicates a similar file/subfolder location on the Supervisor, but under a “stations” file subfolder organized by stations, including this one.

    Or, you specify another explicit location under the Supervisor’s file space (file:^location).

  5. In the two other file import properties, you can accept default values or change, if needed.

    • File Overwrite Policy — either Checksum (default) or Last Modified.

    • Execution Time — standard selections for a Niagara file import.

  6. The Use Category Mask boolean specifies whether the imported file(s) will have any export tag category filters applied to it (default is true). For related details, see CategoryFilters.

  7. Click Save after finishing all property changes.

For further details, see FileImportTags.