Upload
dsgandhi6006
View
101
Download
1
Tags:
Embed Size (px)
DESCRIPTION
Implementing Client Extensions for OIE, Oracle Internet Expense
Citation preview
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 1/16
White Paper on Implementing Accounting Client Extensions for Oracle Internet Expenses(Doc ID 333199.1)
White Paper
Implementing Accounting Client Extensions forOracle Internet Expenses
See Change Record
Table of ContentsThis white paper contains the following information.
1. Overview2. Standard Accounting Generation
Non-Project ExpensesExpense Allocations Enabled with Online ValidationExpense Allocations Enabled without Online ValidationExpense Allocations Disabled
Project ExpensesExpenses Audit
3. Client Extensions (AP_WEB_CUST_ACCTG_PKG)Non-Project Expenses
BuildAccountGetIsCustomBuildOnly
Project ExpensesBuildDistProjectAccount
4. Client Extensions Use CasesNon-Project Expenses
Expense Allocations Enabled With Online ValidationExpense Allocations Enabled without Online ValidationExpense Allocations Disabled
Project Expenses5. Change Record
1. OverviewOracle Internet Expenses Accounting Generation is done during expenses entry, in workflow, and in the expensesaudit module. Accounting generation comprises two stages irrespective of where it is done:
1. Build Code Combinations - This stage entails establishing valid accounting segment values. These values areobtained either through system defaults or user updates.
2. Validate Code Combinations - This stage ensures that the built code combinations exist and pass crossvalidation rules. If build code combinations do not exist, they can be created automatically, provided dynamicinsertion is turned on.
Standard Accounting Generation - To build code combinations, Oracle Internet Expenses provides hard-codedlogic to default accounting segment values. Once defaulted, users can perform updates to complete the build stage.
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 2/16
For validations, Oracle Internet Expenses uses the standard Oracle eBusiness suite code combination validations. Thestandard validation mainly comprises ensuring that code combinations exist, and that code combinations comply withcross validation rules. See: Section 2, Standard Accounting Generation.
Customizable Accounting Generation - Starting in 11i.OIE.J.RUP2, Internet Expenses provides three GLAccounting client extensions. The first two are available for non-project expenses, and the third one is available forproject-related expenses. The client extensions are PL/SQL API's which are designed to let customers create customrules to build and validate code combinations. If enabled, these PL/SQL API's are called during expenses entry and inworkflow (based on system setup), and in the expenses audit module. See: Section 3, Client Extensions(AP_WEB_CUST_ACCTG_PKG).
Attention:
If PL/SQL API's are customized, they override both stages of the standard accountinggeneration irrespective of which expense reporting process they are called from.
2. Standard Accounting GenerationFor expenses entry and workflow, three factors determine whether accounting generation occurs during expensesentry versus in workflow:
1. Whether end users can perform expense allocations (in other words, update GL accounting segments)2. Whether online validations is enabled3. Whether expenses are charged to Oracle Projects projects and tasks. If expense allocations is enabled, end
users can only update accounting for non-project expenses.
For expenses audit, code combinations are rebuilt when auditors change expense types. For project expenses, codecombinations can further be rebuilt if accounting is updated directly. For the validation stage, expenses are re-validated when expense types are changed, and when auditors make updates to the accounting segments.
Standard Accounting Generation, Non-Project Expenses
During expenses entry, accounting is built based on system defaults and end user updates. End user updates consistof changing the cost center for the expense report, and updating GL segments for expenses. To track user changes,the account generation occurs twice: once to build the account based on original parameters, and again to build theaccount based on new parameters. For more information, refer to Setting Up Expense Allocations in chapter 3 of theOracle Internet Expenses Implementation and Administration Guide. In particular, refer to the Expense AllocationUpdates and Validation discussion for how accounts are built and validated.
This table discusses the different use cases for any expense line not charged to Oracle Projects project and task.
Expense Allocations Enabled with Online Validation
ProcessPoint Where Build Accounting Validate Accounting System Setup
Occurs when:
Users access the pageUsers change theexpense report cost Users do not update
accounting, click Next
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 3/16
ExpensesEntry
ExpenseAllocations step
center after allocationshave been madeUsers change theexpense type for a linethat has already beenallocatedUsers update accountingsegments and clickUpdate or Next buttons.
buttonUsers updateaccounting segments,click Update or Nextbuttons.
OIE: Enable Expense Allocations =either 'Automatically-enabled withOnline Validation,' or 'User-enabledwith Online Validation.'
Workflow
Expensesworkflow ServerSide Validationprocess
Occurs when building thedefault employee account Same as build accounting Not applicable
ExpensesEntry
ExpenseAllocations step Update Accounting page
User updates accountingsegments and clicks Previewor Apply
OIE: Enable Expense Allocations =either Automatically-enabled withOnline Validation or User-enabledwith Online Validation
Expense Allocations Enabled without Online Validation
ProcessPoint Where Build Accounting
ValidateAccounting System Setup
ExpensesEntry
ExpenseAllocations step
Occurs when:
Users access the pageUsers change the expensereport cost center afterallocations have been madeUsers changed the expensetype for a line that hasalready been allocatedUsers update accountingsegments and click Updateor Next buttons.
Does not occurduring expensesentry
OIE: Enable Expense Allocations =either 'Automatically-enabled', or'User-enabled'.
Workflow
Expensesworkflow ServerSide Validationprocess
Does not occur in workflow, foraccounting generation at thedistribution level
After user submitsexpense report
No setup required to enable inworkflow. Performer must be definedfor Expense Allocation Errorsnotification.
Workflow
Expensesworkflow ServerSide Validationprocess
Occurs when building the defaultemployee account at the headerlevel
Same as buildaccounting Not applicable
ExpensesEntry
ExpenseAllocations step Update Accounting page
User updatesaccountingsegments andclicks Preview orApply
OIE: Enable Expense Allocations =either Automatically-enabledenabled
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 4/16
Expense Allocations Disabled
ProcessPoint Where Build Accounting
ValidateAccounting System Setup
ExpensesEntry Not applicable
Does not occur duringexpenses entry
Does not occur duringexpenses entry OIE: Enable Expense Allocations =
Workflow Expenses workflow ServerSide Validation process
After user submitsexpense report, foraccounting generationat the distributionlevel
Same as buildaccounting
No setup required to enable in workflow.Performer must be defined for ExpenseAllocation Errors notification.
Workflow Expenses workflow ServerSide Validation process
Occurs when buildingthe default employeeaccount at theheader level
Same as buildaccounting Not applicable
Standard Accounting Generation, Project Expenses
If expenses are charged to Oracle Projects projects and tasks, account generation is only performed in workflow. Formore information, refer to Integrating with Oracle Projects in chapter 2 of the Oracle Internet ExpensesImplementation and Administration Guide. In particular, refer to the Project Expense Report Account Generatordiscussion.
This table discusses the behavior of any expense line charged to a project and task.
Where Occurs Where Occurs Build Accounting Validate Accounting System Setup
Expenses Entry Not applicable Does not occur during expensesentry Same as build accountingProjects entry enabled via the OIE:Enable Projects Allocations profileoption
Workflow
ExpensesworkflowServer SideValidationprocess
Internet Expenses calls theProject Expense Report AccountGenerator, for accountinggeneration at the distributionlevel
Same as build accounting Define Account Generator in OracleProjects
Workflow
ExpensesworkflowServer SideValidationprocess
Occurs when building thedefault employee account atthe header level
Same as build accounting Not applicable
Standard Accounting Generation, Expenses Audit
The Expenses Audit module is accessed from either of the following seeded responsibilities: Internet Expenses Auditor,or Internet Expenses Audit Manager.
This table discusses the accounting generation behavior in the Expenses Audit module.
Project or
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 5/16
Non-Project Where Build Accounting Validate Accounting Comments
Non-ProjectExpenses
On AuditExpenseReports page
Occurs when auditors changeexpense types Same as build accounting
For build accounting, segmentvalues are overwritten if segmentsdefined for the expense type setup
Project ExpensesOn AuditExpenseReports page
Occurs when auditors changeexpense types
Internet Expenses calls theProject Expense Report AccountGenerator
Same build comments as for non-project expenses
3. Client Extensions (AP_WEB_CUST_ACCTG_PKG)As noted in the overview, three separate PL/SQL API client extensions are provided with OIE.J RUP2. The followingissues should be kept in mind as you plan and implement your customizations.
System Setup Controls Behavior - The build and validation stages refer to the same setup that wasdocumented in the Standard Accounting Generation section earlier. For example, if you enable expenseallocations without online validation, then only the build portion of the customization will be called duringexpenses entry.Impact on Standard Accounting Generation - If the customization is performed, then both the standardbuild and validation logic are overridden. For the validation stage, you should call the standard validation logicfrom your customization.Impact on Expenses Processing - Since the same PL/SQL API's are called during expenses entry, workflow,and expenses audit, the customization applies to all three points in the expenses process. In other words, youcannot choose to, for example, call the customization for expenses entry, and not for expenses audit.Impact in Expenses Audit - The customization is only called when auditors change expense types. Ifauditors directly update accounting segments, then no builds occur, and the standard validation logic isinvoked.
Attention:
It is critical that you evaluate the performance impact if accounting generation is customized.In addition, it is recommended that you call the standard accounting validation instead ofcreating your own customized validation logic.
Client extensions are provided in PL/SQL package AP_WEB_CUST_ACCTG_PKG, which is stored under:
$AP_TOP/patch/115/sql/apwcaccs.pls (package specification)$AP_TOP/patch/115/sql/apwcaccb.pls (package body)
Non-Project Expenses
BuildAccount
This function provides a client extension to Oracle Internet Expenses for building and validating account codecombinations for non-project related expense lines.
FUNCTION BuildAccount( p_report_header_id IN NUMBER, p_report_line_id IN NUMBER,
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 6/16
p_employee_id IN NUMBER, p_cost_center IN VARCHAR2, p_exp_type_parameter_id IN NUMBER, p_segments IN AP_OIE_KFF_SEGMENTS_T, p_ccid IN NUMBER, p_build_mode IN VARCHAR2, p_new_segments OUT NOCOPY AP_OIE_KFF_SEGMENTS_T, p_new_ccid OUT NOCOPY NUMBER, p_return_error_message OUT NOCOPY VARCHAR2) RETURN BOOLEAN;
| RETURNS | True if BuildAccount was customized | False if BuildAccount was NOT customized
How BuildAccount is invoked
BuildAccount is invoked:
indirectly by the Middle Tier (Java objects used in Expenses Entry and Audit call a PL/SQL wrapper which callBuildAccount)directly by the Server Tier (PL/SQL wrappers used by Expenses Entry, Audit, and Workflow call BuildAccount)
How to validate account segments in BuildAccount
For details on how to validate key flexfields, refer to Oracle Application Flexfields Guide. You may also refer to InternetExpenses Standard Accounting Generation logic in AP_WEB_ACCTG_PKG.BuildAccount($AP_TOP/patch/115/sql/apwacctb.pls).
Error Handling in BuildAccount
Since BuildAccount is invoked in 2 different technology stacks: Java objects(indirectly) and PL/SQL (directly), youmust accommodate two types of error handling.
For Java technology stack, you must use FND_MSG_PUB and FND_MESSAGE PL/SQL APIs to initialize an error stackand add a message to the error stack.
To initialize the error stack: FND_MSG_PUB.initialize;
To create a message:
if the message is stored in FND_NEW_MESSAGES: FND_MESSAGE.set_name(&APPL_SHORT_NAME, &MESSAGE_NAME);e.g. FND_MESSAGE.set_name('SQLAP', 'OIE_CORRECT_INVALID_CCID');
To add a message to the error stack: FND_MSG_PUB.ADD();
BuildAccount parameter p_return_error_message OUT NOCOPY VARCHAR2, allows you to pass back the errormessage text to the PL/SQL technology stack, which can be displayed in Expenses Worklfow.
To set the return error message parameter:
if the message is stored in FND_NEW_MESSAGES: FND_MESSAGE.set_name(&APPL_SHORT_NAME, &MESSAGE_NAME);
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 7/16
p_return_error_message := FND_MESSAGE.GET;e.g. FND_MESSAGE.set_name('SQLAP', 'OIE_CORRECT_INVALID_CCID'); p_return_error_message := FND_MESSAGE.GET;
GetIsCustomBuildOnly
GetIsCustomBuildOnly is called by the Expenses Entry Allocations page when users press Update/Next (only in thecase where Online Validation is disabled). Since Online Validation is disabled, there needs to be a capability to use theBuildAccount client extension to rebuild account segments in expenses entry. The GetIsCustomBuildOnly functionallows you to indicate whether you want to enable this capability or not.
If you do enable this capability, then you must update BuildAccount to supportp_build_mode=C_CUSTOM_BUILD_ONLY.
If you do not enable this capability, then the possibility for rebuilding the account segments may occur in ExpensesWorkflow with BuildAccount p_build_mode=C_VALIDATE.
FUNCTION GetIsCustomBuildOnly RETURN NUMBER;
| RETURNS | return 1 - if you want to enable custom builds | return 0 - if you do not want to enable custom builds | If Online Validation is enabled, custom rebuilds can be performed | in BuildAccount (when p_build_mode = C_VALIDATE). | | If Online Validation is disabled, custom rebuilds can be performed | in BuildAccount, as follows: | (1) in Expenses Entry Allocations page (when p_build_mode = C_CUSTOM_BUILD_ONLY) | (2) in Expenses Workflow AP Server Side Validation (when p_build_mode = C_VALIDATE)
How GetIsCustomBuildOnly is invoked
GetIsCustomBuildOnly is invoked:
Indirectly by the Middle Tier (Java object used in Expenses Entry calls a PL/SQL wrapper which callGetIsCustomBuildOnly)Directly by the Server Tier (PL/SQL wrapper used by Expenses Entry calls GetIsCustomBuildOnly)
Project Expenses
BuildDistProjectAccount
This function provides a client extension to Internet Expenses for building and validating account code combinationsfor projects related expense lines.
FUNCTION BuildDistProjectAccount( p_report_header_id IN NUMBER, p_report_line_id IN NUMBER, p_report_distribution_id IN NUMBER, p_exp_type_parameter_id IN NUMBER, p_new_segments OUT NOCOPY AP_OIE_KFF_SEGMENTS_T, p_new_ccid OUT NOCOPY NUMBER, p_return_error_message OUT NOCOPY VARCHAR2, p_return_status OUT NOCOPY VARCHAR2) RETURN BOOLEAN;
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 8/16
RETURNS | True if BuildDistProjectAccount was customized | False if BuildDistProjectAccount was NOT customized
How BuildDistProjectAccount is invoked
BuildDistProjectAccount is invoked:
Indirectly by the Middle Tier (Java object used in Expenses Audit calls a PL/SQL wrapper which callBuildDistProjectAccount)Directly by the Server Tier (PL/SQL wrappers used by Expenses Audit and Workflow callBuildDistProjectAccount)
How to validate account segments in BuildDistProjectAccount
For details on how to validate key flexfields, refer to Oracle Application Flexfields Guide. You may also refer to InternetExpenses Standard Accounting Generation logic in AP_WEB_ACCTG_PKG.BuildDistProjectAccount($AP_TOP/patch/115/sql/apwacctb.pls).
Error Handling in BuildDistProjectAccount
Since BuildDistProjectAccount is invoked in 2 different technology stacks: Java objects(indirectly) and PL/SQL(directly), you must accommodate two types of error handling.
For Java technology stack, you must use FND_MSG_PUB and FND_MESSAGE PL/SQL APIs to initialize an error stackand add a message to the error stack.
To initialize the error stack: FND_MSG_PUB.initialize;
To create a message:
if the message is stored in FND_NEW_MESSAGES: FND_MESSAGE.set_name(&APPL_SHORT_NAME, &MESSAGE_NAME);e.g. FND_MESSAGE.set_name('SQLAP', 'OIE_CORRECT_INVALID_CCID');
To add a message to the error stack: FND_MSG_PUB.ADD();
BuildAccount parameter p_return_error_message OUT NOCOPY VARCHAR2, allows you to pass back the errormessage text to the PL/SQL technology stack, which can be displayed in Expenses Worklfow.
To set the return error message parameter:
if the message is stored in FND_NEW_MESSAGES: FND_MESSAGE.set_name(&APPL_SHORT_NAME, &MESSAGE_NAME); p_return_error_message := FND_MESSAGE.GET;e.g. FND_MESSAGE.set_name('SQLAP', 'OIE_CORRECT_INVALID_CCID'); p_return_error_message := FND_MESSAGE.GET;
In either case(invoked from Java or PL/SQL), you must set parameter p_return_status to either:
'SUCCESS'
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 9/16
'ERROR''VALIDATION_ERROR''GENERATION_ERROR'
4. Client Extensions Use CasesNon-Project Expenses
Expense Allocations with Online Validation
This describes the use cases, current business logic, and client extensions used in Expense Allocations with OnlineValidation.
Use Case Client Extension
WhenExpenseAllocationspage isfirstaccessed
or
WhenExpenseAllocationspage isaccessedafter userchangedtheexpensetype for aline thathasalreadybeenallocated
or
WhenExpenseAllocationspage isaccessedafter userchangedtheexpensereportheadercostcenter
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - contains the expense type parameter id | p_segments - contains the expense report line segments | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 10/16
When userpressesUpdate onExpenseAllocationspage forlines thathave beenupdatedby users.Also, whenusers clickNext forlines thathaven'tbeenvalidated
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_employee_id - contains the employee id | p_cost_center - NULL in this case | p_exp_type_parameter_id - NULL in this case | p_segments - contains the expense report line segments | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_VALIDATE | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred
WhenExpenseReport isprocessedbyExpensesWorkflowAP ServerSideValidationProcess(APValidateExpenseReport)
(Alwaysused forbuildingandvalidatingdefaultemployeeaccountingat theheaderlevel)
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - NULL in this case | p_report_line_id - NULL in this case | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - NULL in this case | p_segments - NULL in this case | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT_VALIDATE | p_new_segments - returns the default employee segments | p_new_ccid - returns the default employee code combination id | p_return_error_message - returns any error message if an error occurred
Expense Allocations without Online Validation
This describes the use cases, current business logic, and client extensions used in Expense Allocations without OnlineValidation.
Use Case Client Extensions
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 11/16
WhenExpenseAllocationspage is firstaccessed
or
WhenExpenseAllocationspage isaccessedafter userchanged theexpensetype for aline that hasalreadybeenallocated
or
WhenExpenseAllocationspage isaccessedafter userchanged theexpensereportheader costcenter
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - contains the expense type parameter id | p_segments - contains the expense report line segments | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred
When userpressesUpdate/NextfromExpenseAllocationspage forlines thathaven'tbeenvalidatedyet and aCustomBuild hook isprovided
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_employee_id - contains the employee id | p_cost_center - NULL in this case | p_exp_type_parameter_id - NULL in this case | p_segments - contains the expense report line segments | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_CUSTOM_BUILD_ONLY | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred
WhenExpenseReport is
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 12/16
processedby ExpensesWorkflow APServer SideValidationProcess (APValidateExpenseReport)
(Used tobuildaccountingat the linelevel)
| p_report_line_id - contains report line id | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - contains the expense type parameter id | p_segments - contains the expense report line segments | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_VALIDATE | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred
WhenExpenseReport isprocessedby ExpensesWorkflow APServer SideValidationProcess (APValidateExpenseReport)
(Alwaysused forbuilding andvalidatingdefaultemployeeaccountingat theheaderlevel)
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - NULL in this case | p_report_line_id - NULL in this case | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - NULL in this case | p_segments - NULL in this case | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT_VALIDATE | p_new_segments - returns the default employee segments | p_new_ccid - returns the default employee code combination id | p_return_error_message - returns any error message if an error occurred
Expense Allocations Disabled
This describes the use cases, current business logic, and client extensions used when Expense Allocations is disabled.
Use Case Client Extensions
WhenExpenseReport isprocessedbyExpensesWorkflowAP Server
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - contains the expense type parameter id | p_segments - NULL in this case | p_ccid - NULL in this case
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 13/16
SideValidationProcess(APValidateExpenseReport)
(Used tobuildaccountingat the linelevel)
| p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT_VALIDATE | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred
WhenExpenseReport isprocessedbyExpensesWorkflowAP ServerSideValidationProcess(APValidateExpenseReport)
(Alwaysused forbuildingandvalidatingdefaultemployeeaccountingat theheaderlevel)
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - NULL in this case | p_report_line_id - NULL in this case | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - NULL in this case | p_segments - NULL in this case | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT_VALIDATE | p_new_segments - returns the default employee segments | p_new_ccid - returns the default employee code combination id | p_return_error_message - returns any error message if an error occurred
Expense Audit
This describes the use cases, current business logic, and client extensions used Expense Audit.
UseCase Client Extensions
WhenAuditorchangestheExpense
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_employee_id - contains the employee id
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 14/16
ReportLine'sExpenseType inExpensesAudit
| p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - contains the expense type parameter id | p_segments - NULL in this case | p_ccid - contains the expense report line | code combination id | p_build_mode - AP_WEB_ACCTG_PKG.C_BUILD_VALIDATE | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id
| p_return_error_message - returns any error message if an error occurred
Project Expenses
This describes the use cases, current business logic, and client extensions used for Projects.
Use Case Client Extensions
WhenExpenseReport isprocessedbyExpensesWorkflowAP ServerSideValidationProcess(APValidateExpenseReport)
(Used tobuildaccountingat the linelevel)
AP_WEB_CUS_ACCTG_PKG.BuildDistProjectAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_report_distribution_id - contains report distribution id | p_exp_type_parameter_id - contains the expense type parameter id | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred | p_return_status - returns either 'SUCCESS', 'ERROR', 'VALIDATION_ERROR', 'GENERATION_ERROR'
WhenAuditorchangestheExpenseReportLine'sExpenseType inExpensesAudit
AP_WEB_CUS_ACCTG_PKG.BuildDistProjectAccount
| PARAMETERS | p_report_header_id - contains report header id | p_report_line_id - contains report line id | p_report_distribution_id - contains report distribution id | p_exp_type_parameter_id - contains the expense type parameter id | p_new_segments - returns the new expense report line segments | p_new_ccid - returns the new expense report line | code combination id | p_return_error_message - returns any error message if an error occurred | p_return_status - returns either 'SUCCESS', 'ERROR', 'VALIDATION_ERROR', 'GENERATION_ERROR'
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 15/16
WhenExpenseReport isprocessedbyExpensesWorkflowAP ServerSideValidationProcess(APValidateExpenseReport)
(Alwaysused forbuildingandvalidatingdefaultemployeeaccountingat theheaderlevel)
AP_WEB_CUS_ACCTG_PKG.BuildAccount
| PARAMETERS | p_report_header_id - NULL in this case | p_report_line_id - NULL in this case | p_employee_id - contains the employee id | p_cost_center - contains the expense report cost center | p_exp_type_parameter_id - NULL in this case | p_segments - NULL in this case | p_ccid - NULL in this case | p_build_mode - AP_WEB_ACCTG_PKG.C_DEFAULT_VALIDATE | p_new_segments - returns the default employee segments | p_new_ccid - returns the default employee code combination id | p_return_error_message - returns any error message if an error occurred
5. Change Record
Date Description of Change
August 25, 2005Created document.
January 5, 2006 Updated document to reflect changes from patch 2656377.
April 13, 2006 Updated document to reflect changes from patch 5141939.
December 15, 2006 Updated to reflect changes for 11i.OIE.K and Release 12.
Oracle CorporationAuthor and Date Ron Langi - Internet Expenses Development - August 14, 2005Steve Dalton - Internet Expenses Product Management - August 25, 2005
Disclaimer This document is provided for information purposes only and the contents hereof are subject to change withoutnotice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whetherexpressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for aparticular purpose. We specifically disclaim any liability with respect to this document and no contractual obligationsare formed either directly or indirectly by this document. This document may not be reproduced or transmitted in anyform or by any means, electronic or mechanical, for any purpose, without our prior written permission.
9/22/2014 Document
https://support.oracle.com/epmos/faces/DocContentDisplay?_adf.ctrl-state=1d9kbzma6q_384 16/16
Oracle Corporation
Copyright NoticeCopyright 1994-2006, Oracle. All rights reserved.
Trademark NoticeOracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or itsaffiliates. Other names may be trademarks of their respective owners.