Report Definitions Adding a map to illustrate a report

You can display the data in a Report Definition using a map, if the data supports that kind of visualization. Map visualizations are useful for reports on "sales by region", "activity by state", "incidents by county", and similar reports.

PRPC includes a wide range of maps for your use. See Maps available for use as charts.

Geographical data may be represented in a variety of ways in customer applications. For example, some customers may have country names spelled out in their databases ("France"), or may use some code ("FR"). Because of this, defining map charts requires an additional step in addition to those normally needed in defining charts, in which a developer specifies how geographic values in the database are mapped to regions on a selected map.

Follow these steps to define a map chart:

1. Specify how geographic values in the database related to regions in a selected map, using the Maps tab of the Reporting Settings landing page.
   1. Click the Pega menu, then select Reporting > Settings > Maps.
   2. In the Map Type field enter a few letters of the name of the map you want to use and click the SmartPrompt icon to see a display of possible matches. Select a specific map.
   3. In the Class field, specify the class of the data you want to display.
   4. In the fields that appear, associate property values with regions of the map.
   5. Click "Save" to save your settings. Close the tab to abandon your edits without saving them.
2. Associate the map with the report:
   1. In the Designer Studio, open the Report Definition rule form and select the Chart tab. You cannot work with a map as the chart for a Report Definition in the Report Browser.
   2. In the control bar, click "All Chart Types".
   3. Select "Map"
   4. In the "Map" field that appears, enter a few letters of the name of the map you want to use and click the SmartPrompt icon. Select the map from the options SmartPrompt presents.
   5. Associate columns with the X and Y axes of the map, as for any chart.
3. Optionally, create a color palette to enhance data display on the map. See the instructions in Working with the Chart Editor, but note that maps use the color palette in a differently than other charts do: if you define a color palette for a map, the map will only use those colors. You can, for instance, define a palette and a map of the United States by state so that the states for which you have no data to display all use the same color.

Note that the preview function is not available when you work directly in the Chart tab of a Report Definition, as you must do when adding a map to a report. Click the Run icon in the Designer Studio control bar to preview the map and the report.

Once the map appears with the chart, you can adjust its colors, the way it displays its data, and other variables. See Working with the Chart Editor.

Report Definition form — Completing the Chart Definition dialog Using the Report Browser

Working with the Chart Editor