How to Associate a Pivot Filter Bar with a Pivot Table

27-2 Web User Interface Developers Guide for Oracle Application Development Framework ■ Color: Applies to regions. For example, a color theme might identify a range of colors to represent the population in the states of a region or the popularity of a product in the states of a region. A map can have multiple color themes visible at different zoom levels. For example, a color theme at zoom levels 1 to 5 might represent the population of a state, and the county median income at zoom levels 6 to 10. ■ Point: Displays individual latitudelongitude locations in a map. For example, a point theme might identify the locations of warehouses in a map. If you customize the style of the point that is displayed, you might choose to use a different image for the type of inventory electronics, housewares, garden supplies in a set of warehouses to differentiate them from each other. ■ Graph: Creates any number of pie graph themes and bar graph themes. However, only one graph theme can be visible at a given time. You select the desired theme from the View menu of the map toolbar. Graph themes can show statistics related to a given region such as states or counties. For example, a graph theme could display the sales values for a number of products in a state. Figure 27–1 Geographic Map of Southwest US with Color, Point, and Pie Graph Themes

27.1.2 Geographic Map Terminology

The following list gives a brief description of the terminology used in a geographic map: ■ Base map: Provides the background geographic data, zoom levels, and the appearance and presence of items such as countries, cities, and roads. The base map can be any image that can be configured using a map viewer and map builder, for example, the floor maps of office buildings. ■ Zoom control: Consists of pan icons and a zoom slider that render in the upper left-hand corner of the map. Figure 27–2 shows a map zoom control that is Using ADF Geographic Map Components 27-3 zoomed-out all the way that is, the zoom level is set to 0. At zero, the entire map is displayed. You can customize the location and the initial setting of the zoom control in the dvt:map tag. The View menu which appears in the map toolbar just above the sample map lets you determine the visibility of the zoom control. By default, the initial zoom level for a map is set to 0. Figure 27–2 Zoom Control of a Map – Pan icons: Consists of icons with arrows that point north, south, east, west, northeast, northwest, southeast, and southwest at the top of the zoom control. You can use these icons to move the entire map in specific directions. – Zoom slider: Consists of a slider with a thumb for large scale zooming and icons for zooming a single level. You can use the plus icon to zoom in and the minus icon to zoom out one level at a time. When the thumb is at the bottom of the slider, the zoom level is zero. ■ Scale: Consists of two horizontal bars that display in the lower left-hand corner of the map below the information panel and above the copyright. Figure 27–3 shows the scale. The top bar represents miles mi and the bottom bar represents kilometers km. Labels appear above the miles bar and below the kilometers bar in the format: [distance] [unit of measure]. The length and distance values of the bars change as the zoom level changes and as the map is panned. Figure 27–3 Map Information Panel, Scale, and Copyright ■ Information panel: Displays latitude and longitude in the lower left-hand corner above the scale. Figure 27–3 shows the information panel. By default, the information panel is not visible. You can display this panel from the View menu or by clicking the Information button on the toolbar. ■ Measurement panel: Displays either distance, area, or radius depending on which tools in the toolbar are currently in use. Text appears in the following format: [label] [value] [unit of measure] to the right of the information panel. Figure 27–4 shows the measurement panel with a distance measurement. Area measurement and radius measurement appear in a similar manner with the appropriate labels. 27-4 Web User Interface Developers Guide for Oracle Application Development Framework Figure 27–4 Map Measurement Panel Beside the Information Panel The following tools provide information in the measurement panel: – Area measurement: Appears only when the Area, Rectangular Selection, or Multi-Point Selection tools are active. – Distance measurement: Appears only when the Distance tool is active. – Radius measurement: Appears only when the Circular Selection tool is active. ■ Copyright: Appears in the lower left-hand corner of the map and contains text that you can customize in the dvt:map tag. ■ Overview map: Consists of a miniature view of the main map as shown in Figure 27–5 . This map appears in the lower right-hand corner of the main map and lets you change the viewable region of the main map without having to use the pan tool or the pan icons. Figure 27–5 Overview Map The following items are part of the overview map: – Reticule: Appears as a small window that you can move across a miniature view of the main map. The position of the reticule in the miniature map determines the viewable area of the main map. As you move the reticule, the main map is updated automatically. – ShowHide icon: Appears in the upper left-hand corner when the overview map is displayed. When you click the ShowHide icon, the overview map becomes invisible and only the icon can be seen in the lower right corner of the main map. ■ Toolbar: Contains the following elements in the sequence listed: – View menu: Lets you control which themes are visible, select a specific theme for display, and determine the visibility of the zoom control, legend, and the information panel. – Toolbar buttons: Provide the following tools for interaction with the map: Pan, Zoom In, Zoom Out, Rectangular Selection, Circular Selection, Polygon Selection, Point Selection, Distance, Area, Legend, and Information.

27.1.3 Geographic Map Component Tags

The geometric map has parent tags, map child tags, and tags that modify map themes. Using ADF Geographic Map Components 27-5

27.1.3.1 Geographic Map Parent Tags

The map component includes the following parent tags: ■ Map tag dvt:map: The parent tag for the main map component. Unlike other data visualization parent tags, the map tag is not bound to data. Instead, all the map theme child tags are bound individually to data collections. The map tag contains general information about the map including the identification of the base map, the URL for the remote server that is running Oracle Application Server MapViewer service and the URL for the Geocoder web service that converts street addresses into longitude and latitude coordinates for mapping. For a list and description of the child tags, see Section 27.1.3.2, Geographic Map Child Tags. ■ Map toolbar dvt:mapToolbar: A parent tag that allows the map toolbar to be placed in any location on a JSF page that contains a map. This toolbar contains a mapID attribute that points to the map associated with the toolbar. The toolbar lets you perform significant interaction with the map at runtime including the ability to display the map legend and to perform selection and distance measurement. The map toolbar tag has no child tags.

27.1.3.2 Geographic Map Child Tags

The dvt:map tag has the following child tags: ■ Color theme dvt:mapColorTheme: One of the optional map layers that you bind to a data collection. ■ Point theme dvt:mapPointTheme: One of the optional map layers that you bind to a data collection. The point theme identifies individual locations on a map. ■ Bar graph theme dvt:mapBarGraphTheme: One of the optional map layers that you must bind to a data collection. This theme displays a bar graph at points to represent multiple data values related to that location. For example, this tag might be used to display a graph that shows inventory levels at warehouse locations. ■ Pie graph theme dvt:mapPieGraphTheme: One of the optional map layers that you must bind to a data collection. This theme displays a pie graph at specific points to represent multiple values at that location. For example, this tag might be used to display a graph that shows inventory levels at warehouse locations. ■ Map legend dvt:mapLegend: Created automatically when you create a map. Use this tag to customize the map legend. ■ Overview map dvt:mapOverview: Created automatically when you create a map. Use this tag to customize the overview map that appears in the lower right-hand corner of the map.

27.1.3.3 Tags for Modifying Map Themes

The following tags modify various map themes: ■ Point style item dvt:mapPointStyleItem: An optional child tag of the dvt:mapPointTheme tag. Use this tag only if you want to customize the image that represents points that fall in a certain data value range. To define multiple images, create a tag for each image and specify the associated data value range and image. ■ Pie slice set dvt:mapPieSliceSet: A child of the dvt:mapPieGraphTheme tag. This is an optional tag that you use to wrap dvt:mapPieSliceItem tags, if you want to customize the color of the slices in a map pie graph.