Providing geoscience data globally oneGeology logo Navigation
Main content
Bottom links

OneGeology

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, or add better abstracts or layer titles. 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.

Section last modified: 26 April 2011

Back|Next

OneGeology © 2014. This site is hosted by the British Geological Survey but responsibility for the content of the site lies with OneGeology not with the British Geological Survey. Questions, suggestions or comments regarding the contents of this site should be directed to the OneGeology administration.