To specify the spatial data sources to associate documents with:

1. In the Documents section, press Data Sources to open the configuration wizard.

2. Press to add a data source.

3. From the menu, select the Data Source Name and Attribute Name to use to establish the association between each element of the data source and the documents.

4. Press Add to add the data source.

5. Press to add more data sources.

6. Press to delete a data source.

7. Press Save to save the information.

The JMap Server administrator installs the Documents extension by selecting the relevant installation file for his platform.

Once installed, the extension is automatically displayed in the Installed Extensions section of JMap Admin.

JMap Documents contains components for JMap Server and for JMap Pro (client). The extension is therefore displayed in the respective tabs of the Extensions section.

JMap Documents is configured in JMap Admin in three steps:

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

2. Configure the document repositories.

3. Make the extension available in the applications:

   1. Integrate the extension into the JMap Pro application deployment.

   2. Activate the extension in the projects so that the JMap NG and JMap Survey applications can access it.

Integrate JMap Documents into JMap Pro Application Deployment

When configuring a JMap Pro deployment, you must specify the extensions to add to the application. Details are provided in the JMap Pro Applications section of the JMap Server Administrator's Manual.

Enable JMap Documents in Projects

JMap Documents must be enabled in the project so that it can be accessed from a JMap NG or JMap Survey type application. Details are provided in the Projects section of the JMap Server Administrator's Manual.

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.
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.
4. Press the buttons to access the Metadata structure, Metadata form, Search forms and Permissions configuration interfaces.

5. Press the buttons to Edit, Synchronize 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.
3. Press the buttons to Edit, Synchronize or Delete the repository.

SharePoint

1. Inform the settings indicated by the Document Depot Wizard.
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 enter its configuration interface.
4. Press the buttons to access the Metadata structure, Metadata form, Search forms and Permissions configuration interfaces.

5. Press the buttons to Edit, Synchronize 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 and 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.

Repositories have only user permissions.

Configuring the metadata structure

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.

3. Specify the attribute name, SQL type and check the relevant box if the attribute should be indexed.

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 Manual provides details on this topic.

2. Select the form components.

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

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.

The attributes available in the form are those defined in the metadata structure.

To configure a search form:

1. In the repository configuration interface, press Search forms.

2. Press Create to create a new form.

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 Manual provides details on this topic.

4. Select the form components.

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.

6. Press Save to save the information and close the window. The created forms are displayed in the Search forms interface.

The JMap Documents configuration interface displays the table of repositories configured in the extension and provides access to the Create, Synchronize, and Delete repositories functions as well as the section to select the data sources to associate documents with.

You can select multiple repositories to synchronize or delete them in bulk.

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

Synchronizing repositories

This function is also accessible from the configuration interface of each repository.

When JMap Pro application users delete documents or hyperlinks from a repository, they are not automatically deleted from the JMap System DB table; they are still listed there but their status becomes obsolete.

To delete documents and hyperlinks from the System DB table as well as their associations with spatial data sources, you must run the Synchronize function. This is a way to optimize the performance of repositories and the Documents extension.