# Favorites

### Loading and Saving Favorites

You can save any DQL queries as a favorite for easy and quick access later.

You can load and save favorites from the ***Edit*** menu or the DQL editor's context menu. Simply use the ***Load from Favorites*** or ***Save to Favorites*** menu items available in those menus at any time while in the DQL editor.

{% hint style="info" %}
Depending on whether there is a text selection or not, either the whole content of the code area or only the selected text will be saved as a favorite.\
Ideally complete statements should be selected and saved as favorites, but it is possible to save incomplete statements as well if desired. Incomplete favorites do need to be closed after being loaded to form a valid statement that can be executed correctly.
{% endhint %}

When saving a query to **Favorites**, a number of properties can be set to catalog, sort and find favorites later.

Favorites can also be edited later if changes are needed (see [Manage Favorites](#manage-favorites) below for editing existing favorites).

<figure><img src="https://748143113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ9QWGdnSQRxjUz4KkCwk%2Fuploads%2FpoqNGRMB54CGp6lXtGCR%2FCapture.PNG?alt=media&#x26;token=ecd574c4-115a-4b2f-b2c0-ac451563c2f3" alt=""><figcaption><p>Example of a favorite's properties</p></figcaption></figure>

**Name**\
Name of the favorite.

**Category**\
Select a category for your favorite. Your favorite query will be grouped together with other favorites under the same category.&#x20;

**Query type**\
Enter or select a query type.

**Object type**\
Enter the object type used in this query.

**Show in Favorites**\
Select if you want the favorite to be displayed in the **Favorites** menu. Unchecking this will hide the favorite from the Favorites menu and the Favorites Panel in the Repository Navigator.

**Show in Repository**\
Enter any repository this particular favorite should be limited to.\
An exclamation mark placed in front of the repository name (e.g. `!testrepository`) hides the favorite for the respective repository.\
Leaving the field empty will display the favorite in *all* repositories.\
Repositories can also be selected by opening the menu to the right of this field, but only known (previously used) repositories will be displayed in the list.

**Description**\
Enter an (optional) description of what this favorite does.

**DQL Query**\
Displays the DQL query for this favorite.

### Manage Favorites

The **Manage Favorites** window allows favorites to be edited, deleted, searched, as well as exported/imported to/from external files (for sharing favorites with others for example).

The Manage Favorites window can be accessed from the [Repository Navigator's Favorites Panel](https://docs.dqman.com/opentext-documentum-edition-23.1/repository-navigator#favorites-panel) by right-clicking and selecting the ***Manage Favorites*** item from its context menu.

<figure><img src="https://748143113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ9QWGdnSQRxjUz4KkCwk%2Fuploads%2F8L1WIvT4xxgGr2Uo0XOK%2FCapture.PNG?alt=media&#x26;token=554e8ba3-a031-49bf-ac9f-77bb1e7e6dfb" alt=""><figcaption><p>The Manage Favorites window</p></figcaption></figure>

Favorites can be searched/filtered, using the various properties at the bottom of the window. **Any property** performs a full text search in all available properties. All queries that match the filter criteria are displayed in the center of the window.

The **toolbar buttons** perform the following actions on the selected favorite(s):

<figure><img src="https://748143113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ9QWGdnSQRxjUz4KkCwk%2Fuploads%2FNy3R5ZQXbO4JUUdDYNql%2FCapture.PNG?alt=media&#x26;token=0f723b4e-b515-48dc-9d65-b5edab4a677d" alt=""><figcaption></figcaption></figure>

**Edit** opens the selected favorite for editing (this can also be done by double-clicking a favorite from the list).

**Deletes** the selected favorite.

{% hint style="danger" %}
It is not possible to restore a deleted favorite, so take care when using this action.
{% endhint %}

**Export to File** exports all selected favorites to a file.

**Import from File** imports favorites from a file.