Providing geoscience data globally Navigation
Main content
Bottom links


Home > How to serve a OneGeology WMS > Using ESRI software to serve OneGeology web services > Edit GetCapabilities docs

5.2.2 Edit the GetCapabilities documents

ArcGIS server doesn’t create any static GetCapabilities xml documents, but does allow you to use external files. You will need to use such external files if you want to add any additional spatial reference systems, correct the keywords listing, change the LegendURL images, add better abstracts and layer titles, or add an INSPIRE extended capabilities section. We think to provide a fully compliant WMS it is highly likely that you will need to use a set of static files.

The first step to editing your files is to create them!

The quickest way to do this is to use the response documents from your initial service. You will need to have a file for all the WMS versions that you want your service to support. We would recommend that you have at least a version 1.3.0 document and a version 1.1.1 document; for completeness you could also have a 1.1.0 and 1.0.0 response.

Your WMS version 1.1.1 GetCapabilities document is generated using a request like:

http://[hostname]/ArcGIS/services/[map service title]/MapServer/WMSServer?service=WMS&request=GetCapabilities&version=1.1.1&

Save this as [short service name]111.xml

Your WMS version 1.3.0 GetCapabilities document is generated using a request like:

http://[hostname]/ArcGIS/services/[map service title]/MapServer/WMSServer?service=WMS&request=GetCapabilities&version=1.3.0&

Save this as [short service name]130.xml

It doesn’t really matter what name you give these files, as long as you use the same name prefix for all files that belong to the same service.

You need to put these files on the server (or at a location available to your server), and make them browseable. These files only need to be browseable internally by the ArcGIS server.

Now go back to the ArcGIS Server Manager and edit your service. Select "WMS", then select the "Use External capabilities files" option and in the ‘Specify the location and prefix’ dialog add the web address to the folder containing the capabilities response documents plus your [short service name] prefix.

Using External capabilities files

For example:
For a service called BGS_EN_MARS_GEOLOGY, we may save our initial GetCapabilities response documents using a prefix "MARS-", giving us a file called MARS-130.xml for our version 1.3.0 GetCapabilities response document, MARS-111.xml for our version 1.1.1 GetCapabilities response document, MARS-110.xml for our version 1.1.0 GetCapabilities response document, and MARS-100.XML for our version 1.0.0 GetCapabilities response document. We might then save these to a location on our web server such as C:\Inetpub\wwwroot\ONEGEOLOGY_WMS\BGS_EN_MARS_GEOLOGY\ which would be browseable locally as http://localhost/ONEGEOLOGY_WMS/BGS_EN_MARS_GEOLOGY/. When we select the "Use External capabilities files" option, we then provide the web address and prefix as http://localhost/ONEGEOLOGY_WMS/BGS_EN_MARS_GEOLOGY/MARS-

Having created your files, you may then edit them as required. We would recommend you make a second copy of the files in case you make an error whilst editing.

INSPIRE extended capabilities

The extended capabilites section is inserted into your external GetCapabilities section, between the Exception element block and the first Layer element.

For example to add a scenario 1 INSPIRE extended capabilities section (where you have an external XML document or service that provides such an XML document containing metadata for your WMS service) you would insert a section like below:

<inspire_vs:ExtendedCapabilities xmlns:inspire_vs="">
    <inspire_common:MetadataUrl xsi:type="inspire_common:resourceLocatorType">

Alternatively to add a scenario 2 INSPIRE extended capabilities section (where you have no external metadata document for your WMS service) you would insert a section like below:

<inspire_vs:ExtendedCapabilities xmlns:inspire_vs="">
        <inspire_common:OrganisationName>Mr Matthew Harrison</inspire_common:OrganisationName>
    <inspire_common:MandatoryKeyword xsi:type='inspire_common:classificationOfSpatialDataService'>

In addition (for both scenarios) you will need to  reference the inspire_common schema and namespace   in your root element, so it will become something like:

    xmlns="" xmlns:xsi=""
    xsi:schemaLocation=" http://../arcgis/services/.../MapServer/WmsServer?version=1.3.0%26service=WMS%26request=GetSchemaExtension">

Section last modified: 23 March 2016