Viewing Undefined Variables (2024)

You are here:

You can view a list of all files where you have variables inserted in the content, but those variables have not been defined. This might occur, for example, if you have inserted a variable in a topic and then later change the name of the variable or variable set. The old variable or set name is still used at the location where it was previously inserted in the topic; therefore, a problem exists. From the Undefined Variables window pane, you can open the topic in question and fix the undefined variable. You can also quickly rename or remove multiple variables in a single batch, add the undefined variable to the project, or map the undefined variable to an existing variable.

how to view undefined variables

Open a project.
Do one of the following, depending on the part of the user interface you are using:
- Ribbon Select the View ribbon.Then in the Dynamic Reports section, select Undefined Items > Undefined Variables.
- Analyzer Summary Window Pane Double-click the row that mentions undefined variables.
The Undefined Variables window pane opens.
To see more of the information in the window pane, drag the divider bar to make the pane wider:
- Variable Displays the name of the variable set and the variable within it. The variable set is listed first, followed by a period and then the name of the variable (e.g., Primary.CompanyName).
- File Displays the name of the file.
- Title Displays the properties title of the file (if any).
- Folder Displays the folder where the file is found.
- Tag Displays the tag being used by the variable.
If a certain number of items have been found, page navigation buttons in the local toolbar may be enabled. You can use these buttons to go to additional pages to display more items. You also have the option to view all items at once in one long list. This is called the View All option. You can toggle these views by clicking the View All/View as Pages button in the local toolbar. The button displays the opposite of whatever view is currently activated (e.g., If the View All option is currently active, the button shows View as Pages to indicate that if clicked, the button will switch the window pane to the View as Pages option).

how to fix undefined variables

There are a few ways to fix an undefined variable: (1) You can rename the variable or variable set so that it matches what you have used in the topic; (2) you can re-insert the variable in the topic so that it uses an existing variable set/variable name, (3) you can add the undefined variable to the project as a new variable; and (4) you can map the the undefined variable to an existing variable.

to rename variables

In the window pane, select all variable occurrences that you want to rename. If you want to select all rows click . You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.

Note: All variable occurrences that you select will be renamed to the same variable that you provide in the following steps.
In the local toolbar, click the Rename button. The Rename Variable(s) dialog opens.
In the New variable name field, enter a new variable. Type the name of the variable set, followed by a period, then the name of the variable (e.g., MyVariableSet.MyVariableName).
Click OK.
A message lets you know how many files were changed. Click OK. All of the selected variable occurrences are renamed.

Note: If you want to undo the conversions, you can use the Backups window pane (View > Backups). See Restoring Backup Files.

to re-insert variables

Do one of the following, depending on whether you want to open the file in the Analyzer interface or within Flare.

to open the file in the analyzer interface

Double-click the file in the window pane. The benefit of using this method is that it is quick and convenient. You have access to the features normally available in the editor (but not necessarily to all of the features available elsewhere in Flare).

to open the file in flare
1. In the window pane, click on the file.
2. Select File > Send to Flare.
The benefit of using this method is that you have access to all of the features in the application, not just those available from the editor.
Re-insert the variable in the topic, selecting an existing name from a variable set. See the online Help in Flare for more information about inserting variables.

to Add a New Variable

In the window pane, select all variable occurrences that you want to add to the project. If you want to select all rows click . You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
Do one of the following, depending on the part of the user interface you are using:
- Local Toolbar Click .
- Right-Click Right-click on the variable you want to add and from the context menu select Add Variable.
The Variable Set Editor opens, with the new variable(s) displayed.
Note: When you create a new variable, one of two things will happen:
1. If the Variable Set file specified for the undefined variable exists in the project, Analyzer will add the new variable to the existing Variable Set file.
2. If the Variable Set file specified for the undefined variable does not exist in the project, Analyzer will create a brand new Variable Set file in the project and add the variable to that file.
(Optional)In the Variable Set Editor, edit the variable's properties (e.g., name, definition, comment).
Click to save your work.

to Map to an Existing Variable

In the window pane, select all variable occurrences that you want to map to an existing variable. If you want to select all rows click . You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
Do one of the following, depending on the part of the user interface you are using:
- Local Toolbar Click .
- Right-Click Right-click on the variable you want to add and from the context menu select Map to Existing Variable.
The Variables dialog opens.
In the dialog, select the existing variable in the project to overwrite the current undefined variable reference.
Click OK.
A message lets you know how many files were changed. Click OK. All of the selected variable occurrences are overwritten with the new variable.

Note: If you want to undo the conversions, you can use the Backups window pane (View > Backups). See Restoring Backup Files.
Click to save your work.

notes

Note: Another way to replace a variable in many places throughout a project is to use the Find and Replace in Files feature in Flare. For example, let's say that you originally inserted a variable named "Company" (from the "Primary" variable set) in a lot of places in your project. Later, you renamed the variable "Branch." You can perform a find and replace throughout your entire project. In the "Find" field, you can enter Primary.Company, and in the "Replace with" field, you can enter Primary.Branch. Also, make sure you select the "Find in source code" option in the Find and Replace in Files window pane. After replacing this text throughout your project, that variable will no longer be considered "undefined" in Analyzer. For information about using the Find and Replace in Files feature, see the online Help in Flare.

Note: You can also include this information in reports that you create. See About Reports.