Working with Studio Reports Maps

Working with Studio Reports Maps

Applies to: Kyvos Reporting


An AmMap is a geographical heat map that visualizes data using color gradients. Color intensity and range help convey varying data values associated with specific regions. Kyvos Reporting Studio provides advanced tools to design and preview AmMaps for geographic data analysis.

Note

AmMaps are created in Kyvos Reporting Studio and can later be viewed and analyzed in Web Studio.

Inserting an AmMap

To insert an AmMap:

  1. On the Kyvos Reporting Studio toolbar, click the Map icon, or go to Insert > Map.

    image-20250725-150544.png
  2. On the canvas, click and drag to define the region for the map.

    image-20250725-150645.png

The map placeholder appears on the layout. You can now configure its properties using the Properties pane.

Map Properties

image-20250725-150735.png

You can configure map properties using either:

  • Detail View: Groups properties under categories.

  • Sort View: Lists properties alphabetically.

The following properties are described using Detail View structure.

Data Properties

image-20250725-151003.png

Property

Description

Property

Description

Connection Name

Select the connection to be used for data retrieval.

Connection Type

Choose the connection type (e.g., SQL, Cube).

Data Source

Select a Query Object or use the SQL Designer to define a custom SQL query.

Runtime Connection Name

Specify the named connection to be used during report execution.

General Properties

image-20250725-151050.png

Property

Description

Property

Description

Area Attributes

Opens a dialog to configure content shown in the balloon tooltip on map areas.

image-20250725-151123.png

 

Define fields and summary functions (e.g., COUNT(Games)), set prefix/suffix, and title.

Area Field

Select the field that defines geography, such as state or country name.

Map Type

Select the map layer based on the data (e.g., World, USA States, Asia Countries).

Heatmap Properties

image-20250725-151200.png

Property

Description

Property

Description

Start Color

Select the color for the lowest data value.

End Color

Select the color for the highest data value.

Summary Function

Choose the aggregation method (e.g., Sum, Avg, Count).

Value Field

Select the numeric field that determines the heat map’s value intensity.

Miscellaneous Properties

image-20250725-151301.png

Property

Description

Property

Description

Name

Unique name for the map control.

Top

Position from the top margin (in pixels).

Left

Position from the left margin (in pixels).

Height

Height of the map control (in pixels).

Width

Width of the map control (in pixels).

Tag

User-defined tag for associating with other controls (optional).

Visible

Set to True to display the map during runtime. Set to False to hide it.

Previewing the Map

To preview the configured map:

  1. Click the Preview tab in Kyvos Reporting Studio.

  2. The report with the map is displayed for review.

    image-20250725-151341.png

Once verified:

  • Save the report.

  • Use the Upload Report icon to publish it to Web Studio.

Note

The report appears in Web Studio with interactive capabilities, including hover-based region highlights and tooltips based on configured attributes.

image-20250725-151501.png

 

Copyright Kyvos, Inc. 2026. All rights reserved.