This action might not be possible to undo. Are you sure you want to continue?
Bill Stratton Dheeraj Sharma
• • • • • • Introduction Web ADI Prerequisites Web ADI Terminology Salary Management Integrator Custom Update Integrator Questions and Answers
Introduction - Xcelicor
• Founded 1997 • Focused exclusively on Oracle HRMS • People who “Excel” at their “Core” competency of Oracle HRMS
Web ADI • • • • • Replaces WEB ADE Requires no client software Entirely web-based Has download and upload capabilities Oracle stated direction Web ADI is now the Oracle supported way to download and upload data from Oracle applications to your desktop. which required special client software to be installed on the target PC. It replaces the old WEB ADE. 4 . Web ADI is entirely webbased and does not require any special client software beforehand.
Web ADI Prerequisites • Must set profile option HR: Enable Web ADI Integration to Yes • Internet Security Options – Download Unsigned ActiveX controls set to at least “Prompt” • Excel – Tools – Macro – Security – Trusted Publishers – Trust Access to Visual Basic Project Radio button checked • Menu HR ADI Seeded Integrator Form Functions to initial signon menu for responsibility There are a number of task that must be performed before you try downloading or uploading via Web ADI. navigate to Tools – Macro – Security – Trusted Publishers. Check the Trust Access to Visual Basic Project radio box. On the client desktop. set the Internet Security Options – Download Unsigned ActiveX controls to at least “Prompt” Within Excel. the System Administrator must set the System Profile option HR: Enable Web ADI Integration to Yes. First. 5 . The responsibility that the user will use should have the menu HR ADI Seeded Integrator Form Functions included in their initial signon menu.
The Layout defines the columns that will appear on the spreadsheet. only upload or both. It is used to contain all of the relevant information concerning a particular download or upload. Mappings are used when you are bringing in data from a legacy flat file into Oracle. You can have more than one layout associated with an integrator. You can control who has access to an integrator by a responsibility. It controls whether you can only download. 6 .Web ADI Terminology • Integrator • Layout • Mapping Integrator is the main object in Web ADI. The mapping definition will map the columns on the legacy file to the view that will be used to upload the data into the application tables.
7 . We will be showing the Salary Management integrator next. you can begin using them without loading any other special software.Web ADI “Out of the Box” • People – Salary Management • View – List – People Folder • View – List – Assignment Folder Oracle delivers integrators right out of the box. Assuming that the target responsibility has these seeded integrator functions included on the initial logon menu.
I modified the folder. I ran a blind query and then sorted the results by organization. 8 . using the standard folder tools. The next screen will show the results of this query. to include Organization in the folder. added Organization • Sorted Folder results by Organization The salary management integrator is one of the seeded integrators that is tied directly to the Salary Management screen. You first navigate to the Salary Management screen.Salary Management Integrator • Used to do Mass Salary Updates • Navigation path: People – Salary Management • Using Folder Tools.
The next step is to start the Web ADI integrator by click on the Export icon button. We will focus on my name here. 9 .Here you can see the results of my query.
Click on the Next button to go to the next step. (Notice the train above that tracks our progress). We will leave the reporting box unchecked.The system will respond with the screen above. since we will be changing the downloaded data and uploading it back to Oracle. 10 .
Click on the Open button to navigate to the next screen. the system will respond with this dialogue.Eventually. 11 .
Here I have added the change date. the Upd indicator will appear (the little flag icon). 12 . As you change (or add data) to this screen. The next screen will actually show the salary change.The next two screens will show the data downloaded into the spreadsheet.
I have scrolled to the right and put in the proposed salary and change reason. Note that I had to use the actual code of the change reason. since the API that is being used requires the code. 13 .
The next step is to start the upload process. It is located on the menu taskbar under Oracle as shown above. 14 .
15 .You can control which records actually get uploaded by making the appropriate selection here.
it would be listed here. 16 . it only sent up my record. If the processed detected an error.Since I selected to send only the indicated rows. Note the little smiley face.
17 . so you will need to use the salary management screen again to approve the salary.Here is the uploaded record in the salary proposal screen. Note that it is still unapproved.
Assignment and Salary tables • Will use HR Assignment API (sort of) • Must include Oracle Web ADI Menu to responsibility • Actual Business Case – Implementing Daily Business Intelligence – Several regions missing Supervisors – Need mass update capability to load Supervisors So lets create an integrator from scratch. so we needed this completed for everyone before we can roll this out. we will initiate this screen from the Web ADI menu item called Create Document. Address. I will discuss this further shortly. 18 . address.OK. assignment and salary tables. This is an actual business solution we are experimenting with at a current client. So our integrator will download everyone that does not have a supervisor to a spreadsheet so that we can add this information in and upload it back to Oracle. We will use a version of the standard HR Assignment API. so that we can create this integrator. Lets Create our own Integrator • Will use a custom HR data view that denormalizes Person. We need the Oracle Web ADI Menu on our initial logon menu. As you will see later. This particular integrator will not be attached to any screen. We first created a denormalized view that joined the person. We are implementing Daily Business Intelligence and not all of our regions populated the Supervisor field on the Assignment screen during implementation. DBI controls its displays based on the supervisor hierarchy.
Our solution was to write a PL/SQL function that would take the numbers we would normally know. 19 . make the change and then upload. is that you must use an API (or a Application Programming Interface). This special code is called a Wrapper and will make our process easier. look up the ids and then call the API. There are some issues we need to discuss concerning APIs. like the employee number of the supervisor and the assignment number of the employee. we must come up with a better plan. the person id of the supervisor and the assignment id of the employee. we must first download the existing version of the assignment. you must first download • What about all of those IDs? – Person ID – Assignment ID • What is a Wrapper? • Make friends with your IT staff One of the requirements to upload data to Oracle applications via Web ADI. Obviously. this is a task for a technical resource. Since we are updating existing Assignment records (as opposed to creating all new assignments). The standard Oracle supported APIs all use record IDs. instead of the more user friendly fields we see on the screen. In particular for our example. we need the send the API. so make some friends with your IT staff.API Issues • In order to update. Since users will not know these ids.
They are the effective date of the change. then the date track mode will stay as a correction. It also handles the issue when the supervisor’s hire date is after the employee’s current assignment effective date. then it will change the date track mode to update and use the supervisor’s hire date as the new assignment effective date. we created our own custom wrapper for this process. Our special function has four parameters. It uses the standard HR Assignment API. the assignment number of the employee and the employee number of the supervisor. The function uses these parameters to find the necessary assignment and person ids. 20 . so that we are using Oracle supported functionality when updating our assignment records. If not. the date track mode (whether it is an update or a correction).Supervisor Wrapper • Uses HR Assignment API • Four Input Parameters – Effective Date – Date Track Mode – Assignment Number of Employee – Employee Number of Supervisor • Finds all necessary IDs • Handles Supervisor Hire Date Issue So. If it is.
We will actually use Web ADI to create our integrator.Ok lets get started. 21 . The first step is to select the Create Document menu item from the Web ADI Menu.
since we are going to upload our integrator definition back up into the database. so I have blanked out the URL stuff to protect the innocent. The first screen is used to select which viewer we will use to create our integrator. 22 . Also.I have taken these screen shots from the client machine. the Reporting box is unchecked. We are going to use Excel.
sort of a bootstrap like process.We are actually using a seeded integrator to create our custom integrator. 23 . Here we are selecting the seeded HR Integrator Setup integrator.
24 .We are also using the supplied layout for the integrator definition.
25 . we select None for content. Since we want to start with a blank spreadsheet.Content determines what gets included on the spreadsheet when it is downloaded.
Here is our last chance to fix any of our choices. 26 . Once we select Create Document. it will create a blank spreadsheet for us to use to define our new integrator.
27 .After the blank spreadsheet is created and downloaded. Excel will start up and display the columns we need to populate to define our Supervisor update integrator.
download existing records. 28 . Since we want to update existing assignment records. We can either create new records.The first column describes what this integrator can do. or download and update existing records. we will select UPDATE.
we need to select an application code. You can use the Oracle menu option to get a list of valid values. Best practices dictate that you should put all custom code into your own custom application code.Next. as we have done here. 29 .
30 . This is the name that will appear in the pick list when the user starts their own “Create Document” session.Next. we need to name our integrator.
You could also use one of the Oracle supplied views. 31 .Next. we need to specify want view to use in order to retrieve our desired records to update. You will need to work with your new friends in the IT department to help you with this. we created a custom view that joins the person. address. assignment and salary record together. As I stated before.
As you saw in the Salary Management example. we are not attaching this to any form. 32 . so we select GENERAL. you can attach an integrator to an existing Oracle form. In our example.
You need to get this information from your technical folks. 33 .Our wrapper that we created is included in a package we called XCEL_UTILITY. We need to tell Web ADI this information as well as the actual procedure name in the next column.
34 .Here is the name of the actual procedure we created that will take our inputs and call the HR Assignment API.
35 . we can start the Upload process from the Oracle menu taskbar.Once we have completed this spreadsheet.
we are going to upload just the flagged records. 36 .Similar to the Salary Management example. You could create several integrators with one pass.
Function Security • Must create a function to secure Integrator • System Administrator – Application – Function • Attach function to Menu • Attach function to Integrator We would eventually get a conformation that the integrator was successfully added. Now we must say who is allowed to use this integrator. we must create a menu function and attach it the menus that are allowed to use it. This is a System Administrator process. 37 . Then we attach the function to the integrator. Oracle uses the menu function process to secure integrators. Therefore.
so that we can add this to a menu. We are really just creating a placeholder. 38 .Here is a picture of the function definition.
Here is the next tab in the process. 39 .
Here I am adding this newly created function to an initial signon menu. 40 .
Select Create Document to start this process. Once again. 41 . we are going to use Web ADI to do this for us.Now we need to attach this function to our newly created integrator.
We will use Excel again to attach the function to the integrator. 42 .
43 .We will use the seeded HR Maintain Integrator Form Function Associations integrator to perform our desired task.
You could supply just the desired integrator (the one we just created) in the Integrator User name field if you wish. 44 .This will download all of the integrators associated with our custom application.
45 . We just need to add the name of our function on the line for our newly created integrator.Here is the form function template.
Select Define Layout from the Web ADI Menu. Again.Now we are ready to create the layout of the spreadsheet that will be used to update the supervisors on the employee assignment screen. 46 . we use Web ADI to perform our definition.
First select the integrator that you want to create the layout for. Here we are selecting our newly created integrator. 47 .
The first four columns are the parameters to our wrapper. You can see where I am putting the effective date and date track mode options in the header of the spreadsheet. but the assignment number and supervisor employee numbers will be down in the line items. 48 . I then go and check the fields from our view that I want displayed on the spreadsheet.
Here are the other fields I want displayed. the wrapper will just ignore the change. so even if the user changes any of these fields. 49 . Remember our wrapper is only going to update the supervisor field. I only included these fields to assist the user.
Stand Alone Query
• Attaches a query to the Integrator
Once the layout is created, we now want to create a query so that we do not download every assignment when we launch our integrator.
Again, we use Web ADI to create this query. Select the Create Document item.
Select our viewer again.
53 .Now we are going to use the seeded integrator HR Create Standalone Query to create our query.
This will restrict the download to just employees who are in this department. This tells the query to prompt for the desired name. 54 . use your new friends in IT to assist you. Once again. Our query is going to prompt the user for a department name. Notice the weird name we have to give the parameter.Here we are creating our Where clause.
This column describes the parameter name. 55 .
56 . Here we are saying that the parameter will contain character data (the name of the desired department).This column describes the type of data that will go into the parameter.
57 .This is the prompt the user will see when the integrator asks for the department name.
We will use the familiar Create Document. we upload the query and we should now be ready to give it a try. but now we will use our new integrator.Lets give it a try • Upload the Stand Alone Query • Use the Create Document Once again. 58 .
This means that the selected assignment records will eventually show up in Excel.We select our viewer again. 59 .
Here is our integrator. 60 .
61 . We must enter the department name as it appears on the Assignment screen. Mappings are used to create new records from an existing text file or spreadsheet. since we are downloading the data that is being updated. You can create a drop down box of valid department names.The mapping is not used for our example. but that takes some additional technical setups that are outside of the scope of this presentation. Here we enter a session date and see how our prompt show up.
62 . I blanked out some of the names.Here is a partial list of the downloaded data. Notice that I am using my test employee here. I entered the employee number of the desired supervisor and the assignment number of the employee. Since I am using live client data here.
When I uploaded the spreadsheet. 63 . my new supervisor now shows up.
1) • Patch 4125542 for viewlets “PROVIDE VIEWLET FOR CREATING STANDALONE INTEGRATORS” Some final thoughts. did use the secured views as a base.Some Final Notes • Use Secured Views when interacting with Security Profiles • Oracle HRMS Web ADI Implementation and Configuration Supplement (228527. Download the patch number above and give them a try. There are also some interesting viewlets you can watch that demos the integrator creation process. I used this document extensively to teach myself Web ADI. Make sure you use secured views with your integrator. This will keep users from seeing employees that they are not supposed to see. Our custom view. 64 . A good reference document is shown above.
com 65 .Questions? Thanks for your attention!! Bill Stratton Dheeraj Sharma Xcelicor firstname.lastname@example.org dsharma@xcelicor.
This action might not be possible to undo. Are you sure you want to continue?
We've moved you to where you read on your other device.
Get the full title to continue listening from where you left off, or restart the preview.