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 Version History

« Previous Version 18 Next »

Feature Description

The Tag Editor is a core feature of CIMON Canvas that links abstract process variables with physical control devices. Nearly every feature Canvas provides has its functionality based on the tags defined in the Tag Editor. These tags can be numerous data types, and within a Canvas application, tags can be accessed and updated by UI elements, external devices, scripts, and various utility functions (recipes, alarm groups, etc). Tags are easily created, modified, and organized inside the Tag Editor pane or exported and imported from spreadsheet-type software (i.e., Microsoft Excel and Google Sheets), allowing easy management and printing. For more details on the tag editor, please visit Tag Editor Information to learn more.

Designer Functionalities

Tag Editor

Click View > Tag Editor to open the Tag Editor pane, as displayed on the right:

Here, all created tags, and their designated names, data types, connected I/O devices, assigned I/O addresses, initial values, persistent attributes, and descriptions are shown. Users can create, group, edit, paste, copy, cut, and delete tags from this pane by clicking the icons or using the right-click menu. The user can also click the Tag Count icon to see how many tags of each type or device have been created.

The Tag Editor pane can be undocked by dragging the pane's header to be placed to the user's liking.

Tag Editor Groups

To add a tag group, click the Add tag group icon in the Tag Editor pane. After pressing the button, a text field will open in the Tag Editor pane where a name for the tag group can be assigned.

If the user has too many tags in a single pane, finding and managing individual tags may be challenging. Tag groups allow users to organize tags based on category, with a tree structure for subordinate tags. The grouped tags are displayed and managed in the Tag Editor pane.

Tags can be defined and configured inside the Tag Editor pane. Within a Canvas project, tags can be accessed and updated by UI elements, external devices, scripts, and various utility functions (recipes, alarm groups, etc). Canvas currently has three types of tags: Remote, Virtual, and Virtual (Runtime Only). Remote tags write and read their value to and from external devices. Virtual tags allow access to the Xpanel's gateway and can be accessed by other devices through the Data Server feature. Virtual (Runtime Only) tags are only used internally within the Xpanel. They simulate devices and processes, process input data, and store data describing the application state.

Each tag supports boolean, analog, and string tags with the following data types: BOOL, REAL, LREAL, SINT, INT, DINT, LINT, USINT, UINT, UDINT, ULINT, and STRING.

Edit Tag

To create a new tag, click the Add tag icon to open the Edit Tag window. This window will also pop up when double-clicking an existing tag or right-clicking an existing tag and clicking Edit Tag. In this window, tag names, data types, I/O devices, I/O addresses, etc may be assigned. One field, Path, may not be assigned, but it shows the location where the tag is being created or resides. When selecting Virtual or Virtual (Runtime Only) in the I/O Device field, a Type field populates in the I/O Address Editor. The options of this drop-down are shown in the image at the top right. All options are available to Virtual (Runtime Only), whereas some are unavailable to Virtual. Each chosen option populates another Value field with pre-set selections to do particular functions.
The visibility of the Advanced section and the fields shown inside depend on the Data Type field. The BOOL data type does not show the Advanced drop-down, whereas some data types do not have the Encoding field. Shown at the bottom right, the STRING data type is selected, which has a different Advanced section than the others:

  • When creating a tag, use a name that follows the criteria listed below:

    • The following special characters are not allowed: $, #, +, /, ?, ., {, }, [, ].

    • Tags are not case-sensitive (i.e., dig and DIG will give a duplicate name error).

    • The user cannot use the same tag name more than once in the same tag group. However, tags may use the same name in different tag groups.

  • It is important to verify that the data type of every tag matches the data type used within the paired device. If there is a mismatch, data may be incorrectly represented or manipulated.

  • Only the first address is needed for data types that span multiple addresses (namely 32-bit double words). The address of the remaining words or bytes is implied. Modbus devices typically only send and receive one 16-bit word per address. Therefore, Modbus double words may not be directly accessible via a single real tag.

Tags can be bound to objects and their parameters. Within Canvas projects, tags can be bound to specific values in objects, and some objects require tags to be bound to them before they can function properly. To bind a tag to an object parameter, users must hover over any parameter that can have a tag bound to it. Once hovering over, there will be a Link icon, and clicking on this icon will open the Binding Properties window. Clicking the Tag field will open a tag window and display all tags in the project. Users can select a tag from the page, which will then be bound to the parameter. Users can pick the direction for how the tag will function. Users can pick Tag to Property, Property to Tag, or Bidirectional.

Users can also Drag and drop the tag onto the parameter. To bind a tag to a property, click and hold the tag's name from the Tag Editor. While holding, drag onto the property that the tag needs to be bound to, and once the Link icon appears, let go of the tag, and it will automatically be bound to the property. After this, no further input will be required for the tag unless necessary.

Depending on the tag type, users can also add Formatting Options. These options can specify how many decimal places, how many leading zeroes, or even if the base should be decimal or hexadecimal, or if there should be a thousand separators. These will only work on tags that are bound to Text.

Smart Binding

Some objects can be bound by just dragging the tag onto the object. This will automatically bind the tag to a specific property of the object. An example of this would be a Text Box. When the user smart binds to a Text Box, it will automatically bind the tag to the text. To smart bind, click and hold the tag's name from the Tag Editor. While holding, drag onto the object that the tag needs to be bound to, and the cursor will change, indicating it can be bound to. Once the cursor changes, let go, and it will be bound, requiring no further input on the object. Objects that have a bindable parameter in basic properties will be able to have tags smart bound to them.

Back to Top of Tags

Custom Expression

Custom Expressions can be used on object parameters. Custom expressions can be used in place of a tag to have an object parameter function in a specific way. There are currently six expressions that are possible in the Custom Expressions. There is a Condition Map, Boolean Value, Multilanguage String, Scale Tag Value, Date/Time String, and Custom Expressions. Each of them can perform a specific function; for more information on what they do, please look at the Appendix, as there will be more details on each Expression.

Not all parameters can access all of these choices. Specific parameters will only have access to some of the parameters listed above.

Spreadsheet Compatability

  1. Select the tag(s) or tag group(s) to be copied to a spreadsheet. The user can select multiple tags using the [Ctrl] + Left-click. The subordinate tags are also selected when the user chooses a group tag.

  2. Copy ([Ctrl] + [C]) the selected tags to the clipboard.

  3. Paste ([Ctrl] + [V]) the contents directly into a spreadsheet. Each column stores a different tag attribute. These tag attributes match the ones described in the Edit Tag window. A detailed description of the tag attributes and their intended functions can be found here. Note that the associated attributes of Encoding, Clamp Mode, Deadband Type, and Scale Mode populate in a spreadsheet, even if their parent attribute is disabled.

  4. Edit the tag(s)/tag group(s) in the spreadsheet. Users can automatically create consecutive tags with a spreadsheet's increment/decrement feature. Note: Most Auto-increment features do not work for hexadecimal values. Please double-check that word and bit addresses for real tags follow the correct device address format.

  5. Select the rows in the spreadsheet to copy.

  6. Copy ([Ctrl] + [C]) the rows to the clipboard and paste ([Ctrl] + [V]) them to the Canvas Tag Editor pane. The pasted contents will replace tags with the same name. All tag attributes must be copied for Canvas to paste into the Tag Editor pane.

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.