The minimum specification for an OLAPESRIMapChart requires a valid data model. The OLAPESRIMapChart displays a single column of data on a map by coloring the regions of the map based on the response data. The OLAPESRIMapChart can only display one value for each member of a region identifier hierarchy. As a result, you must select a single member for each of the non-geographic hierarchies, and you must select a single measure. This selection is accomplished by setting an array of strings called the crossing, where each string represents the member of each hierarchy. By default, the map viewer selects the first member for each hierarchy and the first measure. For example, your cube contains a Geography hierarchy, a Time hierarchy, a Sales measure, and an Expense measure. If Geography is the region identifier, you can display 2004 sales data for each region by selecting Year=2004 for the Time hierarchy and then selecting the Sales measure.
The OLAPESRIMapChart allows the user to map response information onto an existing ESRI map. The response is linked to the ESRI map by using key values that match those found in a specified field on the ESRI map service. OLAP data specifics
A map chart's data properties are defined in a data model that descends from ESRIMapDataModel, an abstract class whose subclasses provide a handle to the data being used to color the map. ESRIMapDataModel has the following subclasses:
An OLAPESRIMapChart's individual display properties can be set by calling the OLAPESRIMapChart's getGraphModel() method, which returns an ESRIMapModel that can be used to set the desired properties. The ESRIMapModel class contains
An easy way to set an OLAPESRIMapChart's display properties is to apply a pre-defined GraphStyle to the chart. A graph style sets many of the graph's visual characteristics, such as its use of colors, fonts, and background. A graph style can be used as is or modified through the GraphStyle class.
A graph style can be specified as an argument on a OLAPESRIMapChart's constructor. Or, it can be applied to an existing chart by calling the OLAPESRIMapChart's applyGraphStyle() method as follows:
OLAPESRIMapChart mapChart = new OLAPESRIMapChart();
mapChart.applyGraphStyle(new GraphStyle(GraphStyle.STYLE_SCIENCE);
Applying a GraphStyle to a graph propagates the GraphStyle's properties onto all applicable graph properties, including those in the graph model.
Rather than use the style as is, you can modify it before applying it. Modifying the style definition is typically easier and more convenient than modifying the graph's individual display properties. For example, the GraphStyle class contains only a single set of value text propertes. After applying the modified style, you can still adjust individual properties through the graph model.
Whether you set a graph style or individual display properties, the new display settings override any previous settings that were applied to the graph. For example, if a gray background and yellow bar outlines have been set on a graph, and then a style is applied to that same graph, the style's background and outline settings replace the previously set gray background and yellow outlines.
The OLAPESRIMapChart asynchronously updates when a PropertyChangeEvent is received from any of its models (ex. DataModel, GraphModel ).