Configuring document depots

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.

   Primary depot location	Indicates the location of the depot in the server's file system. Click on Browse... in order to browse the file system.
   Browsable	Select this option to allow JMap Pro users to browse the depot.
   Allow sub dirs creation	Select this option to enable JMap Pro users to create subdirectories in the document depot.
   Additional depot locations	Indicate alternative paths to access the depot. Click on to add alternative paths.

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.

   1	General information: This section displays information on the depot, including its name, its Id, its description, and its status.
   2	Parameters: This section displays detailed information on the depot's characteristics.
   3	Information: This section presents data related to the depot's synchronization.
   4	Click on to access the configuration interfaces for the Metadata structure, Metadata form, Search forms, and Permissions.
   5	When the metadata forms are configured, they are displayed in this section.
   6	These buttons allow you to Edit, Synchronize or Delete the depot.

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.

1	General information: This section displays information on the depot, including its name, its Id, its description, and its status.
2	Parameters: This section displays detailed information on the depot's characteristics.
3	Information: This section displays data related to the depot's synchronization.
4	Click on to access the configuration interface for Permissions.
5	These buttons allow you to Edit, Synchronize or Delete the depot.

SharePoint

1. Enter the information requested by the Document depot wizard.

   URL	Enter the URL of the library containing the documents in SharePoint.
   User	Indicate which user has permission to access the documents in SharePoint.
   Password	Enter the password.
   Browsable	Select this option to allow JMap Pro users to browse the depot.
   Allow sub dirs creation	Select this option to enable JMap Pro users to create subdirectories in the document depot.
   Metadata	The metadata that is available is extracted from SharePoint and displayed on the left. Select the metadata that will be used to create and/or search for documents.

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.

   1	General information: This section displays information on the depot, including its name, its Id, its description, and its status.
   2	Parameters: This section displays detailed information on the depot's characteristics.
   3	Information: This section presents data related to the depot's synchronization.
   4	Click on to access the configuration interfaces for the Metadata form, Search forms, and Permissions.
   5	When the metadata forms are configured, they are displayed in this section.
   6	These buttons allow you to Edit, Synchronize or Delete the depot.

The metadata structure is provided by the SharePoint server, and you must not configure it. From the SharePoint metadata structure, you can directly configure the metadata form and the search forms.

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.

1. In the configuration interface of the depot, click on and then click on Metadata form to open the Form layout interface. The JMap form components are available. The Forms section of the JMap administrator manual provides details on this topic.
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.

3. Enter a name for the form and click on Form layout to open its configuration window. The Forms section of the JMap administrator manual provides details on this topic.
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.