| Table of Contents |
|---|
This page goes over the process on how to create a new equipment graphic in FIN Stack using the Graphics Builder.
Now with FIN 4.0, most everything in the software is "context-sensitive." What the means is, depending on where you are at in the navigation menu (location being your "context") determines what info/data you will see and get in return. This helps FIN Stack automatically do certain things for the user, and also helps return the user-specific details/wizards that relate to their context.
This applies to creating create graphics too, which is why each level of the graphic will have a slightly different process. Use the following steps to get a general idea of how to create a basic equipment graphic:
Watch VIDEO here
...
Navigate & Create
1a. First thing you'll 1. The user will need to do is navigate (using the smart menunavigation bar) down to any one of the equipment equipments for which you they would like to make a graphic.
- Make sure the equipment name is on the header of the menu (which indicates that you are in that context).
1b. Next, you will need to switch over to the "Menu" view of the Smart View, scroll down to the system integrator apps section, Click on Graphic Builder and Select "new"
→ → → → → 
2. Equip Graphic Wizard
2a. As soon as you select "New" a 2. Once the user has navigated to the desired location, Select the Menu, which is located on the top left corner 
3. Select the Graphics Builder tile
4. When the user clicks on the Graphics Builder tile, it will slide out and give the user 3 options
- In this case, the user will select on New
Equip Graphic Wizard
1. When the user selects on the New button, a wizard will appear allowing for you to pre-set a few things for your graphic.
- Graphic Name: Allows you to type in a name for the graphic.
- Graphic Template: Allows you to select a starter template from a list of available pre-built "duct templates." This is not a required parameter, just gives you a starting point of ductwork. (You can also create your own templates to be used here).
- Graphic On Filter: The Graphic On filter refers to the graphic's "graphicOn" tags, which determine what database records this graphic will run on. By default, this filter will automatically be filled in based on your context equipment. (In our example, I created the graphic while on a VAV, which is why this filter in the screenshot is filled in with that VAV's tags). This filter can be changed after the fact if the need arises.
- Relative - By Tags: This option makes it so that the points automatically come in Relative, based on their current tags. When points are relative, they are not "hardcoded" to one set of equipment's data. They are relative and will load on any equipment that has similar points based on the points' tags. An example of a Room Temp's point binding that was brought in 'Relative By Tags,' will be as follows: equipRef=$self and air and temp and point and zone. So, if this same graphic is loaded on any VAV it will look for a point that has those same exact tags, and use that as the path to load up the point's data.
| Note | ||
|---|---|---|
| ||
| We recommend this option for when your database has points from several similar types of equipment that do not share the same navName. This is common when using different brands where point names don't match. Instead of having to worry about each point having the same exact name, you can have them be relative by tags instead. NOT recommended for a server that is still being worked on where tags will be changing often. |
- Relative - By navName: This option makes it so that the points automatically come in Relative, based on their current navName. When points are relative, they are not "hardcoded" to one set of equipment's data. They are relative and will load on any equipment that has similar points based on the points' navName. An example of a Room Temp's point binding that was brought in 'Relative By navName,' will be as follows: equipRef=$self and navName=="Room Temp" . So if this same graphic is loaded on any other equipment it will look for a point that has that same exact navName and use that as the path to load up the point's data.
...
- Absolute - by Point Ids: This option makes it so that the points automatically come in Absolute (or `hardcoded`) to the current equipment you are on. When a a point is brought in "Absolute by Point id" the path is automatically hardcoded to get data from that exact point no matter where the graphic is loaded. An example of a Room Temp's point binding, that was brought in 'Absolute by Point Id', will be as follows: id==@1eeaf884-82cd6356. So if this same graphic is loaded on any other equipment it will always reference that exact specific point (id) in the database and load up that specific points data.
| Note | ||
|---|---|---|
| ||
| This is only recommended for graphics that are not relative , or will contain specific data from an a piece of exact equipment. Some common examples that would utilize this setting would be Plants, specific 1-off equipment, and certain summary-style equip graphics. |
- Points: This allows you to select which points you would like to bring into the graphic. By using the CTRL and/or SHIFT keys, you can select multiple points. The points are populated based on your context equipment. You also get points associated to that equip's refs. (In our example, the VAV has an ahuRef, so we are able to select points from the ahuRef to show in our graphic)
- Add Components For:This list is populated by the points you select in the previous "Points" section. By highlighting points in this section, you are telling FIN Stack to automatically create a graphical component (based on its tags) and bind the point to the graphical component. This isn't required but can save time since it selects the component, brings it in, binds the point to it, and brings out a Display Label for it.
2b2. Once you're done, click OK and select on the Ok button and your graphic will be created using those parameters, and your Smart Menu will jump you over to the available graphics view.
- Many things will automatically be created within the graphic, so now all you have to do is go in and move a few things around, and possibly, create some overview boxes.
- To edit your graphic, click on the graphic's name in the menu and select "Edit" to open up the graphic in the Graphics Builder app.
→ 
...
Organizing Components & Smart Labels (Automatically)
3a. When you open your graphic for the first time since creating it via the Wizard, you will automatically have a few things done for you.
...
3b. The first thing you should do now is organize your components and smart labels, to do this quickly and efficiently, we recommend utilizing the Builder's Magic Buttons. The Graphic Graphics Builder's Magic Buttons can be found in the right menu (3 overlapping lines on on the top right corner).
→ 
→ 
3c. The Magic Button you want to use first is "Smart Label to GraphicObjects." As soon as you click the button (only the first time), it will organize the smart labels and components neatly across the top and left of the screen.
...
The next step is to add Overview boxes. Typically, these consist of points that do not have a physical components but need to be visible in the graphic for the end-user to command/view.
5a. To create an overview box, go to the right Builder Menu, click on "Magic Buttons" and then select Overview Box and "New."
...
5b. A new window will appear with an option to select a mini group or regular group, and allowing for you to select which points you would like to include in the overview box.
- Mini Group: If enabled, this will make the overview box appear with larger values
...
- and smaller title area. This box is smaller than the regular box and is recommended for scenarios where the box needs to be on the graphic, such as VFD (Spd,Cmd,Ena,Stat)
- Points: This will allow you to select which points to include in the overview box. TIP: If you had any smart labels selected before opening the Overview Box wizard, those points will already be selected in the list of points in the wizard.
5c. After selecting your points, the next window allows you to type in a Title for the overview box, select from a list of icons, and also allows you to give each of your points a custom "shortName"
...