implementing client extensions for oie

Upload: dsgandhi6006

Post on 10-Oct-2015

94 views

Category:

Documents


1 download

DESCRIPTION

Implementing Client Extensions for OIE, Oracle Internet Expense

TRANSCRIPT

  • 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.