Oracle EBS R12 Solutions

Saturday 18 March 2017

How to find Onhand Quantity of a Lot Controlled Item in a locator Controlled Subinventory ??

Had a requirement to get total Available to Transact (ATT) quantity of a lot controlled item in a locator controlled subinventory. Searched extensively in MOS and google to find API. We knew INV_Quantity_Tree_PUB.Query_Quantities API does that but could not find out appropriate parameter values. As the item was lot controlled, we were passing p_is_lot_control parameter as TRUE. API was returning 0 as ATT because we were not passing lot number.

We needed to find ATT of all lots in a locator inside a subinventory. After playing with the parameter values I realized that to get total ATT of the item we actually needed to pass FALSE to p_is_lot_control parameter. And to our surprise it worked like a magic. Here is a sample script which can be used.

DECLARE
        L_api_return_status VARCHAR2(1);
        l_qty_oh             NUMBER;
        l_qty_res_oh         NUMBER;
        l_qty_res            NUMBER;
        l_qty_sug            NUMBER;
        l_qty_att            NUMBER;
        l_qty_atr            NUMBER;
        l_msg_count          NUMBER;
        l_msg_data           VARCHAR2(1000);
        l_item_id            NUMBER :=3917224;
        l_org_id             NUMBER :=284;
        BEGIN

        inv_quantity_tree_grp.clear_quantity_cache;
        dbms_output.put_line('Transaction Mode');
          apps.INV_Quantity_Tree_PUB.Query_Quantities (
            p_api_version_number => 1.0
          , p_init_msg_lst       => apps.fnd_api.g_false
          , x_return_status      => L_api_return_status
          , x_msg_count          => l_msg_count
          , x_msg_data           => l_msg_data
          , p_organization_id    => l_org_id
          , p_inventory_item_id => l_item_id
          , p_tree_mode          => apps.INV_Quantity_Tree_PUB.g_transaction_mode
          , p_onhand_source      => 3
          , p_is_revision_control=> false
          , p_is_lot_control     => FALSE
          , p_is_serial_control => FALSE
          , p_revision           => NULL
          , p_lot_number         => NULL
          , p_subinventory_code => 'SSTOCK'
          , p_locator_id         => 11285
          , x_qoh                => l_qty_oh
          , x_rqoh               => l_qty_res_oh
          , x_qr                 => l_qty_res
          , x_qs                 => l_qty_sug
          , x_att                => l_qty_att
          , x_atr                => l_qty_atr );

dbms_output.put_line('Quantity ATT'||to_char(l_qty_att));
dbms_output.put_line('Quantity ATR'||to_char(l_qty_atr));
end;
/

It may be known to others but I did not know this. So thought of sharing this for people like me.
Happy reading.

Wednesday 12 June 2013

How to retrigger PO Requisition Account Generator (in iProcurement)?

Summary

“PO Requisition Account Generator Workflow” (POWFRQAG) gets triggered to default the distribution accounts – and usually this WF is customized in most of the EBS implementation projects to support the business rule for defaulting charge account.

This process also gets retriggered automatically for change in some entities like (category, requestor etc.) depending on the line type of the PR. But the process does not retrigger for update in any other field (or DFF) in PR line and that’s where this extension is required.

This solution below will describe how to retrigger the “PO Requisition Account Generator Workflow” for change in ‘Quantity’ and this is limited to the iProcurement page [iProcurement >> Shopping Cart >> Checkout >> Requisition (Lines)] only – and it is not applicable to the ‘Requisitions’ Forms.

Solution Approach

All the fields for PR line are available in the entity object oracle.apps.icx.por.schema.server.PoRequisitionLineEO. The account generator gets retriggered for the attributes where the property AccountLineBizAttrSet is set to ‘Y’

So, here we need to extend the PoRequisitionLineEO to xxcusPoRequisitionLineEO to set the AccountLineBizAttrSet property of ‘Unit Price’ attribute to ‘Y’

Technical Details

Following steps to be done to address the customization:

Copy and download entire directory structure and files from $JAVA_TOP/oracle/apps/icx
To extend the PoRequisitionLineEO, create a new project and then open the package oracle.apps.icx.por.schema.server in the project. Now select the EO in the “Extends Entity” field.Save the new EO as xxcusPoRequisitionLineEO.

Entity Object Wizard, click the “New from Table…” button and select your target attribute(s) [e.g. QUANTITY]. Click “OK”. Accept the defaults for the rest of the steps in the wizard.

In the System Navigator panel, highlight the EO created above. The Structures panel will list all the attributes in the EO.

Highlight the attribute QUANTITY in the Structures panel and the right-click to select the “Edit” option. The Attribute Editor will come up.
Select Properties from the left-hand panel. Enter “AccountLineBizAttrSet” in the name field and “Y” in the value field. Click “Add”, then Hit “OK” and save the changes.

Now create the substitution for the parent (seeded) EO.

Installation

Copy xxcusPoRequisitionLineEODefImpl.java and xxcusPoRequisitionLineEOImpl.java to $JAVA_TOP/oracle/apps/icx/por/schema/server.
Compile java files using javac command and change the permission of the class files to 777
Copy xxcusPoRequisitionLineEO.xml $JAVA_TOP/oracle/apps/icx/por/schema/server and change the permission to 777
FTP the substitution file xxcusIProc.jpx (in general this file is created under ‘MyClasses’ folder where the project is created) and execute the following command:
java oracle.jrad.tools.xml.importer.JPXImporter $JAVA_TOP/oracle/apps/icx/por/schema/server/xxeocIProc.jpx -username apps -password <password> -dbconnection "(DESCRIPTION=(ADDRESS_LIST=(ADDRESS= (COMMUNITY=TCP_COMMUNITY)(PROTOCOL=TCP)(Host= <host>)(Port=<port>)))(CONNECT_DATA=(SID= <sid>)))"

Bounce OACORE and OC4J in the middle tire.

Tuesday 4 June 2013

How to Send "To Supplier" Attachments with Purchasing Notifications

How can Header and Line level attachments of the type To Supplier be sent with the Supplier Notification, at time of Purchase Order Approval?

Solution

1. Set-up the Purchasing Options:

• Navigate to Setup => Organization => Purchasing Options
• Set the Output format to: PDF
• Set the Maximum Attachment Size in MB to any value that email server can handle(e.g. 10)
• Set the Email Attachment File name (for example Attachment.zip)

2. Create an attachment file on ones system
(Word Doc, Excel File, etc.)

3. Create a Purchase Order (PO) with Attachments

• Navigate: Purchase Orders => Purchase Orders
• Enter the required data for the PO and save
• Add an attachment at the header level and attachment at line level
(Use Attachments icon - Use 'To Supplier' as the Category)

• Click on Save
• Click on the Approval button
• In the Email field, enter the Supplier Email Address
• Submit the PO for Approval

4. The email will be received at the address entered above
5. Save the attached file attachment to ones desktop for review

Here is the Oracle Support Document for the same
R12: Sending "To Supplier" Attachments with Purchasing Notifications [ID 797329.1]

Cheers....

Sunday 2 June 2013

How to Create Custom Customer Statement Report??

Business Requirements

Client business needs to generate and send the statements with outstanding balance to their customers. Oracle eBS provides the functionality to generate the statement from ‘Receivables’ application:

Receivables > Print Documents > Statements

However, the output generated by the program (AR Customer Balance Statement Letter) needs to be formatted as per the business standard layout and additionally the output needs to be emailed to the customers based on the registered contacts.

Build Constraints

Following section describes the seeded process and the constraints around the extension to cater the requirements.

Study of the Seeded Process

Once the application user enters the statement data from the ‘Print Statement’ form and ‘Submit’ the program, it submits the ‘Statement Generation Program’ concurrent request.

This is a ‘Spawn’ process and it populates the temp tables based on the data entered by the user in the form.

Finally it submits the ‘AR Customer Balance Statement Letter’. This is a java concurrent program which executes the query in the temp table and generates the PDF output as per Oracle defined template. The SQL query is attached as a XML data template in its data definition in ‘XML Publisher Administrator’.

The data in the temp table is purged once the process is completed.

The navigation to Submit Customer Statement Print Documents -> Statements

Select the Operating Unit and then Select Cycle and Statement Date and Click Submit. It actually Submits AR Customer Balance Statement Program

The program is submitted in all installed languages concurrently.

Where is the Customization?

To fulfill the requirement, following customizations are required:

1. Create a new custom XML data template to include the new field ‘EMAIL_ID’ for the customer contact.

2. Create a bursting control file so that the output PDF is split based on the ‘EMAIL_ID’.

3. Upload the custom XML data template and the bursting control file to the data definition of the concurrent program ‘AR Customer Balance Statement Letter’ (identified by the short name ‘ARCUSBALSL’).

4. Create a new rich text template (RTF) based on the proposed layout and upload the document to XML template related to the above data definition.

Thus the ‘AR Customer Balance Statement Letter’ will be submitted by the seeded process but it will execute the query in the custom data template and generate the output as per the custom layout. The bursting program will split and send the email to the intended recipients.

Where is the Constraint?

Oracle has restricted to upload any custom data template or bursting control file against the data definition ‘ARCUSBALSL’. Thus generic customization approach stated in above section can not be done in this case.

A parallel custom process (like ‘XXX AR Customer Balance Statement Letter’) can not be designed because it can’t be executed alone. It has to be submitted by the parent program ‘Statement Generation Program’, spawned from the ‘Print Statement’ form to generate all the data required for the report.

Revised Technical Approach

Since there was no alternative, the technical team has completed a PoC by altering seeded Oracle process which violates the Oracle standard practice of implementation.

This section highlights the steps to be done to implement the solution:

1. Create a custom data definition (XX_ARCUSBALSL) and add new RTF layout.

2. Download the XML data template ARXSGPO.xml and Save it as XX_ARXSGPO.xml.

- Modify to add the new field ‘EMAIL_ID’ element

- Add code in “beforeReport” trigger to update the template name in the table FND_CONC_PP_ACTIONS for the current request id.

UPDATE FND_CONC_PP_ACTIONS
   SET argument1 = 'XXCUSTOM'
      ,argument2 = 'XX_ARCUSBALSL'
WHERE action_type = 6
   AND concurrent_request_id = P_CONC_REQUEST_ID;

By updating the FND_CONC_PP_ACTIONS table you ask Post Processor to pickup the custom Data Definitions and Templates

XXCUSTOM is the Custom Application Name

- Add the code “AfterReport” trigger to execute the bursting program.

3. Create a bursting control file for sending email.

4. Attach the ‘XML data template’ and ‘Bursting Control File’ with the data definition XX_ARCUSBALSL.

5. Now ARCUSBALSL (‘AR Customer Balance Statement Letter’) executes the java class oracle.apps.xdo.oa.cp.JCP4XDODataEngine (executable name XDODTEXE) .

Create a new java class XXJCP4XDODataEngine to call the custom data definition ‘XX_ARCUSBALSL’ instead of the seeded data template.

Create a new executable XX_XDODTEXE with the new java program and attach it with the seeded concurrent program ‘ARCUSBALSL’.

6. Thus the seeded ‘Statement Generation Program’ will invoke the ‘AR Customer Balance Statement Letter’ and this will execute the query in the custom XML data template to create desired PDF files which will be emailed by the bursting program.

Risk and Mitigation

The approach described above does not alter any process in ‘Statement Generation Program’. It is only altering the mechanism of producing output; yet there are some potential risks in this solution.

Risks

1. The executable of the seeded concurrent program ‘ARCUSBALSL’ is changed to a custom executable – so this can be reverted after the patch application.

2. New functionality will not be available after patch application since ‘ARCUSBALSL’ will be executing a custom query. Although this is not much relevant since for a custom report (which is a copy of seeded report with extended functionality) is never upgraded with the patch application.

3. Oracle Support may not be available for this program.

Mitigations

1. A script will be provided which can be executed as a post patching activity. This script will replace the seeded executable with the custom one.

2. If ARXSGPO.xml is upgraded then XX_ARXSGPO.xml can be rebuild based on that. This is however may not require at all.

3. In case of any issue in live instance, it can be reproduced in any support instance by replacing the executable of the concurrent program with the seeded one. Then it can be observed if there is issue exists with the seeded process and accordingly it can be reported to the Oracle Support.

Cheers.....

How to use Hook to print custom PO Report???

When PO is submitted for approval , in the PDF generation flow standard XML is generated by the routine POXMLGEN in package PO_COMMUNICATION_PVT (file: POXVCOMB.pls). In order to support the custom extensions in the XML generation logic a new custom hook GENERATE_XML_FRAGMENT in package PO_CUSTOM_XMLGEN_PKG is added. This new procedure will be called from the standard XML generation logic - POXMLGEN. In order to have this hook available in the PO_COMMUNICATION_PVT the Patch set: 14677799:R12.PO.B [Metal ink ID: 1505737.1] should be available in environment.

The custom hook has the following logic:

- Take the DOCUMENT_ID, REVISION_NUM, DOCUMENT_TYPE, and DOCUMENT_SUBTYPE as input.

- Generate XML from the custom source under the tag PO_CUSTOM_DATA.

The returned XML will be merged into the standard XML and it will be sent to the publisher for rendering the template.

Guidelines

1. Before extending the custom hook, check if the requirement can be met by the standard XML itself. One option could be to use the DFF attributes to capture the required attribute. It is recommended to use the standard XML attribute instead of extending the hook wherever applicable. In this case, the customer is trying to determine the Legal Entity name based on a different attribute (instead of using the default legal entity for that operating unit).

2. Backup the custom hook source files. Modify the custom hook source files to generate the custom XML based on the custom source (refer the example below). The XML can be either hand built or generated using the dbms_xml routines. Make sure that

a) the XML is complete (match the tags)

b) No invalid characters in the XML

Exceptions are handled gracefully

Below is the sample code for generating Custom XML for Std PO

PROCEDURE generate_xml_fragment (

p_document_id IN NUMBER,

p_revision_num IN NUMBER,

p_document_type IN VARCHAR2,

p_document_subtype IN VARCHAR2,

x_custom_xml OUT NOCOPY CLOB

)

--1). Declare context

CONTEXT DBMS_XMLGEN.ctxhandle;

context1 DBMS_XMLGEN.ctxhandle;

w_document_type VARCHAR2 (1000);

BEGIN

-- Custom Function

w_document_type := PO_COMMUNICATION_PVT.getdocumenttype ();

--- Query for Standard PO

CONTEXT := DBMS_XMLGEN.newcontext

('SELECT

TO_CHAR(ph.creation_date,''fmddth Month YYYY'') xx_order_date,

TO_CHAR(ph.start_date,''fmddth Month YYYY'') xx_aggrement_start_date,

TO_CHAR(ph.end_date,''fmddth Month YYYY'') xx_aggrement_end_date ,

DECODE

(NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getlocationinfo (ph.bill_to_location_id)

) bill_to_location_id,

DECODE (NVL (ph.ship_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getlocationname ()

)||chr(10) bill_to_location_name,

''Email : ''||pap1.email_address ap_email,

DECODE (NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressline1 ()

)||chr(10) bill_to_address_line1,

DECODE (NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressline2 ()

)||chr(10) bill_to_address_line2,

DECODE (NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressline3 ()

)||chr(10) bill_to_address_line3,

DECODE (NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressline4 ()

) bill_to_address_line4,

DECODE (NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressinfo ()

)||chr(10) bill_to_address_info,

DECODE (NVL (ph.bill_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getterritoryshortname ()

)||chr(10) bill_to_country,

DECODE (NVL (ph.ship_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getlocationinfo (ph.ship_to_location_id)

) ship_to_location_id,

DECODE (NVL (ph.ship_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressline1 ()

)||chr(10) ship_to_address_line1,

DECODE (NVL (ph.ship_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getaddressline2 ()

)||chr(10) ship_to_address_line2,

CURSOR(SELECT xx_po_long_text_f(fad.media_id, ''SHORTTEXT'') xx_to_supplier_text

FROM fnd_attached_docs_form_vl fad

WHERE fad.pk1_value(+) = TO_CHAR(ph.po_header_id)

AND entity_name =''PO_HEADERS''

AND Category_Description =''To Supplier''

AND function_name =''PO_POXPOEPO''

AND datatype_name = ''Short Text''

ORDER BY fad.seq_num ASC

) hdr_short_text,

CURSOR (SELECT xx_po_long_text_f(fad.media_id, ''LONGTEXT'') xx_to_supplier_text

FROM fnd_attached_docs_form_vl fad

WHERE fad.pk1_value(+) = TO_CHAR(ph.po_header_id)

AND entity_name = ''PO_HEADERS''

AND category_description = ''To Supplier''

AND function_name = ''PO_POXPOEPO''

AND datatype_name = ''Long Text''

ORDER BY fad.seq_num ASC

) hdr_long_text,

CURSOR(

SELECT pl.line_num line_num,

item_description item_description,

(pl.note_to_vendor||chr(10)) line_note_to_vendor,

pl.unit_meas_lookup_code unit_meas_lookup_code,

TRIM(TO_CHAR(pl.unit_price,''999,999,999,999.99'')) unit_price,

TRIM(TO_CHAR(pl.quantity,''999,999,999,999.99'')) quantity,

pl.quantity_committed,

DECODE

(NVL (pll.ship_to_location_id, -1),

-1, NULL,

PO_COMMUNICATION_PVT.getlocationinfo (pll.ship_to_location_id)

) ship_to_location_id,