Create the feature download service

Introduction

The feature download service implements technical guidance (version 3.1) for the implementation of INSPIRE download services. The feature download service supports both predefined and direct download service options through a single WFS 2.0.0-based service type.

When an INSPIRE feature download service is created, two stored queries are automatically created: urn:ogc:def:query:OGC-WFS::GetFeatureById for fetching feature by ID and urn:x-ii:def:query:OGC-WFS::GetDatasetByCrs for fetching data by CRS. These two stored queries can be used to extract predefined datasets through standard WFS 2.0.0 operations, and the service administrator can add additional stored queries if needed.

There is also an Enable direct access option. This option enables direct data download through a standard WFS 2.0.0 getFeature operation without going through the stored query configured by the administrator. This option is disabled by default and can be enabled by the administrator if needed.

The data source that can be used for publishing feature download service is an enterprise geodatabase (see ArcGIS for INSPIRE System Requirements). If the geodatabase is based on the INSPIRE geodatabase template, the features and respective GML encodings follow the INSPIRE data model application schemas. If the data is not yet harmonized, it can be published as is through a compliant feature download service interface (see Create an INSPIRE feature download service using the as-is mode ).

Overview

There are two methods to create, serve, and use an INSPIRE feature download service. One method is to use a map document. If the enterprise geodatabase is using the INSPIRE geodatabase templates, the map document should be created using the INSPIRE desktop add-in. The INSPIRE feature download service can be created by sharing it as a service in the map document. The second method is to set up a connection to the INSPIRE geodatabase, publish it as a geodata service, and enable the INSPIRE feature download service. This topic provides steps for both methods. After setting up the INSPIRE feature download service using either method, you will need to configure its Common and Advanced properties. Once the service is configured, you can use it. See Using the INSPIRE Feature Download Service for more information.

Remarque :

The following steps require a valid INSPIRE geodatabase that includes data. The initial import of source data and the periodic process-controlled update of geodatabase data is not part of INSPIRE.

Method 1: Create the INSPIRE feature download service using a map document

After creating a foundational map document for your feature download service, use the following steps to create the service itself.

1. Dans ArcMap, cliquez sur Fichier > Partager comme > Service.

   La boîte de dialogue Partager en tant que service apparaît.

2. Cliquez sur Publier un service.
3. Choisissez une connexion existante à ArcGIS Server.

   Remarque :

   Si vous n'avez pas encore de connexion, vous pouvez en créer une en sélectionnant l'option de connexion à ArcGIS Server dans la table des matières Catalog.

4. Fournissez un nom de service et sélectionnez le dossier dans lequel le service doit être publié.
5. Cliquez sur Suivant.
6. Dans la boîte de dialogue Editeur de services, cliquez sur Fonctionnalités, puis choisissez Service de téléchargement des entités ArcGIS for INSPIRE.
7. Cliquez sur Publier dans l'angle supérieur droit de la boîte de dialogue Editeur de services.
8. Cliquez sur OK dans la boîte de dialogue Résultats de la publication du service.

   Le service a été publié.

   Remarque :

   Si vous avez publié le service de carte dans un ArcGIS Server fédéré, vous devez partager le service avec tout le monde avant de réaliser les étapes de configuration suivantes.

9. Dans la fenêtre Catalogue, cliquez avec le bouton droit sur le service et sélectionnez Propriétés.

   La boîte de dialogue Editeur de service s'affiche.

10. Sous Fonctionnalités, cliquez sur Service de téléchargement des entités ArcGIS for Inspire.

    La boîte de dialogue Modifier les propriétés de téléchargement des entités Inspire apparaît. Vous allez maintenant configurer le service de téléchargement des entités INSPIRE. La configuration des propriétés consiste à configurer des informations basiques dans la section des propriétés communes et des informations détaillées supplémentaires dans la section des propriétés avancées. Il est également possible d'inclure des requêtes stockées supplémentaires si cela est nécessaire.

11. Configurez les propriétés communes et avancées comme indiqué dans ces sections.
12. Une fois les propriétés définies, cliquez sur OK pour confirmer les changements.

Method 2: Create the INSPIRE feature download service using a geodatabase connection

To create an INSPIRE feature download service based on a geodatabase connection, follow these steps:

1. Démarrez ArcCatalog et créez une connexion de base de données à une géodatabase d'entreprise.
2. Connectez-vous à cette géodatabase.
3. Cliquez avec le bouton droit de la souris sur l'entrée de la connexion et sélectionnez Partager en tant que service de géodonnées.
4. Choisissez une connexion existante à ArcGIS Server.

   Remarque :

   Si vous n'avez pas encore de connexion, vous pouvez en créer une en sélectionnant l'option de connexion à ArcGIS Server dans la table des matières Catalog.

5. Fournissez un nom de service et sélectionnez le dossier dans lequel le service doit être publié.
6. Cliquez sur Suivant.
7. Dans la boîte de dialogue Editeur de services, cliquez sur Fonctionnalités, puis choisissez Service de téléchargement des entités ArcGIS for INSPIRE.
8. Cliquez sur Publier dans l'angle supérieur droit de la boîte de dialogue Editeur de services.
9. Cliquez sur OK dans la boîte de dialogue Résultats de la publication du service.

   Le service a été publié.

   Remarque :

   Si vous avez publié le service de carte dans un ArcGIS Server fédéré, vous devez partager le service avec tout le monde avant de réaliser les étapes de configuration suivantes.

10. Dans la fenêtre Catalogue, cliquez avec le bouton droit sur le service et sélectionnez Propriétés.

    La boîte de dialogue Editeur de service s'affiche.

11. Sous Fonctionnalités, cliquez sur Service de téléchargement des entités ArcGIS for Inspire.

    La boîte de dialogue Modifier les propriétés de téléchargement des entités Inspire apparaît. Vous allez maintenant configurer le service de téléchargement des entités INSPIRE. La configuration des propriétés consiste à configurer des informations basiques dans la section des propriétés communes et des informations détaillées supplémentaires dans la section des propriétés avancées. Il est également possible d'inclure des requêtes stockées supplémentaires si cela est nécessaire.

12. Configurez les propriétés communes et avancées comme indiqué dans ces sections.
13. Une fois les propriétés définies, cliquez sur OK pour confirmer les changements.

Configure common properties

The common properties section appears when you click INSPIRE feature download service capabilities in the Service Editor dialog box.

Supported languages

You can define the language versions to be supported and the default language of the service. The languages supported by a service instance can be configured by clicking the input field Supported languages, and clicking the languages you want from the list. This list includes all languages existing within the geographical limits of INSPIRE. Once selected, the language will be activated for the service. The default language of the service must be chosen from the Default language drop- down menu.

You will need to define further properties by clicking the Advanced Properties button. The properties will need to be specified for all supported languages.

Remarque :

Adding an additional language may cause the requirement for adaptations in localization documents.

The standard mode of operation for the INSPIRE feature download service is active by default and requires INSPIRE–compliant data inside of the enterprise geodatabase. With this mode enabled, the service will expose data that strictly follows the GML application schema on INSPIRE Data Themes.

Enable direct access

This option enables the ability to access data directly through the standard WFS 2.0.0 getFeature operation without going through the stored query configured by the administrator. This option is disabled by default.

Enable stored query management through WFS 2.0.0

This option enables the ability to manage stored queries (including add and delete stored queries) by the user using the standard WFS 2.0.0 operation. This option is disabled by default so users can only access data through stored queries created by the administrator.

Use as-is mode for underlying data

See the detailed description in the section Create an INSPIRE feature download service using the as-is mode regarding this option.

Configure Advanced properties

There are three sections in the Advanced Properties section: properties of the service, contact metadata of the service, and properties for supported feature types. These correspond to sections in the Edit Properties interface and are described in the following table:

Advanced properties of the service

Property item	Description and notes
Title	A title that describes the resource.
Abstract	Short summary for the content of a resource.
Keywords	Terms that capture the essence of the topic (for example, words, expressions or formalized terms, in this case the terms are in regard to INSPIRE terms). It is recommended to use infoMapAccessService , INSPIRE, and Download Service as keywords for the INSPIRE feature download service.
Access constraints	Describes whether an access restriction exists that would protect the privacy or the intellectual property. Also provides a special restriction for accessing resources or metadata. Default-Value: None.
Fees	Default-Value: No conditions apply.
Online resource (http/GET)	The URL under which the service is made available for http/GET requests. This value is prepopulated based on the ArcGIS Server connection details used during the service creation process. Changing this is important if you run the service behind a reverse proxy. This value defines the online resource url for http GET binding advertised by the service in the getCapabilities document.
Online resource (http/POST)	The URL under which the service is made available for http/POST requests. This value is prepopulated based on the ArcGIS Server connection details used during the service creation process. Changing this is important if you run the service behind a reverse proxy. This value defines the online resource url for http POST binding advertised by the service in the getCapabilities document.
Inspire spatial dataset identifier code	Unique Resource Identifier code.
Inspire spatial dataset identifier namespace	Unique Resource Identifier namespace.
Metadata URL	Metadata URL for use by an INSPIRE Discovery Service describing this service instance. URLs that contain characters classified as potentially unsafe in IETF RFC1738 should be encoded as entity reference while entering the URL in the user interface (for example { and } should be encoded respectively as %7B and %7D).
Metadata published at (YYYY-MM-DD)	Publication date of the metadata that describes the service.
Metadata contact organization	INSPIRE is more demanding than ISO 19115 by mandating both the name of the organization and a contact email address. The role of the responsible party serving as a metadata point of contact is out of scope of the Metadata Regulation, but—according to INSPIRE View Service TG 3.0—this property is mandated by ISO 19115.
Metadata contact mail	Metadata contact email, see above.
Service created at (YYYY-MM-DD)	To be compliant with the INSPIRE Metadata Regulation, and with ISO 19115, one of following dates shall be used: date of publication, date of last revision, or date of creation. Date of last revision is preferred. The date shall be expressed in conformity with the INSPIRE Metadata Regulation.
Service last revised at (YYYY-MM-DD)	See above.
Service published at (YYYY-MM-DD)	See above.
Individual temporal extent value covered by the service (YYYY-MM-DD)	See above.
Begin of temporal extent covered by the service (YYYY-MM-DD)	See above.
End of temporal extent covered by the service (YYYY-MM-DD)	See above.
Bounding box: minX value	X value of lower left corner. Used for service bounding box in capabilities response. Default-Value: -180 (if left empty).
Bounding box: minY value	Y value of lower left corner. Used for service bounding box in capabilities response. Default-Value: -90 (if left empty).
Bounding box: maxX value	X value of upper right corner. Used for service bounding box in capabilities response. Default-Value: 180 (if left empty).
Bounding box: maxY value	X value of upper right corner. Used for service bounding box in capabilities response. Default-Value: 90 (if left empty)
Degree of conformity	Choose conformant or not conformant when the conformity to the cited specification has been evaluated. In the case where the evaluation has passed, the degree is conformant; otherwise it is not conformant. Choose not evaluated when the conformity to the cited specification has not been evaluated. The default value is not evaluated.
GEMET keywords	Additional keywords can be defined using the INSPIRE GEMET vocabulary. The keywords chosen here will be added to the KeywordList element.

Contact metadata of the service

The party responsible for the metadata of the INSPIRE feature download service is specified in this section. The interface provides default placeholder values that you should update accordingly.

Supported Feature Types

This part of the dialog box allows you to choose the feature types to be supported by the service. This section is available only when using the INSPIRE geodatabase template. If you set up the feature download service based on an ArcGIS Server Map Service, the number of feature types to be selected is limited to those feature types corresponding to the layers in your map document. For feature download services based on a geodatabase connection, you can check or uncheck those feature types you want to be available/unavailable.

Remarque :

For an As-Is feature download service, the feature type is automatically set as the feature class and table names. The list of available feature types can be configured by modifying the value in wfsUseDataAsIsFeatureTypes through the REST admin page.

Add Stored Query

An administrator can add additional stored queries by clicking the Add Stored Query button. Add stored query can also be done through an HTTP POST operation if the Enable stored query management through WFS 2.0.0 option is enabled.

To Add Stored Query, follow these steps:

1. Click Add Stored Query.
2. Paste the stored query XML into the text field.

   The query XML needs to be in the format conforming to WFS 2.0.0. The following is an example:

   <wfs:CreateStoredQuery service="WFS"
   version="2.0.0"
   xmlns="http://www.opengis.net/wfs/2.0"
   xmlns:fes="http://www.opengis.net/fes/2.0"
   xmlns:gco="http://www.isotc211.org/2005/gco"
   xmlns:gmd="http://www.isotc211.org/2005/gmd"
   xmlns:gml="http://www.opengis.net/gml/3.2"
   xmlns:gml31="http://www.opengis.net/gml"
   xmlns:gsml="http://xmlns.geosciml.org/GeoSciML-Core/3.0"
   xmlns:gsmlbh="http://xmlns.geosciml.org/Borehole/3.0"
   xmlns:gsmlc="http://xmlns.geosciml.org/Collection/3.0"
   xmlns:gsmlem="http://xmlns.geosciml.org/EarthMaterial/3.0"
   xmlns:gsmlga="http://xmlns.geosciml.org/GeologicAge/3.0"
   xmlns:gsmlgm="http://xmlns.geosciml.org/Geomorphology/3.0"
   xmlns:gsmlgt="http://xmlns.geosciml.org/GeologicTime/3.0"
   xmlns:gsmlgu="http://xmlns.geosciml.org/GeologicUnit/3.0"
   xmlns:gsmlla="http://xmlns.geosciml.org/LaboratoryAnalysis-Specimen/3.0"
   xmlns:gsmlpp="http://xmlns.geosciml.org/PhysicalProperties/3.0"
   xmlns:gsmlst="http://xmlns.geosciml.org/GeologicStructure/3.0"
   xmlns:gsmltrs="http://xmlns.geosciml.org/TemporalReferenceSystem/3.0"
   xmlns:gsmlu="http://xmlns.geosciml.org/Utilities/3.0"
   xmlns:ogc="http://www.opengis.net/ogc"
   xmlns:sld="http://www.opengis.net/sld"
   xmlns:swe="http://www.opengis.net/swe/2.0"
   xmlns:wfs="http://www.opengis.net/wfs/2.0"
   xmlns:xi="http://www.w3.org/2001/XInclude"
   xmlns:xlink="http://www.w3.org/1999/xlink"
   xmlns:xs="http://www.w3.org/2001/XMLSchema"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   
   <StoredQueryDefinition id="urn:x-ii:def:query:OGC-WFS::GetDatasetByCrs2">
             <wfs:Title xml:lang="en">Get Dataset by ID</wfs:Title>
          <wfs:Parameter xmlns:wfs="http://www.opengis.net/wfs/2.0" name="CRS" type="xs:anyURI"/>
             <wfs:QueryExpressionText isPrivate="false"
                  language="urn:ogc:def:queryLanguage:OGC-WFS::WFSQueryExpression"
                  returnFeatureTypes="au:AdministrativeBoundary">
                  <wfs:Query srsName="${CRS}" typeNames="au:AdministrativeBoundary">
                  </wfs:Query>                                      
             </wfs:QueryExpressionText>
        </StoredQueryDefinition>
   </wfs:CreateStoredQuery>

3. Click the Test button to validate and test the query XML.
4. If the XML is validated, click Apply to create the stored query.
5. After the stored query has been created, restart the service.
6. Use the stored query following standard WFS 2.0 operation.

Delete Stored Query

To delete a stored query, follow these steps:

1. Click the Show Details button next to a stored query.
2. Click the Delete button, and click OK.
3. Restart the service.

Remarque :

If the Enable stored query management through WFS 2.0.0 option is enabled, predefined queries can be added and deleted through respective WFS 2.0.0 CreateStoredQuery and DropStoredQuery operations.

To manage queries, the ArcCatalog user must have file-level access to the ArcGIS Server config store folder and subfolders. Alternatively, predefined query administration can be managed using standard WFS 2.0.0 web based operations.

Save and reuse INSPIRE service properties

It is possible to save the properties for reuse by other services; for example, you can save the INSPIRE feature download service properties file for reuse, and load it when you start editing another INSPIRE feature download service. The steps are the same as those for an INSPIRE view service. See Create the INSPIRE View service for detailed instructions.

Activation ou désactivation de la mise en cache du document des fonctionnalités

Lorsque l'option de mise en cache est définie sur vrai (configurable), ArcGIS for INSPIRE génère au préalable la réponse getCapabilities au démarrage du service. Ceci optimise le délai de réponse de l'opération getCapabilities, en particulier pour les services dotés d'un grand nombre de couches. La mise en cache est définie sur vrai par défaut. Procédez comme suit pour activer/désactiver la mise en cache :

1. Accédez à la page d'administration REST.

   Par exemple, http://servername:6080/arcgis/admin.

2. Cliquez sur Services.
3. Choisissez le service et cliquez sur Modifier.
4. Recherchez le paramètre cacheGetCapabilities et définissez sa valeur sur true (vrai) ou false (faux).
5. Cliquez sur Save (Enregistrer).

Create and use the custom INSPIRE Feature Download service capabilities document

Si la propriété cacheGetCapabilities est définie sur false (faux), la réponse de l'opération getCapabilities est générée dynamiquement et ne peut pas être remplacée par un fichier de fonctionnalités personnalisé. Cela signifie que toutes les propriétés créées dans les pages des propriétés ArcCatalog sont reflétées dans la réponse.

If the administrator decides to create and use a custom getCapabilities operation response, then the GetCapabilities<version>_<3 letter language code>_custom.xml file needs to be saved at the service cached capabilities folder (for example c:\arcgisserver\directories\arcgisforinspire\GEMR_MapServer\GEMR_MapServer_inspiredownload).

If a custom capabilities file is found in the folder, the file is used to respond to getCapabilities operation requests for that specific version and language level. For example GetCapabilities200_FRE_custom.xml would be used when responding to a getCapabilities operation requests with Language=FRE, version=2.0.0, and service=WFS request parameters. If there is no custom cached file in the directory for that particular language and version configuration, the regular cached getCapabilities files are used to respond. The administrator therefore may choose to use custom cache file for certain version and/or language and use the default for others. Custom cached capabilities files are not deleted when the service is restarted. Only default cached capabilities files are deleted and recreated.

Create an INSPIRE feature download service using the as-is mode

It is possible to publish non-harmonized INSPIRE data stored in an enterprise geodatabase via an INSPIRE-compliant feature download services based on WFS 2.0.0 through the use "as-is" mode for underlying data option within INSPIRE. When this option is enabled, all features are encoded and exposed as-is, and feature types will reflect the feature classes defined by the map document or included in the geodatabase (for geodata service).

To configure the INSPIRE feature download service for the as-is mode, complete the following steps:

1. Click the use "as-is" mode for underlying data option.
2. Provide the prefix for the INSPIRE data.

   The prefix is required. The prefix and layer name together uniquely define the feature type described in the WFS getCapabilities document under the namespace specified in the next step.

3. Provide the namespace for the INSPIRE data.

   The namespace is required.

Remarque :

• When using the as-is mode with an enterprise geodatabase, it is expected that:
  • The a4icommon.xml workspace has been loaded in the gdb
  • The features are using EPSG:4258 coordinate system
  • The person connecting the geodatabase has insert, update, and delete access for the PredefinedDatasets table
• When creating the map document, the .mxd can reference only one geodatabase.
• If publishing the as-is service using the .mxd, those layers in the .mxd will be made available by default. If publishing the as-is service using the geodata service, those layers in the geodatabase will be available by default, and the list of the layers available can be controlled by modifying the value for the wfsUseDataAsIsFeatureTypes parameter through the ArcGIS ServerREST admin page. The syntax of the value is "/featureclassname1/featureclassname2/…/".
• When publishing Feature Download Service with as-is option, a folder within the storedQueries directory in the Inspire-ConfigStore is created, currently when you delete an as-is download service, this folder have to be deleted manually after deleting the service.