XVision Guide

The  Cross Reference dockable window creates a report that locates Items and the Local Variables referenced in the main elements of the current project. 

The Cross Reference is able to explore the references (item or local variables) contained in:

1. Pages (general properties, animations, Keyboard Events page)
2. Menu 
3. Events from System Keyboard 
4. Overall expressions
5. Actions on Event
6. Recipes
7. DataLogger
8. Scheduler
9. Background Script

For each element are explored expressions, parameters and action scripts.

Note: search for items and local variables within the script extracts only the references in calls to:

1. Function GetExpressionValue
2. Function SetItemValue
3. Method GetIndex (class Item)
4. Method DeleteItem (RTDB class)
5. Method InsertItem (RTDB class)
6. Method GetLocalVariable
7. Function SetLocalVariable

and any case is unable to locate the references if:

1. The item names or Local Variables are passed to procedures by variables or constantsThe item names or Local Variables are obtained by strinmg concatenation or other functions.

Note: The Cross Reference explores pages from the saved copy on disk.

Running the Cross Reference

The Cross-Reference is not updated dynamically: it is therefore necessary to use the update command to generate or update the report. Selecting the command Update the system proceeds to search for references. You can limit the search to only those elements that affect and filter by name references excerpts:

Note: the execution of cross-reference list can take from a few seconds to several minutes, depending on the items included in the research and their number and complexity.

The collected data can be viewed by organizing:

1. for reference: Displays the report by listing, for each reference (item / local variable), objects in which it is referenced
2. object: view the report by listing, for each object in the system, the references (item / local variable) it contains

You can switch between display modes using the buttons on the toolbar. By changing the display mode is not done reloading.

The references found are represented by different icons depending on whether the Item ( ) Or Local Variables ( ). Any such references do not exist are shown graphically with an exclamation mark on the icon ( ).

A special filter function allows you to limit the view to only references that do not exist.

For each occurrence the list provides with the necessary information leading to the location of the item. By double-clicking or by selecting the indication Locate from the context menu it is possible to automatically select the element that contains the reference.

Selecting the command Item Property from the context menu on the indication of an existing item you can open the properties window.

The toolbar at the top of the window makes the following commands:

The Cross List window can be displayed (or recalled if set as pop-up window) by selecting Cross-List from the menu View.