| Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces 11g Release 2 (11.1.2.2.0) E17490-03 |
UIComponent class: oracle.adf.view.faces.bi.component.thematicMap.UIPointLocation
Component type: oracle.dss.adf.thematicMap.PointLocation
The pointLocation tag is a child of the pointDataLayer. It is used to specify the columns in the data layer's model that determine the location of the data points. These locations can be names that join with the named points in the built-in basemap, or they can be x/y coordinates.
There are two different types of pointLocations: pointName and pointXY. If the location of the data points is given in terms of named points (such as cities), then type="pointName" is used along with the pointName attribute to join with the names in the built-in point layer of the basemap.
<dvt:pointDataLayer value="#{bean.myCollection}" var="row" >
<dvt:pointLocation type="pointName" pointName="#{row.cityName}" >
<dvt:marker />
</dvt:pointLocation>
</dvt:pointDataLayer>
If the data is in terms of point coordinates, then type="pointXY" is used along with the pointX and pointY attributes. The expected values for pointX and pointY depends on the projections included in the specified basemap. For all of the built-in basemaps, the points should be specified in latitude and longitude values.
<dvt:pointDataLayer value="#{bean.myCollection}" var="row" >
<dvt:pointLocation type="pointXY" pointX="#{row.longitude}" pointY="#{row.latitude}" >
<dvt:marker />
</dvt:pointLocation>
</dvt:pointDataLayer>
The <dvt:pointLocation> tag can have the following children:
| 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. |
| 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.UIPointLocation | 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 |
| pointName | String | Yes | The column in the data model that determines the location of the point data. The locations are ids of the named points from the basemap point layer for which the data is being displayed. Used only when the pointLocation type="pointName". |
| pointX | String | Yes | The x coordinate of the point data. Used only when the pointLocation type="pointXY". |
| pointY | String | Yes | The y coordinate of the point data. Used only when the pointLocation type="pointXY". |
| 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. |
| type | String | Yes | Valid Values: pointName, pointXY Default Value: pointName The type of the point data being used. Valid values are:
|