Professional Documents
Culture Documents
UI Maps
UI Map Overview
A UI map is a meta-data object that holds the HTML that
appears in map zones to provide a more aesthetically
pleasing user experience
Foreshadowing:
BPA scripts (which will only be covered in the next chapter) make
extensive use of UI maps to capture data during update-oriented
business processes
16 - 2
Map Zones
16 - 3
16
HTML Primer
16 - 6
CSS
Cascading Style Sheets
Used to define the look of the page
May be embedded in the HTML page or stored in a separate file
(both methods can be used)
Javascript
Used to enable actions against HTML elements or data on the page
May be embedded in the HTML page or stored in a separate file
(both methods can be used)
Is NOT Java (although there are some similarities)
16 - 7
16
HTML
HTML Skeleton
HTML is an XML document that a web browser will
understand
It contains a <head> element and a <body> element
<html>
<head>
</head>
<body>
</body>
</html>
16 - 9
</table>
</body>
16 - 10
Border is 1 pixel
The Result
Cells have 7
pixels of space
around the data
<td>Aaa</td>
<td>Bbb</td>
</tr>
<tr>
Cells have 7
pixels of space
between them
<td>Ccc</td>
<td>Ddd</td>
</tr>
</table>
16 - 11
<body>
<input type=text/>
<input type=checkbox/>
<input type=button value=Press/>
</body>
16 - 12
16 - 13
<class> (continued)
Another <class>
<body>
<table>
<tr>
<td class="oraLabel" oraLabel="approvalProfileBO/approvalProfile"> </td>
<td><input type="text" class="oraInput" oraField="approvalProfileBO/description"> </td>
</tr>
</table>
</body>
16 - 14
16 - 15
16 - 16
</body>
16 - 17
Putting It Together
<table border="1" cellpadding="7" cellspacing="7">
<tr>
<td colspan="2">A Quick Person</td>
</tr>
<tr>
<td>Name</td>
<td><input type="text"></td>
</tr>
<tr>
<td>State</td>
<td>
<select>
<option value="CA">California</option>
<option value="IL">Illinois</option>
<option value="NY">New York</option>
</select>
</td>
</tr>
</table>
16 - 18
16
CSS
Why CSS?
16 - 20
Element CSS
<table border=0" cellpadding="7" cellspacing="7 style="background-color:#BAD2F5; color:black;" >
<tr>
<td colspan="2 style=font-weight:bold>A Quick Person</td>
</tr>
A style attribute
<tr>
<td>Name</td>
<td style=background-color:red;><input type="text></td>
</tr>
<tr>
<td>State</td>
<td>
<select>
<option value="CA">California</option>
<option value="IL">Illinois</option>
<option value="NY">New York</option>
</select>
</td>
</tr>
</table>
16 - 21
}
.boldfont {
font-weight: bold;
}
</style>
</head>
16 - 22
16 - 23
A class attribute
16 - 24
References
Colors - http://www.visibone.com/colorlab/big.html
CSS - http://www.blooberry.com/indexdot/css/
Easy Google Search is dot css"
16 - 25
16
Javascript
</select>
</td>
</tr>
</table>
16 - 27
When using a browser, you are triggering MANY events every second
with even the smallest use
Some of the basic events are:
onMouseOver
onMouseOut
onLoad
onChange
onClick
onKeyPress
onBlur
onFocus
onUnload
16 - 28
16 - 29
oraConvertToLocalDate() is a JavaScript
function that is made available through the
UI Map Framework
16 - 30
16 - 31
16
User Interface (UI) Maps
16 - 33
16 - 34
Zone Type
Zone
Parameter
Type
Parameter
UI Map
Object Displayed
bo=Customer
XML Parm 1
sourceField=PER_ID targetPath=customerId
XML Parm 2
XML Parm 3
XML Parm
IndividualTaxpayer Schema
<taxpayerId mapField="PER_ID" mdField="TP_ID"/>
<name />
<email mapField="EMAILID"/>
<socialSecurityNumber />
<homePhone />
<birthDate />
16 - 36
16 - 37
IndividualTaxpayer Schema
...
<creditThreshold mapField="ADHOC_CHAR_VAL"
dataType="money" label="Threshold">
<row mapChild="CI_PER_CHAR">
<CHAR_TYPE_CD is="THRHLD" />
<EFFDT default="%CurrentDate" />
</row>
</creditThreshold>
...
IndividualTaxpayer Schema
...
<creditThreshold mapField="ADHOC_CHAR_VAL"
mdField="THRESHOLD">
<row mapChild="CI_PER_CHAR">
<CHAR_TYPE_CD is="THRHLD" />
<EFFDT default="%CurrentDate" />
</row>
</creditThreshold>
...
Both do the same thing - the right side means that youve set up a metadata
field with a type of "money" and a label of "Threshold"; this is more work up
front, but it allows for a multi-lingual and translatable application
Copyright 2009, Oracle. All rights reserved.
IndividualTaxpayer Schema
...
<custType mapField="ADHOC_CHAR_VAL"
dataType="lookup" label="Customer Type"
lookup="CUST_TYPE_FLG" >
<row mapChild="CI_PER_CHAR">
<CHAR_TYPE_CD is="CUSTTYPE" />
<EFFDT default="%CurrentDate" />
</row>
</custType>
...
IndividualTaxpayer Schema
...
<custType mapField="ADHOC_CHAR_VAL"
mdField="CUST_TYPE" >
<row mapChild="CI_PER_CHAR">
<CHAR_TYPE_CD is="CUSTTYPE" />
<EFFDT default="%CurrentDate" />
</row>
</custType>
...
fkRef=
If the element is a foreign key to another table and you
want the FK's context menu and info string to be
displayed, you can add the attribute fkRef="FK Reference
Code"
IndividualTaxpayer Schema
...
<obligationId mapXML="BO_DEFN_AREA" label="Obligation" fkRef="SA" />
...
This will cause the SA's context menu and info string
to be displayed
16 - 40
IndividualTaxpayer Schema
<header type="group" label="Individual Taxpayer"/>
<taxpayerId />
<name />
<socialSecurityNumber />
<birthDate />
<contactInformation
type="group" label="Contact Information"/>
<email />
<homePhone />
</contactInfo
16 - 41
16 - 43
16
User Interface (UI) Maps
16 - 45
16 - 46
16
User Interface (UI) Maps
16 - 48
Zone Type
Parameter
Type
Zone
Parameter
UI Map
map=CustomerMap
Object Displayed
bo=Customer
XML Parm 1
sourceField=PER_ID targetPath=customerId
XML Parm 2
XML Parm 3
XML Parm
16 - 49
HTML
UI Map
Schema
<conservationProgram type="group">
<includeBO name="C1-ConservationProgram"/>
</conservationProgram>
16 - 51
16 - 52
16
User Interface (UI) Maps
16 - 54
16 - 55
16
User Interface (UI) Maps
HTML Fragments
16
User Interface (UI) Maps
Help Text
16 - 59
16 - 60
16 - 61
16
User Interface (UI) Maps
16 - 63
16 - 64
16
User Interface (UI) Maps
Consistency
Enforcing Consistency
We ship a sample style sheet so your HTML can inherit the
look and feel from a single spot
We also ship a library of JavaScript functions to handle
things like monetary formatting, date formatting,
defaulting, etc.
It's important that your UI maps include these so users are
presented with a consistent look and feel
16 - 66
16 - 67
16
User Interface (UI) Maps
16 - 69
Query Zone
Query
Zone
Validate
User Parms
Service
Script
16 - 70
Database
Map Zone
Map
Zone
1. Generate HTML
2. Retrieve XML
Business
Object
16 - 71
Database
Map Zone
Service
Script
Database
Business
Object
16 - 72
Script
(Service)
API
(Script
Schema)
<includeBO name="Account"/>
<includeBO name="Person"/>
<includeBO name="Premise"/>
Step
16 - 73
16 - 74
Review Questions
16 - 75
16 - 76