Versions Compared

Key

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


Note

This documentation describes the mapping components provided as part of Weave 2.3, for changes in Weave 2.4 see BIRT Map Updates for Weave 2.4

...

The first is the colour to use to draw highlighted features (this is different from the colour used for drawing selections). This is used inĀ the situation when a single feature within a selection needs to be highlighted in a BIRT report (i.e. when a map is contained within a report that will generate a map image for each selected feature).

The second used when the map is embedded in a dataset and will be covered later.

...

The Location setting for the map determine where the map will be centred and is used in conjunction with the Scale setting to determine what area of the world the map will cover.

There are three choices:

Value

Description

Original

Centre on the area that the user was viewing.
This will ensure that the map covers at least the area the user was looking at, it may be more vertically or horizontally because the size of the map on the page may be different to that of the browser.
There are no input parameters for this option.

Selection

Centre on the current selection.
This will pan the map so that it is centred on the current selection.
This would normally be used in conjunction with the Scale setting of the same name.
There are no input parameters for this option.

Specific

Match an area entered directly.
The report designer must enter the area of the map to be displayed directly.

Scale settings

The Scale setting for the map determine what scale the map will be generated at and are used in conjunction with the Location settings to determine the actual area of the world the map will cover.

There are three choices:

Value

Description

Original

Match the scale that the user was viewing.
This basically does nothing to calculate a scale but instead uses the current location (as set by the Location setting) to determine the map scale.
This may not be the exact scale the the user had selected on the client because of differences in page and screen sizes, if you want the map scale to be exactly what the user was viewing then the Specific value should be chosen for this option and a formula should be used to set the scale.
There are no input parameters for this option.

Selection

Set the scale to ensure the map covers at least the current selection.
This will scale the map so that it displays the current selection.
This would normally be used in conjunction with the Location setting of the same name.
You can also specify the size of a buffer around the selection so that the map covers more of the surrounding area

Specific

Set the scale directly.
The report designer must enter the scale of the map to be displayed directly.

Setting a map scale

Like the DPI setting the scale setting, when set to Specific, allows its value to be set from a formula.

...

Info

In reality unless you specify a map engine id explicitly each layer id is actually suffixed with "/*", which will match any map engine id. This will effectively remove all layers matching the specified name from all map engines.

So using a layer id of "property" is the same as using "property/*".

...