App Builder includes built-in wizards for generating map charts on pages with a Desktop user interface. How you create a map chart depends upon whether you are adding the map to an existing page, or adding a map on a new page.
Topics:
Map chart support in Oracle Application Express is based on the AnyChart AnyMap Interactive Maps Component. AnyMap is a flexible Macromedia Flash-based solution that enables developers to visualize geographical related data. Map charts are rendered by a browser and require Flash Player 9 or later. For more information about AnyChart, go to
http://www.anychart.com
AnyChart stores map data in files with a *.amap
extension, and supports 300 map files for the United States of America, Europe, Asia, Europe, Africa, Oceania, North America, and South America. To render a desired map, you select the map source in the wizard (for example, Germany
) and the map XML automatically references the desired map source .amap
file, germany.amap
. To browse through the available maps, see "Map Reference" in AnyChart User's Guide:
You define a map in App Builder using a wizard. You select a map type, map source, and provide a SQL query using the following syntax:
SELECT link, label, value FROM ...
Where:
link
is a URL.
label
is the text that identifies the point on the map with which you want to associate data. The Region ID or Region Name of the map will be used as the label.
value
is the numeric column that defines the data to be associated with a point on the map.
Consider the following example when creating a new page:
On the Workspace home page, click the App Builder icon.
Select an application.
Click Create Page.
Click Chart.
Select Map Chart and click Next.
For Map Type, select United States of America and click Next.
For Map Source, expand Country Maps and select States.
For Page Attributes specify the appropriate attributes and click Next.
For Navigation Preference, specify the type of navigation to include on this page and click Next. The navigation options (for example, navigation menu or tabs) depends upon the current application theme.
For Map Attributes, select the appropriate attributes and click Next.
The Query page appears.
Scroll down and expand and review the May Query Example and Map Reference Information regions.
Scroll down and expand and review the Map Reference Information region at the bottom of the page.
Specify a SQL query by either:
Entering a SQL query in the field provided. See "About Creating SQL Queries for Maps."
Clicking the Build Query button. When the Build Chart Query Wizard appears, follow the on-screen instructions.
When you create your query, you must incorporate the region name information as described in the Map Reference Information region. The following example includes information for Florida and Alaska:
SELECT null link, region label, value Populations FROM ( SELECT 'Florida' region, 18328340 value FROM dual UNION ALL SELECT 'Alaska' region, 686293 value FROM dual)
Note:
If you are referencing geographical information stored in a database table, the information must correspond with the Region information associated with the map source. For more information, see AnyChart User's Guide:
Click Create.
Add or edit map charts in Page Designer.
Topics:
Once you create a map chart, you can alter its display by editing attributes in the Property Editor.
To view the map chart attributes:
See Also:
"Using Custom XML with Map Charts" and "Enabling Automatic Updates"
There are additional map settings that cannot be controlled using the standard attributes on the Map Attributes page. To further control the look and feel of a chart, you can use custom XML.
To use custom XML:
Tip:
For more information on supported XML format for maps, see the Online Map XML Reference at:
You can create map charts that monitor information by enabling the Asynchronous Update attribute on the Map Attributes page. Enabling this attribute updates the map to reflect changes in the underlying data within a specified time interval.
To enable automatic refresh:
Developers can create and edit map charts in Component View.
Topics:
See Also:
To add a map chart to an existing page.
Navigate to the page. See "Viewing a Page in Legacy Component View."
Create a new region. Under Region, click the Create icon.
Select Map Chart and click Next.
For Map Type, select a map type (for example, Europe), and click Next.
For Map Source, a Tree lists the map source files for the selected Map Type. Click the Map Source you want to use (for example, Denmark).
For Display Attributes:
Title - Enter a title for the region. This title displays if the region template you choose displays the region title.
Region Template - Choose a template to control the look of the region.
Parent Region - Define the parent region to which the new region belongs.
Display Point - Identify a display point for this region.To learn more, see field-level Help.
Sequence - Specify the sequence for this component. The sequence determines the order of evaluation.
Click Next.
For Display Attributes, select the appropriate map attributes and click Next.
To learn more about an attribute, see field-level Help. See "Viewing Field-Level Help."
Specify a query by either:
Entering a SQL query in the field provided. See "About Creating SQL Queries for Maps."
Clicking the Build Query button. When the Build Chart Query Wizard appears, follow the on-screen instructions.
Specify relevant attributes. To view map reference information associated with your selected Map Source, expand the Map Region Information region at the bottom of the page.
To associate data with geographical locations, you must incorporate information from the Region Name or Region ID columns into the Map query. See "About Creating SQL Queries for Maps."
For Conditional Display:
Condition Type - Select a condition type from the list that must be met in order for this component to be rendered processed.
Authorization Scheme - Optionally select an authorization scheme which must evaluate to TRUE in order for this component to be rendered or otherwise processed.
Click Create Region.
Once you create a map, you can alter its display by editing map attributes on the Map Attributes page.
To access the Map Attributes page:
Navigate to the page. See "Viewing a Page in Legacy Component View."
Access the Chart Attributes page:
Under Region, select the region name.
The Region Definition appears.
Click Map Attributes.
Edit the appropriate attributes.
To learn more about an attribute, see field-level Help. See "Viewing Field-Level Help".
Click Apply Changes.
See Also:
"Using Custom XML with Map Charts" and "Enabling Asynchronous Updates"
There are additional map settings that cannot be controlled using the standard attributes on the Map Attributes page. To further control the look and feel of a chart, you can use custom XML.
To use custom XML:
Tip:
For more information on supported XML format for maps, see the Online Map XML Reference at:
You can create map charts that monitor information by enabling the Asynchronous Update attribute on the Map Attributes page. Enabling this attribute updates the map to reflect changes in the underlying data within a specified time interval.
To enable asynchronous updates: