Find Field References Dialog Box

You use the Find Field References dialog box search for references to a specific field. This search is useful to perform before you rename or delete a field, so you can first check where it is being used. After you find the references, you can choose to rename the field and update selected references with the new name, replace the field name in selected references with a different field name, or delete the field together with selected references.

More information: Finding and Modifying References

You display the Find Field References dialog box by selecting a field in the Define Data dialog box and clicking the Find References button. You can also display the Find Field References dialog box by clicking the Find References link in the message that is displayed when you edit or delete a field in the Define Data dialog box.

The Find Field References dialog box contains the following items:

Item	Description
Search result	Displays the name of the field for which you are searching, and the number of references that were found. For example, `Found 3 references to Address`.
Select All	Selects the checkbox next to each of the references in the Find Field References dialog box. You can then perform a rename, delete, or replace operation on the field in the selected references.
Deselect All	Deselects the checkbox next to each of the references in the Find Field References dialog box.
Refresh	Searches through the open model for references to the selected field and updates the list accordingly.
Element	The name and icon of the element that contains the reference. You can click the element name to highlight it on the Design board or Layout board.
Property	The name of the element property whose value contains the reference.
Expression	The reference string. The reference to the field is displayed in bold, for example, Customer_Data@address or =@name.
Edit Expression	Opens the relevant editor (for example, the Define Action dialog box, the Define Filter dialog box, or the Dynamic Expression Editor dialog box), so you can modify the reference. If you modify a reference in the Dynamic Expression Editor dialog box, the change is automatically reflected in the Find Field References dialog box. If you modify a reference in any other dialog box, the item is marked in gray. Click Refresh to update the Find Field References dialog box with the modified reference.
Rename field	Enables you to rename the specified field and update selected references with the new name.
New name	The name to which you want to rename the field.
Rename	Renames the field with the specified name, and replaces the old field name with the new one in any references whose checkbox is selected.
Delete field	Enables you to delete the specified field and delete the field name from selected references.
Delete	Deletes the field with the specified name, and deletes the field name in any references whose checkbox is selected. Make sure that the expressions are still valid after deleting the field name.
Replace references	Enables you to replace the specified field with a different field in selected references.
Replace with	The field you want to use to replace the specified field. The fields in the dropdown list are those in the same dataset and of the same type as the current field.
Replace	Replaces the specified field with the new field in any references whose checkbox is selected.