Configuring Siebel Open UI > Customizing Styles, Applets, Fields, and Controls > Customizing Applets >
Customizing List Applets to Render as Maps
A list applet can be configured to display a map instead of a standard list of records. When the list applet is configured to display a map, the following features are available:
- Markers. A marker is displayed on the map at the location address for each record.
- Contextual menu. Clicking a marker reveals a contextual menu with the following options:
- View Details. Clicking this option opens a pop-up dialog box with details about the record associated with the marker.
- Select. Clicking this option zooms in on the map to the location address associated with the marker record.
- Tooltip. When you hover over a marker, a tooltip is revealed, showing the address associated with the record.
- Map panning.
- Map zooming.
The example in this topic describes how to customize Siebel Open UI to render a list applet as a map in Siebel Open UI. To customize list applets to render as maps
- Add files to the manifest:
- Log in to a Siebel client with administrative privileges.
For more information about the screens that you use in this step, see Configuring Manifests.
- Navigate to the Administration - Application screen, and then the Manifest Files view.
- In the Files list, add the following files. You must add a separate record for each file:
siebel/mappmodel.js siebel/maprenderer.js
- Administer the manifest for the applet:
- Navigate to the Administration - Application screen, and then the Manifest Administration view.
- In the UI Objects list, specify the following applet.
|
|
Type |
Applet |
Usage Type |
Physical Renderer |
Name
|
Applet Name Where Applet Name is the name of the applet in which you want the map to appear. |
- In the Object Expression list, add the following expression. Siebel Open UI uses this expression to render the applet on a desktop platform.
|
|
Expression |
Desktop |
Level
|
1 |
- In the Files list, add the following file:
siebel/custom/maprenderer.js
- In the UI Objects list, specify the following applet.
|
|
Type |
Applet |
Usage Type |
Presentation Mode |
Name
|
Applet Name Where Applet Name is the name of the applet in which you want the map to appear. |
- In the Object Expression list, add the following expression. Siebel Open UI uses this expression to render the applet on a desktop platform.
|
|
Expression |
Desktop |
Level
|
1 |
- In the Files list, add the following file:
siebel/custom/mappmodel.js
- Define the PM user properties:
- Open Siebel Tools.
For more information about using Siebel Tools, see Using Siebel Tools.
- In the Object Explorer, click Applet.
- In the Applets list, query the Name property for the applet that you must modified in Step 2.
- In the Object Explorer, expand the Applet tree, and then click Applet User Property.
- In the Applet User Properties list, create four new applet user properties. Use values from the following table.
|
|
MapMarkerLocation |
Business Component |
MapMarkerTitle |
Business Component |
MapSelectedRowImage |
The SVG image, as added in the CSS |
MapUnSelectedRowImage |
The SVG image, as added in the CSS |
When specifying the Value field for the MapMarkerLocation and the MapMarkerTitle, the business component specified must meet at least one of the following conditions in order to properly display the markers on the map:
- It must be exposed in the list column of the list applet configured for the map.
- It must be exposed as an applet control or list column of a sibling applet to the map applet of the same business component.
- It must be set as a private field.
- Compile your work.
- Define the Web Template for the map:
- Open Siebel Tools.
For more information about using Siebel Tools, see Using Siebel Tools.
- In the Object Explorer, expand the Applet tree, and then click Applet Web Template.
- In the Applet Web Templates list, add the following applet web template.
|
|
Name |
Enter text that describes the visualization behavior. For example, enter Map View to describe a map visualization. |
Type |
Edit List |
Web Template
|
Choose a web template that defines the desired visualization. For example, choose Applet Map. |
- Make sure Siebel Tools defines a SWT file for the web template that you defined in Step c.
For example, make sure the Web Template Files list in Siebel Tools includes a record for the Applet Map web template file, and that the FileName property for this record is CCAppletList_Map.swt. If your deployment requires a new web template, then you must define it before you can define the applet web template. For more information about configuring web templates, see Configuring Siebel Business Applications.
- Test your modifications:
- Clear the browser cache.
- Refresh the list applet that you modified in Step 2.
- Make sure that it renders a map.
|