Professional Documents
Culture Documents
1]
Modified: 22-Aug-2012 Type: TROUBLESHOOTING Status: PUBLISHED Priority: 3
Applies to:
Oracle Web Applications Desktop Integrator - Version 11.5.8 to 12.1.3 [Release 11.5 to 12.1] Information in this document applies to any platform. Web ADI
Purpose
This document is to help better understand the setup and configuration of Web ADI with Oracle Applications and hit on the key issues that are seen within ATG Web ADI Support.
Troubleshooting Steps
Release 12 Desktop Integrator Responsibility Official script for BNE responsibilities is: $BNE_TOP/patch/115/import/US/bneresp.ldt For Release 12.x, this ldt does just have 'Desktop Integration' responsibility, and it has had just that one in all versions for 120.x and 120.x.1200000.x Integrators: -An Integrator is a Web ADI term used to encapsulate all of the information required to move data to/from a desktop application into Oracle Applications. An Integrator definition may include information about open interface tables, validation, business rules, and data that can be downloaded. -System Administrator > Application > Function > create a new function similar to the Web ADI Create Document function, but change the bne:page=BneCreateDoc -URL Call BneApplicationServiceBneApplicationService?bne:page=BneCreateDoc -A list of currently installed integrators can be seen with the following SQL query : select user_name from bne_integrators_tl order by 1; -This query lists the integrator name and product and can be used to just see what integrators are available for a particular Product SELECT biv.integrator_code, biv.user_name,
1 / 10
fa.application_id, fa.application_short_name FROM bne_integrators_vl biv, fnd_application fa, fnd_application_tl fat WHERE biv.application_id = fa.application_id AND fa.application_id = fat.application_id /* The next line can be commented out to return all products */ AND fa.application_short_name = '&ApplicationShortNameApplicationShortName' AND fat.language = 'US' ORDER BY fa.application_short_name, biv.user_name; -To allow a Integrator to be removed from the list or enabled, update the enabled_flag on the bne_integrators_b table to "Y" or "N" for the desired : integrator_code/application_id combination. UPDATE bne_integrators_b SET enabled_flag='N' WHERE integrator_name='<Integrator name>'; Viewers: -A Viewer is a Web ADI term for the desktop application in which a document will be generated. -A customer can select Excel 97 from the list and still generate a spreadsheet successfully on Excel 2007. The BNE .ldt file which creates the Viewer List is the bnevw.ldt. For example, the Version 115.59.1013.4 Will deliver the Excel 2007 for 11i Applications. $BNE_TOP/patch/import/US/bnevw.ldt FNDLOAD APPS/APPS 0 Y UPLOAD $BNE_TOP/admin/import/bnevw.lct $BNE_TOP/patch/115/import/US/bnevw.ldt Layouts: -A Layout tells Web ADI which columns will be displayed in the Desktop Application document and how those columns will be displayed, including formatting. Web ADI provides a set of screens that users and Integrator Developers can use to create their own Layouts. Integrator Developers are able to provide Layouts as seed data. FNDLOAD APPS/APPS 0 Y UPLOAD $BNE_TOP/admin/import/bnelay.lct $BNE_TOP/patch/115/import/US/bnelay.ldt Tables related to Layout definition: -select count(1) from BNE.BNE_LAYOUTS_B; -select count(1) from BNE.BNE_LAYOUTS_TL; -select count(1) from BNE.BNE_LAYOUT_BLOCKS_B; -select count(1) from BNE.BNE_LAYOUT_COLS; -select count(1) from BNE.BNE_LAYOUT_LOBS; select lt.user_name, lc.layout_code, lc.block_id, lc.interface_seq_num from bne_layout_cols lc, bne_layouts_b lb, bne_layouts_tl lt where lb.application_id = lt.application_id and lb.layout_code = lt.layout_code and lb.integrator_app_id = 231 and lb.integrator_code = 'JOURNALS_115' and lc.application_id = lt.application_id and lc.layout_code = lt.layout_code and lt.language = 'US' and lc.application_id = 231 and lc.interface_app_id = 231 and lc.interface_code = 'GL_INTERFACE_115' order by lc.layout_code, lc.block_id, lc.interface_seq_num;
Content: -This is the information that will be downloaded into the Viewer. Content definitions is to identify the data to be downloaded, and any required parameters. The Content that is passed to or selected in the Create Document page flow determines the Content that will be used to derive the Content data.
2 / 10
The Login URL for the BNE when attempting to Upload. oracle.apps.bne.webui.pageflow.BneOALoginPage.class calls the cancelUrl and successUrl
How BNE pulls the Responsibilities: Bne Responsibilities web page is oracle.apps.bne.webui.pageflow.BneOALoginPage2.java Which, gets the resp list from oracle.apps.bne.utilities.oa.BneOASessionUtils.java Which uses these queries: sqlQuery = "SELECT RT.RESPONSIBILITY_NAME, UR.RESPONSIBILITY_APPLICATION_ID, UR.RESPONSIBILITY_ID " + "FROM FND_RESPONSIBILITY_TL RT, FND_RESPONSIBILITY R, FND_USER_RESP_GROUPS UR " + "WHERE UR.USER_ID = :1 " + "AND SYSDATE BETWEEN UR.START_DATE AND NVL(UR.END_DATE, SYSDATE) " + "AND R.APPLICATION_ID = UR.RESPONSIBILITY_APPLICATION_ID " + "AND R.RESPONSIBILITY_ID = UR.RESPONSIBILITY_ID " + "AND SYSDATE BETWEEN R.START_DATE AND NVL(R.END_DATE, SYSDATE) " + "AND R.APPLICATION_ID = RT.APPLICATION_ID " + "AND R.RESPONSIBILITY_ID = RT.RESPONSIBILITY_ID " + "AND RT.LANGUAGE = :2 "; if ( version != null ) { sqlQuery += "AND NVL(R.VERSION, '0') = :3 "; } sqlQuery += "ORDER BY 1 "; OR String sqlQuery = "SELECT RT.RESPONSIBILITY_NAME, UR.RESPONSIBILITY_APPLICATION_ID, UR.RESPONSIBILITY_ID, S.SECURITY_GROUP_NAME, S.SECURITY_GROUP_ID " + "FROM FND_RESPONSIBILITY_TL RT, FND_RESPONSIBILITY R, FND_USER_RESP_GROUPS UR, FND_SECURITY_GROUPS_VL S " + "WHERE UR.USER_ID = :1 " + "AND SYSDATE BETWEEN UR.START_DATE AND NVL(UR.END_DATE, SYSDATE) " + "AND R.APPLICATION_ID = UR.RESPONSIBILITY_APPLICATION_ID " + "AND R.RESPONSIBILITY_ID = UR.RESPONSIBILITY_ID " + "AND SYSDATE BETWEEN R.START_DATE AND NVL(R.END_DATE, SYSDATE) " + "AND R.APPLICATION_ID = RT.APPLICATION_ID " + "AND R.RESPONSIBILITY_ID = RT.RESPONSIBILITY_ID " + "AND UR.SECURITY_GROUP_ID = S.SECURITY_GROUP_ID " + "AND RT.LANGUAGE = :2 "; if ( version != null ) { sqlQuery += "AND NVL(R.VERSION, '0') = :3 ";
BNE Servlets: The Release 12 BNE Servlets can be found under following location: $ORA_CONFIG_HOME/10.1.3/j2ee/oacore/application-deployments/oacore/html/orion-web.xml
3 / 10
Note: Don't confuse '$IAS_ORACLE_HOME' with '$ORA_CONFIG_HOME' as the $IAS_ORACLE_HOME will point you to the wrong orion-web.xml.
<!-- WEBADI Servlets --> <servlet> <servlet-name>BneApplicationServiceBneApplicationService</servlet-name> <servlet-class>oracle.apps.bne.webui.BneApplicationService</servlet-class> </servlet> Description: Application Service is a re-implementation of a simple UIX ( CABO ) Page Broker. Its primary purpose is to deliver UIX ( CABO ) pages and flows ( including menus ) via a BneBasePage Controller and BneBasePage which retains UIX ( MARILN ) nodes and event handling. <servlet> <servlet-name>BneComponentServiceBneComponentService</servlet-name> <servlet-class>oracle.apps.bne.integrator.component.BneComponentService</servlet-class> </servlet> Description: BneComponentServiceBneComponentService - Calls Component Classes passing all parameters. This is one of the three Web ADI servlets. It is concerned with the running of Web ADI components - most typically LOVs. It runs in secure (non GUEST) authentication mode. If a user is not logged in with a non GUEST account, it will force them to log in.
<servlet> <servlet-name>BneDocumentServiceBneDocumentService</servlet-name> <servlet-class>oracle.apps.bne.integrator.document.BneDocumentService</servlet-class> </servlet> Description: BneDocumentServiceBneDocumentService - servlet used for launching Bne Viewers. This servlet is deprecated in favor of using the Create Document page flow which will use the BneTemplateService to stream viewers. This will give transparent cross browser support on the windows platform, whereas this service relies on Internet Explorer functionality. As of R12, this servlet has been changed to take advantage of Document Parameters stored in the database. The core viewer parameters are now sourced from here and not the servlet request/parameter list in the servlet session. <servlet> <servlet-name>BneViewerXMLServiceBneViewerXMLService</servlet-name> <servlet-class>oracle.apps.bne.integrator.document.BneViewerXMLService</servlet-class> </servlet> Description: BneViewerXMLServiceBneViewerXMLService extends BneAbstractXMLServletBneAbstractXMLServlet. Its main steps are to Perform Validation, Load Viewer Class, Run Viewer Creation and Stream XML. <servlet> <servlet-name>BneDownloadServiceBneDownloadService</servlet-name> <servlet-class>oracle.apps.bne.integrator.download.BneDownloadService</servlet-class> </servlet> Description: BneDownloadServiceBneDownloadService extends BneAbstractXMLServletBneAbstractXMLServlet. <servlet>
4 / 10
<servlet-name>BneOfflineLOVServiceBneOfflineLOVService</servlet-name> <servlet-class>oracle.apps.bne.integrator.download.BneOfflineLOVService</servlet-class> </servlet> Description: BneOfflineLOVServiceBneOfflineLOVService extends BneAbstractXMLServletBneAbstractXMLServlet. <servlet> <servlet-name>BneUploaderService</servlet-name> <servlet-class>oracle.apps.bne.integrator.upload.BneUploaderService</servlet-class> </servlet> Description: Web Interface for Web ADI Uploads. An upload is the process of receiving an xml file of data from the viewer (excel, word, project, etc), parsing the xml, validating the data and either loading it into database tables or passing the data values to an API, either pl/sql (currently) or java (in the future) Upload functionality is accomplished at a high level by three classes. BneUploaderService (which takes the handleRequest (from BneAbstractXMLServletBneAbstractXMLServlet, which is a wrapper over the doGet/doPost from HttpServlet) into a call to....) BneUploader (which handles calling the main upload functionality via SAX) BneSAXUploader</li>
BneUploaderService is the web interface to the BneUploader class. All of the significant functionality of the upload is accomplished by the BneUploader class, refer to the javadoc for BneUploader for details about the upload functionality. Effectively this makes BneUploaderService a web wrapper for the BneUploader class. As such, there are four main functions carried out by BneUploaderService. 1st, obtain the upload file (and any http request parameters) from the servlet request 2nd, ensure that the request is made within a self service applications session 3rd, call the processUpload method of the BneUploader class 4th, return any messages to the calling environment, in xml format <servlet> <servlet-name>BneTemplateRedirectServiceBneTemplateRedirectService</servlet-name> <servlet-class>oracle.apps.bne.integrator.document.template.BneTemplateRedirectService</servlet-class> </servlet> Description: BneTemplateRedirectServiceBneTemplateRedirectService extends BneHTMLServletBneHTMLServlet. <servlet> <servlet-name>BneTemplateService</servlet-name> <servlet-class>oracle.apps.bne.integrator.document.template.BneTemplateService</servlet-class> </servlet> Description: This class is a part of the Web ADI framework used to stream Template (or Bootstrap) viewers to the client. It requires only the bne:documentId parameter sent on the http request. <servlet> <servlet-name>BneAdminServletBneAdminServlet</servlet-name> <servlet-class>oracle.apps.bne.framework.BneAdminServlet</servlet-class> </servlet> Description: This servlet is a facility to help administer Web ADI. It acts as a service to: -get log file information -change your log level -various middle tier information
5 / 10
-reset internal caches <servlet> <servlet-name>BneCaboTestServletBneCaboTestServlet</servlet-name> <servlet-class>oracle.apps.bne.framework.BneCaboTestServlet</servlet-class> </servlet> Description: This servlet is for testing Web ADI UIX configuration settings. It creates four pages, the first is a default form which is used to call 2 explanation pages and 2 test pages:UIXsimple or UIXcomplex. The form parameter "showpage" determines which of these pages is shown, if there is no value for showpage, a form is displayed giving the user various choices. Otherwise the appropriate html or UIX page is shown. <servlet> <servlet-name>BneSnoopServletBneSnoopServlet</servlet-name> <servlet-class>oracle.apps.bne.framework.BneSnoopServlet</servlet-class> </servlet> Description: This servlet is used to test the configuration of a Bne Servlet, shows the java properties and servlet properties.
Release 11.5.10 BNE Servlets can be found under following location: $IAS_ORACLE_HOME/Apache/Jserv/etc/zone.properties # ----- WEBADI Servlet ----# servlet.BneSnoopServlet.code=oracle.apps.bne.framework.BneSnoopServlet servlet.BneProxy.code=oracle.apps.bne.share.BneProxy servlet.BneComponentService.code=oracle.apps.bne.integrator.component.BneComponentService servlet.BneDocumentService.code=oracle.apps.bne.integrator.document.BneDocumentService servlet.BneApplicationService.code=oracle.apps.bne.webui.BneApplicationService servlet.BneCaboTestServlet.code=oracle.apps.bne.framework.BneCaboTestServlet servlet.BneUploaderService.code=oracle.apps.bne.integrator.upload.BneUploaderService
You may see references to BNE in the jserv.properties, however this parameter is no longer used as of 11.5.9 and higher. wrapper.classpath=/u02/oracle/visappl/bne/11.5.0/conf This relates to $BNE_TOP/conf/webadi.properties. This file is also no longer used but still exists on the 11.5.10 file system. This properties file was replaced by the Profiles and zone.properties file. The main tables in ADI are as follows: BNE_CONTENTS_TL BNE_INTEGRATORS_TL BNE_INTERFACES_TL BNE_INTERFACE_COLS_TL BNE_LAYOUTS_TL BNE_LAYOUT_COLS BNE_MAPPINGS_TL
6 / 10
2. Upload the Journal Import Request 'View Output' to the SR, if the issue reported is related to the Upload functionality. 3. To enable Debug, set the BNE Profiles: BNE Server Log Filename = <provide name> BNE Server Log Level = TRACE BNE Server Log Path = <set to the value of the $APPLTMP> OR <match the value given in the webadi.properties for 11i.
4. Log in to the Applications as the System Administrator and navigate to Applications - Function. Query the %BNE% Check the Function BNE_CREATE_DOCUMENT and make sure the correct Web HTML call is to the Servlet BneApplicationServiceBneApplicationService and that the Web Host is set to the correct host. 5. Check if BNE is Installed: select application_short_name, application_name, product_version,status from FND_PRODUCT_INSTALLATIONS , fnd_application,fnd_application_tl where fnd_product_installations.application_id = fnd_application.application_id and fnd_product_installations.application_id = fnd_application_tl.application_id and language = 'US' and application_short_name = 'BNE'; COL COL COL COL COL app_s_name FORMAT a16 inst_status FORMAT a15 product_version FORMAT a12 patchset FORMAT a15 appl_id FORMAT 99999
select fav.application_id APPL_ID, fav.application_short_name app_s_name, decode(fpi.status,'I','Installed','S','Shared','N','No', fpi.status) inst_status, fpi.product_version, nvl(fpi.patch_level, 'Not Available') patchset from fnd_application_vl fav, fnd_product_installations fpi where fav.application_id = fpi.application_id and fav.application_short_name = 'BNE'; For a more comprehensive picture, run the AD Configuration Report ($AD_TOP/sql/adutconf.sql) to document the status of an Oracle E-Business Suite system, and provide information about all installed products (including shared and dependent products). If a shared product is present in the shared products list of any installed products (you can verify this from the $APPL_TOP/admin/applprod.txt file) 6. What patchset level do you have for Web ADI? select substr(aa.application_short_name,1,20) "Product", a.patch_level "Patch Level" from fnd_product_installations a, fnd_application aa where a.application_id = aa.application_id and aa.application_short_name = 'BNE';
7 / 10
8 / 10
9 / 10
References
NOTE:1077728.1 - Using Microsoft Office 2007 and 2010 with Oracle E-Business Suite 11i and R12 NOTE:1251224.1 - FAQ: Certification Information For Client ADI And Webadi NOTE:285218.1 - Recommended Browsers for Oracle E-Business Suite 11i NOTE:106528.1 - Application Desktop Integrator - Product Documentation NOTE:389422.1 - Recommended Browsers for Oracle E-Business Suite Release 12 NOTE:726989.1 - Web Applications Desktop Integrator (Web ADI) List of Patches
10 / 10