Oracle Application Framework Developer’s Guide - …

1 Oracle Application Framework developer 's Guide Release RUP5. April, 2007. 2. Table of Contents Oracle Application Framework developer 'S 9. 9. Oracle Application Framework Support Guidelines for 11. CHAPTER 1: GETTING STARTED .. 15. Introduction to OA Framework .. 15. Setting Up Your Development 21. Customer, Consultant or Support Representative Using JDeveloper on Windows .. 21. Customer, Consultant or Support Representative Using JDeveloper on Linux .. 23. Building and Running 'Hello, World!' .. 26. OA Framework Development Runtime Configuration.

2 55. CHAPTER 2: OA Framework ESSENTIALS .. 57. JSP Application Primer .. 57. Anatomy of an OA Framework Page .. 65. Page 65. The 66. The 70. The Controller .. 75. Web Bean 77. Guide to OA Framework Javadoc .. 79. OA Framework State Management .. 82. Architectural 82. Root Application Modules (Database Session and Transaction State).. 83. Servlet 87. Oracle applications User Session .. 87. Page Context .. 88. Request .. 91. State Persistence Model ('Passivation') .. 92. Application Module Pooling .. 92. CHAPTER 3: BUILDING AN OA Framework Application (THE BASICS)95.

3 Implementing the Model .. 95. Designing Model 95. Recommended Build 97. Business Components 97. Entity 97. Entity Associations (Association Objects) .. 104. View Objects and View 106. View 112. Application Modules .. 115. Entity Objects, Entity Experts, 'Validation' Application Modules and 'Validation' View Objects124. Validation View Objects (VVOs) .. 125. 3. Validation Application Modules (VAMs) .. 125. Entity Experts .. 125. Reusing Business 126. Implementing the View .. 128. Designing the User Interface .. 128. 128. Reusable Components.

4 130. Attribute Sets .. 133. URL Parameters: Tokens, Encryption, 135. Style 136. Accessibility .. 137. Internationalization .. 137. Model Interaction .. 138. Menus and Page Security .. 142. Implementing the 146. Designing an OA 146. Creating an OA Controller .. 148. Handling an HTTP 149. Modifying Bean 151. Creating Beans Programmatically .. 152. Handling an HTTP POST (Form Submit) .. 153. Model Interaction .. 155. Disabling Validation .. 157. 158. Error Handling .. 160. Creating Attribute Sets .. 171. Designing Attribute Sets .. 171. Creating Attribute Set Packages 171.

5 Creating Attribute Sets Manually .. 172. Generating Attribute Sets Automatically (Only on Linux) .. 172. Internationalization .. 176. User 176. 176. Timezone .. 177. Date and Time .. 178. 179. Text and Component Alignment .. 180. Localized Layouts .. 180. Files in a Typical OA Framework 181. CHAPTER 4: IMPLEMENTING SPECIFIC UI 185. Accelerator Keys ('Hot Keys') .. 185. Attachments .. 187. Auto-Repeating Layouts .. 204. Bound Values .. 207. 213. 4. Bulleted 218. Buttons (Action/Navigation) .. 220. Buttons (Global) .. 228. Charts and Graphs.

6 234. Component-Level Function Security (Dynamic User Interface).. 255. Concurrent Processing: Request Submission and 271. Content Containers in 276. Contextual Information .. 279. Controlling UIX Rendering Output (Look-and-Feel / Facets).. 281. Custom HTML .. 283. Daily Business Intelligence (DBI) / OA Framework Integration .. 285. Data Export .. 288. Date 293. Declarative Page 297. Dialog Pages .. 307. Dynamic User Interface .. 255. File Upload and 310. Flexfields .. 313. Forms / OA Framework Page Integration .. 332. Headers and 335. 340.

7 Hide/Show .. 352. Image Cache 359. Images in Your Pages .. 364. Include Content (URL and Servlet) .. 369. Inline Messaging, Tips, Hints and Bubble Text .. 371. Instruction 375. 377. List of Values (LOV) .. 380. Locator Element: Breadcrumbs .. 396. Locator Element: Page/Record Navigation .. 405. Locator Element: Train .. 411. Message 414. Notifications (Workflow Worklist) .. 417. Page Access 420. Page Contents Bottom 422. Page 423. Page Layout (How to Place Content).. 425. 5. Page Security .. 440. Page 446. Partial Page Rendering (Dynamic User Interface).

8 255. Personalizable 449. Creating a Configurable Page .. 449. Creating an End-User Personalizable 460. Considering for Admin-Level 461. Personalization Caveats .. 464. Portlets .. 465. Printable 469. Processing Page .. 471. Quick 474. Related Links / 476. Rich Text 478. Save Model ('Warn About Changes') .. 486. Separator 490. 491. Shuttle .. 523. Standard Web 528. Submitting the Form .. 539. SubTab Navigation .. 543. Switchers ( Application and Context) .. 548. Tables - 551. Tables - 591. Tabs / 627. 642. CHAPTER 5: IMPLEMENTING SERVER-SIDE FEATURES.

9 653. Java Entity 653. About Entity Objects .. 653. Create .. 653. Update / Validate .. 659. Delete .. 663. Lock .. 665. Rollback .. 666. Transaction Undo .. 668. Object Version Number 670. WHO Column Support .. 672. Error 672. Entity Experts, Validation applications Modules and Validation View Objects .. 673. Calling PL/SQL Functions and Procedures .. 675. Entity Objects for Translatable (_TL) Tables .. 676. 6. Standard Validation Patterns and 677. PL/SQL Entity 681. Create .. 681. 682. Lock .. 683. Update .. 686. Delete .. 686. Rollback.

10 688. WHO Column Support .. 688. Error 688. PL/SQL Entity Objects for _TL Tables .. 688. View Objects in 690. Application Modules in 703. Entity Object and View Object Attribute Setters .. 708. CHAPTER 6: ADVANCED OA Framework DEVELOPMENT TOPICS .. 715. Supporting the Browser Back Button .. 715. Browser Back Button Support Use Cases .. 729. OA Framework State Persistence Model (Passivation).. 758. Advanced Java Entity Object Development 777. Controlling UIX Rendering Output (Look-and-Feel / Facets).. 281. OA Framework and AOL/J 784. Application Module and Connection 785.