# Configuring Document Depots

The second step in configuring JMap Documents is to create and configure document repositories. To do this: 

1. In the **Documents** configuration interface, press **Create** to open the repository configuration window. 
2. Enter a **Name** and **Description** for the repository. 
3. Select the **Depot Type**. You have three choices: \
   \- **File system**: This is a directory located in the server's file system containing documents in the form of files. \
   \- **Hyperlink**: This is a table in the JMap System DB containing hyperlinks to URLs.\
   \- **SharePoint**: This is a connection to Microsoft's SharePoint electronic document management system. 

The creation of the repository differs depending on the repository type, but the subsequent steps are similar for all three repository types.

## Creating a depot

### File system

1. Inform the settings indicated by the **Document Depot Wizard**.

   <table data-header-hidden><thead><tr><th width="221.01809954751133"></th><th></th></tr></thead><tbody><tr><td>Primary depot location</td><td>Specifies the location of the repository in the server's file system. Press <strong>Browse...</strong> to navigate the file system.</td></tr><tr><td>Browsable</td><td>Check this option to allow a JMap Pro application user to navigate the repository.</td></tr><tr><td>Allow sub dirs creation</td><td>Check this option so that the user of a JMap Pro application can create subfolders in the document repository.</td></tr><tr><td>Additional depot locations</td><td><p>Specify other alternative paths to access the repository. </p><p>Press <img src="https://2224254070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDUF1p2rT0hfE3QBlbbvE%2Fuploads%2FwL63hNGrYIrWfI1Nzpl6%2Fajouter-vert.png?alt=media&#x26;token=ed4b55d9-c247-468f-af72-9e1507877d03" alt=""> to add alternative paths.</p></td></tr></tbody></table>
2. Press **Finish** to create the repository and return to the repository configuration interface. The repository name is displayed in the table.
3. Click the repository name to access its configuration interface.<br>

   <table data-header-hidden><thead><tr><th width="224.37226277372264"></th><th></th></tr></thead><tbody><tr><td>General information</td><td>Shows information about the repository, such as its name, ID, description, and status.</td></tr><tr><td>Parameters</td><td>Provides detailed information on the characteristics of the repository.</td></tr><tr><td>Information</td><td>Presents data related to repository synchronization.</td></tr></tbody></table>
4. Press the buttons to access the [Metadata structure](#configuring-the-metadata-structure), [Metadata form](#configuring-the-metadata-form), [Search forms](#configuring-search-forms) and [Permissions](#permissions) configuration interfaces.&#x20;
5. Press the buttons to **Edit**, [Synchronize](https://docs-jmapserver-lima.k2geospatial.com/e/extensions/documents/managing-repositories#synchronizing-repositories) or **Delete** the repository.

### **Hyperlink**

1. In the **Document Depot Wizard** select the **Hyperlink** repository type and press **Finish** to create the repository and return to the repository configuration interface. The repository name is displayed in the table.
2. Click the repository name to access its configuration interface.

   <table data-header-hidden><thead><tr><th width="224.37226277372264"></th><th></th></tr></thead><tbody><tr><td>General information</td><td>Shows information about the repository, such as its name, ID, description, and status.</td></tr><tr><td>Parameters</td><td>Provides detailed information on the characteristics of the repository.</td></tr><tr><td>Information</td><td>Presents data related to repository synchronization.</td></tr><tr><td>Permissions</td><td>Press the button to enter the Permissions configuration interface.</td></tr></tbody></table>
3. Press the buttons to **Edit**, [Synchronize](https://docs-jmapserver-lima.k2geospatial.com/e/extensions/documents/managing-repositories#synchronizing-repositories) or **Delete** the repository.

### **SharePoint**

1. Inform the settings indicated by the **Document Depot Wizard**.

   <table data-header-hidden><thead><tr><th width="246.93975903614455"></th><th></th></tr></thead><tbody><tr><td>URL</td><td>Specify the URL of the library that contains the documents in SharePoint.</td></tr><tr><td>User</td><td>Specify the user with permission to access documents in SharePoint.</td></tr><tr><td>Password</td><td>Specify the password.</td></tr><tr><td>Browsable</td><td>Check this option to allow a JMap Pro application user to navigate the repository.</td></tr><tr><td>Allow sub dirs creation</td><td>Check this option so that the user of a JMap Pro application can create subfolders in the document repository.</td></tr><tr><td>Metadata</td><td>Available metadata is retrieved from SharePoint and displayed on the left. <br>Select the metadata to use for document creation and/or search.</td></tr></tbody></table>
2. Press **Finish** to create the repository and return to the repository configuration interface. The repository name is displayed in the table.&#x20;
3. Click the repository name to enter its configuration interface.

   <table data-header-hidden><thead><tr><th width="224.37226277372264"></th><th></th></tr></thead><tbody><tr><td>General information</td><td>Shows information about the repository, such as its name, ID, description, and status.</td></tr><tr><td>Parameters</td><td>Provides detailed information on the characteristics of the repository.</td></tr><tr><td>Information</td><td>Presents data related to repository synchronization.</td></tr></tbody></table>
4. Press the buttons to access the [Metadata structure](#configuring-the-metadata-structure), [Metadata form](#configuring-the-metadata-form), [Search forms](#configuring-search-forms) and [Permissions](#permissions) configuration interfaces.&#x20;
5. Press the buttons to **Edit**, [Synchronize](https://docs-jmapserver-lima.k2geospatial.com/e/extensions/documents/managing-repositories#synchronizing-repositories) or **Delete** the repository.

The metadata structure comes from the SharePoint server and you do not need to configure it. From the SharePoint metadata structure you can directly configure the [metadata form](#configuring-the-metadata-form) and [search forms](#configuring-search-forms).

## Configuring a depot

These steps are similar for all depot types.

### **Permissions**

You must configure the repository access permissions. To do this, in the repository configuration interface, press **Permissions.**

This section has two tabs: **Permissions** and **Owners**. The owners are the only ones who can manage the administrative permissions for the repository, manage the list of owners and delete it.

A list of users and groups with permissions appears in the **Permissions** tab. Click on ![](https://docs-jmapserver-lima.k2geospatial.com/~gitbook/image?url=https%3A%2F%2F2224254070-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDUF1p2rT0hfE3QBlbbvE%252Fuploads%252F3KaDFt9YF0qzIwNBwAHo%252Fajouter.png%3Falt%3Dmedia%26token%3Dd3e3f51e-5214-4536-b702-4ce2653e254f\&width=300\&dpr=4\&quality=100\&sign=89cced3f\&sv=1) to add new users or groups.

{% hint style="info" %}
Available users and groups are configured in the JMap Server section of JMap Admin. Refer to the [Users and Groups ](https://docs-jmapserver-lima.k2geospatial.com/e/administrator/jmap-server-administrator-manual/jmap-server/security/users-and-groups)section for more information about managing users in JMap Server.
{% endhint %}

Repositories have only user permissions.

<table data-header-hidden><thead><tr><th width="207"></th><th></th></tr></thead><tbody><tr><td>Read</td><td>Allows the user of a JMap Pro, JMap NG or JMap Survey application to open the list of documents or hyperlinks in the repository associated with an element, open a document and download it.</td></tr><tr><td>Save documents</td><td>Allows the user of a JMap Pro application to add a document or hyperlink to the repository from the local server.</td></tr><tr><td>Delete</td><td>Allows the user of a JMap Pro application to delete a document or hyperlink from the repository. </td></tr><tr><td>Associate Files</td><td>Allows the user of a JMap Pro application to associate one or more elements of a layer with one or more elements or hyperlinks of the repository.</td></tr></tbody></table>

### Configuring the metadata structure

{% hint style="warning" %}
This step is for **File System** type repositories only.
{% endhint %}

You must configure the repository metadata structure, that is, the attributes that contain the metadata for each document. This information is stored in a table created by the repository database system. From this structure you can configure the search and metadata forms.

1. In the repository configuration interface, press **Metadata structure**.
2. &#x20;In the **Metadata structure** window, press ![](https://2224254070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDUF1p2rT0hfE3QBlbbvE%2Fuploads%2FwL63hNGrYIrWfI1Nzpl6%2Fajouter-vert.png?alt=media\&token=ed4b55d9-c247-468f-af72-9e1507877d03) to add an attribute.&#x20;
3. Specify the attribute name, SQL type and check the relevant box if the attribute should be indexed.&#x20;
4. Press ![](https://2224254070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDUF1p2rT0hfE3QBlbbvE%2Fuploads%2FwL63hNGrYIrWfI1Nzpl6%2Fajouter-vert.png?alt=media\&token=ed4b55d9-c247-468f-af72-9e1507877d03) to add another attribute or press ![](https://2224254070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDUF1p2rT0hfE3QBlbbvE%2Fuploads%2Fn9eE0ZJEiN21KlwF16p8%2Fsupprimer-vert.png?alt=media\&token=63628468-629d-49ee-b634-c6a73ba06320) to remove an attribute.&#x20;
5. Press **Save** to save the information and close the window.

### Configuring the metadata form

This form allows the user of a JMap Pro application to add or modify the values ​​of the attributes that constitute the metadata of a document, when adding a new document to the repository.

1. In the repository configuration interface, press **Metadata form** to open the **Form layout** interface. JMap form components are available. The Form Layout section of the [JMap Server Administrator's Manua](https://docs-jmapserver-lima.k2geospatial.com/e/administrator/jmap-server-administrator-manual/resources-layers/configuring-layers/forms/configuring-forms#form-layout)l provides details on this topic.&#x20;
2. Select the form components.&#x20;
3. Configure each component by selecting the relevant attribute and its characteristics.&#x20;
4. Press **Save** to save the information and close the window. The form attributes are displayed in the **Metadata form** section in the repository configuration interface.

### Configuring search forms

This form allows the user of a JMap Pro or JMap NG application to search for documents associated with map elements from their metadata.

&#x20;The attributes available in the form are those defined in the [metadata structure](#configuring-the-metadata-structure).&#x20;

To configure a search form:

1. In the repository configuration interface, press **Search forms**.&#x20;
2. Press **Create** to create a new form.&#x20;
3. Specify a name for the form and press **Form layout** to open its configuration window. The Form Layout section of the [JMap Server Administrator's Manua](https://docs-jmapserver-lima.k2geospatial.com/e/administrator/jmap-server-administrator-manual/resources-layers/configuring-layers/forms/configuring-forms#form-layout)l provides details on this topic. &#x20;
4. Select the form components.&#x20;
5. Configure each component by selecting the relevant attribute and its characteristics. **Name** and **Description** attributes are available by default to form a basic search form.&#x20;
6. Press **Save** to save the information and close the window. The created forms are displayed in the **Search forms** interface.