SystemHistoryImportTag properties

Double-click a SystemHistoryImportTag for its property sheet (Figure 41).

Figure 41. SystemHistoryImportTag property sheet example

SystemHistoryImportTag properties are described as follows:

Status

Read-only status of the export tag, typically “ok”, unless “disabled” (Enabled=false).
Enabled

Whether the tag will attempt an export on the next Join (true, the default) or not (false).
Supervisor Station

Click the drop-down control to select the NiagaraStation that represents the Supervisor (with enabled JoinProfile).
After selection, you must Save before you can use the folder (Select Parent Target) feature of the next property. Also, add (and delete ) controls exist to specify more than one Supervisor station; however, this configuration is rarely expected.
Station Slot Path

Parent slot path for the system history import descriptor on the Supervisor, relative to the NiagaraStation representing this station. If multiple Supervisor stations, this applies only to the first (top) one.
Station Slot Path must begin with slot:histories
- You can accept the default “slot:histories” value, or else manually type a path, to create corresponding archive folders under the NiagaraStation (that represents this JACE) on the Supervisor. This includes use of “BFormat” %value% options.
  
  See Station Slot Path considerations and BFormat options in Station Slot Paths.
- Or, click the folder for a Select Parent Target dialog, and navigate to the desired folder or container. In this case, you must have already made (and saved) the needed folders in the JACE’s station “profile.bog” file.
  You can edit the “profile.bog file” to add NiagaraArchiveFolders under Histories—see Verify and edit the Station (.bog) File for details. Do not select any parent folder other than under Histories (property value must begin with slot:histories). Such folders are used to organize Niagara history descriptors of any type (import, systemImport, export).
History Import Name

The name of the Niagara SystemHistoryImport descriptor that this tag creates on the Supervisor, by default set using a format variable (%defaultHistoryImportName%). For this export tag type, the default matches the name of the export tag itself. If desired, enter a different name here.
Execution Time

The standard execution time selections for a Niagara HistoryImport descriptor, where the default is Daily at 2:00 AM, all days of the week. Other selections include Manual or Interval. For more details on this property and most remaining properties, see “History Import Edit” in the Drivers Guide.
This property, as well as “Config Overrides” (capacity and fullPolicy) properties and both “On Demand” properties, are all written to the Niagara HistoryImport descriptor upon a Join.
Config Overrides

Standard selections for a Niagara HistoryImport descriptor, containing settings for:
- capacity — either Unlimited (default), or some finite number of records.
- fullPolicy — either Roll (default), or Stop.
On Demand Poll Enabled

Standard selection for a Niagara HistoryImport descriptor. either true (default) or false.

For related details on this (and next) property, see “On demand properties in history import descriptors” in the Drivers Guide.
On Demand Poll Frequency

Standard selection for a Niagara HistoryImport descriptor, either Normal (default), Slow, or Fast.
Use Category Mask

Boolean to specify whether the history imported by this tag will have any export tag category filters applied to it (default is true).
This feature is future use only for SystemHistoryExportTags—currently, only histories exported using the HistoryImportTag can make use of the category mask feature.
System Tag Patterns

Text string(s) to search against the “System Tags” property value in the “History Config” slot of all history extensions in the subordinate (JACE) station. You can enter multiple strings, separating each with a semicolon (;), and also a “wildcard” (*) character, for example: RTU*;*Temp;Ltg

Upon a Join, matching histories will be imported at the Supervisor by an added Niagara SystemHistoryImport descriptor. For related details, see the section “Using System Tags to import Niagara histories” in the Drivers Guide.