Double-click a SystemHistoryImportTag for its property sheet (Figure 41).
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 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.