11i Extend Oracle Applications: Building OA Framework Applications Student Guide

Transcription

1 11i Extend Oracle Applications: Building OA Framework Applications Student Guide Course Code D18994GC11 Edition 1.1 English Month Year October 2005 Part Number D19286

2 Copyright Oracle Corporation, All rights reserved. This documentation contains proprietary information of Oracle Corporation. It is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited. If this documentation is delivered to a U.S. Government Agency of the Department of Defense, then it is delivered with Restricted Rights and the following legend is applicable: Restricted Rights Legend Use, duplication or disclosure by the Government is subject to restrictions for commercial computer software and shall be deemed to be Restricted Rights software under Federal law, as set forth in subparagraph (c)(1)(ii) of DFARS , Rights in Technical Data and Computer Software (October 1988). This material or any portion of it may not be copied in any form or by any means without the express prior written permission of the Education Products group of Oracle Corporation. Any other copying is a violation of copyright law and may result in civil and/or criminal penalties. If this documentation is delivered to a U.S. Government Agency not within the Department of Defense, then it is delivered with Restricted Rights, as defined in FAR , Rights in Data-General, including Alternate III (June 1987). The information in this document is subject to change without notice. If you find any problems in the documentation, please report them in writing to Worldwide Education Services, Oracle Corporation, 500 Oracle Parkway, Box SB-6, Redwood Shores, CA Oracle Corporation does not warrant that this document is error-free. Oracle and all references to Oracle Products are trademarks or registered trademarks of Oracle Corporation. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners. Authors: Bill Sawyer, Sara Woodhull, Liza Lyons, Suvarna Gaddipati Technical Contributors and Reviewers: Eric Bing, Anne Carlson, Siu Chang, John Zerbel, Mark Sullivan, Bill Curtis This book was published using: oracletutor

3 Table of Contents Introduction and the OA Framework Architecture i Extend Oracle Applications: Building OA Framework Applications Course Objectives Lesson Objectives Day Day Day Day Day Advantages of Java Pillars of Java Programming Core Java Specification Design Patterns Frameworks What is a Framework? Parts of OA Framework Model-View-Controller (MVC) Design Pattern Flexible Architecture OA Framework Architecture Resources Summary Introduction to the Model-View-Controller (MVC) Design Pattern i Extend Oracle Applications: Building OA Framework Applications Objectives Model-View-Controller (MVC) Design Pattern Model: Business Components for Java Model: Application Modules Model: Entity Objects Model: View Objects Model: Controlling Transactions View: OA Framework-Based Page View: Java Objects in a Page View: A Framework Example View: Page Hierarchy View: A Framework Region View: Reusing Page Components with the Extends Property View: Attribute Sets Improve Consistency View: Data Source Binding The View - Design Time The View - Personalization Controller: Controlling UI Behavior Controller: Handling a GET Request Controller: Handling a POST Request Controller: The OAPageContext Object Controller: Applications Context Client and Server Resources Summary Setting Up Your Development Environment i Extend Oracle Applications: Building OA Framework Applications Objectives i

4 Basic JDeveloper Deployment Configure the JDEV_USER_HOME Environment Variable on Your PC Get Tutorial.zip File and Extract Start JDeveloper and Verify Installation Checking DB Connections Setting Up Connections Connection Wizard OA Workspaces and OA Projects OA Project Settings Summary Implementing Your First OA Framework Page: Hello World i Extend Oracle Applications: Building OA Framework Applications Objectives Finished Page Overview Prerequisite: Set Up Your Development Environment Step 1. Create a New OA Workspace and Empty OA Project Step 2. Set Run Options in OA Project Settings Step 3. Create the OA Components Page File Step 4. Modify the Page Layout (Top-level) Region Step 5. Create the Second Region (Main Content Region) Step 6. Create the First Item (Empty Field) Step 7. Create a Container Region for the Go Button Step 8. Create the Second Item (Go Button) Step 9. Save Your Work Step 10. Run Your Page Using the Run Option Step 11. Add a Controller Step 12. Edit Your Controller Step 13. Build Your Controller Step 14. Test Your Work Using the Run Option Step 15. Test Your Work Using the Debugger Summary Basics of the Model i Extend Oracle Applications: Building OA Framework Applications Objectives BC4J Objects Encapsulation The "Reuse Onion" Entity Objects Entity Object Entity Objects: Creation Standards Entity Object Automatic Features Entity Object Information Association Entity Association View Objects View Object View Object Rows Creating View Objects in the VO Wizard View Object Java Files View Object Files View Object Non-BC4J Solution View Object BC4J Solution View Object BC4J Solution - Read-Only View Object Initial Query View Object EO Population View Object EO Uniqueing ii

5 View Object Entity-Derived Attributes View Object EO Fault-in View Object Reference EOs View Object VO/EO Merge - Part View Object VO/EO Merge - Part View Object VO/EO Merge - Part Master-Detail Relationships View Link Application Module Transaction BC4J Packages in JDeveloper Summary Guided Demonstration - Setting Up Your Development Environment Basics of the View i Extend Oracle Applications: Building OA Framework Applications Objectives Terminology OA Workspaces and OA Projects Region Styles Named Children and Indexed Children Page Layout Region Item Styles More Item Styles Attribute Sets Extending Other Objects CSS Styles Common CSS Styles Binding Items to Data Creating a Region with the Region Wizard Destinations and Links Mailto Links Standards Help Meet Many Requirements General Naming Rules Page and Object Naming Rules Styles and Bean Names Attribute Set Standards Attribute Sets Attribute Set Naming Conventions More Attribute Set Standards More Standards Information Overview of Building Search Regions Simple Search Advanced Search Personalized Views Construction Mode Results-based Search Auto Customization Criteria Search Construction Mode of "None" Manually-Built Search Regions Disabling Blind Queries Lists of Values (LOVs) Defining an External LOV Summary Basics of the Controller i Extend Oracle Applications: Building OA Framework Applications Objectives iii

6 Common Logic to Code Typical Locations for Code Handling Queries View Object initquery Code Dynamic WHERE Clauses Using findbykey Instead of initquery Processing a Button Press Checking for Button Presses and Getting Parameters from Requests Example: Manually-built Search The Process Example Search: Controller Forwarding to Another Page Setting Titles with Message Dictionary Event Flow Overview Initial Setup Flow Controller Event Flows in OA Framework GET Event Flow Overview GET Event Flow (1) Get info and validate user GET Event Flow (2) Fetch Metadata GET Event Flow (3) Get Root AM, Validate Session GET Event Flow (4) Instantiate BC4J and UIX Classes Example Bean Hierarchy Structure GET Event Flow (5) processrequest GET Event Flow (6) Post-Processing GET Event Flow (7) UIX Renders the Page Structure of a Web Bean Data Binding POST Event Flow Overview POST Event Flow (1-3) Submit, Client-Side Validation POST Event Flow (4 & 5) Validate User and Retrieve State POST Event Flow (6) Apply Form Data POST Event Flow (6) More of processformdata POST Event Flow (7) processformrequest Summary Implementing a Search i Extend Oracle Applications: Building OA Framework Applications Objectives Finished Page Before Search Finished Page After Search Finished List of Values Page Finished Drilldown-to-Details Page Overview Task 1: Create Your Project Task 2: Create Your Page's Model Components Task 3: Create Your Initial Page Task 4: Configure a Results-Based Search Task 5: Convert Search Region to Auto Customization Criteria Task 6: Add a List of Values (LOV) to Your Employee Name Field Overview Task 1: Create the Details Page View Object Task 2: Create the Details Page UI Task 3: Implement the View Object Query Task 4: Implement the Drilldown to the EmpDetailsPG Summary Debugging OA Framework Applications i Extend Oracle Applications: Building OA Framework Applications iv

7 Objectives Oracle9i JDeveloper Debugger Invoking the Oracle9i JDeveloper Debugger for OA Framework Pages Fundamentals of Debugging Breakpoints Setting Breakpoints Editing Breakpoints Breaking on Exceptions Setting Breakpoints During Runs Exception-style Breakpoint Debugger Windows: Data Debugger Windows: Smart Data Debugger Windows: Stack Other Debugger Windows Stepping Through a Program Customizing Debugger Windows Debugging Declarative Applications More Debugging Tips Understand BC4J Interactions Debugging Validation and Commits Demonstration Overview Task 1: Investigate Unexpected Code Execution (Part 1) Task 2: Resolve a NullPointerException (NPE) Task 3: Resolve a ClassCastException Task 4: Resolve a SQLStmtException Task 5: Use a Class Breakpoint Task 6: Investigate Unexpected Code Execution (Part 2) Task 7: Explore Application Module Retention Behavior Task 8: Resolve a Common Missing Import Task 9: Investigate Unexpected UI Results Summary Implementing a Create (Part 1) i Extend Oracle Applications: Building OA Framework Applications Objectives Implementing a Create Overview Implementing a Poplist Extending a Shared Region Creating a New Row Initializing a View Object Creating and Initializing a VO Row Getting the Data Saving a Row to the Database Overview Task 1: Build the Create Page Task 2: Implement the Positions Poplist Task 3: Implement Row Initialization (Create a View Object Row) Task 4: Implement the Apply Button Handling Task 5: Revise Search Page to Include Create Employee Button Summary Implementing a Create (Part 2) i Extend Oracle Applications: Building OA Framework Applications Objectives Implementing a Create Overview Validation What Triggers Validation v

8 Client-side Validation Server-side Validation Attribute Level Server-side Validation Entity Object Level Server-side Validation View Object Level Validation Helpers Using SQL to Validate EOs EOs Need VOs to Hold SQL Solution: "Validation VOs" and "Validation AMs" Where Do These Fit in the "Reuse Onion"? Situation: Purchase Order Business Object Solution: Entity Expert Customer Extends Code Entity Expert Primary Access Point to VAMs and VVOs Benefits of Using Entity Experts Building Entity Experts Associate Entity Expert with EO Building VVOs and VAMs Referencing VVOs and VAMs Defaulting Data - Model Interactions Back Button Primer Transaction Unit Helper Allow the Back Button? Overview Task 1: Handle the Back Button in Your Application Task 2: Implement Employee Business Logic Using Declarative Validation Task 3: Implement Employee Business Logic Using Java Code Task 4: Validate and Set the Start Date Task 5: Add Logic to Make Employee Name Task 6: Creating VVOs for Validations Task 7: Create an Entity Expert Class Task 8: Validate and Set the ManagerId Task 9: Validate and Set the Position Task 10 (Optional): Validate and Set the End Date and Salary Task 11: Implement Cross-Attribute (Entity Level) Business Logic Summary Implementing Partial Page Rendering (PPR) i Extend Oracle Applications: Building OA Framework Applications Objectives Implementing PPR Overview What Is Partial Page Rendering (PPR)? Uses of PPR OA Framework Features Using PPR Item Styles That Support PPR Events PPR Requirements Create Page Flow Create Page Flow with PPR Dynamic Page Structure Dynamic Page Structure Actions Overview Task 1: Create an "Application Properties" View Object Task 2: Configure Position Item to Fire PPR Action on Change Task 3: Configure the MgrName Item to React to PPR Events Task 4: Implement PPR Event Handling Summary Implementing a Delete i Extend Oracle Applications: Building OA Framework Applications vi

9 Objectives Implementing a Delete Overview Error Handling Overview Exception Types Message Types Message Dictionary Attribute-level Exceptions Example OAAttrValException Entity Attribute Example Other Features Dialog Pages Example: Redirect to a Basic Warning Page Message Boxes Message Boxes Example Resources Overview Task 1: Implement a Delete in Your EmployeeEOImpl Class Task 2: Implement a Delete Switcher Task 3: Implement the Delete Action (Optional) Challenge Task: Create and Implement the Status Column Summary Implementing an Update i Extend Oracle Applications: Building OA Framework Applications Objectives Finished Page Overview Task 1: Make a Copy of Your EmployeePG Task 2: Add an Update Column to the Search Page (Optional) Challenge Exercise: Create a Multistep Update Task CE-1: Modify EmpUpdatePG to Create the "Step 1" Page Task CE-2: Build the "Step 2" Page Task CE-3: Build the "Step 3" Page Task CE-4: Build and Implement the Shared Train Task CE-5: Build and Implement the Shared Navigation Buttons Summary Creating Applications' Menus and Function Security i Extend Oracle Applications: Building OA Framework Applications Objectives Example Menu Menu: Global Menu Menu: Tabs Menu: Horizontal Navigation Menu: Side Navigation Menu: Subtab Menu: Task/Property Menu Menu Structures Oracle Applications Forms Creating Menus Register Functions Functions Menu Context Creating Responsibilities Creating Users Using JSP Pages for Testing Creating JSP Pages to Call Menus Future Direction: Navigation and Security Separate Grants and Permissions Structures vii

10 Summary Personalizing and Extending OA Framework Pages i Extend Oracle Applications: Building OA Framework Applications Objectives Personalization vs Extension Personalization Capabilities Types of Extensions Oracle Applications Technology Stack Overview User Interface Personalization Administrator Personalization Administrator Personalization Features User Personalizations User Personalization Features Benefits of Personalizations Extension Types Adding a New Page Extensions: Adding a New Page Adding Attributes Add Attribute Scenario Override Default Values Scenario Override Attribute Validation Scenario Summary Naming Standards and Deploying an OA Framework Page i Extend Oracle Applications: Building OA Framework Applications Objectives OA Framework File Standards Package Names File Names Standard File Suffix Abbreviations Region and Item Names JDeveloper to Apache Mapping Deploying Model and Controller Files Deploying the BC4J Substitutions File Deploying the View XMLImporter Compatibility Summary Understanding OA Framework State Management i Extend Oracle Applications: Building OA Framework Applications Objectives Agenda State Management State Architecture Root Application Module Application Module Default Behavior Servlet Session Applications User Session (ICX Session) Page Context Request Parameter Values Token Types Ways to Pass Parameters Related Topic: Passivation Passivation Demonstration: Application Module Management viii

11 Expense Report Flow Setup Flow Related Pages on Same Menu Tab Different Page Flows: Create Missing Supplier Recommendations: Multipage Flow Recommendations: Multipage Flow with Side Trip Flow More Recommendations for Side Trip Flow: Use "Extended Pages" Recommendations: Unrelated Pages Summary ix

12

13 Preface Profile Before You Begin This Course Before you begin this course, you should have the following qualifications: Thorough knowledge of Oracle Applications System Administration Working experience with Java programming Prerequisites There are no prerequisites for this course. How This Course Is Organized 11i Extending Oracle Applications: Building OA Framework Applications is an instructor-led course featuring lecture and hands-on exercises. Online demonstrations and written practice sessions reinforce the concepts and skills introduced. xi

14 Related Publications Oracle Publications Title Part Number Additional Publications System release bulletins Installation and user s guides Read-me files International Oracle User s Group (IOUG) articles Oracle Magazine xii

15 Typographic Conventions Typographic Conventions in Text Convention Element Example Bold italic Caps and lowercase Courier new, case sensitive (default is lowercase) Initial cap Italic Quotation marks Uppercase Glossary term (if there is a glossary) Buttons, check boxes, triggers, windows Code output, directory names, filenames, passwords, pathnames, URLs, user input, usernames Graphics labels (unless the term is a proper noun) Emphasized words and phrases, titles of books and courses, variables Interface elements with long names that have only initial caps; lesson and chapter titles in crossreferences SQL column names, commands, functions, schemas, table names The algorithm inserts the new key. Click the Executable button. Select the Can t Delete Card check box. Assign a When-Validate-Item trigger to the ORD block. Open the Master Schedule window. Code output: debug.set ( I, 300); Directory: bin (DOS), $FMHOME (UNIX) Filename: Locate the init.ora file. Password: User tiger as your password. Pathname: Open c:\my_docs\projects URL: Go to User input: Enter 300 Username: Log on as scott Customer address (but Oracle Payables) Do not save changes to the database. For further information, see Oracle7 Server SQL Language Reference Manual. Enter user_id@us.oracle.com, where user_id is the name of the user. Select Include a reusable module component and click Finish. This subject is covered in Unit II, Lesson 3, Working with Objects. Use the SELECT command to view information stored in the LAST_NAME column of the EMP table. Arrow Menu paths Select File > Save. Brackets Key names Press [Enter]. Commas Key sequences Press and release keys one at a time: [Alternate], [F], [D] Plus signs Key combinations Press and hold these keys simultaneously: [Ctrl]+[Alt]+[Del] xiii

16 Typographic Conventions in Code Convention Element Example Caps and Oracle Forms When-Validate-Item lowercase triggers Lowercase Column names, table names SELECT last_name FROM s_emp; Passwords PL/SQL objects DROP USER scott IDENTIFIED BY tiger; OG_ACTIVATE_LAYER (OG_GET_LAYER ( prod_pie_layer )) Lowercase italic Uppercase Syntax variables SQL commands and functions CREATE ROLE role SELECT userid FROM emp; Typographic Conventions in Oracle Application Navigation Paths This course uses simplified navigation paths, such as the following example, to direct you through Oracle Applications. (N) Invoice > Entry > Invoice Batches Summary (M) Query > Find (B) Approve This simplified path translates to the following: 1. (N) From the Navigator window, select Invoice then Entry then Invoice Batches Summary. 2. (M) From the menu, select Query then Find. 3. (B) Click the Approve button. Notations: (N) = Navigator (M) = Menu (T) = Tab (B) = Button (I) = Icon (H) = Hyperlink (ST) = Sub Tab xiv

17 Typographical Conventions in Oracle Application Help System Paths This course uses a navigation path convention to represent actions you perform to find pertinent information in the Oracle Applications Help System. The following help navigation path, for example (Help) General Ledger > Journals > Enter Journals represents the following sequence of actions: 1. In the navigation frame of the help system window, expand the General Ledger entry. 2. Under the General Ledger entry, expand Journals. 3. Under Journals, select Enter Journals. 4. Review the Enter Journals topic that appears in the document frame of the help system window. xv

18 xvi