Desktop Integrators You Mean I Can Load Data Straight From a Spreadsheet? Lee Briggs Director, Financials Practice BizTech LBriggs@BizTech.com Session ID: 7627
Please set your cell phones to silent mode.
Agenda Introductions Application Desktop Integrator and Web-ADI R12 New Functionality Creating a Custom Integrator - Preparation Create the Integrator Define the Layout Start Loading Data More than the Basics Lists of Values Q & A
About Lee Briggs Director, Finance Practice with BizTech 10 Years of Oracle Application implementation experience Financials and Supply Chain from 11.5.3 through R12.1.3 Custom Reporting using FSGs, OBIEE, and BI Publisher Experience with clients across all industries, with a focus on Business Services, Professional Services and Banking industries Chair of the ADI SIG Oracle Certified Specialist in General Ledger and Payables
About BizTech Leading Mid-Atlantic Oracle Platinum Partner and IT Services firm focused on Oracle Applications and Technology solutions Over 400 successful Oracle implementations over the past 15 years Based in King of Prussia, PA with offices in New Jersey, New York City and Washington DC Service Fortune 500 companies, organizations and government agencies 100 + Oracle certified and experienced consultants
Client-Centric Practice Areas Oracle Applications - Full Portfolio of Oracle Applications Solutions - Implementation, Upgrade, Migration - Since 1990 MPL6 to R12 Experience - Over 400 successful implementations to date Oracle Technology and Business Intelligence - End to end service offering in BI and EPM - Fully staffed team of Data Architects and DBAs - Solid experience in RAC, HA and HS designs - Understand full Oracle technology stack Oracle Applications Oracle Technology BI/EPM Clients Managed Services ITO Oracle Software Provider Managed Services and IT Outsource - Remote or Onsite services - Full portfolio of Oracle Applications and Technologies - World-Class Data Center with 24x7 Support - Instant capacity, operational focused business model Oracle Software Provider - Full Portfolio of Oracle License Resell - Help Clients Optimize License models - RapidApp BI Software for the agile enterprise - RapidApp Auditor to manage change and GRC
Oracle Application Desktop Integrator (ADI) Integral part of Oracle Financial Applications Initially released as a stand-alone application installed on a client pc Spreadsheet-based extension of General Ledger and Assets Enables users to create budgets, record financial transactions and run financial reports in Microsoft Excel
Oracle Application Desktop Integrator (ADI) Enables user to revise budgets, create journal entries and define financial reports from any location without being connected to the server Required to be connected to transfer data to or from Oracle Applications
Application Desktop Integrator Full Features Journals Budgeting Report Definition Report Publishing Formatting Reports Report Drilldown Create Assets Physical Inventory Diagnostics
Web ADI From release 11.5.9, Oracle began to migrate towards Web ADI Uses Internet computer architecture to lower the cost of ownership by having the product centrally installed and maintained No client installation is required Provides superior performance
Web ADI Initially a journals-only solution Additional functionality gradually released
R12 ADI is De-Supported Oracle Support Note 377640.1 advises that Client/Server ADI is not supported for R12 All FSG reporting within Oracle Applications is being moved to BI Publisher and Report Manager 11.5.10 Documentation for General Ledger no longer refers to Client ADI, but instead directs users to use preconfigured Web-ADI solutions for Journal Uploads, Budget Uploads.
R12 New Functionality Web ADI is repackaged as Desktop Integrator As well as pre-packaged integrators, provides functionality to now build custom integrators to load data to ANY interface table or API
Creating a Custom Integrator: Preparation BNE% Profile Options Profile Name BNE Server Log Level BNE Server Log Path BNE Servlet Path BNE UIX Base Path BNE UIX Physical Directory BNE Upload Import Directory BNE Upload Staging Directory BNE Upload Text Directory Value Trace $BNE_TOP/log /oa_servlets/ /OA_HTML/cabo $COMMON_TOP/webapps/oacore/html/cabo/ $BNE_TOP/upload/import $BNE_TOP/upload $BNE_TOP/upload
Creating a Custom Integrator: Preparation Replace $BNE_TOP and $COMMON_TOP with the actual values With DBA assistance, check the following directories exist with 777 permissions $BNE_TOP/log $COMMON_TOP/webapps/oacore/html/cabo $BNE_TOP/upload/import $BNE_TOP/upload
Creating a Custom Integrator: Preparation Most important preparation tip Once these profile options have been updated, bounce the ENTIRE instance Assign your user two responsibilities Desktop Integration Manager Desktop Integration
Creating a Custom Integrator: Preparation Microsoft Excel setup You must Trust Access to Visual Basic Project You must allow Macros to run
Creating a Simple Custom Integrator No validation of data in the integrator No look-ups No content No custom upload parameters User enters ALL data
Creating a Simple Custom Integrator 1. Create the Integrator 2. Define the Integrator Layout 3. Start Loading Data
Create the Integrator Responsibility: Desktop Integration Manager Navigation: Create Integrator
Enter Integrator Information
Enter Integrator Information Integrator Name The name of the integrator as the user will see it Internal Name The name of the integrator as the system sees it Application The name of the module that owns the interface table
Security Rules First Gotcha (No mention of Security Rules in Implementation and Administration Manual) Add two Security Functions Desktop Integration Create Document (Code: BNE_ADI_CREATE_DOCUMENT) Create Document (Code: BNE_CREATE_DOCUMENT)
Create the Interface
Create the Interface Interface Name What you will refer to the interface name as Interface Type Select from Table, API Procedure, API Function Table Name Select the Table Name you will be populating data GOTCHA #2 Click on APPLY!
Create the Interface
Create the Interface Once you ve clicked on Apply, every column from the table will be displayed here Best Practice Use forms personalization to increase number of rows returned (25 per page by default!) Best Practice Identify the Required Fields, and the fields you want. Best Practice Set every other field listed to not display
Create Content
Create Uploader List
Create Uploader List Uploader List (new in R12.1.3) allows you to specify what options are available to the user upon upload What rows to upload (all, flagged, etc) How the rows are validated Whether to invoke an import process automatically
Define Importer List
Define Importer List Importer List allows you to specify how to move uploaded data from interface tables to base tables Allows you to apply validation rules to apply before import to base tables
Define the Layout Responsibility: Desktop Integration Manager Navigation: Define Layout
Define the Layout
Define the Layout Select the Integrator for which you are defining the layout Over 225 seeded integrators will also show in this list
Create the Layout
Create the Layout Layout Name You can have multiple Desktop Layouts for the same integrator Number of Header Records Dependent on what you re trying to accomplish with the data you re loading
Create the Layout
Create the Layout Here, you can control where fields appear (Header or lines) Example AP Invoice Headers import Operating Unit could be the same for all invoice headers Invoice Currency could be the same for all invoice headers Vendor would be different for each invoice header
Create the Layout You can also default information in here, whether it s constant, derived by SQL, on an environment variable Default Invoice currency to USD Default User information Created By : FND_GLOBAL.USER_ID Last Updated By: FND_GLOBAL_ID Last Update Login: FND_GLOBAL.LOGIN_ID Creation Date: SYSDATE Last Update Date: SYSDATE
Create the Layout GOTCHA #3 Updates to the layout and integrators will not always show up once you ve saved an requeried the layout DBA s will need to clear Java cache on the instance after EVERY change, or assign yourself Functional Administrator responsibility, and clear the Cache yourself!!
Start Loading Data! Responsibility: Desktop Integration Navigation: Create Document
Start Loading Data - Select the Integrator
Start Loading Data - Select the Viewer
Start Loading Data - Select the Viewer Viewers include various versions of: Microsoft Excel Microsoft Project Microsoft Word Mobile Sales Deployment for Windows
Start Loading Data - Select the Layout
Start Loading Data Review your Criteria
Start Loading Data
More than the Basics List of Values Component Components allow you to return list of values for a field Example Let me present a list of all my AP Invoice Types so I can pick from them, rather than having to type the Invoice Type (and get it exactly right)
More than the Basics List of Values Responsibility Desktop Integration Manager Navigation Manage Components
More than the Basics List of Values
More than the Basics List of Values Parameter Name Parameter Value Table-column-alias INVOICE_TYPE_LOOKUP_CODE Table-column-sort ASCENDING Table-columns LOOKUP_CODE,MEANING,DESCRIPTION Table-headers Lookup Code,Meaning,Description Table-select-column INVOICE_TYPE_LOOKUP_CODE Window-caption Lookup Code,Meaning,Description Window-height 500 Window-width 400
More than the Basics List of Values Navigation Manage Integrators Select the Integrator Select the Interface Page Update the attribute for List of Values
More than the Basics List of Values
More than the Basics List of Values Label Validation Type ID Column Meaning Column Desc Column Validation Entity Where Clause Component Name LOV Type Value Table LOOKUP_CODE LOOKUP_CODE DESCRIPTION FND_LOOKUP_VALUES_VL (Nvl('', Territory_Code) = Territory_Code Or Territory_Code Is Null) And Lookup_Type = 'INVOICE TYPE' And (Lookup_Type='INVOICE TYPE') And (View_Application_Id=200) And (Security_Group_Id=0) And Enabled_Flag = 'Y' XXPC AP Invoice Type Standard
More than the Basics List of Values
Questions? Lee Briggs Director, Financial Practice LBriggs@BizTech.com Twitter: BizTechOracle