Professional Documents
Culture Documents
Oracle web ADI Responsibility should have Desktop Integration Menu. In R12 we have set of predefined form functions for few Integrators. We need to attach those functions to Desktop Integration Menu to have access to those Integrators.
Security Settings
It is also possible to give access to all users if there are no security implications by setting the profile option BNE Allow No Security Rule to Yes
Excel
o o o o Go to Tools > Macros > Security Security Level tab change it Low. Trusted Publishers tab Check Trust all installed add-ins and templates. Trusted Publishers tab Check Trust access to Visual Basic Projects.
Getting Started
When HR: Enable Web ADI Integration is Y, the Web ADI Create Document program is invoked for an HR user by clicking on the Export Data icon on the toolbar of an HRMS window. Seq Prompt Submenu Function 10 Create Document Create Document 20 Define Layout Web ADI Layout Definition 30 Define Mapping Web ADI Text Mapping 40 HR Create Document HRMS Create Document These functions are sufficient to get you started, but more may be added for specific tasks. Note that the HR Create Document function is the same as Create Document but filters out Integrators linked to forms and the HR Startup integrators. When creating custom integrators the HR Setup Integrator (HR_SETUP_SETUP_INTG) should be run from the Create Document function. If an attempt is made to launch the HR Create Document function without having created any general integrators, the error,800:GENERAL% is an invalid Integrator Key
Concepts
Integrator This is the definition that stores the information about the
action the user wishes to perform. For example, downloading specific data to a spreadsheet for viewing or to modify and upload back to the database. For ADE users, this equated to the Style.
View A view is an object by which you can query data on a table or tables.
If the action you are intending to perform involves downloading data, you must associate a view with the integrator. If you are using Create style APIs, you do not require a view. You can elect to use a seeded view, for example, PER_PEOPLE_V, to use with your integrator. However, if the integrator is for updating data, then it is recommended that you create your own views and remember to include the OBJECT_VERSION_NUMBER, and any other In/Out parameters used by your chosen API.
Layout This is where the user selects the columns to be displayed in the
spreadsheet or Word document from the API and/or View used by the integrator. An integrator can have more than one layout defined for it. You can choose which one to use when you create your document.
Mapping the mapping definition links the data source to the api columns.
If no view is specified against the integrator or no text file used to load data, then no mapping is needed. When the data source is a view, the mapping is created automatically, however if a text file is being used then a mapping needs to be manually defined to associate each column in the file (source) to the relevant api parameter (target).
You use standalone integrators directly from the self-service menu function. These integrators allow you to create new data or download and update existing data. You can set up a query restriction to use at runtime. For Standalone Integrators the form name is GENERAL.
To Create Upload Integrator 1. Select HR Create Document from the menu. The Settings page of the
Web ADI wizard appears. 2. In the Settings page, select a spreadsheet viewer in the Viewer field. 3. Deselect the Reporting check box, as this integrator is used to upload data to the database. 4. In the Integrator page, select the seeded integrator "HR Integrator Setup". 5. In the Layout page, select the default layout "HR Integrator Setup". 6. In the Content page, select none. 7. In the Review page, you can see full details of the document that will be created. Choose the Back button if you want to change any of the information, or choose the Create Document button to continue
API Procedure Name- Procedure Name Interface User Name- Enter a unique name Interface Parameter List- Enter a unique name API Type - Select List of Values from Oracle menu or right click on mouse. Choose PROCEDURE o API Return Type- Ignore o o o o
Upload
Enter the following details after getting excel sheet: Integrator application short Name: INV Integrator User Name : Inventory Locator Web ADI
Form function : SG_INV_LOCATOR 9. Upload by going to Oracle menu on spreadsheet toolbar, and select Upload.
Parameters To Integrator
1. Select HR Create Document from the menu. The Settings page of the Web ADI wizard appears. 2. In the Settings page, select a spreadsheet viewer in the Viewer field. 3. Deselect the Reporting check box, as this integrator is used to upload data to the database. 4. In the Integrator page, select the seeded integrator HR Create Standalone Query". 5. In the Layout page, select the default layout "Standalone Query Details". 6. In the Content page, select "Standalone Integrators". 7. Select Mapping o Mapping HR Create Standalone Query Mapping. o Application Short Name INV o Integrator User Name - Inventory Locator Web ADI Upload 8. Review page, you can see full details of the document that will be created.
9. Open file and Enable Macros if prompted. A Processing window will Enter the following details after getting excel sheet:
open and a Confirmation window will advise when document has been created.
SQL WHERE CLAUSE: WHERE ORGANIZATION_CODE = $PARAM$.p_organization_code PARAMETER_NAME PARAMETER_TYPE PROMPT Parameter1:p_organization_code VARCHAR2 Organization Code
Fields Description
Placement: Defines the location of the field on the spreadsheet. Choices
are Context, Header, and Line. In your spreadsheet:
o Header: Fields whose values do not change for every record you
Default Type Parameter: Used to reference a parameter that your system administrator stores in the form function (Self Service Link) that you use to access the Create Document flow. The parameters that can be referenced are specific to each integrator.
Defining Mappings
You can choose to automatically import data into the spreadsheet during the Create Document flow. When you choose to import data on the Content page, Web ADI prompts you to select a mapping. Web ADI requires a mapping in order to determine where imported data should be placed in the spreadsheet. Mapping associates columns in the imported data with columns in the spreadsheet. You do not need to create new mappings for fields that do not have data, or if a mapped field is not included in the spreadsheet. You need to create multiple mappings for content only if the associations between the downloaded columns and the fields in the spreadsheet change. If you import text files with varied data structures, you may have to define more than one mapping for the text file.
criteria. Click the radio button next to the column name, and then click select to select columns to map. o Some Target Columns support the translation of ID values from Source Columns. To find out if the translation of IDs is supported by a specific column, select that column and click Lookup. If the column supports the ID translation, a check box appears under Lookup for that column name. To perform the ID translation, select the Lookup check box for the desired columns. 6. Apply the mapping definition you have created.
Technical
1. 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 Sample script to print out integrator details. Note only update integrators have apis. Reporting_Flag='N' Otherwise they are associated with the _INTFC entity
set Pagesize 1000 set linesize 200 set termout on set verify off spool bne.lis select distinct substrb(bit.application_id,1,12) APP_ID, substrb(bit.user_name,1,35) INTEGRATOR_NAME, bl.reporting_flag, substrb(blcv.layout_code,1,35) INTEGRATOR_LAYOUT, substrb(biv.user_name,1,30) ASSOC_VIEW, substrb(biv.interface_name,1,20) API, substrb(biv.upload_type,1,3) TYPE from bne_integrators_tl bit, bne_layout_cols_v blcv, bne_layouts_b bl, bne_interfaces_vl biv where bit.INTEGRATOR_CODE = biv.INTEGRATOR_CODE and biv.interface_code = blcv.INTERFACE_CODE and bit.integrator_code=bl.integrator_code and upper(bit.user_name) like upper('%&&Integrator_name%') order by bl.reporting_flag / Sample script to find integrators associated with a form function select security_code Integrator, security_type Type, security_value Function from bne_security_rules where application_id=800 and security_value = '&function_name'
2. The following View lets are available for download from Metalink to help with
the HR Integrator setup. Patch Patch Patch Patch Patch Patch Patch 3196431 4125542 3196360 3196357 3196355 4125537 4112747 Disabling integrators Creating standalone integrators Mail merge example Upgrading ADE to Web ADI Download example Creating integrators Associating Form Functions with integrators
3. Debugging
You can get a log file to help diagnose an error in Web ADI. The following profile options need to be set: BNE: Server Log Filename: Use this profile option to change the name of the Web ADI log file on the middle tier. If this profile option is not set, bne.log is used. BNE: Server Log Path: This profile option can be used to set the directory for the Web ADI log file on the applications server. If this profile option is not set, then the FND_TOP/log directory is used. BNE: Server Log Level: This profile option determines the level of detail that is recorded in the Web ADI log file. The valid values are noted below. The level of granularity and amount of information recorded to the log file increases as you move down the list. CRITICAL_ERROR: - Messages that are the result of a system failure. The integrity and reliability of the system is in doubt as a result of this error. ERROR: - Messages that are the result of an unexpected error in the system. It is possible to recover from these errors; the system may still be in a usable state. Setting the profile option to this value will includeCRITICAL_ERROR messages in the log file. WARNING: - Messages trapped by the application.These errors were handled by the application but the system administrator should be aware of them occurring. Setting the profile option to this value will includeERROR and CRITICAL_ERROR messages as well. INFORMATION: - Additional messaging is added to the log file that includes processing information. Setting the profile option to this value includes CRITICAL_ERROR, WARNING, and ERROR log messages. This is the setting that is used by Web ADI if the profile option is not set at the site level. DETAIL: - Messages that summarize what is written to the log file. Setting the profile option to this value includes CRITICAL_ERROR, WARNING, ERROR, and INFORMATION log messages. TRACE: - Messaging that generated detailed debugging statements. Setting the profile option to this value includes CRITICAL_ERROR, WARNING, ERROR, INFORMATION and DETAIL log messages. 4. Creating an Integrator in an NLS environment The script $BNE_TOP/sql/BNENLINS.sql needs to be run to populate multiple language rows on BNE_INTEGRATORS_TL table