Tagname Dictionary intouch Utilize the InTouch Cross Reference Utility
There are several ways to edit existing links and tags. This section includes substituting, converting, and deleting tagnames as well as utilizing the InTouch Cross Reference Utility.
Deleting Tags
Deleting tags is made deliberately difficult in InTouch.
When WindowViewer is running, deleting a tag is not allowed.
When a tag is referenced by any script or animation link, it cannot be deleted. Use the Cross Reference tool to determine tag usage.
In other words, to delete an unused tag from the Tagname Dictionary, you must complete the following tasks:
Shut down WindowViewer.
Eliminate tag use with the Cross Reference utility.
Update Use Counts under Special/Update Use Counts.
Confirm the deletion.
The Delete button will not be available if WindowViewer is running or if InTouch considers the tagname as being used in the application.
InTouch Cross Reference Utility
The InTouch Cross Reference utility allows you to determine your tagname and SuperTag usage in animation links, wizards, InTouch QuickScripts, QuickFunctions, ActiveX controls, scripts and the following InTouch add-on programs: SPC Pro, SQL Access Manager and Recipe Manager.
For all objects such as wizards, ActiveX controls and animation links, it displays the window name and the coordinates of all objects linked to the tagname. It also allows you to view any QuickScript or QuickFunction in which a tag reference is found.
The InTouch Cross Reference tool can remain running in WindowMaker while other tasks are performed.
Utilizing the InTouch Cross Reference Utility
Click Special / Cross Reference.
The InTouch Cross Reference Search Criteria dialog box appears:
Search Criteria area: Enables you to limit the scope of your search. The scope can be determined by selecting only the options required.
Search for all occurrences: Search for all uses of the tagname or SuperTag in animation links, InTouch QuickScripts and all add-on programs such as SPC, SQL Access Manager, Recipe Manager, and so on.
Search for specific occurrences: Search for only the tagname or SuperTag in the specified options.
For example, to search for the usage in window scripts, select Usage in window scripts
Filter: Enter a unique name to identify the filter that you wish to define or open the Filter drop-down list to select a previously defined filter from the list. When you define filters, the name you enter is added to the Filter list.
Search: Begins the cross reference search based on the specified view criteria.
Cross Reference Search Results
When you perform a cross reference search, the InTouch Cross Reference Utility dialog box appears listing all instances of usage found for the Filter that you specified.
If no filter is used, all tagnames defined in the current application’s Tagname Dictionary are displayed. For
example:
Cross Reference Utility Interface Icons
The following table briefly describes the various icons that appear in the InTouch Cross Reference Utility.
Double-click the icon to view it.
To change the Search Criteria selection, click Cancel.
The InTouch Cross Reference Utility dialog box reappears.
Click Search and select the new Search Criteria option.
In the list at the bottom of the dialog box, select (if the tree view is to be populated by) Tag Name or By Window.
By Tagname: Cross referencing by tagname alphabetically lists all tagnames found for the specified search criteria (default view).
Based on your specified search criteria, this view allows you to view the usage of all tagnames found in windows, animation links, scripts and add-on applications.
To expand the view, either double-click a displayed tagname and then double-click Animation Link Use, or click the Expand View button.
When the view is expanded, the window name and the location (coordinates) of the object(s) linked to the tagname are displayed:
Double-click a tagname and then double-click any of its associated scripts to open it in the Script usage for <Tag Name> dialog box.
Click Contract View in the InTouch Cross Reference Utility window to return the dialog box to its default mode.
The drop-down list field at the top of the dialog box displays all scripts associated with the selected tag.
Open the list and select another script. For Application, Window, Key and Condition scripts, the list contains the names of all scripts that use this tagname.
For Data Change scripts, only the tagname is listed.
For QuickFunctions, the list will contain the names of all QuickFunctions (read-only view).
By Window Name: Cross referencing by window name sorts the display by window name and then by the tagnames used in the window.
Note: This view only displays the tagnames used in the window. It does not include usage in animation links, scripts, and so on.
Click the Options button in the InTouch Cross Reference Utility window (Special/Cross Reference/Search/Options).
Choose the By Window option to display Windows alphabetically. Expand or contract the view as desired.
Click Close to exit the InTouch Cross Reference Utility.
Saving Cross Reference Files
Cross reference files can be saved and viewed later in any text editor program that supports the comma separated variable (.CSV) file format.
The information stored in a cross reference file corresponds to the information currently displayed in the InTouch Cross Reference Utility dialog box.
In the InTouch Cross Reference Utility dialog box, click Save As. The Save As dialog box appears.
In the File name box, enter the name to save the cross reference file under. The file can only be saved as a .CSV file.
Click Save.
Printing Cross Reference Files
A cross reference .CSV file can be opened in any text editor program that supports the .CSV file format and then printed as a report.
For example, in Notepad, the file would display as follows.
Click File / Print to print the file.
Updating Use Counts and Deleting Multiple Unused Tagnames
InTouch maintains a use count for each item in the database. This count is not updated automatically for certain operations, such as deleting a window, changing tagnames in links or scripts, and so on. In these cases, InTouch continues to consider the tagname as being used in the application and will not allow it to be deleted. Therefore, you may need to update your use count in order to delete one tagname, or multiple tagnames.
Updating Use Counts
Since InTouch maintains a use count for each item in the database, you may need to update the use counts to set all unused tagnames to zero before InTouch will allow you to delete them.
Close all windows.
Click Special/Update Use Counts.
A message informing you that updating use counts may take a while appears:
Click Yes to update the use counts.
When the system has completed updating, the following dialog box appears:
Click OK.
Deleting Multiple Unused Tagnames
After you have updated the use count, InTouch will allow you to delete all unused tags. You can either delete them one by one in the Tagname Dictionary or several at once by using the Delete Unused Tags command.
Click Special / Delete Unused Tags.
The Choose Names to Delete dialog box appears:
Select the tagnames by holding the Control Key and clicking each tag, then click Delete.
Click All to delete all displayed tagnames.
Displaying the Tag Usage Count
The number of local tags defined in the Tagname Dictionary can be displayed in the WindowMaker menu bar. The tag count does not include internal system tags or remote tagname references. System Tags (37) do not count toward licensed tags.
Click Special / Configure / WindowMaker.
The WindowMaker Properties dialog box appears:
Select Show Tag Count. and click OK. The following message appears.
Click OK to close/restart WindowMaker.
The total number of local tagnames defined in the Tagname Dictionary is displayed: