You're currently browsing the Ignition 8.0 docs. Click here to view the latest docs.


Client Tags, as the name implies, are only available for use in Clients. Their values are isolated to a Client runtime. All clients will have the same list of client Tags, however, the actual values are unique and independent for each running Client. In other words, even though client Tags are created in the Designer, each client will create their own instances. This makes them very useful as in-project variables for passing information between screens, and between other parts of the clients, such as scripting.

Client Tags support most of the data types that standard Tags do (including datasets), but excluding the array types. Additionally, Client Tags do not have a Tag Group property, so the value will only update when the polling property executes, or a reference in the Client Tag's expression updates. 

Often, users will create parameterized windows that take in a line ID or machine name. A Client Tag can store this value for indirection to be used across multiple windows without users on different clients fighting over the current value as they would with a standard Tag.

If you are using Perspective, there are no Client Tags available to a Session. See Session Properties for a similar system.


On this page ...


IULocgo

Client Tags



Expression Type

Client Tags can be configured in one of several ways, based on the Expression Type property. The following options are available. 

  • None: Causes the Tag to behave like a Memory Tag.
  • Expression: Allows the Tag to utilize Ignition's Expression Language, much like an Expression Tag.
  • Query: Executes a SQL Query, similar to a Query Tag. 

  • Named Queries: Client Tags may call Named Queries


Create a Client Tag

This example shows how to create a client Tag. 

  1. From the Tag Browser, right-click on the Vision Client Tags folder and select New Tag > Client Tag. The Tag Editor will open.




  2. In the Tag Editor enter the Tag name and the following general properties, then click OK.

    Name: Area
    Value: Processing
    Data Type: String


  3. A new Tag called Area is created in the Client folder.

Using Vision Client Tags

Once a Client Tag is created, it can be used just like any other Tag. You can drag-and-drop, bind to it, use it in scripting, or add it to a Transaction Group.

Overriding Vision Client Tags

When you open a Client, your Vision Client Tags default to the value that was saved in the Designer. If you want to open a Client with different values in your Client Tags, you can override them in the Vision Client Launcher (either for all applications, or an individual application). A Client Tag can be overridden in the Client Tag Overrides section of the Vision Client Launcher.

  • Use the Settings button to override a client Tag in all applications.
  • Select Manage on the individual application to override a tag on that specific application.

The following feature is new in Ignition version 8.0.7
Click here to check out the other new features

Client Tags can be overriden within a folder. You can also pass client Tag overrides with spaces by using a '+' icon as an escape character. This happens automatically if you are configuring overrides in the Client Launcher.


The following example shows how to override client Tags on a single application.

  1. In the Designer, create a client Tag inside a folder and bind it to something that can be displayed on a window. This example has two Tags: one Tag is directly under Vision Client Tags folder, and another one under a nested folder. Each TagA tag is bound to a different Label components.




  2. Open the Vision Client Launcher. On your application, click the three vertical dots to open the Manage screen.



  3. From the Client Tag Overrides section, click the '+' icon on the right side of the table to add a Tag override. In this example, let's configure two client Tag overrides. The first TagA is for a client Tag directly under Vision Client Tags. Enter the Tag Name and Tag Value. The second override is for the nested TagA Tag. In the Tag Name, the folder name must precede the Tag name followed by a forward slash. Notice how the value has a '+' that denotes a space. The launcher will automatically enter the space for you in the client launcher when you save your updates. Enter the Tag Name (including the folder name) and Tag Value.



  4. Click the Save Changes button on the top right corner of the screen. This will take you back to your My Applications screen.
  5. From the top menubar, click on Tools > Launch Project > Launch Windowed to launch your application in your client. You will see the new values that you overrided in the Client Launcher.



System Client Tags

System Tags provide status about the Ignition system, such as memory usage, performance metrics, and so on. Client-scoped System Tags provide status information about the Vision Client's system. Every individual Vision client is going to have its own values like IP address, hosting name, username, and more. You cannot modify Client System Tags.  For more information, see System Tags.




Related Topics ...

  • No labels