 Cross References

The ISaGRAF workbench includes a cross reference editor which provides user with a total view of the declared variables in the project's programs, and where they are used. The aim of the cross reference is to list all the variables declared in the project, and to localize, at the source of each program the parts of source code where those variables are used. The cross références are very useful for a global view of one variable life cycle. They help localize side effects, and reduce the time to understand the project during the maintenance. The cross references may also be used for a global view of the complete dictionary of a project, so unused variables are easily found and the complexity of the project measured.

Object type selection

Re-calculate cross references

Export cross references

Dictionary errors

Statistics

Search in object list

Open program

The list on the left shows the declared objects of the project (programs, variables and defined words), and the library elements (functions and function blocks) referenced in the project. The list on the right shows the occurrences in the programs of the object currently selected in the first list.

The description of an occurence includes the program name, the number of the FC or SFC step, transition or test, plus line number for text languages or coordinates for LD or FBD diagrams. For quick LD diagrams, the description is completed with the number of the rung. If the variable is used as an output (on a coil) the rung number is followed by a star ("*") character.

Set the "Show unused variables" option from the "Options" menu to display also in main list variables that are not used in the application programs.


Object type selection

Because a project can group a huge number of declared objects, the combo box in the editor toolbar is used to select the type of objects which must be listed in the window. This allows the user to have access to selected information.

Each time the cross references are re-calculated, the selection is reset to "All objects" in order to present the complete list.


Re-calculate cross references

The "File / Re-calculate" command can be used at any time to update the cross references according to the modifications entered in other ISaGRAF editing windows.


Export cross references

The "Tools / Export" command is used to write the complete listing of the cross references in an ASCII text file. This file can then be opened with other applications such as Windows NotePad or word processors.


Dictionary errors

The "Edit / Dictionary errors" command displays in a dialog box the list of errors detected when the project dictionary was loaded.


Statistics

The "Tools / Statistics" command displays in a dialog box the number of objects and variables declared in the project, according to variable types and attributes. A particular application of this command is to know the number of I/O variables declared in the project, in order to ensure that it can be compiled, if a limited version of the ISaGRAF Workbench is used.


Search in object list

The "Edit / Search" command allows the user to directly select an object in the editor list. The searched object cannot be found if it is not actually listed (when using a selected display). It is recommended, before searching for an object, to activate the "All" selection in the toolbar.


Open program

The list on the right contains the occurrences of the selected object in the source files and I/O connection of the open project. The "Edit / Open program" command enables the user to directly open a program where the object appears. It is also possible to double click the mouse on an occurrence (in the occurrence list) to open the corresponding program.