www.aboutoracleapps.

com

Data Upload in Oracle HRMS Using Web ADI. By www.aboutoracleapps.com Inroduction WEB ADI is a self service tool that comes free with Oracle HRMS pack.It is widely used to migrate the data from excel sheets (coming from legacy system) into Oracle tables.It does not require any creation of a program.You just need to set up an integrator and call an appropriate API which in turn pump the legacy data into oracle. Data Upload in Oracle HRMS Using Web ADI

Data Download and Upload Overview You can download data from your Oracle HRMS application to spreadsheets or word processing documents on your desktop using Web ADI.You can query the data in a window, download the queried data to your desktop, and view the data in spreadsheet format or in a word processing document. In some cases, you can manipulate the data you have downloaded, and upload your changes back to Oracle HRMS. Validation of the data takes place by the Application Programmatic Interfaces (APIs) used to upload the data, and any errors are flagged. Please note that if any errors occur, no data is uploaded to the database. You can create an empty spreadsheet and enter new data into it, or bring in the data from a text file, then upload the data into Oracle HRMS. The data is validated using the usual HRMS validation. Standard Oracle security is maintained.

What is Web ADI? Web Applications Desktop Integrator (Web ADI) is a self–service Oracle application, accessed using a browser. The Web ADI software does not need to be installed on individual client machines. Processing takes place on the server rather than on individual client PCs. Web ADI generates Microsoft Excel or Word documents on your desktop, and uploads the data you have selected to upload. The appearance of the spreadsheet or word processing document is determined by configurable layouts. System administrators can restrict the fields that end users work with in the spreadsheet, and can create different layouts for different users. Experienced end–users can also create their own layouts to include just the fields they need to work with.

Integrators The functionality available with Web ADI depends on the information stored in an ‘integrator’. Each integrator contains all relevant information about a particular data download, upload or create process, When you create your spreadsheet or word processing document using Web ADI, you select an appropriate integrator, and Web ADI handles the transfer and validation of data accordingly.

Data Upload You can use Web ADI to upload data from spreadsheet into oracle HRMS. You can do this only if the spreadsheet was created using an upload integrator.You can only upload data using an integrator that has been created for this purpose (for example, the HR Update Salary Proposals integrator available from the Salary Management folder). You must specify at thetime you download the data that you intend to upload it again, by unchecking the Reporting check box. You must also have access to a responsibility that gives you access rights to upload data as well as download it.Data to be uploaded is validated before the upload occurs. You must ensure that you enter values in all mandatory fields so that validation is successful when the data is uploaded to the application. If you do not, the data is not uploaded, and an error message appears in the Messages column in the spreadsheet for the record with the invalid data.For example, if you

Data Upload in Oracle HRMS Using Web ADI 11/13/2008

1

Download/Upload and Create Integrators For integrators that allow both download and upload.. as this integrator is used to upload data to the 4. Query the name of your application. users see the Web ADI pages when they choose the Export Data icon on the toolbar of an HRMS window. do not use your browser’s Back or Forward buttons. 3) INTEGRATOR_USER_NAME – the name that appears when the end user selects the integrator in the Web ADI Create Document pages. Note: To identify the ID for your application. the row is flagged for upload. or enter LETTER for a letter generation integrator. select the seeded integrator ”HR Integrator Setup”. Choose the Back button if you want to change any of the information. Caution: When moving between Web ADI pages. only flagged rows are uploaded. 2. select a spreadsheet viewer in the Viewer field.For download–only and letter generation integrators. set the HR: Enable Web ADI Integration profile option to Yes at Site level. To create an integrator: 1. HR: Enable Web ADI Integration Profile Option In the System Profile Values window. 3. Examine. Creating Integrators Creating integrators is a system administration step required to enable download and/or upload of data from and to windows for which no seeded integrator exists. select APPLICATION_ID. choose Diagnostics. When this profile option is set to Yes. instead. 2) APPLICATION_ID – enter the Application ID of your custom application.aboutoracleapps.. 6. Set up an integrator of the type required. then from the Help menu. This is derived from the FND_APPLICATION table. 7. Define one or more layouts for the integrator. In the Field List of Values.www. In the Settings page. Select HR Create Document from the menu. In the Layout page. The ID of the application appears in the Value field. as a minimum.com are using the HR Update Salary Proposals integrator. If your organization has created its own integrators for uploading data. To configure Web ADI 1. In the Review page.. When the profile option is set to No. In the Integrator page.enter details in the following columns: 1) METADATA_TYPE – enter DOWNLOAD. navigate to the Applications window using System Administrator responsibility. select the default layout ”HR Integrator Setup”. you can see full details of the document that will be created. you must enter values in the Proposed_salary and Change_date fields.When you change any field in the spreadsheet. 5) FORM_NAME – the name of the window from which you want the integrator to be available to the user. Enter the form name of the window. including letter generation integrators. select None. In the Content page. Configuring Web ADI You can configure Web ADI to use your own integrators for downloading and uploading data between Oracle HRMS and spreadsheets or word processors. By default. A spreadsheet document is created. Enter the name of the view you want to use to base the download on. use the Back. your system administrator can tell you which fields you must enter. the Export Data icon launches the Application Data Exchange (ADE) software as before. 5. leave the remaining columns blank. or integrators Data Upload in Oracle HRMS Using Web ADI 11/13/2008 2 . as this causes information to be lost. database. 4) VIEW_NAME – Web ADI uses a view to determine the tablesand columns to download. 2. 8. Uncheck the Reporting check box. or choose the Create Document button to continue. Next and Cancel buttons displayed on the Web ADI page. containing all the fields you need to enter to create your own integrator. Download–only Integrators For download–only integrators. for any row you want to upload. The Settings page of the Web ADI wizard appears.

so should clearly indicate the purpose of the layout. If the integrator already contains layouts. 3.com that allow the creation of new data. This appears whenever the user is required to select the layout. Enter a user–friendly name. Select the integrator for which you want to define the layout and choose Go. Choose Continue. 2.. choose Diagnostics. End users can optionally create their own layouts to restrict the fields displayed to those they are concerned with. 7) INTERFACE_USER_NAME. each row where you have changed data in any field is flagged for upload. This is a name that will appear to end users in any messages or prompts dealing with the interface (API) parameters. 3. 5. 9)API_TYPE. 4. As you change data in a field. specifying the columns to appear in the spreadsheet. according to the type of API you are using. In the Upload Parameters page. Enter your user name and password.. – Enter PROCEDURE or FUNCTION. Enter a user–friendly name. Defining Layouts Each integrator must have at least one layout. leave this column blank. Examine. then choose the Login button. If creating an empty spreadsheet for upload. 6.VARCHAR2.. Specify the name of the API procedure to use to upload the data. To define a layout: 1. If you have saved the spreadsheet on your local PC.API_PACKAGE_NAME. In the Field List of Values. Query the name of your application. The key is used internally by the system to identify the mapping. This is derived from the FND_APPLICATION table. enter GENERAL in this field. a login page appears. 6)API_PROCEDURE_NAME. To upload the integrator Follow the steps for uploading a spreadsheet. and choose Upload. In the Define Layout page. If you only want to upload flagged rows. 3) INTEGRATOR_USER_NAME – this is the name that will appear when the end user selects the integrator in the Web ADI Create Document pages. Enter a user–friendly name. select APPLICATION_ID. Enter a unique key. Select the Oracle menu on the Excel toolbar. The Layout page appears. Uploading Data using Web ADI You can upload data to the Oracle applications database using a spreadsheet created in Web ADI.aboutoracleapps. 4. then from the Help menu. Choose Define Layout from the Web ADI menu. navigate to the Applications window using System Administrator responsibility. enter the datatype of the value returned by the function. 8) INTERFACE_PARAMETER_NAME. The Field List defaults to the complete list of columns available in the view and/or API. you will then select a subset of these fields to include in your layout. If the integrator is to be available directly from the Web ADI menu. If you are not already logged in to Oracle applications. 5) FORM_NAME – this is the name of the window from which you want the integrator to be available to the user. This is a name that will appear to end users in any messages or prompts dealing with the interface (view or API). In the Upl column of the spreadsheet. 5. choose your responsibility and then choose Select. 6. the row is flagged for upload. enter details in the following columns: 1) METADATA_TYPE – enter CREATE (to allow creation of new data) or UPDATE (to allow update of existing data) 2) APPLICATION_ID – enter the Application ID of your custom application.www. Choose the Define Layout button to define a new layout. For upload integrators. whether CREATE or UPDATE. In the Set Responsibility page. In the next page. 4) VIEW_NAME – Enter the name of the view you want to use to base the download on. you must supply the name of the API that handles the upload of data. enter a unique name for the layout. Data Upload in Oracle HRMS Using Web ADI 11/13/2008 3 . To upload data from a spreadsheet using Web ADI: 1. Note: To identify the ID for your application. choose the Parameters button.API_RETURN_TYPE – For APIs of type FUNCTION. locate and open the spreadsheet in Excel. 2. To upload all rows (for example. for example. if uploading from a text file) choose the All Rows option button. choose the Flagged Rows option button. The ID of the application appears in the Value field. these are displayed.System Administrators should always create at least one default layout for an integrator.

Choose the Proceed to Upload button. Note: Web ADI uploads all rows to the database if the data is error–free. indicating the success or failure of the upload. no rows are uploaded. the data is uploaded to the database. Data Upload in Oracle HRMS Using Web ADI 11/13/2008 4 . 8. If any errors occur. EXAMPLE Step 1 : Select the responsibility Web ADI. If the upload is successful. If the upload fails. Confirmation messages indicate the success of the upload. The upload takes place.com 7. return to the spreadsheet and correct any errors.www. Step 2 : Open the form Create Document the following page will open. then retry the upload. Step 3 :Choose ‘HR Integrator Setup’ option and click Next button located at right bottom.Click Next button located at right bottom. and a series of upload messages is displayed. Step 4 :Choose content None and Click Next button located at right bottom. then choose the Upload button in the page that appears next. .Unchek the ‘Reporting’ option while uploading the data into Oracle HRMS.aboutoracleapps. Further details of errors are available in the Messages column at the end of each row of the spreadsheet.

7.www. 1. 6. 4. 5. After processing spreadsheet will pop up automatically wherein you have to enter the required information. 2. METADATA_TYPE APPLICATION_ID INTEGRATOR_USER_NAME VIEW_NAME FORM_NAME API_PACKAGE_NAME API_PROCEDURE_NAME : CREATE : 800 : EMP_DATA : EMP_DATA : GENERAL : HR_EMPLOYEE_API : CREATE_EMPLOYEE Data Upload in Oracle HRMS Using Web ADI 11/13/2008 5 .com Step 5 :Click ‘Create Document’ button located at right bottom After this a Web Page will pop up showing processing of creating document.aboutoracleapps. For present example I had taken following information into account: Step 6 :Enter following information into the required fields. 3.

Data Upload in Oracle HRMS Using Web ADI 11/13/2008 6 .You can check the option ‘Show Trace Messages’ if you want to trace the messages. API_TYPE : EMPLOYEE_DATA : EMPLOYEE_DATA : PROCEDURE Step 7 :Click on Oracle option in the toolbar and then select ‘Upload’.www.com 8. Step 8 : Check the option ‘Show Trace Messages’ and click the ‘Upload’ Button.aboutoracleapps. INTERFACE_USER_NAME 9. INTERFACE_PARAM_NAME 10. As soon as you click the upload option then a following window will prop up .

Step 10 : Press the ‘Defined Layout’ button to create a new layout.www. Step 9 : Open Define Layout form of ‘Web ADI’ responsibility. Step 11 : Give any user friendly Layout Name and Layout Key and select Field list as Created ‘EMPLOYEE DATA’. Data Upload in Oracle HRMS Using Web ADI 11/13/2008 7 .com As soon as the upload is Successful you will see a ‘Green Icon’ with a smiling face in the ‘Message’ column of the spreadsheet. The message will appear that No Layouts are defined for this integrator. If the upload fails then you will see the red icon along with the error message in the ‘Message’ column of the spreadsheet. Step 9 :Click ‘Go’ button.click continue.aboutoracleapps.

Make sure that proper setups are done into the system.aboutoracleapps.com Step 12 : The layout will appear as shown below. Required field are mandatory fields that are to be filled in.One can select as many fields available depending upon the requirements. Data Upload in Oracle HRMS Using Web ADI 11/13/2008 8 . Below the required fields are the Optional fields . Just check the select box and then press ‘Apply’ button. Step 13 : Switch back to Web ADI responsibility and open the form ‘Create Document’. you can select the type of placement of the fields as header/Line level depending upon the requirement.Continue to Press ‘Next’ button till spreadsheet appears.www. Step 14 : Select the custom integrator ‘EMP_DATA’ .

com Step 15 : Enter the Employee information into respective columns. Data Upload in Oracle HRMS Using Web ADI 11/13/2008 9 .000 records can be inserted. if you want to enter the bulk data of say 20.aboutoracleapps.As soon as you enter the information the line is flagged which indicates that the data can be uploaded.000 employees then first unprotect the sheet then expand the sheet so that all 20.www. Those rows that are not flagged will not get uploaded. First column contains ‘Upl’. Please check that all the rows are flagged.

6) hr_maintain_proposal_API.create_employee To create an Employee 4) hr_employee_api.create_competence To create the competencies for an organization.Just Copy that data and paste into the Web ADI generated spreadsheet and then select upload. If a single record fails then uploading of the data fails. Following are some of the API’s that can be used to upload the Employee Data using WEB ADI.com Step 16 : Click Oracle into the menu bar and the select ‘Upload’ Step 17 : Check ‘Show trace Option’ and then press ‘Upload’ button.www.create_applicant To create an applicant.create_cwk To create the contingent worker for an organization. 1) hr_competence_element_api.aboutoracleapps.insert_salary_proposal To upload the CTC for an employee 7) hr_grade_api. This ADI is easy to use and it gives row-wise error messages and are easier to debug. Note: The data is usually provided in Excel by the client . 5) hr_competences_api. Make sure that all the data that you have is free from discrepancy and all the required setups are available in the system. Data Upload in Oracle HRMS Using Web ADI 11/13/2008 10 .create_job To create the job defined for an organization.create_grade To create the grade defined for an organization. You can upload as many rows of data as you can. 2) hr_contingent_worker_api. 8) hr_job_api.create_competence_element To create the competency data for an employee. 3) hr_employee_api. All the records will be inserted into respective Oracle HRMS tables if the upload is successful.

ESOP details.create_performance_rating To upload the performance ratings of employees.bank details.For that use ‘METADATA_TYPE’ as ‘UPDATE’ to achieve the desired results For more articles and Interview Questions visit – www.For primary Address make primary_flag=’Y’ in an API.passport details. These are create style API’s.create_sit To create the special information types like Awards.create_location To create the locations for an organization. 11) hr_performance_ratings_api.com 9) hr_position_api. 12) hr_phone_api.You can use update also if the employee already exists and you need to update the information.create_position To create the position defined for an organization.create_phone To upload the telephone numbers for employees.Visa details.aboutoracleapps.create_person_address To create the employee address. 14) pay_element_entry_api.www.Both primary and secondary addresses can be created .aboutoracleapps..etc. 15)hr_location_api. 10) hr_person_address_api.create_element_entry To upload the elements of salary(one by one) for employees . 13) hr_sit_api.com Data Upload in Oracle HRMS Using Web ADI 11/13/2008 11 .

Master your semester with Scribd & The New York Times

Special offer for students: Only $4.99/month.

Master your semester with Scribd & The New York Times

Cancel anytime.