User Manual







Sepasoft - MES Modules
Cirrus Link - MQTT Modules


Inductive University
Ignition Demo Project
Knowledge Base Articles
IA Support
SDK Documentation
SDK Examples


Ignition 8
Ignition 7.9
Ignition 7.8

Deprecated Pages

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 8 Next »


Vision Windows are the basic building blocks for all your Vision projects. Each window can contain any number of components that can display Tag values, run scripts, write values to the database, display Tag History data on an Easy Chart, and more. When you publish your project, these windows are loaded into the Vision Client where any number of windows can be opened at one time. 

On this page, we'll walk you through how to add components to a Window and bring them to life by showing live values, displaying Tag History data on an Easy Chart,  and launching a project in realtime. Let's get started!

1. Adding Components to Vision Windows

Drag and drop components onto your project windows. Components can do everything from displaying text, to showing Tag values, to displaying reports, and more. You can bind components to each other, to Tags, to values in the database, or any combination. Let's create a few components and show live values in the Vision Client.

 Add Components to Your Project
  1. From the Vision Designer, go to the Project Browser and right-click on Windows to create a Main Window . You will be prompted to enter a name (i.e., Main Window 1) for your window, or you can leave the default name of Main Window. (Note: You have the option to create folders for organizing your windows).

  2. The window will refresh and you can begin clicking and dragging components from the Component Palette on the right onto the window. Let's add a Label and a Text Field component.

  3. Double-click on the Label component to type directly into it, or go to the Text property in the Property Editor, and rename it to say "Enter Text." You can also select the Text Field component and click-and-drag the arrow handles to resize them.

  4. Now let's add some Tag values to the window. (Note: This step assumes you are already connected to Generic Simulator. Refer to the Quick Start Guide for Connecting to a Device).
    The simplest way to add Tag values is to go into the Tag Browser and drill down to the Tag(s) you want and drag them onto the window. Select a few Tags (i.e., Sine Tags) and drag them into the window. You will see a popup asking you what type of components you want to use to show these Tag values. Select LED Display.

  5.  Now you can see live values on your window! Don't forget to save your project.

  6. You can Preview your project in the Designer by clicking the Preview Mode button in the top menubar. This allows you to interact with your windows as if you were using a Client. The Preview Mode button changes between a gray triangle and a gray square depending on which mode you are currently in. Look for the gray triangle to go into Preview Mode.

Learn more about Working with Vision Components and Property Bindings

2. Showing Tag History in an Easy Chart

Displaying Tag History from using an Easy Chart.  This requires that you have Tag History already setup.  Refer to the Quick Start Guide, Add History to Tags

 Displaying History in an Easy Chart

In this example, create a second Main Window (i.e., Main Window 2), add an Easy Chart component to show history on the values of the LED Displays.

  1. Once you have your second Main Window created, drag an Easy Chart component on to your window (Main Window 2).

  2. In the Tag Browser, the first three Sine Tags are logging data. Drag these Sine Tags to the Easy Chart. The Easy Chart will immediately fetch the results and trend the history. When you first drag Tags to the Easy Chart, not much data will be displayed because you just started logging data.

  3. To show more data, set the Chart Mode property from Historical to Realtime in the Property Editor.

Learn more about the Vision Easy Chart!

3. Navigating in a Vision Client

It's important to have a navigation strategy that allows you to navigate seamlessly between different windows in the runtime Vision Client. You can choose from several types of navigation strategies: Tab Strip, Tree View, Menubar, Forward and Back Buttons, and Drill Down. The Naviation Strategies in Vision page provides some things to consider to help you determine the best navigation strategy for your project and your users.

 Navigating in the Vision Client

In this example, we are going to use a simple Docked window and two Button components to switch between the two windows we created in the previous sections.

  1. First, let's create our docked window. In the Project Browser, right click on Windows and select Docked Window.

  2. A New Dock Window will appear for you to select the Docked Position. Select North and click OK.

  3. Right click on your new Docked Window and check Open on Startup. You Docked winodw will open on startup in the client and will be on all windows in your project.

    Your Docked Window look like the following:

  4. Now, let's drag couple of Button components from the Component Palette to the Docked Window, or you can duplicate (Ctrl D) the first button to create the second button.
    Rename the Buttons to something meaningful (i.e., Main Window 1 and Main Window 2).

  5. Now you to add scripting to each of your Buttons so they know what window to open when pressed. Right click on your first button (i.e., Main Window 1) and select Scripting.

  6. This opens the Component Scripting Button window. Here you have to tell the buttons to swap one window for the other when the Button is pressed. In other words, it closes the current window you have open (i.e., Main Winodow 1) and then opens the other window (i.e., Main Window 2) in its place. Use the following steps to apply your script to the button:
    1. Under Event Handlers, expand action, and select actionPerformed.
    2. Select the Navigation tab, select Open / Swap, Open, and Center.
    3. From the Window dropdown, select the your Main Window1.
    4. Click OK.

  7. Repeat Step 6 for your second Button (i.e., Main Window 2).
  8. Click Save and Publish.

4. Launching Clients

Now that we've created a project, let's launch a Client to see it in action.

 Launch a Client
  1. If you haven't already, make sure you have a project created.

  2. Go back to the Gateway Home web page.
    Your project will appear in the Launch Projects panel with a big Launch button to its right. Scroll down until you see it and Click on the Launch button to start up a Client.

  3. A loading screen will pop up briefly before the client opens. 

  4. Login to the Client using:
    Username: admin
    Password: password

    By default, a new project uses the same user source as the Gateway, so the admin/password credentials will work.

  5. After you log in, you can see your Client window displaying your project. We are showing the window from the previous step, you may see the default welcome message on this page.

  6. Go back into the Designer, make a change to the window, and click File > Save and Publish
    Your Client will show a notification saying that there are updates to the project. 

  7. Click on the notification and then the Update button and the Client will update itself!

You can launch as many Clients as you want! If you've got other computers on the same network as the Gateway computer try launching on them too. Make sure that your Gateway computer doesn't have a Firewall enabled, or it is allowing traffic on port 8088 - the default port for the Ignition web server. The address to use on other computers is http://ipaddress:8088 where ipaddress is the IP address of the computer Ignition is installed on.


Learn more about Launching Clients!

  • No labels