Creating a Project
The first step in working with a project is creating one! Once you launch the Designer, the Open/Create Project window is displayed. Here you have the option to create a new project or open an existing project. Let's create a new project!
Enter a unique Project Name. The Project Name can only consist of alphanumeric characters and the '_' (underscore) character. Spaces and other special characters are not supported.
It is not advisable to change the Project Name after it's been created, instead, change the Title property in Config > Projects if you want to change how the project appears later.
- Enter the Project Title. This is the name that will be displayed on the launch page of the Gateway and in the runtime Client or Session. There are no restrictions to special characters or spaces.
- Select the User Source you want to use for granting users access to the project. For more information or to add users, see Security.
- Select the Default Database from the dropdown list. Any queries to the database will use this default database connection unless explicitly specified otherwise.
- Select the primary Tag provider from the Default Tags Provider dropdown list to use for your project. Most installations will likely only have one provider, but in situations where there are more than one, this is the provider that will be used unless explicitly specified otherwise.
- Select a Parent Project: Each project may have a parent project, and will inherit all of the resources of that parent project. Click the dropdown list to see all the available options.
- Select a Project Template: There are several pre-built project templates focused on navigation that support both Perspective and Vision: Perspective Menu Nav, Perspective Web Nav, Vision 2-Tier Tab Nav, Vision Tab Nav, and Vision Tree Nav. Cick the dropdown to see all the available options.
- Click on Create New Project.
- Your project is now created and opens on the Perspective Configuration Page. If you want to design your project in Vision, click on the Vision application in the Project Browser and the Vision Getting Started window will open.
If you want to continue in Perspective, expand Perspective in the Project Browser to begin working on your project. Refer to the Quick Start - Perspective Session page help you get started creating views, adding components, and much more.
To design your project in Vision, expand Vision in the Project Browser to create windows, add components, Tags, and more. For more information on getting started, refer to the Quick Start - Vision Client page.
Open or Create a Project from within the Designer
To create a new project or open an different project from within the Designer, use the File > Open menu in the top menubar.
The Open/Create Project screen will be displayed. You can choose from existing projects or create a new project.
Updating Project Settings
Project settings such as the title, description, connections, and inheritance are set through the Gateway Webpage Config Tab, under System > Projects. For more information, see Projects.
The Designer workspace is centrally located and organized by panels. Some of the panels include a Project Browser, Tag Browser, Component Palette, and Property Editor. These panels can change depending on the type of resource you are currently editing. For example, if you are editing a Perspective view or Vision window, the Designer workspace has Component Palette and Property Editor panels. If you're editing an Alarm Notification Pipeline, your Designer workspace will be the Pipeline Block Editor. If you're editing a Report, your Designer workspace will be the Report Designer. Each type of workspace has panels that are only valid when that workspace is active.
Here are two images showing the Perspective Designer workspace and Vision Designer workspace, and an example displaying the same components. At a glance, they look very similar, but there are some differences, including each having their own Component Palettes. To learn more, refer to the Perspective Designer Interface and the Vision Designer Interface pages.
Perspective Designer's Workspace
Vision Designer's Workspace
The Designer has a host of tools to help you accelerate building, testing, and deploying your project. Let's talk about a few here.
In addition to all the panels available in the Designer workspace, there is also a Tools menu to help you create your projects.
- Console - The Output Console is the script-writers best friend, and most frequently used to test and debug Python scripts in Ignition.
- Image Management - The Image Management tool manages and stores images used for your projects.
- Script Console - The Script Console is used to test and debug Python scripts.
- Database Query Browser - The Database Query Browser is a very convenient tool that lets you make simple selects and edits in a database table, and interact with all of the databases that Ignition is connected to (i.e., running queries, browsing tables and schemas). It is very common during the course of project design to inspect the database directly, or to experiment with a SQL query to get it just right.
- Translation Manager - Opens up the Translation Manager panel, and allows you to configure language translations. See also: Localization and Languages
- Cloud Templates Browser (Vision Only) - The Cloud Templates Browser connects to a repository of templates that other users have made available to anyone.
- Symbol Factory - The Symbol Factory contains a variety of high quality vector graphics symbols that can bring your projects to life.
Previewing the Project
The Designer provides the capability to preview, test, and interact with the screens and functionality before you deploy your project. The Designer workspace operates in two distinct modes: Design mode and Preview mode. Designers can easily switch between these modes to make sure their project is working as expected during the course of development by simply clicking Preview Mode icon from the top menubar, or clicking Project also from the top menubar, and selecting Preview Mode.
The Preview Modeicon toggles to be a Design Mode icon when it is pressed.
Find and Replace
The Find and Replace is a handy tool in the Designer workspace. You can search your entire project for specific components, properties, scripts, and more. You can even use the replace command to make mass changes expeditiously to a project with very little effort.
There are a lot of ways to speed up your development once you are familiar with how Ignition works. There are many keyboard shortcuts in Designer that are listed throughout the Designer interface alongside menu options.
The Ignition Designer uses a lock-free strategy for handling concurrent editing. Multiple people can work together and make changes to a project at the same time. An unlimited number of Designers can be open concurrently, and modifying any resource in the Designer doesn't lock it. The Designer keeps track of the resources that are being edited, and any conflicting edits will be resolved at the time the project is saved. The developer who creates a saving conflict will be prompted to resolve the conflict by choosing whether to use their own changes, accept the other designer's changes, or cancel their save and figure out what to do in another way.
To save your project, got the the Menubar and select File → Save. When the the Save Project dialog pops up, select the items you want to save and click the Save button.
If there are any conflicts, the Designer will ask you to update your project and the conflict resolution screen will open automatically. You will see a thumbnail image of both screens and the .json code showing the conflict. To resolve the conflict, you will be given a choice; accept your changes, accept the other developer's changes, or cancel the save and contact the other developer. Buttons are provided at the top and bottom of the screen for you to enter how you want to resolve the conflict.
The image below shows that changes were made to the slider's value from a user on their Local machine and another user on a Remote machine. The line number and the code are highlighted so you can quickly identify the conflict.