Follow these steps to select the spatial data sources to which documents can be associated:

1. In the Extensions/Documents section, click on and then on Data sources to open the configuration wizard.

2. Click on to add a data source.

3. In the menu, select the Data source name and the Attribute name to use in order to establish the association between each element of the data source and the documents.

4. Click on Add to add the data source.

5. Click on to add other data sources.

6. Click on Save to save the data.

Integrate JMap Documents into JMap Pro application deployment

When configuring a JMap Pro type deployment, you must indicate the extensions to add to the application. Details are offered in the JMap Server Administrator Manual.

Enable JMap Documents in projects

JMap Documents must be activated in the project so that it can be accessed from a JMap NG or JMap Survey type application. Details are offered in the JMap Server Administrator's Guide section.

The second step to configuring Documents consists of creating and configuring the document depots. To do so:

1. In the Extensions/Documents section, in the Server tab, click on Documents to open the configuration interface.

2. Click on Create to open the depot configuration wizard.

3. Enter a Name and a Description for the depot.

4. Select the Type of depot. Three options are available:

   File system: A directory located in the server's file system, which contains documents in the form of files.

   Hyperlink: A table in JMap's System database, which contains hyperlinks to URLs.

   SharePoint: A connection to the Microsoft SharePoint electronic document management system.

The steps to create a depot vary depending on the type of depot, but the subsequent steps are similar for all three types of depots.

Creating a depot

File System

1. Enter the information requested by the Document depot wizard.
2. Click on Finish to create the depot and return to the depot configuration interface. The name of the depot is displayed in the table.

3. Click on the name of the depot to access its configuration interface.

Hyperlink

1. In the Document depot wizard, select Hyperlink as the Type, and click on Finish to create the depot and return to the depot configuration interface. The name of the depot will be displayed in the table.

2. Click on the name of the depot to access its configuration interface.

SharePoint

1. Enter the information requested by the Document depot wizard.
2. Click on Finish to create the depot and return to the depot configuration interface. The name of the depot is displayed in the table.

3. Click on the name of the depot to access its configuration interface.

Configuring a depot

These steps are similar for all types of depots.

Configuring permissions

You must configure the permissions for accessing the depot. To do so, in the depot configuration interface, click on and then on Permissions:

1. In the Permissions tab, click on to open the Available users window and add the user(s).

2. In the users table of the Permissions tab, select the users.

3. Tick the boxes of the permissions you wish to grant to the selected users. The following permissions are available:

   • Read: Allows a JMap Pro, JMap Web or JMap Survey user to open the list of documents or hyperlinks of the depot associated with an element, to open a document, and to download it.

   • Register documents: Allows a JMap Pro user to add a document or a hyperlink to the depot from the local server.

   • Delete: Allows the user of a JMap Pro application to delete a document or a hyperlink from the depot.

   • Associate: Allows a JMap Pro user to associate one or more layer elements with one or more elements or hyperlinks from the depot.

4. Click on Save.

Configuring the metadata structure

This step only applies to File System depots. You must configure the depot's metadata structure, i.e. the attributes containing the metadata of each document. This information is stored in a table created by the depot's database system. From this structure, you can configure the search and metadata forms.

1. In the depot configuration interface, click on and then click on Metadata structure.

2. In the Metadata structure window, click on to add an attribute.

3. Enter the name of the attribute, select its SQL type, and select the check box if the attribute must be indexed.

4. Click on to add another attribute or click on to eliminate an attribute.

5. Click on Save to save the information and close the window.

Configuring the metadata form

This form allows a JMap Pro user to add or edit the attribute values that constitute the metadata of a document when that user adds a new document to the depot.

2. Select the form components.

3. Configure each component by selecting the relevant attribute and its characteristics.

4. Click on Save to record the information and close the window. The form attributes are displayed in the Metadata form section (section 5 in the figure above) in the depot configuration interface.

Configuring the search forms

This form allows a JMap Pro or JMap Web user to search for documents associated with map elements using their metadata. The attributes available in the form are the attributes that were defined in the metadata structure. To configure a search form, follow these steps:

1. In the depot configuration interface, click on and then on Search forms.

2. Click on Create to create a new form.

4. Select the form components.

5. Configure each component by selecting the relevant attribute and its characteristics. The Name and Description attributes are available by default to create a basic search form.

6. Click on Save to record the information and close the window. The forms you created are displayed in the Search forms interface.

The depot configuration interface contains a table that displays the depots configured in the Documents extension. From this interface, you can also Create, Synchronize and Delete depots, and select the data sources to which documents can be associated by clicking on . You can select several depots to synchronize them or delete them in batches.

The table displays the name, status, platform, last update time, and internal ID of each depot.

Synchronizing depots

This function can also be accessed from the configuration interface of each depot.

When JMap Pro users delete documents or hyperlinks from a depot, these elements are not deleted from the table in JMap's System database; they remain listed in the table but the "obsolete" status is assigned to them. In order to delete documents, hyperlinks, and their spatial data source associations from the System database table, you must execute the Synchronize function. This is a way to optimize the performance of depots and of the Documents extension.

The JMap Server administrator installs the extension by selecting the installation file for the platform used. Once it is installed, the extension is automatically displayed in the Extensions section of JMap Admin. The Documents extension contains components for JMap Server, JMap Pro (client), and JMap Web. The extension is therefore displayed in the respective tabs of the Extensions section.

To configure Documents in JMap Admin, follow these three steps:

1. Indicate the spatial data sources to which documents can be associated.

2. Configure the document depots.

3. Integrate the extension when deploying JMap Pro and/or JMap Web applications.