Tag list (Bozza)

This window provides access to the [JSup application|application] [JSup tag|tag] database and many other [JSup tag|tag] related configurations and utilities.

It can be accessed in many ways:

  • Using the toolbar button or with the menu Tools / Tag database (or Ctrl+T keys).
  • From the [JSup Tag edit dialog|Tag Edit dialog] by the button on the right of each [JSup tag|tag] or by pressing the Ctrl+T keys when the cursor is on a [JSup tag|tag] field.
  • From a [JSup Code|code] field of an [JSup Animations|animation] or other [JSup Code script container|code script container] by pressing the Ctrl+T keys.


This dialog provides many functions:

  • Tag [#Tag creation|creation] and [#Tag edit|edit]
  • [#Tag search/filter|Tag search/filter]
  • [#Quick tag search|Quick tag name search]
  • [#Sorting tags|Sorting tag]
  • [#Direct table edit|Direct table edit]
  • Access to [JSup Tag classes|Tag class] and [JSup tag structures|Tag structure] definitions.
  • [JSup Importing tags from Excel|Tag import/export]
  • Copy of tag table content to clipboard (to be pasted in an Excel sheet).


Some notes about the tag table columns:

  • The second column (named "#") shows the Id of the [JSup tag|tags], the unique number of a tag in its own [JSup domains|domain].
  • The Array column is blank for [JSup tag|tags] that are not [JSup Tag arrays|arrays], for [JSup Tag arrays|tag arrays] the sizes of their dimensions are displayed (comma separated).
  • Extra 1 normally shows the tag [JSup alarm groups|alarm groups], but a different field can be chosen in the [http://en.wikipedia.org/wiki/Combo_box|combo box] below.
  • Extra 2 normally shows the tag description, but a different field can be chosen in the [http://en.wikipedia.org/wiki/Combo_box|combo box] below.
  • I/O checked for I/O [JSup tag|tags]: that have one (or more) [IOHook|I/O Hook].
  • Alm: checked for [JSup tag|tags] those define an [JSup tag alarms|alarm] (or more than one, for [JSup analog tag alarm definition|analog tags]).
  • Link: checked for [JSup Linkable tags|linkable tags].
  • Ret: checked for [JSup Retentive tags|retentive tags].
  • Log: checked for [JSup Logged tags|logged tags].
  • R.O.: checked for [JSup Read only tags|read only tags].

Tag creation

A new [JSup tag|tag] can be created by clicking the New button.
The [JSup Tag dialog|Tag dialog] will appear, so the the new [JSup tag|tag] can be defined and [JSup Tag dialog#Saving tag|saved].

New [JSup tag|tags] can be also created by cloning an existing [JSup tag|tag]:

  • select the [JSup tag|tag] to clone;
  • click on the Edit button;
  • Click on the Clone button of the [JSup Tag dialog|Tag dialog]

See [JSup Tag dialog#Cloning a tag|Cloning a tag].

Tag edit

An existing [JSup tag|tag] can be edited and changed:

  • select the [JSup tag|tag] to edit;
  • press the Edit button (or double click the [JSup tag|tag] in the table, when the [#Direct table edit|Direct table edit] is disabled);
  • change the tag properties in the [JSup Tag dialog|Tag dialog] and [JSup Tag dialog#Saving tag|save] it.


Note that some changes are not allowed when a [JSup tag|tag] appears to be used (see [JSup Updating tag usage status|Updating tag usage status]).

[JSup System tags|System tags] cannon be edited.

Tag deletion

An unused tag can be deleted: simply click the Delete button.

See [JSup Updating tag usage status|Updating tag usage status].

Tag search/filter

Existing [JSup tag|tags] can be searched/filtered using the fields above the table columns with the Search / Filter buttons.
Enter the desired criteria the fields and:

  • press the Search button the find the next tag that matches the give criteria.
  • press the Filter button to filter [JSup tag|tags], so only the matching [JSup tag|tags] will be visible (use the No filter button to remove the filter).

Some fields can be search/filter for by selecting a value from a [http://en.wikipedia.org/wiki/Combo_box|combobox].

[http://en.wikipedia.org/wiki/Check_box|Checkboxes] can be checked to search/filter tag with the corresponding characteristic. It is not possible to search/filter tag that does not have those characteristics, but using a [#Sorting tags|sort] on the column could be useful to separate tags.

Extra 1/2 columns can be filtered/search also:

  • true / false strings (or simply "t" / "f") have to be inserted to search/filter boolean fields (that are displayed with a [http://en.wikipedia.org/wiki/Check_box|Checkbox]).


See the search/filter criteria fields' [JSup editor tooltip|tooltip].

Search/filter can also be done using [http://en.wikipedia.org/wiki/Regular_expression|regular expressions] (see Java [http://java.sun.com/javase/6/docs/api/index.html|Pattern] class for the used implementation). Simply prefix the regular expression with a '@' character.

Quick tag search

The quick tag name search is available when the table has the [http://en.wikipedia.org/wiki/Focus_%28computing%29|focus] (and the [#Direct table edit|Direct table edit] mode is not selected): the type characters are added to the Quick tag name search text field and next matching tag (a tag whose name starts with the given prefix) is search and selected (if any).

The tag name prefix can also by type or pasted directly in the Quick tag name search field.

Sorting tags

Tag table is normally sorted by tag name.
You can change the sort by clicking over the table column. See table column [JSup editor tooltip|tooltip] for more information.

Direct table edit

When this checkbox is selected many [JSup tag|tag] fields can be changed directly in the tag table. For example you can easily and quickly change many tag descriptions without the need of opening the [JSup Tag dialog|Tag dialog].

Using Extra columns

Two of the table columns (named Extra 1 and Extra 2) can be customized by the user to view (and edit when the [#Direct table edit] is enabled) the column he desires; simply select the fields in the below [http://en.wikipedia.org/wiki/Combo_box|comboboxes].