PREVNEXT

brandLogo: alt="EnergyLogo"

About Niagara units

In NiagaraAX there is a database of all units that are available in Workbench. You can select and assign these units in Workbench using the “Facets” field. If you need to use a unit that is not available in Workbench, you can add the unit by editing the facets database.

Refer to the "Add a new unit to Workbench" procedure to add a unit to NiagaraAX Workbench.

Add a new unit to Workbench

The following procedure is performed from the NiagaraAX Workbench.

  1. In the NiagaraAX Workbench nav tree, expand the tree by clicking the My File System > Sys Home > lib nodes.
Figure 3-53 The units.xml located file in the Workbench nav tree
  1. Under the lib folder, double-click the “units.xml” to open it in the text file editor view.

    Note: The “units.xml” file contains a list of all the units that are available in NiagaraAX Workbench. Units are grouped by categories.

    The “units.xml” file displays in the Workbench text editor view.
  2. In the “units.xml” file, under the appropriate category, inside a <unit> </unit> element pair, type in the desired new unit and abbreviation using the syntax common to all units within the <quantity> element tags.
    Each unit has a name ( n ) and an abbreviation ( s ) as shown in the example in Figure 3-54. In this example, the full unit name ( n ) is “footballfields”. This is the name that appears in a shortBrandName chart or graph. The abbreviated unit name ( s ) is “ff”. This is the name that appears on a numeric point property sheet (for example).
Figure 3-54 The units.xml file contents
  1. Select File > Save from the Workbench main menu to save the “units.xml” file.

The new unit is now saved as part of the units database, however, you must restart Workbench for the change to visible in the Facets Editor dialog box, as shown in Figure 3-55.

Figure 3-55 New unit available in Facets Editor dialog box

Assign a value facet (unit) to a control point

The following procedure is performed from the NiagaraAX Workbench. The units that are assigned in NiagaraAX Workbench are the units that the history files display in shortBrandName. Therefore, to ensure that you have the proper units for your data, you must set the proper units in the Numeric Interval Point extension, as described in the following procedure.

  1. In NiagaraAX Workbench, open the Facets Editor dialog box, as shown in Figure 3-56, from the point that contains the history extension that you are interested in. You can use the Add dialog box or Edit dialog box if you are in the Point Manager view. Alternatively, you can use the point’s Property Sheet view to access the Facets slot.
Figure 3-56 The Facets Editor dialog box
  1. In the Facets Editor dialog box complete the following fields:
  2. units
    • from the first (left) field, select the category of units that you are interested in.
    • from the second (right) field, select the units that you that you want to assign to the history extension.
  3. precision: type in a number equal to the number of decimal points that you want to collect in your data.
  4. Click the Ok button to complete the unit assignment.

The unit is now assigned to the history file data and appears in collected data files.

shortBrandName
PREVNEXT