Data services
Overview¶
A data service is a way to describe and publish one or several API:s.
Create data service¶
To create a data service, go to Data services in the menu and click on "Create".
Then you can enter a Title and Endpoint URL for the data service. For the "Endpoint URL" field, point to the most general open access address to your data service. Avoid linking deeper with intersections in the API.
If you turn on recommended and optional fields, you can describe your data service in more detail. Then click on "Create". More detailed descriptions with additional metadata fields filled in will help other users to easily find, understand and be able to use the data available from your data service.
It is possible to save the description of the data service even if you have not filled in all the required fields. The data service will then appear in the list with a red warning symbol indicating that it is incomplete and it will not be possible to publish the data service until all required fields are filled in.
Create WMS service - example¶
If you would like to create a WMS service in EntryScape Catalog, you need to go through the following steps:
-
Add WMS as a specification document in Catalog, pointing to OGC WMS standard.
-
Find and copy the WMS endpoint link (URL). Create a dataservice and add the endpoint link.
-
Specify that the data service conforms to WMS (the document in step #1).
-
Create a dataset from the newly described data service.
These steps are described in more detail below.
1. Add WMS as a specification document¶
Go to "Documents" and create a new document of the type Specification, and refer to the OGC WMS standard by adding this URL: http://www.opengis.net/def/serviceType/ogc/wms. This is needed for Catalog to correctly interpret the WMS service that will be added next.
2. Copy WMS endpoint URL to data service¶
Find the WMS endpoint you want to use as an EntryScape Catalog WMS service and copy the URL. It may look something like this:
Go to Data services i EntryScape Catalog and click on "Create". Enter a Title and paste the Endpoint URL.
3. Specify that the data service conforms to WMS¶
To specify that the new data service conforms to WMS, turn on “Recommended fields” at the top and scroll or click down to the field “Conforms to”. (On some instances still running DCAT 2, you need to turn on “Optional fields” to see this field.) Choose the WMS specification that you created in step 1. Note that the document has to be of the document type "Standard/Recommendation/Specification" in Catalog to be visible.
You may also click on the magnifier glass, to choose location and document links or files.
Then click on "Create" and your new WMS data service is created.
4. Create a dataset from the WMS service¶
The next step is to create datasets based on the new WMS service. Go to Datasets, click on "Create", and choose Dataset from service.
Next choose your new WMS service.
After that, all layers connected to the WMS service are shown (in this example we see only one layer). Click on "Create" to create a dataset from the layer.
You can then supplement the information about the dataset by filling in a description and selecting a publisher. A distribution will be created automatically when you create the new dataset.
Edit or remove data service¶
You can edit your data service by clicking on the edit pen in the list of data services.
You may also edit the description about your data service or remove it with the Edit and Remove buttons on the overview page for the data service. There you can also see which datasets that are linked to the data service.
See detailed information¶
If you want to see more detailed information about your data service, click on the information icon.
Then you get a popup dialog where you can see metadata such as endpoint URL and dataset the data service serves as well as all entities linking to or from your data service. Read more about detailed information.
Publish data service¶
When you are done describing your data service, you can publish it by clicking the Publish button to make it green.
In the list of data services, the icons then show whether the service is published (green globe) or not published (black crossed-out globe).
