You are on page 1of 16

Please use the following steps to populate the Operating Unit:

Open app...
select Desktop Integrator responsibility
Define Layout
Integrator - Transaction Import
select Transaction Import - Accounted
click Update button
update layout and click next
review the columns
There should be an ORG_ID column/field at the Header 1 level
the default value is:
select PA_WEBADI_TRX_XFACE.Get_Default_OU_Id
from dual
the default type is:
SQL
If you have ORG_ID but no default value updated, place the above
information in there....
If you do not have this ORG_ID setup in top region, open an SR for help.

Once a custom layout is created in WebADI, how can it be added


To
so that it displays under Expenditure Entry Using Microsoft Excel?
Bottom
(Doc ID 1639645.1)

In this Document
Goal
Solution

This document is being delivered to you via Oracle Support's Rapid Visibility (RaV) process
and therefore has not been subject to an independent technical review.
APPLIES TO:
Oracle Project Costing - Version 12.1.3 and later
Information in this document applies to any platform.

GOAL
Once I create a custom layout in WebADI, how do I add it so that it displays under Expenditure
Entry Using Microsoft Excel?
SOLUTION
Here are the steps to do this:
1. Create the custom layout.
2. Basically, you will need to assign the custom layout to a desired menu, so the first step is to
create and attach a function:
a) From System Admin responsibility - (N) Application/ Function.
b) Query Function PA_BNE% to get the seeded functions to use as examples to create the
custom function:
In particular, the Form tab - Parameters:
bne:page=BneCreateDoc&bne:viewer=BNE:EXCEL
%25&bne:reporting=N&bne:integrator=PA:PAXTTRXB&bne:layout=PA:TRANS_IMP_UNCO
STED_NON_LABOR&bne:content=PA:NONE2
The custom function should look something like this:
ne:page=BneCreateDoc&bne:viewer=BNE:EXCEL
%25&bne:reporting=N&bne:integrator=PA:PAXTTRXB&bne:layout=PA:MYCUSTOMLAYO
UT&bne:content=PA:NONE2
c) Once the custom function is created:
From System Admin responsibility - (N)Security/Responsibility/Define
Query the SSWA responsibility where you want to display the layout i.e. 'Projects Super User'
Note the Menu = Project Super User Responsibility Main Menu
d) From System Admin responsibility - (N) Application/Menu
Query User Menu Name - 'Project Super User Responsibility Main Menu'
Scroll down and see sub menu - 'Expenditure Entry Using Microsoft Excel'
Query User Menu Name - 'Expenditure Entry Using Microsoft Excel'
This is where you will assign the custom layout to be included in the menu.
e) Create a new line with Prompt and attach the function you created.

3. The custom layout should now appear under Expenditure Entry Using Microsoft Excel.
Security settings

A. Settings for Digitally Signed Spreadsheets:


If you want to use digital signatures in Oracle Web ADI, set the 'BNE Enable
Digital Signature profile option' to Yes. When this option is set, WebADI
affixes a digital signature to the spreadsheets you create.
B. Macro security level in Microsoft Excel that requires digital signatures:
For example:
For Microsoft Excel 2007:
-- Choose the Microsoft Office button, and then choose Excel Options. In the
Trust Center category, choose Trust Center Settings, and then the Macro
Settings category.
-- Select the Disable all macros except digitally signed macros option.
Note : If you do not enable the profile ('BNE Enable Digital Signature profile
option' ), Select the Disable all macros with notification option.
-- Select the Trust access to the VBA project object model option.
C. Microsoft Internet Explorer Settings :
-- From the Tools menu, select Internet Options and then select the Security
tab.
-- Select the zone in which you are working, such as Trusted Sites, and select
the Custom level button.
-- In the Downloads settings, select Enable for the File download option.
Additionally, if you use Microsoft Internet Explorer 7 or 8, select the following
scripting setting so that Oracle Web Applications Desktop Integrator can
complete the spreadsheet creation process.
-- From the Tools menu, select Internet Options and then select the Security
tab.
-- Select the zone in which you are working, such as Trusted Sites, and select
the Custom level button.
--In the Scripting settings, select Enable for the Allow status bar updates via
script option.

Implementing Web ADI


Profile Options

BNE Allow No Security Rule


BNE Allow Set Parameters
BNE Debug Log Directory
BNE Debug Log Filename
BNE Debug Log Level
BNE Disable
Create Documents
Create Document workflow

Integrator > Viewer > Layout >Content > Review > Create Document
A. You can create from PA responsibility
NAV: Projects: Spreadsheet Expenditure Entry >

Uncosted Labor Transactions

Uncosted Non-Labor Transactions

Costed Transactions

Accounted Transactions

Note: Some steps in the Flow will be skipped


B. You can also create from Web ADI responsibility
NAV: Integrator > select 'Projects-Transaction Import' integrator
Note: You must be granted access to an integrator by your system
administrator. Specific form functions grant access to specific integrators.
Viewer > select the viewer . For example, Excel 2007.
Note :Select the Reporting box only if you want to create a spreadsheet that
does not allow data upload.
Layout > select a layout. Example : Transaction Import-Uncosted Labor
Content > Not applicable to 'Projects-Transaction Import Integrator

Review > optionally, click Save. The Select Shortcut window allows you to
select a shortcut that appears at the beginning of the Create Document flow.
Note: System administrators can save the shortcut to a form function, and
attach the form function to a user's menu.
Create Document >Create your spreadsheet.
Working with Spreadsheets

A. Regions in the spreadsheet : You can toggle on and off of each region in
the spreadsheet namely - View Context , View header and View line
Note: In Microsoft Excel 2007, the Oracle menu is available from the Add-Ins
tab.
Note: If you create a digitally signed spreadsheet, it is recommended to work
without saving in order to preserve the signature.
B. Filtering on the line items : Oracle Web ADI enables you to turn on
Microsoft Excel filtering on the line items. This is useful when your
spreadsheet contains many rows of
data. To enable filters, from the Oracle menu select Filters, then Show Filters.
To turn filters off, from the Oracle menu select Filters, Hide Filters.
C. Multiple Worksheets : Your spreadsheet may contain multiple worksheets if
your product integrator is defined to generate multiple worksheets or if your
downloaded data exceeds 64,000
rows, multiple worksheets will be automatically created. If your spreadsheet
contains multiple worksheets, then at upload time you will be presented the
options of Upload or Upload All. Upload will upload only the current
worksheet. Upload All will upload all worksheets.
D .Adding Rows to a Spreadsheet : To add rows to an open spreadsheet
---Unprotect the spreadsheet: Select Tools, then Protection, then Unprotect
Sheet. Excel 2007 > Review -Unprotect Sheet
--Select a row in the lines section of the spreadsheet. Select Insert, then
Rows.
E. Uploading Data from Spreadsheets :
Choose Upload from the Oracle menu. The Upload Parameters window
appears. Select the desired parameters.
Note :Upload parameters depend on the integrator you select
All Rows : Select to upload all rows in your spreadsheet, regardless of
whether changes have been made.

Flagged Rows : Select to upload only those rows that are marked with a flag
character in the Upl column of your spreadsheet. WebADI displays a flag
character against a row that has changed.
F. Validate Before Upload :
Recommended. Validating prevents invalid data from being uploaded to
Oracle E-Business Suite. It is useful when you expect the import process to
be quite lengthy or when you plan to run it unattended, such as overnight.
G. Automatically Submit Import:
Select this option to automatically submit a processing request for the data
after upload.
This parameter is available when a post-processing procedure has been
setup for the integrator. A post-processing procedure may be a call to a
server-side procedure or a concurrent program to continue processing the
data in the E-Business Suite.
H. Start the upload process : After the upload process completes, the upload
window indicates whether or not the upload was successful.
I. Messages: WEBADI returns messages to the spreadsheet identifying all
rows containing invalid values. If the data in any rows are invalid, WEBADI
does not upload any of the data in the spreadsheet.
You must correct all errors to successfully upload the spreadsheet.
Any errors that occur during the upload of a multi-sheet workbook will also
be displayed in a Summary Worksheet. The Summary Worksheet enables you
to see all errors and link to them.
J. Monitoring Concurrent Requests :
Monitor concurrent requests from the spreadsheet If integrators starts a
concurrent program to import the data to Oracle E-Business Suite
To monitor concurrent requests from the spreadsheet, select the Oracle
menu, then Monitor. The Monitor Requests window displays the last 10
concurrent requests submitted by the current user.
Security Projects WEBADI
Scripts Specific to PA

1.SQL> SELECT * FROM BNE_SECURED_OBJECTS O WHERE


O.OBJECT_TYPE ='INTEGRATOR' AND O.APPLICATION_ID = 275;
-- Object Code gives the Integrator Technical name

2. SQL> SELECT SECURITY_TYPE, SECURITY_VALUE FROM


BNE_SECURITY_RULES R
WHERE EXISTS (SELECT 1 FROM BNE_SECURED_OBJECTS O WHERE
O.SECURITY_RULE_APP_ID = R.APPLICATION_ID
AND O.SECURITY_RULE_CODE = R.SECURITY_CODE
AND O.OBJECT_TYPE ='INTEGRATOR'
AND O.APPLICATION_ID = 275) ;
-- AND O.OBJECT_CODE ='<OBJECT_CODE from query1> - Optional use for
specific object
-- Gives the Function Technical Name (SECURITY_VALUE )
defined for an Integrator Mostly
Security functions for costing

1.Always check whether the PA function (Ex:


PA_BNE_LABOR_TRANSACTIONS )
is in the current responsibility.
This means include the Web ADI define layout form function in the menu for
the responsibility or add the Menu that has the function already in it .
2.Following are the current Functions used in PA for WEBADI
PA_BNE_COSTED_TRANSACTIONS
PA: Uncosted Labor Transactions
SECURITY_VALUE

USER_FUNCTION_NAME

PA_BNE_LABOR_TRANSACTIONS

PA: Uncosted Labor Transactions

PA_BNE_ACCOUNTED_TRANSACTIONS

PA: Accounted Transactions

PA_BNE_COSTED_TRANSACTIONS

PA: Costed Transactions

PA_BNE_NON_LABOR_TRANSACTIONS

PA: Uncosted Non-Labor Transactions

PA_PAXPREPR_OPT_BUDGETS

Financials: Project: Budgets and


Forecasts

Security functions for costing


PA: Accounted Transactions : To import accounted transactions

PA: Costed Transactions: To import costed transactions


PA: Uncosted Labor Transactions: To import uncosted labor transactions
PA: Uncosted Non-Labor Transactions : To import uncosted non-labor
transactions
Customizations
MODIFY PROJECTS EXCEL UPLOAD ADI LAYOUT :

You can create your own custom spreadsheet layouts by duplicating the
default layouts and then updating the duplicates.
To duplicate and update spreadsheet layouts, you must have an Oracle Web
Applications Desktop Integrator (Web ADI) responsibility and access to a Web
ADI menu that enables you to define spreadsheet layouts. In addition, you
must have access to the following Oracle Projects integrators in Web ADI
Note: To access Oracle Projects spreadsheet layouts, the Web ADI menu and
your Web ADI responsibility must be associated with the function.
You can customize a spreadsheet layout by selecting the fields you want to
include,specifying the placement of fields, and by specifying how
spreadsheet values are populated.
Warning: Do not update or delete a default Oracle Projects spreadsheet
layout.
Steps :

Use the Self-Service "Web ADI" responsibility

a) Define Layout
b) Select Integrator
Projects - Transaction Import
c) Press Go
d) Select the Layout to be modified
e) Press Duplicate
f) Change the Layout name
g) Press Apply
h) Open the New Layout ( Update)

Customize layout

-select the fields you want to include,


-Specify the placement of fields, and by specifying how spreadsheet values
are populated.
Warning: Do not update or delete a default Oracle Projects spreadsheet

Click Next

--Define Properties of the spreadsheet Layout and the Fields in regions in the
spreadsheet ( View Context , View header and View line )
Use the modified layout from the Projects responsibility:

Under the 'Expenditure Entry Using Microsoft Excel' sub menu, select the link
of function connected to the modified layout created and save the Menu .
Use the modified layout from the "Web ADI" responsibility:

--------

Create Document
Press Next
Select Integrator :Projects - Transaction Import
Press Next : Select Viewer
Press Next : Select the modified layout
Press Next : Select Content & Review
Press Next : Press Create Document

Override the Default Parameters

You can Override the Default Parameters when Uploading from WEB ADI to
Projects

Following features can also be set :

--- &bne:rows=all Flagged rows . The parameters are FLAGGED or ALL it may
be case sensitive
--- &bne:importFlex=IMPORTVALIDATION Description Flexfield validation
NOTE: Add the parameter in the Form-tag without spaces, otherwise you get
the following error when you try to access "Create Document":
---The following error has occurred
Exception Name: oracle.apps.bne.exception.BneFatalException - Error
loading
\ class: Log File Bookmark: 236030

Trouble shooting
How to Identify the code behind the LOVs in WEDADI layouts ?

LOVs on each field are same as the one used in the forms, for example
Projects LOV in forms also uses the PA_PROJECT_EXPEND_V also same in
WEBADI.
The information about the tables/views based on which the LOV is formed
can be obtained from the BNE_INTERFACE_COLS_B table which will be
populated by the pabneint.ldt.
In BNE_INTERFACE_COLS_B the following fields convey the information
regarding the LOV.
-- VAL_TYPE = 'TABLE' -- which means that validation and LOV is based on
table/view.
-- VAL_ID_COL -- column name from the table/view associated with the field.
-- VAL_MEAN_COL -- column which conveys extra user information about the
ID column.
-- VAL_DESC_COL -- column which contains the description of the ID column.
-- VAL_OBJ_NAME -- TABLE/VIEW which is being queried for values of this
field.
-- VAL_ADDL_W_C -- Additional WHERE clause.
Sample SQL > SELECT VAL_ID_COL, VAL_OBJ_NAME,VAL_ADDL_W_C FROM
BNE_INTERFACE_COLS_B
WHERE INTERFACE_CODE = 'TRANSACTION_INTERFACE'
AND INTERFACE_COL_NAME = 'NON_LABOR_RESOURCE_ORG_NAME';
Download Web ADI Document Stuck

Pop up for the download that says "processing: Create document...Your


document is being created. Do not close this window until processing
completes
Solution: Verify the Security options in IE Browser and Macro Security
Settings in Microsoft Excel
What is the version of the latest installed WebADI Patchset?

use the following SQL.


SQL> SELECT application_id, patch_level FROM fnd_product_installations
WHERE application_id in (231);

How to get BNE.log

Please refer the following notes :


1. Note 294739.1
2.Note.817023.1
How to Capture performance information (TRACE) on the Oracle LOV used in web ADI /excel?

Please refer the following notes :


Note 170223.1 :Trace 11i Bind Variables - Profile Option: Initialization
SQL Statement Custom
Note 295963.1 : How to Obtain a Trace with Binds for Concurrent Processes
in Oracle Projects
Note 294739.1 : How to enable tracing for WEBADI
Frequently Asked Questions:

1.Is the Oracle Applications Desktop Integrator client-server version still


supported?
--Version 7.2 will be supported for Release 11 and 11i only; Not for Release
12 and higher.
2.Do any Oracle Web ADDI components need to be installed on the desktop?
-- No. You need only a Web browser supported by Oracle E-Business Suite
and Microsoft Excel.
3.How will new integrators be added?
--New seeded integrators will be added as separate patches. These patches
will be
shipped with the products related to the integrators.
4.Are reference fields supported when entering key and descriptive flexfield
information into the spreadsheet?
--No. Reference fields are not currently supported; however, there are plans
to support
this Oracle E-Business Suite flexfields feature. See ER 2809958 for the
current status of this feature.
5.My spreadsheet has only 10 rows for entering data. Can I increase the
number of lines so that I can enter more than 10 records?
--Yes, you can increase the number of rows to enter more records.

6.Can I copy my entire Oracle Web ADI worksheet to a different workbook?


-- You cannot copy an entire worksheet to a different workbook; however, you
can copy row and column values from one worksheet to another Web ADI
worksheet and then upload the data.
7.What versions of Microsoft Excel can be used with Oracle Web Applications
Desktop Integrator?
--Microsoft Excel 2000, 2002, 2003, and 2007 are currently supported. These
versions
contain the VBA code that is capable of receiving OLE commands from the
browser.
8.What internet browsers are supported by Oracle Web Applications Desktop
Integrator?
-All browsers supported by Oracle E-Business Suite are supported.
9.Is the Apple Macintosh supported?
--Although not currently supported, work is currently underway to support
Apple Macintosh.
10. How does the desktop tier communicate with the middle tier?
--The desktop tier makes a direct connection to the HTTP server on the
middle tier. It
uses standard Web protocols such as HTTP, HTTPS, or SSL.
11.What is the role of the middle tier?
--Oracle E-Business Suite software and tools are deployed and managed on
this tier.
This tier eliminates the need to install and maintain application software on
each desktop
client.
12.How does the middle tier communicate with the database tier?
--The middle and database tiers communicate via SQL*Net, Net8, or JDBC.
13. What is the role of the database tier?
--The database tier holds all data and data-intensive programs, and
processes all SQL requests
for data.

14.Does Oracle Web ADI support Single Sign-On (SSO)?


--Yes. Web ADI is SSO capable when used in an Oracle E-Business Suite
environment. No extra configuration of Oracle Web ADI with SSO is required.
15.What Type of Expenditure Items Can be created ?
-- Any records that can be created through populating
PA_TRANSACTION_INTERFACE_ALL
Can be created.

Microsoft Office 97

Microsoft Office 2000

Microsoft Office XP
o Ensure that "Trust access to Visual Basic Project" is selected
when going to
Tools -> Macro -> Security -> Trusted Sources.

Microsoft Office 2003


o Ensure that "Trust access to Visual Basic Project" is selected
when going to
Tools -> Macro -> Security -> Trusted Sources.

Microsoft Office 2007


o Ensure that "Trust access to VBA Project Object Model" is
selected when going to
Microsoft Office button -> [Application] Options -> Trust Center
-> Trust Center Settings -> Macro Settings.
Note:
For versions of Microsoft office (XP and 2003) ,"Medium" should
be selected when going to Tools -> Macro -> Security -> Security
Level.

+ One of the following Browsers :

Microsoft Internet Explorer 5.0 or greater.

o Check security settings to make sure they allow a file to be


downloaded.

Navigate to Tools -> Internet Options and choose the


Security tab.

Select Local Intranet and choose the Custom Level button.

Set "File download" to "Enable".

o Netscape 4.7 or greater.

Microsoft Internet Explorer 7 or 8


o Enable Scripting setting - "Allow status bar updates via script"
Reference: Note 1077728.1

database schema is the skeleton structure that represents the logical view
of the entire database. It defines how the data is organized and how the
relations among them are associated. It formulates all the constraints that
are to be applied on the data.
A database schema defines its entities and the relationship among them. It
contains a descriptive detail of the database, which can be depicted by
means of schema diagrams. Its the database designers who design the
schema to help programmers understand the database and make it useful.

A database schema can be divided broadly into two categories

Physical Database Schema This schema pertains to the actual storage of


data and its form of storage like files, indices, etc. It defines how the data will be
stored in a secondary storage.

Logical Database Schema This schema defines all the logical constraints
that need to be applied on the data stored. It defines tables, views, and integrity
constraints.

Database Instance
It is important that we distinguish these two terms individually. Database
schema is the skeleton of database. It is designed when the database
doesn't exist at all. Once the database is operational, it is very difficult to
make any changes to it. A database schema does not contain any data or
information.

A database instance is a state of operational database with data at any


given time. It contains a snapshot of the database. Database instances tend
to change with time. A DBMS ensures that its every instance (state) is in a
valid state, by diligently following all the validations, constraints, and
conditions that the database designers have imposed.

You might also like