# Repository Navigator

The Repository Navigator is available in the DQL view, to the left of the dqMan screen. You can open or close it using the Repository Navigator from the **View** menu or by using the **Navigator** button on the toolbar.

The Repository Navigator displays a cabinet/folder tree, an object type/registered table tree, a group tree and a favorites tree for the currently connected repository of the session window.

Whenever a tree item is expanded, the appropriate data is fetched dynamically from the repository. Therefore, you can easily update a part of the tree by collapsing and re-expanding the parent folder.

### The Cabinet/Folder Tree

**Create a DQL query for the folder contents**\
Click the desired folder to create a DQL query for the folder contents, placed in the DQL command input area without executing it. The query is created using the **Default Query Template** that you can modify in the **Options** dialog box.

**View the folder content**\
Center mouse click to create a DQL similar to the above, but automatically executed.

**Filter**

Filtering is applied only to the folders already loaded in the grid. Filtering is not applied when expanding a folder, unless the filter is reapplied.

**Context menu**\
Right-click a folder to open the context menu:

<table><thead><tr><th>Context Menu Command</th><th>What It Does</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Expand recursive</strong></td><td>Expands all subfolders.</td><td></td></tr><tr><td><strong>Dump object</strong></td><td>Creates a dump of the currently selected folder.</td><td></td></tr><tr><td><strong>List of query templates</strong></td><td>Lists template queries defined in the <strong>Options</strong> dialog box. Templates marked with a green arrow will be executed immediately; the others will only generate a DQL query.</td><td></td></tr><tr><td><strong>Create Folder</strong></td><td>Opens a dialog box to create a folder. The folder is linked to the currently selected cabinet or folder. The name of the folder is mandatory; you can optionally assign an ACL.</td><td></td></tr><tr><td><strong>Create Document</strong></td><td>Opens a dialog box to create a document (<code>dm_document</code> or any of its subtypes). The document is linked to the currently selected cabinet or folder.<br>Selecting the object type and object name are mandatory. Assigning a content file from the local file system or an ACL is optional.</td><td></td></tr><tr><td><strong>Destroy Cabinet</strong></td><td>Recursively destroys all subfolders of the currently selected folder, including all contained objects. If these objects are linked to more than one folder, you can decide to only destroy the links.</td><td></td></tr><tr><td><strong>Tree Options</strong></td><td>Opens the appropriate page of the options dialog to manage repository tree settings.</td><td></td></tr></tbody></table>

Object functions and plugin functions are also available, if they have been enabled for the Repository navigator.

### The Object Type/Registered Table Tree

**Create a DQL query for type objects or registered tables**\
Click an object type/table to create a DQL query for objects of the selected type/rows of the selected registered table using the **Default Query Template**. The result is displayed in the DQL command input area without executing it.\
To execute it, use the center mouse button.&#x20;

**Filter**

Filtering is applied only to the types already loaded in the grid. Filtering is not applied when expanding a type, unless the filter is reapplied.

**Context menu**\
Right-click an object type/table to open the context menu with the following options:

<table><thead><tr><th>Context Menu Option</th><th>What It Does</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Expand recursive</strong></td><td>Expands all subtypes.</td><td></td></tr><tr><td><strong>Dump type object</strong></td><td>Creates a dump of the currently selected type.</td><td></td></tr><tr><td><strong>List of query templates</strong></td><td>Lists template queries defined in the <strong>Options</strong> dialog box. Templates marked with green arrow are executed immediately, the other templates only generate a DQL query and place it in the DQL command area.</td><td></td></tr><tr><td><strong>User Functions</strong></td><td>Lists user functions available for the selected tree item.</td><td></td></tr><tr><td><strong>Tree Options</strong></td><td>Opens the respective page of the <strong>Options</strong> dialog box to manage repository tree settings.</td><td></td></tr><tr><td><strong>Copy Registered Table</strong></td><td>Opens the Copy Registered Table assistant and preselects the table.</td><td></td></tr></tbody></table>

### The Group Tree

**Creation of a DQL query for group objects**\
Click a group to create a DQL query for the group using the **Default Query Template**. The result is displayed in the DQL command input area without executing it.\
To execute it, use the center mouse button.&#x20;

**Filter**

Filtering is applied only to the groups already loaded in the grid. Filtering is not applied when expanding a group, unless the filter is reapplied.

**Context menu**\
Right-click a group to open the context menu with the following options:

<table><thead><tr><th>Context Menu Option</th><th>What It Does</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Expand recursive</strong></td><td>Expands all subgroups. As the group structure of a repository is not organized hierarchically, some groups may contain each other, in which case this function will result in an endless loop.</td><td></td></tr><tr><td><strong>Dump group object</strong></td><td>Creates a dump of the currently selected group.</td><td></td></tr><tr><td><strong>List of query templates</strong></td><td>Lists template queries defined in the <strong>Options</strong> dialog box. Templates marked with green arrow are executed immediately, the other templates only generate a DQL query and place it in the DQL command area.</td><td></td></tr><tr><td><strong>User Functions</strong></td><td>Lists user functions available for the selected tree item.</td><td></td></tr><tr><td><strong>Tree Options</strong></td><td>Opens the respective page of the <strong>Options</strong> dialog box to manage repository tree settings.</td><td></td></tr></tbody></table>

### Favorites Panel

**Load a favorite query**\
Click a favorite to load the DQL query of the favorite into the DQL command input area without executing it.\
To execute it, use the center mouse button.&#x20;

**Filter**

Favorites can now be filtered from the grid. Filtering works whether the favorites are expanded or not

**Manage Favorites**\
Further details on editing and managing favorites can be found in the [Favorites](/opentext-documentum-edition-24.2/favorites.md) topic.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dqman.com/opentext-documentum-edition-24.2/repository-navigator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
