Create the INSPIRE Feature Download Service—ArcGIS for INSPIRE

ArcGIS for INSPIRE implements both Download Service delivery patterns established by the INSPIRE technical guidance (version 3.1). The first, described in this section, provides the Feature Download Service. The other is the INSPIRE Predefined Dataset Download Service based on an Atom implementation.

Learn more about creating INSPIRE Predefined Dataset Download Services

The INSPIRE Feature Download Service supports both predefined and direct download service options through a single WFS 2.0.0-based service type.

The data source that can be used for publishing the INSPIRE Feature Download Service is an enterprise geodatabase (refer to the ArcGIS for INSPIRE system requirements). If the geodatabase is based on the INSPIRE geodatabase templates, 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 INSPIRE Feature Download Service interface.

Learn more about creating an INSPIRE Feature Download Service using the as-is mode

There are two methods for creating, serving, and using 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 extension. The 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 Feature Download Service. This topic provides steps for both methods.

After you set up the INSPIRE Feature Download Service, you need to configure its properties before you can use it.

Note:

The following steps require a valid INSPIRE geodatabase that includes data. The initial import (typically accomplished through extract, transform, and load (ETL)) of source data and the periodic process-controlled update of geodatabase data is not part of ArcGIS Server.

Caution:

You must use ArcMap or ArcCatalog to manage INSPIRE services. ArcGIS Server Manager cannot be used to manage INSPIRE services. Actions such as saving an INSPIRE service using ArcGIS Server Manager will lead to a loss of some INSPIRE specific properties.

Overview

Method 1: Create the INSPIRE Feature Download Service using a map document

After creating an initial ArcMap map document, complete these steps to create the Feature Download Service:

In ArcMap, click File > Share As > Service.
The Share as a Service dialog box appears.
Click Publish a service.
Choose an existing connection to ArcGIS Server.
Note:
If you don't have a connection yet, you can create one by choosing the ArcGIS Server connection option on the Catalog table of contents.
Provide a service name and choose the folder where the service should be published.
Click Next.
In the Service Editor dialog box, click Capabilities and choose ArcGIS for INSPIRE Feature Download Service.
Click Publish at the top right corner of the Service Editor dialog box.
Click OK on the Service Publishing Results dialog box.
The service has been published.
Note:
If you published the Map Service in a federated ArcGIS Server, you must share the service with everyone before proceeding with the following configuration steps.
In the Catalog window, right-click the service and click Service Properties.
The Service Editor dialog box appears.
Under Capabilities, click ArcGIS for Inspire Feature Download Service.
The Editing the InspireFeatureDownload properties dialog box appears. Next, you will configure the properties of the INSPIRE Feature Download Service. This consists of configuring basic information in the Common Properties section and additional detailed information in the Advanced Properties section. You can also include additional stored queries as necessary.
Configure common and advanced properties as discussed in these sections.
After setting the properties, click OK to confirm the changes.

Method 2: Create the INSPIRE Feature Download Service using a geodatabase connection

Complete these steps to create a Feature Download Service based on a geodatabase connection:

Start ArcCatalog, and create a database connection to an enterprise geodatabase.
Connect to that geodatabase.
Right-click the connection entry and click Share as Geodata Service.
Choose an existing connection to ArcGIS Server.
Note:
If you don't have a connection yet, you can create one by choosing the ArcGIS Server connection option on the Catalog table of contents.
Provide a service name and choose the folder where the service should be published.
Click Next.
In the Service Editor dialog box, click Capabilities and choose ArcGIS for INSPIRE Feature Download Service.
Click Publish at the top right corner of the Service Editor dialog box.
Click OK on the Service Publishing Results dialog box.
The service has been published.
Note:
If you published the Map Service in a federated ArcGIS Server, you must share the service with everyone before proceeding with the following configuration steps.
In the Catalog window, right-click the service and click Service Properties.
The Service Editor dialog box appears.
Under Capabilities, click ArcGIS for Inspire Feature Download Service.
The Editing the InspireFeatureDownload properties dialog box appears. Next, you will configure the properties of the INSPIRE Feature Download Service. This consists of configuring basic information in the Common Properties section and additional detailed information in the Advanced Properties section. You can also include additional stored queries as necessary.
Configure common and advanced properties as discussed in these sections.
After setting the properties, click OK to confirm the changes.

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 supported languages and the default language of the service. The languages supported by a service instance can be configured by clicking Supported languages and choosing the ones you want from the list. The 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.

Click the Advanced Properties button to define additional properties. The properties need to be specified for all supported languages.

Note:

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

The Enable direct access option in ArcGIS for INSPIRE allows you to enable direct data downloads 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.

Enable stored query management through WFS 2.0.0

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, as necessary.

The Enable stored query management through WFS 2.0.0 option in ArcGIS for INSPIRE allows you 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

Learn more about creating an INSPIRE Feature Download Service using the as-is mode

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 INSPIRE implementing rules, 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 implementing rules, 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 YYYY-MM-DD format.
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. The minX value must be expressed as a westbound longitude in decimal degrees with a precision of at least two decimals. Default-Value: -180.00 (if left empty).
Bounding box: minY value	Y value of lower left corner. Used for service bounding box in capabilities response. The minY value must be expressed as a southbound latitude in decimal degrees with a precision of at least two decimals. Default-Value: -90.00 (if left empty).
Bounding box: maxX value	X value of upper right corner. Used for service bounding box in capabilities response. The maxX value must be expressed as a eastbound longitude in decimal degrees with a precision of at least two decimals. Default-Value: 180.00 (if left empty).
Bounding box: maxY value	Y value of upper right corner. Used for service bounding box in capabilities response. The maxY value must be expressed as a northbound latitude in decimal degrees with a precision of at least two decimals. Default-Value: 90.00 (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 the corresponding 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.

Note:

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.

Complete these steps to add a stored query: these steps:

Click Add Stored Query.

Paste the stored query XML into the text field.

The following is an example of an XML query in the required format for conformance to WFS 2.0.0:

<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:au="http://inspire.ec.europa.eu/schemas/au/4.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>

Click the Test button to validate and test the query XML.
If the XML is validated, click Apply to create the stored query.
After the stored query has been created, restart the service.
Verify that the stored query was created in the ArcGIS for INSPIRE storedquery configuration folder. For example, C:\a4iconfig\storedQueries\xxx.MapServer.
Use the stored query following standard WFS 2.0 operation.

Delete Stored Query

Complete these steps to delete a stored query:

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

Note:

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

You can save INSPIRE service 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 Download Service. The steps are the same as those for an INSPIRE View Service.

Learn more about creating the INSPIRE View Service

Enable or disable capabilities document caching

When the caching option is set to true (configurable), ArcGIS for INSPIRE will pregenerate the getCapabilities response when the service starts; this will improve the getCapabilities operation response time, especially for services with a large number of layers. Caching is set to true by default. Follow the steps to enable/disable caching:

Go to the REST admin page.
For example, http://servername:6080/arcgis/admin.
Click Services.
Choose the service, and click Edit.
Find the parameter cacheGetCapabilities and set its value to true or false.
Click Save.

Create a custom capabilities file for INSPIRE Feature Download Services

This section describes how custom capabilities can be created and used for Feature Download Services.

When the cacheGetCapabilities property is set to false, the getCapabilities operation response is generated dynamically and can't be overridden by a custom capabilities file. This results in all properties authored in the ArcCatalog property pages being reflected in the response.

If cacheGetCapabilities is set to true, the getCapabilities operation response is generated every time the service is restarted and a capabilities file is cached for each version and supported language.

If the administrator decides to create and use a custom getCapabilities file, it needs to be saved in 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. The name of the file should follow this pattern: GetCapabilities<version>_<three letter language code>_custom.xml. 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

You can 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 in ArcGIS for 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:

Click the use "as-is" mode for underlying data option.
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.
Provide the namespace for the INSPIRE data.
The namespace is required.

Note:

When using the as-is mode with an enterprise geodatabase, it is expected that:

The a4icommon.xml workspace has been loaded in the geodatabase
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 file can only reference one geodatabase.

When publishing the as-is service using an MXD file, the layers in the file are made available by default. When publishing the as-is service using the geodata service, the layers in the geodatabase are made available by default, and the list of the layers available can be controlled by modifying the value for the wfsUseDataAsIsFeatureTypes parameter through the ArcGIS Server REST admin page. The syntax of the value is /featureclassname1/featureclassname2/…/.

When publishing a Feature Download Service with the as-is option, a folder is created in the storedQueries directory in the Inspire-ConfigStore. When you delete an as-is Feature Download Service, the folder must be manually deleted after the service is deleted.

Feedback on this topic?