© 2009 Oracle Corporation – Proprietary and Confidential 1

Extracting maximum value from latest Oracle Desktop Integration Framework (DIF) features Sudhir Gupta Sr Consultant - Oracle Consulting

© 2009 Oracle Corporation – Proprietary and Confidential Agenda Oracle Web ADI Desktop Integration Framework Overview Integrator Interface & Validation Rules Content Layout & Mapping UI Components Define Parameter Demo Q&A Implementation Overview Additional Resources

© 2009 Oracle Corporation – Proprietary and Confidential Oracle Web ADI Overview -Recap Metadata Driven Framework which provides integration of Oracle Ebusiness suite with desktop applications – Generate documents of Microsoft Excel™, Word™,Projects™ on the desktop Enables download of data from database, text files to desktop document Enables upload of data to E-business suite (PL/SQL,Interface Tables) Configurable layouts determine the appearance of the document to be created Incorporation of LOV’s, Validation into spreadsheets but retain the familiarity of Spreadsheet UI Leverages Oracle E-business security model Supports concurrent Manager to import data from Interface tables to Base tables

© 2009 Oracle Corporation – Proprietary and Confidential Oracle Web ADI In Use Today EBS consist of 150 plus Desktop Integration solution out-of-box across all product families Growing Need for developing custom Integrator

© 2009 Oracle Corporation – Proprietary and Confidential 6 Introducing Oracle E-business suite Desktop Integration Framework Design Time Framework to develop desktop Integration solutions for Oracle E-business suite applications

© 2009 Oracle Corporation – Proprietary and Confidential 7 Desktop Integration Framework Architecture Desktop Integration Framework CRMCRM FinancialsFinancials HRMSHRMS …… SCMSCM Design Time Run Time Integrator Interface Component Content Business Rules ATGATG Metadata Repository Integrator Services Oracle Web ADI

© 2009 Oracle Corporation – Proprietary and Confidential 8 Desktop Integration Framework Features Create desktop integrators using wizard based UI Define Integrator to upload data through PL/SQL API or directly to Table Define Integrator to download data from Text file or using SQL Query Define UI components Support for UI widgets to embed them in Excel (List of values, Pop lists, Date pickers, Flex fields ) Define Layouts & Mappings for custom integrator Leverages E-Business Suite Security Model Consume Integrator as part of business flow Define layout and mappings for custom integrator

© 2009 Oracle Corporation – Proprietary and Confidential 9 Desktop Integration Framework Business Value Support for custom integrator definition through Desktop Integration framework Extensible Desktop Integration Tighter Integration with Oracle E-business suite Full Integration with Oracle E-business suite security model Upgrade-Safe Reduced Implementation time Enhanced Productivity Lower Cost of Ownership Re-Utilize ADI components such as Parameters,LOV’s etc

© 2009 Oracle Corporation – Proprietary and Confidential Desktop Integration Framework Process flow 10 Create Interface Create Content Define Integrator properties To define custom desktop integrators Define Mappings Create Document Define Layout

© 2009 Oracle Corporation – Proprietary and Confidential 11 Integrator Description Integrator: Encapsulates all information required to move data to/from a desktop application into Oracle E-Business Suite. May include information about open interface tables, validation, business rules, and data that can be downloaded. Go to responsibility “Desktop Integration Manager” and choose “Manage Integrators” function to create/edit custom Integrators. User can Create, Update and Delete Integrators from Manage Integrators function. Note: Oracle seeded integrators cannot be updated or deleted. User can define Layout and Mappings for Integrator User can Search Integrators by Name, Internal Name, Application, Source and Enabled status

© 2009 Oracle Corporation – Proprietary and Confidential 12 Integrator Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 13 Integrator Description Wizard based UI to create Integrator Define Integrator related properties,parameters and function based security rules Note – Only Enabled Integrator will be available for use in the business flow Security Rules – User can define function based security rules for integrator End users

© 2009 Oracle Corporation – Proprietary and Confidential 14 Integrator Description contd.. Integrator Parameters Depending upon Business needs user can define set of parameters that can be used by integrator at run-time Upload & Server Parameters : to define upload page displayed to end user and for back-end service while uploading data to EBS Importer Parameters : to define rules for importing data from interface tables to base tables Documents Parameter:to define input values to be taken from end user while creating the document Session Parameters : to define values to be retained with the document for the session

© 2009 Oracle Corporation – Proprietary and Confidential 15 Integrator Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 16 Interfaces in Integrator Description Interface: Definition of Table or PL/SQL API (Procedure, Function) used for uploading data into Oracle E-Business Suite User can Create, Update, Delete Interfaces Interface Attributes: Describe the columns/ parameters of Interface tables/ APIs and how data for these should be validated Interface Attributes are automatically generated for selected Interface User can add custom Interface Attribute User can set Interface Attribute properties: Default Value of Type – Constant, SQL Query, Environment Variable, Lookup, Parameter, Profile Option Validation Rules – Table, Java, Group Validation and Flex Field Display Text and other properties which determines whether Interface Attribute is enabled, mandatory, displayed, used to retrieve error message

© 2009 Oracle Corporation – Proprietary and Confidential 17 Interfaces in Integrator Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 18 Interfaces in Integrator Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 19 Interfaces in Integrator Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 20 Interfaces in Integrator Validation Table Validation Validate field against values in a column of table based on condition (during Upload) Retrieve List of Values by attaching Component (in Excel document) Java Validation Provide List of Values for a field in document Validate field against complex business rules by extending java classes BneBaseSQL – SQL Java class contains all of the SQL queries required for LOV and upload validation BneUploadValidator- Validator Java class that contains all the business logic for Java validation BneAbstractListOfValues – Component Java class that contains all the business logic and setup information for generating list of values for Java page document (if used for Java Validated LOV)

© 2009 Oracle Corporation – Proprietary and Confidential 21 Interfaces in Integrator Validation Cont’d.. Group Validation Used to validate different interdependent fields as group or to validate a set of fields as a group at once Require user to indentify a parent field and multiple dependent fields Flexfield Validation Key Flex field and Desc Flex field Validation and LOV retrieval Identify KFF Segments and Parent Key flex field.Associate KFF Structure code Identify DFF Context & Segments and Parent Desc flex field.Associate DFF Structure code Other data integrity validation during upload – data types,column width,not nulls, etc Pop-list (For offline users) and calendar are other validation provided in the document

© 2009 Oracle Corporation – Proprietary and Confidential 22 Interfaces in Integrator Validation Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 23 Contents in Integrator Description Contents: Definition of the data that can be downloaded from Text File, or SQL Query into document Define Multiple Content for Integrator: While creating document end-user can select a content to extract data Seeded text content is available for integrator (cannot be deleted) Content Attributes: Represent the column/ field that exists in Text File or SQL Content Automatically generated. Content Parameters: Represent any input values required for execution of SQL Query While creating document, depending upon selected Content, end-user will be prompted for these inputs

© 2009 Oracle Corporation – Proprietary and Confidential 24 Contents in Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 25 Contents in Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 26 Contents in Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 27 Layouts & Mappings of Integrator Overview - Recap Layout: Describe the Interface Attributes/ columns that will be displayed in desktop application document, and where they will be displayed (Context-Header/ Header/ Line) Use style-sheet to define format Define default values for columns (Constant, Environment Variable, Lookup, SQL) It is mandatory to define at least one Layout for an Interface Define custom look and feel & properties for the Desktop Document Mapping Link the Content Attributes (that will be downloaded into document) and Interface Attributes (into which the data will be uploaded) For Reporting Only Contents, you need not define Mapping. For rest of the Contents, it is mandatory to define Mapping.

© 2009 Oracle Corporation – Proprietary and Confidential 28 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 29 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 30 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 31 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 32 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 33 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 34 Layouts & Mappings of Integrator Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 35 UI Components Description Component: Describes UI object that is used for validation of a field in document Manage Components function in Desktop Integration Manager responsibility User can create Component – Date Picker, Flex Field, List of Values based on Java or Table User can search Components by Name, Code and Application

© 2009 Oracle Corporation – Proprietary and Confidential 36 UI Components Screenshots

© 2009 Oracle Corporation – Proprietary and Confidential 37 Define Parameter Description UI to define different types of Integrator Parameters Parameter List: Set of logically related Parameters Parameter Definition: Describe the display options (text, style, type), default values, validation types of the parameter Parameter Attributes: Name-Value pairs that store additional information. Used at run-time to implement complex business logic. User can create Parameter in a Parameter List, and edit its definition User can duplicate and test Parameter List

© 2009 Oracle Corporation – Proprietary and Confidential 38 Define Parameter Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 39 Define Parameter Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 40 Define Parameter Screenshot

© 2009 Oracle Corporation – Proprietary and Confidential 41 Desktop Integration Framework Consume Integrator Consume Integrator definition from OA Page,Forms,Self Service Menu/Function,Create document function in the Desktop Integration responsibility Use Oracle Web ADI’s Create Document wizard It prompts end-user for Integrator,Viewer,Layout,Content,Mapping and parameters(if any, based on selected integrator & content) Review page with all the selected values Define Document Creation shortcuts and directly generate document (without any web ADI prompts)

© 2009 Oracle Corporation – Proprietary and Confidential Desktop Integration Framework Process flow 42 1.Login as operations and choose responsibility “Desktop Integration Manager”. 2.By going to this responsibility you can create custom integrators. Create Interface Create Content Define Integrator properties To define custom desktop integrators Define Mappings Create Document Define Layout

© 2009 Oracle Corporation – Proprietary and Confidential 43 Desktop Integration Framework Demo

© 2009 Oracle Corporation – Proprietary and Confidential Question and Answers Thank You

© 2009 Oracle Corporation – Proprietary and Confidential FAQs and Tips 1.Desktop Integration framework is available above Release onwards. 2.Custom Table should be created in BNE schema. 3.Public Synonym against this custom table must be created in APPS schema. 4.Custom Table must be registered in BNE schema. 5.While choosing the custom table, choose application “Web Applications Desktop Integrator” 6.While creating custom integrator(used for uploading data to database) use “HR Upload Parameter List” as “Upload Parameter” in the “Integrator parameters” section 7.And add function “Desktop Integration - Create Document” for any new integrator. 8.For custom integrator with Text Content, assign parameter list "Web ADI: Download "Text File" Parameters“. 9.To clear BNE cache after any changes in custom integrator, pls use following URL and click on first “clear” link(and use browser back button to go to application) 10.while creating parameter names, pls assign application if it is specific to appln and name it as unique as possible(or check name before creating new)

© 2009 Oracle Corporation – Proprietary and Confidential Additional Resources Document by Metalink: Oracle® E-Business Suite Desktop Integration Framework Developer's Guide/ Release 12.1 / Part No. E / December 2009 Above developer guide is available in Contact – 46