# Collections (& Presentations)

## Working with Collections

There are multiple ways to **create** collections and **add records** to collections. The most common one is to use the little **plus button** on the lower left in the quick access. Click on the plus button to create a new collection on the top level. You can **drag** any collection on another collection to **move** the collection below another collection. Alternatively you can use the **right click** on a collection to create a new collection below the selected one (see [options](#collection-options)).

In the search result you can also use the **right click** on single records or on a selection of records to create a new collection on top level ("**Add to new collection**") and add them to the newly created collection. When in the search result, you can also select one or multiple records and **drag them onto a collection** in the quick access to add them to already existing collections. Use the right click on single or multiple records in the search, go to "**Remove from collection**" and click on the collection you want to remove the records from.

When dragging records from one collection to another, you can choose if the records should be **copied** to the other collection (and remain in the opened collection) or **moved** to the other collection (and be removed from the collection you're currently viewing).

To view the content of a **collection** side by side with the **search result**, open the collection and then click on the **little icon** on the upper right next to the "X". Click the same icon again, to close the split view. Click on the "**X**" or the name of the collection in the quick access to **close** the collection.

## Collection Detail

**Click** on a collection or presentation to open the collection and **view it's content**.

You can choose between two views:

<table><thead><tr><th width="164.810615199035">VIEW</th><th width="179">OPTIONS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Standard View</td><td></td><td>By default, preview images of the records in the collection are shown along with the standard info. You can choose between different preview sizes, etc.</td></tr><tr><td></td><td>&#x3C;see here></td><td></td></tr><tr><td>Compare View</td><td></td><td>In the compare view, the full details of the records will be shown next to each other. You can scroll left/right and are able to compare the files and/or the data of the records in the collection.</td></tr><tr><td></td><td>Show</td><td>Choose if you want to show and compare both "Files &#x26; Data", "Only Files" or "Only Data" of each record.</td></tr><tr><td></td><td>Records per Page</td><td>Choose how many records should be shown per page. A navigation will appear on the lower right.</td></tr></tbody></table>

## Collection Options

Use the **right click** on a collection or the **three dot menu** in the collection detail to access the following **options**:

<table><thead><tr><th width="236.21052631578948">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Select all (up to 1.000)</td><td>Select all records of the collection. Only works with up to 1.000 records, otherwise this option is disabled.</td></tr><tr><td>Show in Search</td><td>Shows all records of the collection in the main search so that they can be filtered.</td></tr><tr><td>Open in Fullscreen</td><td>Opens the fullscreen mode so that all records can be viewed.</td></tr><tr><td>Create Presentation</td><td>Turns the collection into a presentation. For all options <a href="#presentation-settings">see below</a>.</td></tr><tr><td>Upload</td><td>Only available for collections with <a href="#upload-and-file-system-connect">upload enabled</a>. Click to upload files into this collection.</td></tr><tr><td>Download</td><td>Click to open download settings and download all files of this collection.</td></tr><tr><td>Export</td><td>Click to open the export settings and export all records of this collection.</td></tr><tr><td>Print</td><td>Click to open the print settings and download a pdf file with all records of the collection.</td></tr><tr><td>Share Collection</td><td>Click to open the <a href="#sharing">sharing options</a>.</td></tr><tr><td>Settings</td><td>Click to open the <a href="#collection-settings">settings</a> of the collection.</td></tr><tr><td>Rename Collection</td><td>Click to rename the collection without opening the settings.</td></tr><tr><td>Create New Collection</td><td>Click to create a new collection below the current collection.</td></tr><tr><td>Copy Collection</td><td>Click to copy the collection.</td></tr><tr><td>Delete Collection</td><td>Click to delete the collection.</td></tr></tbody></table>

## Collection Settings

### General

On the first tab some **general settings**, like the **name** and a **description** of a collection can be found.

<table><thead><tr><th width="172.83112183353438">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Owner</td><td>The owner / creator of the collection. Will be set automatically when a user creates a collection. Can't be changed.</td></tr><tr><td>Name</td><td>Name of the collection. Is shown in the quick access.</td></tr><tr><td>Description</td><td>Description of the collection.</td></tr><tr><td>Default View</td><td>Default view for the records in the collection. Will be used when opening a collection. See <a href="#collection-detail">collection detail</a>.</td></tr><tr><td>Short Name</td><td>Short name of the collection. Has to be unique.</td></tr><tr><td>Reference</td><td>Reference of the collection. Has to be unique.</td></tr><tr><td>Collection Link</td><td>The link to the collection.</td></tr></tbody></table>

### Sharing

By sharing a collection you can give other users, groups or anonymous users **access to a collection and its content** and grant them permissions they'd usually wouldn't have. Collections can be shared with multiple users by adding multiple permissions.

{% hint style="info" %}
Please note: users require the system right "**Collection Sharing**" to be able to share collections and they can only share the permissions they are allowed to ("**grantable**" has to be set for each permission they should be able to share with others).
{% endhint %}

Use the **plus** button on the bottom left and choose between:

<table><thead><tr><th width="295.5">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Share with user/group/email</td><td>Choose this option when you want to share the collection with a specific user, a user group or with an email that doesn't exist in the system yet. Only users with the system right "<strong>Create email user</strong>" are allowed to share a collection with an email as this creates a user account for the email.</td></tr><tr><td>Create anonymous sharing link</td><td>Choose this option when you want to create a link for external users that don't have and don't require a user account. Everyone who has this link can access the collection.</td></tr></tbody></table>

For **each share** you have the following **options**:

<table><thead><tr><th width="222.8347613219094">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>User/Group/Email</td><td>Choose a specific user, a user group or an email that doesn't exist in the system yet to share the collection with. Only users with the system right "<strong>Create email user</strong>" are allowed to share a collection with an email as this creates a user account for the email.</td></tr><tr><td>Permission Preset</td><td>Choose a permission preset. Presets can be defined by administrators. If no preset is available, please use the additional options to set the permissions for the recipient.</td></tr><tr><td>Expiration Date</td><td>Define a date when the share should automatically expire so that the user will not be able to access the collection anymore. The expiration date can be adjusted afterwards. If no expiration date is set, the share is valid indefinitely.</td></tr><tr><td>Email</td><td>Activate to send an email to the recipient (provided that the user has specified an email).</td></tr><tr><td>Link</td><td>Either copy or open the sharing link.</td></tr><tr><td>Options</td><td>Open additional sharing options (see next table).</td></tr></tbody></table>

The **additional options** include:

<table><thead><tr><th width="210.90919409761636">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Active</td><td>Activate or deactivate the share.</td></tr><tr><td>User / Group / Email</td><td>Choose a specific user, a user group or an email that doesn't exist in the system yet to share the collection with. Only users with the system right "<strong>Create email user</strong>" are allowed to share a collection with an email as this creates a user account for the email.</td></tr><tr><td>Starting Date</td><td>Define a date when the share should automatically start so that the user will be able to access the collection. If no starting date is set, the share is directly valid.</td></tr><tr><td>Expiration Date</td><td>Define a date when the share should automatically expire so that the user will not be able to access the collection anymore. The expiration date can be adjusted afterwards. If no expiration date is set, the share is valid indefinitely.</td></tr><tr><td>Persistent</td><td>Activate this checkbox to prevent this share from being disabled on a subordinate collection.</td></tr><tr><td>Send Email</td><td>Sends an email with the sharing link to the recipient (provided that the user has specified an email).</td></tr><tr><td>Language</td><td>Displays the language that's used for the email.</td></tr><tr><td>Message</td><td>Enter a message that should be included in the email notification.</td></tr><tr><td>Permissions</td><td>Chose a permission preset or define individual permissions (only available for users with the system right "<strong>Allow to set custom sharing permissions</strong>".</td></tr></tbody></table>

You can change the **order** of the shares by using the **drag** handle at the beginning of each permission. This does not affect the permissions, it's just a visual change. The shares and sharing links are **valid indefinitely** **unless** the **expiration date** has been reached, the share has been **disabled** (in the additional options) or the share was **deleted** (using the "**minus**" on the bottom of the sharing menu).

Use the "**Copy row**", "**Copy all rows**" and "**Paste rows**" to copy & paste permissions within a collection. Copying an anonymous sharing link will result in a new sharing link with the same settings.

As an additional protection a **pin code** can be set for a collection. Users who open the collection have to **enter** the pin code to **get final access** to the collection and its content. The pin code has to be at least **3 characters** long and can consist of numbers, letters and special characters.

By default, permission will be **inherited** by the subordinate collections, meaning the permissions you define for a collection also grant users access to the subordinate collections. Activate "**Ignore permissions of the superordinate collections**" so that the permissions are not inherited from above.

Use "**Activate**" to save the changes and prevent the dialogue from closing. Use "**Save**" to save your changes and close the dialogue.

### Upload Settings

**Collections** can be used to **upload** bulks of **files**. Files can either be **dropped** on the collection in the **frontend** or in the **Hotfolder** or **File System Connect** (without having to use the FYLR frontend). All files will be **imported** to FYLR and **linked** to the **collection**.\
\
More details can be found in the following tutorials and below you find a detailed description of the settings:

* [Difference Between Hotfolder and File System Connect](https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect)
* [Preparations Before Usage](https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect/preparations-before-usage) (fo system administrators)
* [Setting Up an Upload Collection](https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect/setting-up-an-upload-collection)
* [Importing Files](https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect/importing-files)

#### Settings

You can define if new **records** should be **created** for each uploaded file, or if already existing records should be **updated** with the uploaded file. Use the following **settings** to define the **behavior** of the upload.

{% hint style="info" %}
To set up an upload collection, the user needs the **permissions** to create records and "read" permission for at least one pool.
{% endhint %}

<table><thead><tr><th width="228.61872909698997">OPTION</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Enable Upload</td><td>Enables the upload feature for this collection.</td></tr><tr><td>URLs</td><td>Open a http(s) URL with a webdav client. Browsers are not webdav clients. See our <a href="https://docs.fylr.io/tutorials/how-to-set-up-the-hotfolder-and-file-system-connect">tutorials </a>for more. URLs containing the word <code>hotfolder</code> are for <strong>Upload</strong> and URLs containing the word <code>WebDAV</code> are <strong>File System Connect</strong>.</td></tr><tr><td>Object Type</td><td>Select the object type that should be used when creating or updating records.</td></tr><tr><td>Pool</td><td>Select the pool the files should be created in.</td></tr><tr><td>Mask</td><td>Choose a mask that should be used.</td></tr><tr><td>Field for Files</td><td>Choose the upload field that should be used.</td></tr><tr><td>Metadata Mapping</td><td>Select the metadata mapping that should be applied when uploading files.</td></tr><tr><td>Method</td><td>Define what should happen, when files get updated to the collection.<br>"Create new records": only create new records for all uploaded files.<br>"Update existing records": only updates existing records that were found by matching the filename (see below).<br>"Create new records and update existing records": updates existing records if found, otherwise creates a new record for the file.</td></tr><tr><td>Field to Match Filename</td><td>Only available for method "Update". Choose a field that matches with the filename of the uploaded files to update files of existing records.</td></tr><tr><td>File Upload Policy</td><td>Only available for method "Update". Choose what should happen, when the records that should be updated already have a file.<br>"Create new preferred asset version": uploads the file to the existing record, marks it as preferred and keeps the current file.<br>"Create new asset version": uploads the file to the existing records but keeps the current file as the preferred version.<br>"Replace file": uploads the file to the existing record and removes the current file.<br>"Refuse": refuses the uploaded file if the record that should be updated already has a file.</td></tr><tr><td>Tags</td><td>Tags that should be set automatically when creating new records.</td></tr></tbody></table>

## Presentation Settings

Collections can be turned into presentations by clicking on "**Presentation**" in the context menu of a collection. The content of the collection can be organized on **slides**, **presented** **online** and **downloaded** as a Microsoft **PowerPoint** file (.pptx).

{% hint style="info" %}
Please note, to download the presentation as a Microsoft PowerPoint file, the plugin "easydb-presentation-pptx-plugin" has to be enabled in the Plugin Manager.
{% endhint %}

You can choose between the following **slide types** when adding new slides using the little **plus button** in the overview:

<table><thead><tr><th width="264.5">TYPE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>Text only</td><td>Adds a new slide with a headline and a text field.</td></tr><tr><td>One record</td><td>Adds a new slide where you can place one record.</td></tr><tr><td>Two records</td><td>Adds a new slide where you can place two records next to each other.</td></tr><tr><td>One record &#x26; text</td><td>Adds a new slide where you can place one record and add a text next to it.</td></tr><tr><td>Add all missing records</td><td>Adds a new slide (type "One record") for each (remaining) record.</td></tr></tbody></table>

Slides can be **deleted** by clicking the little **minus button** in the overview whereas the little **bin** icon on the slide only r**emoves the record** **from the slide**. Use **drag & drop** to change the **order** of the **slides**. For records with **multiple files**, a little navigation appears in the lower left of the presentation and lets you **choose** the file you want to display. Add the same record to another slide to display another file from the record.

In the **options** of the presentation (click the **settings** **icon** in the overview) you can define if the **standard info** of each record should be shown as a caption below the record in the presentation (default) or not.

Click on "**Start presentation**" to enter the fullscreen mode and **view** the presentation in your **browser**. You can **navigate** the slides by using the **keyboard** (left & right and space goes to the next slide) or the "**left**" and "**right**" buttons on the bottom of the screen. Click on "**Detail**" to open the detail view of the shown record and access all available data. To **close** the presentation, click on the "**X**" in the upper right corner.


---

# 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.fylr.io/for-users/quick-access/collections-and-presentations.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.
