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

...

You can resize the map using the handles directly within the design or you can set the width and height exactly by editing the advanced properties of the map

...

Note

Currently the map size must be set to specific units (cm, pixels, etc) and can not be set as a percentage.

...

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 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.

...

One option when using a formula is to set the formulas value from a parameter that's automatically set by Weave each time a report is generated, the name of this parameter is 'client.scale' and the value for this parameters is always set to the users current map scale at the time of the report generation. So, by setting the Scale formula to

No Formatcode
params['client.scale']

you can ensure that the map in the report will be generated at the same scale that the user was originally using.

...

The parameter will be named scale, if the map doesn't have a name, or <name>.scale if the map does have a name.
The numeric value is directly available as params["scale"] (or params["<name>.scale"]) or a formatted string value available using params["scale"].displayText (or params["<name>.scale"].displayText).

Layers Settings

...

The layers settings allow you to alter the layers that are displayed on the map.

...

Finally by checking the Display only shown layers check box you can provide a list of exactly the layer ids that should be turned on.

...

Layer ids for showing/hiding map layers

...

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/*".

...