Transcript Slide 1

1
© 2009 Oracle Corporation – Proprietary and Confidential
<Insert Picture Here>
Extracting maximum value from latest Oracle Desktop Integration
Framework (DIF) features
Sudhir Gupta
Sr Consultant - Oracle Consulting
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
Introducing Oracle E-business suite Desktop
Integration Framework
Design Time Framework to develop desktop Integration solutions
for Oracle E-business suite applications
6
© 2009 Oracle Corporation – Proprietary and Confidential
Desktop Integration Framework
Architecture
Desktop Integration Framework
ATG
Integrator
Interface
Component
Content
Business
Rules
CRM
Financials
Oracle
Web ADI
Metadata Repository
HRMS
…
SCM
Integrator Services
Design Time
Run Time
7
© 2009 Oracle Corporation – Proprietary and Confidential
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 )
•
•
•
•
8
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
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
9
© 2009 Oracle Corporation – Proprietary and Confidential
Desktop Integration Framework
Process flow
To define custom desktop integrators
10
Define Integrator
properties
Define Layout
Create Interface
Define Mappings
Create Content
Create Document
© 2009 Oracle Corporation – Proprietary and Confidential
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
11
© 2009 Oracle Corporation – Proprietary and Confidential
Integrator
Screenshot
12
© 2009 Oracle Corporation – Proprietary and Confidential
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
13
© 2009 Oracle Corporation – Proprietary and Confidential
Integrator
Description contd..
• Integrator Parameters
• Depending upon Business needs user can define set of parameters that can be used by
integrator at run-time
•
•
•
•
14
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
Integrator
Screenshot
15
© 2009 Oracle Corporation – Proprietary and Confidential
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
16
© 2009 Oracle Corporation – Proprietary and Confidential
Interfaces in Integrator
Screenshot
17
© 2009 Oracle Corporation – Proprietary and Confidential
Interfaces in Integrator
Screenshot
18
© 2009 Oracle Corporation – Proprietary and Confidential
Interfaces in Integrator
Screenshot
19
© 2009 Oracle Corporation – Proprietary and Confidential
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)
20
© 2009 Oracle Corporation – Proprietary and Confidential
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
21
© 2009 Oracle Corporation – Proprietary and Confidential
Interfaces in Integrator
Validation Screenshot
22
© 2009 Oracle Corporation – Proprietary and Confidential
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
23
© 2009 Oracle Corporation – Proprietary and Confidential
Contents in Integrator
Screenshots
24
© 2009 Oracle Corporation – Proprietary and Confidential
Contents in Integrator
Screenshots
25
© 2009 Oracle Corporation – Proprietary and Confidential
Contents in Integrator
Screenshots
26
© 2009 Oracle Corporation – Proprietary and Confidential
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.
27
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
28
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
29
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
30
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
31
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
32
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
33
© 2009 Oracle Corporation – Proprietary and Confidential
Layouts & Mappings of Integrator
Screenshots
34
© 2009 Oracle Corporation – Proprietary and Confidential
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
35
© 2009 Oracle Corporation – Proprietary and Confidential
UI Components
Screenshots
36
© 2009 Oracle Corporation – Proprietary and Confidential
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
37
© 2009 Oracle Corporation – Proprietary and Confidential
Define Parameter
Screenshot
38
© 2009 Oracle Corporation – Proprietary and Confidential
Define Parameter
Screenshot
39
© 2009 Oracle Corporation – Proprietary and Confidential
Define Parameter
Screenshot
40
© 2009 Oracle Corporation – Proprietary and Confidential
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)
41
© 2009 Oracle Corporation – Proprietary and Confidential
Desktop Integration Framework
Process flow
To define custom desktop integrators
Define Integrator
properties
Define Layout
Create Interface
Define Mappings
Create Content
Create Document
1.Login as operations and choose responsibility “Desktop Integration Manager”.
2.By going to this responsibility you can create custom integrators.
42
© 2009 Oracle Corporation – Proprietary and Confidential
Desktop Integration Framework
Demo
43
© 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 12.1.2 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
http://hostname/OA_HTML/BneAdminServlet 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.
E15877-01 / December 2009
• Above developer guide is available in http://support.oracle.com/
• Contact Email – [email protected]
46
© 2009 Oracle Corporation – Proprietary and Confidential