Generate an OpenCatalog¶

Generate a catalog with OpenCatalog¶

To create an OpenCatalog, simply :

1. In the Administration > Inventory > Sharing menu, click on New;
2. Click on the gear-shaped button ;
3. Select the OpenCatalog application;
4. Select the catalog(s) to be published;
5. Name the share ;
6. Register;

The OpenCatalog consultation URL then appears.

Color settings¶

OpenCatalog can be integrated directly into a website. If you wish to integrate OpenCatalog into your organization's corporate identity, you can select the theme's main color. This is done in the platform's administration menu.

To change the main theme color :

1. In the Administration > Isogeo > Settings menu, change the color.

To return to the default color, click on the cross in the upper right-hand corner of the color widget.

Integrating OpenCatalog into a site (iFrame)¶

OpenCatalog is developed via the Isogeo API. It has been designed to be easily integrated into your existing websites (intranet, extranet, map portal, OpenData portal, IDG, etc.) via an iFrame HTML tag.

Several modes are implemented in OpenCatalog to facilitate display in an iFrame.

• Remove title bar
• Remove services, datasets and resources
• Disable proxy

Remove title bar¶

There is a mode for removing the title bar.

No-header mode¶

To use this mode, simply add ?no-header? as a parameter to the URL.

For example, to integrate the OpenCatalog demo :

<iframe src="https://open.isogeo.com/s/8d491301f61249139918e3710cd39eb7/wak8OBU2hQX6F6rtIe3fWiRCvzFH0?no-header" width=100% height="800"></iframe>

Withdraw services and resources¶

There are five types of plug in the Isogeo API:

• Raster data (and data sets)
• Vector data
• Resource
• Service

If you wish to display only raster and vector data in the results list, you can use the dataset-only mode.

Using dataset-only mode¶

To use it, simply add ?dataset-only to the end of the OpenCatalog url.

For example:

<iframe src="https://open.isogeo.com/s/8d491301f61249139918e3710cd39eb7/wak8OBU2hQX6F6rtIe3fWiRCvzFH0?dataset-only" width=100% height="800"></iframe></a>

Disable proxy¶

OpenCatalog uses a proxy to retrieve information related to map services, despite cross-Origin problems. However, this proxy prevents requests to "local" services (any service only available locally: either directly locally or on an internal server). To access these services from the site, you need to disable the proxy.

Using the no-proxy mode¶

To use this mode, simply add ?no-proxy to the end of the url.

For example:

<iframe src="https://open.isogeo.com/s/8d491301f61249139918e3710cd39eb7/wak8OBU2hQX6F6rtIe3fWiRCvzFH0?no-proxy" width=100% height="800"></iframe>

Authorize Cross Origin requests¶

Disabling the proxy can cause cross-Origin problems. For this reason, OpenCatalog must be allowed access to the server:

Access-Control-Allow-Origin: https://open.isogeo.com

Integrate a single page (iFrame)¶

If you only want to integrate a single form, for example, in a pop-up window, use the ?lock mode.

The following differences from the default version should be noted:

• The title bar is removed
• Navigation from one page to another is disabled: it is therefore impossible to return to the list of catalog data, to click on a keyword or to go to another associated file.

Lock mode¶

To use this mode, simply add ?lock to the end of the file url address.

For example:

<iframe src="https://open.isogeo.com/s/8d491301f61249139918e3710cd39eb7/wak8OBU2hQX6F6rtIe3fWiRCvzFH0/r/66d9aa8eb6d641d28b43632695b69833?lock" width=100% height="800"></iframe></a>