Use this to create a new equip graphic in using the Graphics Builder.




1 – Navigate and Create

  1. Navigate to the equip you want to create a graphic for.

In the breadcrumb list, make sure your designated equip is the stopping point.

  1. Select > System Integrator Apps > Graphics Builder.
System Integrator Apps > Graphics Builder
  1. In the Graphics Builder slider menu, click New.
Graphics Builder slider menu
  • The Create a Graphic dialog box displays with required fields.
    The required fields are outlined in the table below.
  1. Click OK.
  • The graphic is created using those parameters, and displays in the Graphics Builder pane.
  1. To edit the graphic, click on the graphic name in the menu.
  1. In the slider menu, click Edit.
Edit Graphics
Create a Graphic required fields



Graphic Name

Enter a name for the graphic.

Graphic Template

Select a starter template from a list of available pre-built "duct templates."
(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.
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 the 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.
Use this when your database has points from several similar equipment that do not share the same navName

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.
This allows your bindings to look for a navName instead of breaking every time a tag is changed. This is your safest route to having relativized graphic.

Absolute: By Point Ids

This option makes it so that the points automatically come in Absolute (or `hardcoded`) to the current equipment. When 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.
This is only recommended for graphics that are not relative, or contain specific data from an exact equipment.


Select the points 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 equip. You also get points associated to that equip refs.

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 Desigo Optic to automatically create a graphical component (based on its tags) and bind the point to the graphical component.
This is optional. It selects the component, brings it in, binds the point to it, and brings out a Display Label.

2 – Organize Components and Smart Labels (Automatically)

When opening a graphic for the first time, a few things are automatically done:

  • If you selected Template in the Create a Graphic dialog box, a generic duct is pre-built. If this does not match your duct setup, navigate to the Components pane and then drag and drop the ducts you want to use onto the Builder.
  • If you selected Add Components to in the Create a Graphic dialog box, those components and corresponding smart labels are stacked up on the top left corner of the graphic. If the components are incorrect, you can manually edit the parameters and choose other component(s) in the Components pane.
  1. To organize the components and smart labels, click Magic Buttons .
  1. In the Magic Buttons menu, select Smart Label to GraphicObjects.
    Clicking Smart Label to GraphicObjects organizes the smart labels and components neatly across the top and left of the screen.
Smart Label to GraphicsObjects
  1. Drag and drop the components in the desired location on the ductwork.
  1. Once components have been arranged on the duct, click Smart Label to GraphicObjects again to move the Smart Labels to the corresponding components.
    If you want to adjust the position of the labels, drag the component to the desired position.

From this time on, the Magic Buttons will resize your Smart Labels and place them next to the component that shares the same binding.

  • Your components are now in place and have visual smart label displays to represent them.

3 – Components, Binding Points, Smart Labels and Custom Titles (Manually)

If the component is incorrect or if you did not select it, you can create it manually.

By default, the Builder displays the Components Pane and the Properties Pane.

Bringing out a component

In the Components Pane, you can search for different available graphic components and any models you may have saved or created previously.

  1. Drag-and-drop the desired component onto the Builder to create a copy of it.
Drag and drop component
  1. To bind a point to your component, click and select Virtual Point Pane
  1. Drag-and-drop the desired point onto the component to create the binding.
  1. To see what point is bound to the component, select the component.
  1. In the Property Pane, click Advanced view, and then scroll down to the VirtualPointRef property value:
Property Pane Advanced View
  1. Drag the component to the desired location.

Creating a Smart Label Display

  • To create a smart label display, drag-and-drop the point from the Virtual Point menu onto an empty spot in the Builder.
  • This automatically creates a smart label.

Renaming your point display name on the graphic

  1. Click Smart Label: ShortNames in the Magic Buttons menu to manually customize the display name on any Smart Label or display model.
  • The Change ShortNames dialog box displays.
  1. Click Apply.

4 – Create Overview Boxes

Overview boxes consist of points that do not have physical components but need to be visible in the graphic to command and view.

  1. To create an overview box, click and then select the graphic you want to open.
  1. Under Tools, click Magic Buttons .
  1. Click Overview Box .
Overview box slider
  1. In the slider menu, click New.
  • The Create Overview Box dialog box displays, with the option to select a mini group or regular group.
  • Mini Group: If enabled, the overview box displays with larger values, and smaller title area.
    This box is recommended for scenarios when the box is needed on the graphic, such as VFD (Spd,Cmd,Ena,Stat)
  • Points: This allows you to select which points to include in the overview box.
  1. Select the desired points and then click Apply.
  • The Change Point Names dialog box displays.
  1. Fill out the required fields in the dialog box, depending on what you selected.
  1. Create as many overview boxes as needed.
    displays near commandable points.

5 – Save and Close

Click Save to publish the graphic and save changes.