Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.1.2)

E23187-01

<dvt:areaLocation>

dvt:areaLocation areaLocation area location

UIComponent class: oracle.adf.view.faces.bi.component.thematicMap.UIAreaLocation
Component type: oracle.dss.adf.thematicMap.AreaLocation

The areaLocation tag is a child of the areaDataLayer. It is used to specify the column in the data layer's model that determine the location of the area data. These locations are area names that join with the area names in the built-in basemap layer.

Relationship with other tags

The <dvt:areaLocation> tag can have the following children:

Screen Shot(s)


No image.

Events

Type Phases Description
org.apache.myfaces.trinidad.event.AttributeChangeEvent Invoke Application,
Apply Request Values
Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing.

Attributes

Name Type Supports EL? Description
attributeChangeListener javax.el.MethodExpression Only EL a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.
binding oracle.adf.view.faces.bi.component.thematicMap.UIAreaLocation Only EL an EL reference that will store the component instance on a bean. This can be used to give programmatic access to a component from a backing bean, or to move creation of the component to a backing bean.
id String Yes the identifier for the component
name String Yes

The column in the data model that determines the location of the area data. The locations are ids of the areas from the basemap for which the data is being displayed. The area ids are determined by the following naming convention:

For the "usa" basemap, the ids are determined by the rules below:

  • The id for the country layer is "USA"
  • For states, the ids are the two letter postal abbreviation (e.g., the id for Massachusetts is "MA" and the id for Texas is "TX")
  • For counties, the ids are the two letter state abbreviation the county is located in, followed by an underscore, and then the name of the county, all in capital letters with underscores replacing spaces (e.g., the id for Middlesex county in Massachusetts is "MA_MIDDLESEX" and the id for Red River county in Texas is "TX_RED_RIVER")
  • For cities, the ids are the two letter state abbreviation the city is located in, followed by an underscore, and then the name of the city, all in capital letters with underscores replacing characters that are not letters (e.g., the id for Boston, Massachusetts is "MA_BOSTON" and the id for San Antonio, Texas is "TX_SAN_ANTONIO")

For all other basemaps, the ids are determined by the rules below:

  • The continent ids for the "world", "africa", "asia", "australia", "europe", "northAmerica", and "southAmerica" basemaps are: "AF" (Africa), "AS" (Asia), "AU" (Australia), "EU" (Europe), "NA" (North America), and "SA" (South America).
  • The region ids for the "worldRegions", "apac", "emea", "latinAmerica", and "usaAndCanada" basemaps are: "APAC" (Asia-Pacific), "EMEA" (Europe and the Middle East), "LAT" (Latin America), "NA" (United States and Canada).
  • The country ids are determined by the ISO 3166-1 alpha-3 country codes (e.g., Canada is "CAN" and China is "CHN")

Links to complete lists of the area ids for all basemaps are listed below:

rendered boolean Yes Default Value: true

whether the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible on the client). If you want to change a component's rendered attribute from false to true using PPR, set the partialTrigger attribute of its parent component so the parent refreshes and in turn will render this component.