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.
Nota:
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.
- En ArcMap, haga clic en Archivo > Compartir como > Servicio.
Se abre el cuadro de diálogo Compartir como servicio.
- Haga clic en Publicar un servicio.
- Elija una conexión existente con ArcGIS Server.
Nota:
Si todavía no dispone de conexión, puede crear una eligiendo la opción de conexión de ArcGIS Server en la tabla de contenido de Catálogo.
- Indique un nombre de servicio y elija la carpeta donde debe publicarse el servicio.
- Haga clic en Siguiente.
- En el cuadro de diálogo Editor del servicio, haga clic en Capacidades y elija Servicio de descarga de entidades de ArcGIS for INSPIRE.
- Haga clic en Publicar en la esquina superior derecha del cuadro de diálogo Editor del servicio.
- Haga clic en Aceptar en el cuadro de diálogo Resultados de publicación del servicio.
El servicio se ha publicado.
Nota:
Si publicó el servicio de mapas en un ArcGIS Server federado, debe compartir el servicio con todos antes de continuar con los pasos de configuración siguientes.
- En la ventana Catálogo, haga clic con el botón derecho del ratón en el servicio y haga clic en Propiedades del servicio.
Se abre el cuadro de diálogo Editor del servicio.
- En Capacidades, haga clic en Servicio de descarga de entidades de ArcGIS for Inspire.
Aparece el cuadro de diálogo Edición de propiedades de InspireFeatureDownload. Ahora deberá configurar el servicio de descarga de entidades de INSPIRE. La configuración de las propiedades consiste en configurar la información común básica en la sección Propiedades comunes y la configuración detallada adicional en la sección Propiedades avanzadas. También se pueden incluir consultas almacenadas adicionales, si es necesario.
- Configure las propiedades comunes y avanzadas tal como se explica en estas secciones.
- Después de configurar las propiedades, haga clic en Aceptar para confirmar los cambios.
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:
- Inicie ArcCatalog y cree una conexión de base de datos a una geodatabase corporativa.
- Conéctese a esa geodatabase.
- Haga clic con el botón derecho del ratón en la entrada de la conexión y, a continuación, en Compartir como servicio de geodatos.
- Elija una conexión existente con ArcGIS Server.
Nota:
Si todavía no dispone de conexión, puede crear una eligiendo la opción de conexión de ArcGIS Server en la tabla de contenido de Catálogo.
- Indique un nombre de servicio y elija la carpeta donde debe publicarse el servicio.
- Haga clic en Siguiente.
- En el cuadro de diálogo Editor del servicio, haga clic en Capacidades y elija Servicio de descarga de entidades de ArcGIS for INSPIRE.
- Haga clic en Publicar en la esquina superior derecha del cuadro de diálogo Editor del servicio.
- Haga clic en Aceptar en el cuadro de diálogo Resultados de publicación del servicio.
El servicio se ha publicado.
Nota:
Si publicó el servicio de mapas en un ArcGIS Server federado, debe compartir el servicio con todos antes de continuar con los pasos de configuración siguientes.
- En la ventana Catálogo, haga clic con el botón derecho del ratón en el servicio y haga clic en Propiedades del servicio.
Se abre el cuadro de diálogo Editor del servicio.
- En Capacidades, haga clic en Servicio de descarga de entidades de ArcGIS for Inspire.
Aparece el cuadro de diálogo Edición de propiedades de InspireFeatureDownload. Ahora deberá configurar el servicio de descarga de entidades de INSPIRE. La configuración de las propiedades consiste en configurar la información común básica en la sección Propiedades comunes y la configuración detallada adicional en la sección Propiedades avanzadas. También se pueden incluir consultas almacenadas adicionales, si es necesario.
- Configure las propiedades comunes y avanzadas tal como se explica en estas secciones.
- Después de configurar las propiedades, haga clic en Aceptar para confirmar los cambios.
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.
Nota:
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.
Nota:
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:
- Click Add Stored Query.
- 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> - 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.
- Use the stored query following standard WFS 2.0 operation.
Delete Stored Query
To delete a stored query, follow these steps:
- Click the Show Details button next to a stored query.
- Click the Delete button, and click OK.
- Restart the service.
Nota:
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.
Habilitar o deshabilitar la caché de documentos de capacidades
Si la opción de caché está configurada como verdadera (configurable), ArcGIS for INSPIRE pregenerará la respuesta de getCapabilites al iniciar el servicio. Esto sirve para mejorar el tiempo de respuesta de la operación de getCapabilities, en especial para los servicios que utilizan muchas capas. El uso de la caché está configurado en true de forma predeterminada. Siga los pasos siguientes para habilitar/deshabilitar la caché:
- Acceda a la página de administración de REST.
Por ejemplo, http://servername:6080/arcgis/admin.
- Haga clic en Servicios.
- Elija el servicio y haga clic en Editar.
- Busque el parámetro cacheGetCapabilities y defina su valor como verdadero o falso.
- Haga clic en Save (Guardar).
Create and use the custom INSPIRE Feature Download service capabilities document
Si la propiedad cacheGetCapabilities está definida como falsa, la respuesta a la operación de getCapabilities se genera dinámicamente y no se puede invalidar por un archivo de capacidades personalizado. Esto significa que todas las propiedades creadas en las páginas de propiedades de ArcCatalog se reflejarán en la respuesta.
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:
- 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.
Nota:
- 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.