The Open/Find Resource Dialog Box

The Open/Find Resource dialog box offers advanced search capabilities. To open the Open/Find Resource dialog box, go to Find > Open/Find Resource (Ctrl Shift R (Meta Shift R on OS X)). You can also click the Open/Find Resource toolbar button or use the Search for file action, available for some URL input fields.

Figure: The Open/Find Resource Dialog Box

You can use this dialog box to find a file in the current Oxygen XML Editor project or in one of the DITA maps opened in the DITA Maps Manager view by typing a few letters of the file name of a document or a fragment of the content you are searching for. The Open/Find Resource dialog box also supports searching in document edits (comments, insertions, deletions, and highlighted content).

Note: Full support for searching in document edits is available only in the Enterprise edition of Oxygen XML Editor. The Professional edition offers support to search through a maximum of 10 edits.

Search results are presented instantly, after you finish typing the content. The matching fragments of text are highlighted in the results list displayed in the dialog box. When you open one of the documents from the results list, the matching fragments of text are highlighted in the editing area. To remove the highlighting from your document close the Results view. To display the search history, position the cursor in the search field and press Ctrl Down Arrow (Command Down Arrow on OS X) or Ctrl Up Arrow (Command Up Arrow on OS X) on your keyboard. Pressing only the Down Arrow key moves the selection to the list of results.

Note: Searches are case insensitive. For example, if you search for car you get the same results as when you search for Car.

Note: Suffix searches are supported, both for searching in the content of your resources and in their name. For this, you can use wildcards. If you search in content for *ing you will find documents that contain the word presenting. If you search in file paths for */samples/*.gif you will find all the gif images from the samples directory.

The Open/Find Resource dialog box offers the following options:

In file paths - Select this option to search for resources by their name or by its path (or a fragment of its path).
In content - Select this option to search through the content of your resources.
In reviews - Select this option to search through the comments, insertions, and deletion in your resources.
Options - Opens the Open/Find Resource preferences page.
Clear Index - Clears the index.
Reindex - Reindexes your resources.

A contextual menu available on each search result provides actions applicable to the document that contains it. These actions allow you to:

Open the document in one of Oxygen XML Editor internal editors.
Open the document in an external system application.
Identify the document in the system file explorer.
Copy the file's location.

When you perform a search a caching mechanism is used to gather the paths of all files linked in the current project. When the first search is performed, all project files are indexed and added to the cache. The next search operations use the information extracted from the cache, thus improving the processing time. The cache is kept for the currently loaded project only, so when you perform a search in a new project the cache is rewritten. Also, the cache is reset when you press the Reindex button.

Important: Files larger than 2GB are not indexed.

If there is no file found that matches your file pattern or text search, a possible cause is that the file you are searching for was added to the Oxygen XML Editor project after the last caching operation. In this case, re-indexing the project files from the Reindex button enables the file to be found. The date and time of the last index operation are displayed below the file list.

Once you find the files that you want to open, select them in the list and press the Open button. Each of the selected files is opened in the editor associated with the type of the file.

To watch our video demonstration about the Open/Find Resource dialog box and search capabilities, go to http://oxygenxml.com/demo/Open_Find_Resource.html.