====== Orbit Web service resource connection file ======

An Orbit Web service resource connection file is a filed based connection to one specific layer of a well defined web service.

Connection file by web service type : 
  * *.owms : Orbit Web Map Service
  * *.owmts : Orbit Web Map Tile Service
  * *.owfs : Orbit Web Feature Service

It is strongly advised to read  the documentation about [[112:technologies:basic_concepts:web_resources|]].


=== Structure ===

An Orbit Web service resource connection file has the following structure:

  * ServerType : "WMS", "WMTS" or "WFS".
  * ServerName : free of choice - Web service name as labeled in Orbit.
  * ServerURL : service url
  * DataSetName : <layer name> or <layer order reference>
    * <layer name> : value of service FeatureType Name tag in the FeatureTypeList.
    * <layer order reference> : "[i]", were i is the order of the layer it the web service FeatureTypeList.
  * UserName : username credentials if applicable.
  * Password : password credentials if applicable.
  * PreferredCRS : <EPSG code> - optionally for WMTS only -  set fix coordinate reference system to be used.
  * StaticContent :  "true" or "false" - optionally for WFS only - optimize caching and reduce web feature requests.

=== Reason to use ===

Compared to establishing a web service connection and loading the layer via the [[112:orbit_desktop:library:index|Resource Browser]], this alternative way of loading a web service layer has following advantages : 
  * Web service layers are manageable as file based resources like other supported formats.
  * Easy to share with Orbit users.
  * Possibility to create and associate an [[112:technologies:resources:other:olg|Orbit Legend]].
  * Additional configuration possibilities like preferred crs, static content and spatial format, see below.

=== Create ===

Create and edit these files using a text editor. Take care of spelling and file syntax.

=== Examples ===

<code>
ServerType	WMS
ServerName	NASA JPL
ServerURL	http://wms.jpl.nasa.gov/wms.cgi?Service=WMS&Version=1.1.1&Request=GetCapabilities
DataSetName	global_mosaic
UserName	
Password	
</code>

<code>
ServerType	WMTS
ServerName	Agiv_WTMS
ServerURL	http://grb.agiv.be/geodiensten/raadpleegdiensten/geocache/wmts?service=WMTS
DataSetName	ortho2007
UserName	
Password	
PreferredCRS	31370	
</code>

<code>
ServerType	WFS
ServerName	www.ruimtemonitor.be
ServerURL	http://www.ruimtemonitor.be/geoserver/rm/wfs?service=wfs&request=getcapabilities&version=1.1.0
DataSetName	rm:m06_woonwerkafstand_mmm
UserName	
Password	
</code>