Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Current »

This document goes over the Virtual Points section found in the Right Builder Menu


Virtual Point Tools

The virtual point option opens a new menu view where the following can be found:

  • Tools - A list of tools available to be used

    • New VirtualPoint

    • Update Bindings

    • CurVal Format

  • Points - A list of all points available in the open graphic

Add New Virtual Point

New VirtualPoint option allows you to create a new virtualPoint within the graphic

The first part of the wizard allows you to select a point type (Number - Boolean - String - or Query) and name the point.

The next wizard varies based on what type of point your creating.

VirtualPoint Type


Number

The wizard will ask you for a default numeric value (#).

Boolean

The wizard will ask you for a default boolean value (True or False)

String

The wizard will ask you to type in any string value (text)

Query

Return Single Value: makes it so that it only returns a single value. If multiple values are returned, only the first result will result in this points value.

The wizard will ask you to fill out a filter, axon query, and to choose whether you want a single value or a table.

Filter: This section is what will be concatenated into the Axon Query below. You can use the filter button to fill out your @filter. The point of this section is in case you need to utilize the filter wizard to create your query. Otherwise, leave empty and use the Axon query section below.

Axon Query: this section allows you to write out an entire axon query using the filter that was given in the first section. The top 2 sections are basically combined and are only separated to allow for users to do more advanced queries. If you are not very advanced with Axon, simply fill out the top @ filter section and leave the Axon Query section as is.

The newly added point will now appear in the Virtual Point Panel (left menu) and on the right menu that you are currently viewing. 

Update Binding

The update binding sections allows you to update the point bindings of all the virtual points within the graphic

1. Select the Update Bindings option

2. This will open a prompt called Update Bindings. Here you can multi-select which points will get their bindings updated

In the next and final section you can select in what way you'd like to update the point bindings. Your options are Relative By Tags, Relative by navName and Absolute. 

  • Relative: By Tags - this means that the user can add points by their tags. So the binding of the point will consist of tags. This is great for when you have multiple points with different names but are tagged properly.

    • NOTE: If points don't have sufficient tags, it automatically appends the navName of the point

  • Relative: By navName - this means that the user can add points by their navName. So the binding of the point will consist only of the navName and not tags. This is great for when all the points are named the same, or the database isn't tagged up, and fewer issues if points are missing tags.

  • Absolute: By Point Ids - this means that the user can add points by their ids (hardcoded). So the binding of the point will consist of the point id. This is great for when adding points from different equipment and its not a relative graphic like a Central Plant for example.

Note: The target will be determined by your context in the navigation header. This is important because this determines what equipment's point its going to be looking at when updating the points. 

CurVal Format

The CurVal Format option allows the user to format the value of what a point is returning, to some other format available from http://numeraljs.com/

1. Select the CurVal Format option

2. Once selected, a new window will appear with all the available numerical points

  • This allows the user to select which points they want to format, then picking the format type they want from the available list in the dropdown.

3. Once the user picks a format, they can click on the "Next" button or cancel

4. In the next window, the user will be presented with the format chosen and what it will do

  • As well as display the actual format itself in a string.

5. Once the user applies, this will add a string 'curValFormat' on the point with the format chosen

  • The value will change accordingly


  • No labels