11_enhancing the application's usability

8/14/2019 11_Enhancing the Application's Usability

1/24

11Copyright 2007, Oracle. All rights reserved.

Enhancing the Applications Usability


2/24

11-2 Copyright 2007, Oracle. All rights reserved.

Objectives

After completing this lesson, you should be able to do

the following:

Internationalize an application by using resource

bundles Use the JSF loadBundle tag to reference a

resource bundle

Use Application Development Framework (ADF)

declarative validators

Use ADF control hints


3/24


Internationalization

Internationalization is the support for multiple

locales (i18n).

Localization is the process in which support for a

specific locale is added. ADF Faces supports internationalization and

provides localization support for English, German,

Spanish, French, and more.


4/24


Resource Bundles

Resource bundles contain locale-specific strings

used in an application.

Translation strings can include parameters.

sr.browserTitle=SRDemo Beispielanwendungsr.about=ber dieses Beispielsr.copyright=\u00a9 Oracle Corp, 2006sr.contact=Kontakt

UIResources_de.properties

sr.browserTitle=SRDemo Sample Applicationsr.about=About this samplesr.copyright=\u00a9 Oracle Corp, 2006sr.contact=Contact Us

UIResources.properties


5/24



6/24


7/2411-7 Copyright 2007, Oracle. All rights reserved.

Using Resource Bundles

Useto reference the resourcebundle.

Only the name of the default resource bundle

needs to be specified. Translations are looked upby appending_to the name.

Translatable strings are referenced by their key in

the resource bundle.



Handling Error Messages

Use a property resource bundle to replace standard

error-message texts:

Create a resource bundle containing key-value pairs

for replacement of error-message texts.

In faces-config.xml, click the Overview tab. Click Application.

In Message Bundle,add the path to the

message resourcebundle.

Use h:messagestag to displaymessages.



Control Hints and Validation

Declarative validation rules for data controls andbindings:

Provide a consistent

user experience

Are extensible for complexapplication validation

Are metadata based

Control hints for data controls

and bindings include: Labels

Date and currency

formatting



Using Control Hints

Centralize UI settings across clients

Reduce coding

Increase consistency

Hints include: Label Text

Tooltip Text

Format mask

Display Height and Display Width



Accessing Control Hints

Part of the ADF Model

Set at the Entity Metadata level



Control Hint Properties



ADF Declarative Validation

Declarative rules are enforced in the model.

The standard set of rules include:

Compare

List Range

Length

Expression

Error messages are returned through the message

bundle mechanism.

The message bundle can be internationalized.



Adding Validation



Internationalizing Control Hints



Internationalizing the Message Bundle

(Control Hints)

1. Right-click the message bundle class.

2. Select refactor and duplicate the class.

3. Append the language identifier to the class name:

ServiceRequestsMsgBundle.java ServiceRequestsMsgBundle_fr.java

4. Make language (or locale) changes in the new

class.




(Control Hints): Example

static final Object[][] sMessageStrings ={

{ "assignedDate_TOOLTIP", "The date the service requests wasassigned" },{ "assignedDate_LABEL", "Assignment Date:" },{ "assignedDate_FMT_FORMATTER","oracle.jbo.format.DefaultDateFormatter" },{ "assignedDate_FMT_FORMAT", "MM-dd-yyyy" }};

static final Object[][] sMessageStrings ={

{ "assignedDate_TOOLTIP", Date laquelle la demande a t

assigne" },{ "assignedDate_LABEL", Date dassignation" },{ "assignedDate_FMT_FORMATTER","oracle.jbo.format.DefaultDateFormatter" },{ "assignedDate_FMT_FORMAT", "MM-dd-yyyy" }};




(Control Hints)



Internationalized Error Messages



Summary

In this lesson, you should have learned how to:

Internationalize an application by using resource

bundles

Use the JSF loadBundle tag to reference aresource bundle

Add ADF declarative validators to an application

Use ADF control hints



Practice Overview:

Internationalizing an Application

This practice covers the following topics:

Adding declarative validation to the model

Using the resource bundle to internationalize the

application Using a message bundle to internationalize a

message


24/24

11_enhancing the application's usability

Documents