Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The minimum setup required for a WMS map engine is the capabilities URL for the service.

...

Name

Type

Cardinality

Description

layers

#layers

0..1

Refine what layers are included in the map description.

sort

#sort

0..1


styles

#style

0..1


crs#crs0..n

Refine what CRSs the map engine lists as being supported, as opposed to including all of them (as there might be thousands of CRSs that the WMS server says that it supports).

Without any crs tags a map engine will report all the projections the WMS server says it supports. By adding one or more crs tag you can refine this list so that the map engine only includes those projections that you're actually interested in using (which helps to improve performance). 

tokens#tokens0..1Additional tokens to add to the request. The tokens available are dependent on the WMS server implementation and are generally used to support implementation specific extensions to the WMS specification.
legend#legend0..1Modify the legend. Available from 2.6.9.

...

Name

Type

Cardinality

remove

#remove

0..1

Examples

...

languagexml
titleFiltering layers to only include specific layers

...

aliases#aliases0..1

aliases

List the new labels to be displayed for a layer

Properties

None

Sub-tags


Name

Type

Cardinality

alias

#alias

1..n


Content

None

alias

A single label change for a layer

Properties


Name

Type

Required

Description

id

string

yes

The id of the layer to change. Note if a match is not found for the id the label of the layer will be then be searched for.

label

string

yes

The new label to display


Sub-tags

None

Content

None

Examples

Code Block
languagexml
titleFiltering layers to only include specific layers
<wms:mapengine id="test">
  <url>http://server/wms/test</url>
  <layers>
    <layer>point1</layer>
    <layer>point2</layer>
    <layer>line1</layer>
    <layer>line2</layer>
    <layer>polygon1</layer>
    <layer>polygon2</layer>
  </layers>
</wms:mapengine>

...

Code Block
languagexml
titleRemove layers from the Editing legend content
<wms:mapengine id="test">
  <url>http://server/wms/test</url>
  <legend>
    <remove>
      <layer>mann:easetxt<<layer>easetxt</layer>
      <layer>mann:house<layer>house_numbers</layer>
    </remove>
    <aliases>
      <alias id="property" label="Properties"/>
    </aliases>
  </legend>
</wms:mapengine>

...

Note

As of version 1.3.7 of the WMS bundle, the password can be encrypted using the OSGi encrypt command.

WMS 1.3.0

Don't "upgrade" to WMS 1.3.0 unless you really have to.

Version 2.15.16 of the com.cohga.server.map.wms bundle (released as part of Weave 2.5.21) improves support for WMS 1.3.0 by supporting map services that require their axis order to be swapped.

...