Generating and Editing PDA Templates
This section describes how to generate a new PDA template, or edit one that already exists:
New templates – after clicking the Generate PDA Template icon, complete the
properties described below, or accept the defaults. Go to the Preview page to view your
changes. Click OK when finished. Select File|Save As, and
name your new template.
Existing templates – double-click the template you want to edit. The mobile template
editor displays. Click the Generate PDA Template icon. This is the only active icon for existing PDA templates. Edit the
properties described below. Go to the Preview page to view your changes. Click
OK when finished. Select File|Save, to save your
changes.
Device
Allows you to change the width and height of the mobile application and the grid type.
Device
| Property type | Description |
|---|
| Display |
Resolution Width – the width of the screen in pixels. Valid values are 200 – 400.
Resolution Height – the height of the screen in pixels. Valid values are 100 –
300.
Grid Type – select DHTML to present the data in a
DHTML grid, or MimeList to present data in the M-Business Server MimeList format:
DHTML – Dynamic HTML (DHTML) relies on the Document Object Model (DOM) to dynamically
change the appearance of Web pages after they have been downloaded to a user's browser. DOM is the specification for how
objects in a Web page (text, images, headers, links, and so on) are represented. The DOM defines the attributes that are
associated with each object, and how objects and attributes can be manipulated.
MimeList – is a MIME type that defines how the data is presented on the PDA. A MIME
type specifies how a server or browser should interpret the file. For example, whether the file contains plain text, formatted
HTML, an image, or a sound recording.
|
Appearance
Allows you to change content color, font type, and font size for the header and rows, and size of the margins.
Appearance
| Property type | Description |
|---|
| Default |
Font – enter a name of the font for the header and fields, or select a font for the
header and fields from the drop-down list.
Font Size – the size of the header and fields, which must be an integer between 1 and
16.
Font Color – the color of the font. Click the color bar to display the color palette.
Choose from the existing palette, or click Define Custom Colors to define a new
color.
Color – the color of the mobile application. Choose from the existing palette, or
click Define Custom Colors to define a new color.
|
| Header |
Background Color – the color of the header background. Click the color bar to display
the color palette. Choose from the existing palette, or click Define Custom Colors to define
a new color.
Text Color – the color of the header text. Click the color bar to display the color
palette. Choose from the existing palette, or click Define Custom Colors to define a new
color.
|
| Row |
Row Text Color – the color of the row text for the mobile application. Click the
color bar to display the color palette. Choose from the existing palette, or click Define Custom
Colors to define a new color.
Alternate Row Color – allows you to alternate row text by color:
Even Row Background Color – a color for the even rows. Click the color bar to display
the color palette. Choose from the existing palette, or click Define Custom Colors to define
a new color.
Odd Row Background Color – a color for the odd rows. Click the color bar to display
the color palette. Choose from the existing palette, or click Define Custom Colors to define
a new color.
Row Background Color – available if Alternate Row
Color is not selected. Allows you to select the background color of the field data. Click the color bar to display
the color palette. Choose from the existing palette, or click Define Custom Colors to define
a new color.
|
| Margin |
Left Margin Size – the width of the left margin of each cell, in pixels.
Top Margin Size – the size of the top margin of each cell, in pixels.
|
Column
The Column tab sets the maximum length of each column cell data string. Certain column
data cells have long data strings, which might make the data difficult to read in the grid format. The column customization
feature enables you to control the maximum characters to display for each column cell. The depth column properties refer to
grid data. For example, Depth 1 is the initial grid data the user sees. If a user clicks a link in the first grid data that
goes to another list of grid data, the second list of grid data is Depth 2 of the grid data, and so on, to Depth 5. You can set
the width of each column in each depth by selecting a column, and entering the maximum number of characters that can display in
that column. For example, on Depth 1, you may want to set column 1 to display 5 characters. Select Depth One Column Properties, and enter "5" in the Column 1 Width
text box. Repeat the procedure to set column 2, and so on.
Column
| Property type | Description |
|---|
| Enable Column Truncating | Indicates whether to enable the column-truncating feature. If enabled, long strings of data are truncated according to
the number of characters you specify to display. If disabled, the entire data string is displayed. By default, column
truncating is disabled. |
| Depth 1 – 5 Column Properties |
Column Width – for each column, enter the column width in characters. For example,
enter 4 to indicate four characters wide. |
Paging
Specifies whether to enable paging, the number of grid rows to display at one time, and the appearance of the paging
buttons if paging is enabled.
Paging
| Property type | Description |
|---|
| Enable Paging | Indicates whether to enable the paging feature. If
paging is enabled, data is organized into pages that can be accessed by selecting page buttons. If paging is disabled, all the
data is displayed. By default, paging is enabled. |
| Paging |
|
| Paging Button Font |
Font – enter a name of the font for the paging buttons, or select the font used for
the paging buttons from the drop-down list.
Font Size – the font size used for the paging buttons.
|
| Paging Button |
Active Button Color – the color of the active, or selected, paging button.
Active Button Text Color – the text color of the active paging button.
Inactive Button Color – the color of any inactive, or unselected, paging
buttons.
Inactive Button Text Color – the text color of any inactive paging buttons.
|
Search
Indicates whether to enable search, whether to show the search mechanism, and how to customize the search buttons. The
search mechanism includes the search field, the Find, Close, and Back buttons, the column drop-down list, the criteria
drop-down list, and the All-Level check box. The search mechanism can be very useful, but it
does use several rows of a PDA's limited display. Search is enabled by default.
Search
| Property type | Description |
|---|
| Enable Search | Indicates whether to enable the search feature. If
enabled, users can use the search mechanism to search for data. If disabled, users cannot search. |
| Show Search Option | Indicates whether the search mechanism is displayed. By
default, Show Search is enabled. For mobile applications, the Search button appears to the right of the paging buttons. When you click the Search button, the Column drop-down list, the
Search Criteria drop-down list, and the All Depth Level
check box display. |
| Search Option |
Default Search Column Number – if Show Search
Option is disabled, select a default search column number from the drop-down list.
Default Search Criteria – if Show Search Option is
disabled, select a default search criteria from the drop-down list.
Default Search All Level – if Show Search Option
is disabled, indicate whether to search all levels. The default is to not search all levels.
All Level Text – you can change the text "all" next to the check box by entering
different text in the text box to the right of "All level text:"
|
| Use Image Buttons | Indicate whether to use images or
text for search buttons. By default, images are used. |
| Image Buttons |
Image Location – if images are used for buttons, specify the image file location. By
default, button images are stored in: $WEB_APP_ROOT/onepage/portlets/templates/mobile/images where
$WEB_APP_ROOT is the root of all Web applications in the application server. To customize images, provide the correct image
file location.
Search Button Image – identifies the Search button image; for example,
btn_search_6B875D.gif. A preview of the button displays to the right of the input field.
Find Button Image – identifies the Find button image; for example,
btn_find_6B875D.gif. A preview of the button displays to the right of the input field.
Close Button Image – identifies the Close button image; for example,
btn_close_6B875D.gif. A preview of the button displays to the right of the input field.
Back Button Image – identifies the Back button image; for example,
btn_back_6B875D.gif. A preview of the button displays to the right of the input field.
|
| Text Buttons | These options are available only when Use Image Buttons is not selected:
Button Color – enter or select the button color to use as the background color used
for the search buttons.
Search Button Text – use the default Search button text, or type new text.
Find Button Text – use the default Find button text, or type new text.
Close Button Text – use the default Close button text ,or type new text.
Back Button Text – use the default Back button text, or type new text.
|
| Text Button Fonts | These options are available only when Use Image Buttons is not selected:
Font – enter the name of the font to use for the search buttons, or select the font
type used for the search buttons from the drop-down list.
Font Color – the font color used for the search buttons.
Font Size – the font size used for the search buttons.
|
Update
Indicates whether users can update cell data from the PDA, and enables you to customize the update buttons.
Update
| Property type | Description |
|---|
| Enable Update | Indicates whether to enable the update feature. If
enabled, users can update cell data. If disabled, users cannot update cell data. By default, update is enabled. |
| Use Image Buttons | Indicates whether to use images or text for update
buttons. By default, images are used. |
| Image Buttons |
Image Location – if images are used for buttons, specify the image file location. By
default, button images are stored in: $WEB_APP_ROOT/onepage/portlets/templates/mobile/images where
$WEB_APP_ROOT is the root of all Web applications in the application server. To customize images, provide the correct image
file location.
Edit Button Image – identifies the Edit button image; for example,
btn_edit_6B875D.gif. A preview of the button displays to the right of the input field.
New Button Image – identifies the New button image; for example,
btn_new_6B875D.gif. A preview of the button displays to the right of the input field.
Save Button Image – identifies the Save button image; for example,
btn_save_6B875D.gif. A preview of the button displays to the right of the input
field.
Done Button Image – identifies the Done button image; for example,
btn_done_6B875D.gif. A preview of the button displays to the right of the input
field.
|
| Text Buttons | These options are available only when
Use Image Buttons is not selected:
Button Color – enter or select the background color used for the update buttons.
Edit Button Text – use the default Edit button text, or type new text.
New Button Text – use the default New button text, or type new text.
Save Button Text – use the default Save button text, or type new text.
Done Button Text – use the default Done button text, or type new text.
|
| Text Button Fonts | These options are available only
when Use Image Buttons is not selected:
Font – enter the name of the font for the update buttons, or select the font type
used for the update buttons from the drop-down list.
Font Color – the font color used for the update buttons.
Font Size – the font size used for the update buttons.
|
| Enable Update JavaScript | Indicates whether to enable
the JavaScript function. This enables you to add a JavaScript update validation call. If enabled, you can access the text area
under Update JavaScript Properties. |
| Update JavaScript Properties | Enter an update function using JavaScript. The function is called when an update is submitted from the
PDA. |
Breadcrumbs
Enables you to change the appearance of the breadcrumb, or indicator, used to guide the user through the user
interface.
Breadcrumbs
| Property type | Description |
|---|
| Enable Display of Breadcrumbs | Indicates whether to enable use of
breadcrumbs. If selected, breadcrumbs are enabled; otherwise, breadcrumbs are disabled. By default, breadcrumbs are enabled.
|
| Root Page Text | The text used to identify the initial
page of data displayed. The default is Main. |
| Use Image Buttons | Indicates whether to use an image or text as the breadcrumb indicator. If this option is selected, an
image is used, if it is not selected, a text indicator is used. By default, images are used. |
| Image Buttons |
Image Location – if a breadcrumb image is used, specify the image file location. By
default, the breadcrumb image is stored in: $WEB_APP_ROOT/onepage/portlets/templates/mobile/images where
$WEB_APP_ROOT is the root of all Web applications in the application server. To customize images, provide the correct image
file location.
Arrow Button Image – if an image is used, identify the Arrow image; for example,
btn_trail_image_6B875D.gif. A preview of the image displays to the right of the input
field.
|
| Text Button | If an image is not used, enter the text
to use in place of the arrow. For example:
--> |
| Enable Breadcrumbs Text Truncating | Indicates whether
breadcrumb text should be truncated to save space. If this option is selected, text is truncated, if it is not selected, text
is not truncated. The default is not truncated. |
| Breadcrumb Text Truncation Length
| If breadcrumb truncation is enabled, specify the truncation length. The default is 5 characters.
|
Business logic
Enables you to add your own custom JavaScript functions that are called when each grid data cell is drawn.
Business logic
| Property type | Description |
|---|
| Enable Business Logic | Indicates whether to enable the business logic
feature. If enabled, you can add business logic in the form of JavaScript. If disabled, you cannot add business logic. By
default, business logic is disabled. |
| Business Logic JavaScript Function
Declarations | Enter a function call using JavaScript. The function is called when an update is
submitted from the mobile device. |
Related Tasks
Using the Template Editor
Assigning Templates to Mobile Applications