Link Isogeo metadata to Jmap datasources using the JMap/Isogeo connector¶

Prerequisites¶

Isogeo¶

The Isogeo prerequisites are as follows:

1. at least one Isogeo working group;
2. at least one catalog containing at least one metadata, shared between applications (OpenCatalog and Connecteur JMap/Isogeo);
3. a client_secret sent by the Isogeo team to authenticate to the api from JMap Admin.

JMap Server¶

The JMap Server prerequisites are as follows:

1. JMap Server version Kathmandu hotfix 11 or later ;
2. a license including the JMap/Isogeo connector, Jmap Pro and/or JMap NG.

Setting up the JMap/Isogeo connector¶

In Isogeo¶

Here are the steps to follow to set up the JMap/isogeo connector in Isogeo :

1. In the Administration > Inventory > Sharing menu, click on New;
2. Click on the gear-shaped button ;
3. Select OpenCatalog applications and JMap/Isogeo connector;
4. Select the catalog(s) to be published;
5. Name the share ;
6. Save.

In JMap Admin¶

1. Access jmap Admin ;
2. In the extensions tab, open the Isogeo extension;
3. Complete the following four fields in the Configuration section:
4. OpenCatalog URL: URL of the OpenCatalog generated on the Isogeo side, included in the connector share;
5. Customer ID: identifier contained in the authentication JSON file supplied by Isogeo ;
6. Customer secret: customer password contained in the authentication JSON file supplied by Isogeo ;
7. JMap Admin base URL for logging.

Synchronization planning¶

Simply check the Enable scheduler box to schedule the synchronization launch. This step is optional.

Synchronization and results¶

Once the settings have been made, simply click on Synchronize to start synchronization.

Once synchronization is complete, you'll see that the Metadata field has been populated with the URL of the corresponding OpenCatalog record. In fact, this will be the case for all datasources for which a correspondence has been established with an OpenCatalog record.

This will enable you to view your Isogeo metadata records in JMap NG and JMap Pro.

Checking logs¶

After each Synchronization, a log file is generated, accessible in the Logs section of JMap Admin's Isogeo extension. The datasources are classified into three different categories according to the result of the synchronization:

1. Matches: the list of datasources for which a match has been established and for which the Metadata field has been filled in;
2. Mismatches: the list of datasources for which no match could be found;
3. Conflicts: the list of datasources for which a match has been established and for which the Metadata field was already populated.

In the third case, the connector does not overwrite the existing value. It will be necessary to manually delete the existing value, then restart synchronization so that the connector can fill the field with the URL of the corresponding OpenCatalog record.