In this tutorial, we will see how to customize the existing standard Oracle report to get a delimited output file instead of the regular layout. Most business users prefer delimited report output as it can easily be imported into Excel where they can manipulate and perform calculations on the data easily.
Report Builder is the tool used to develop/customize Oracle reports. Before getting into the details, I would like to give an overview about Report Builder.
Main Components of a Report Builder:
Below is the snapshot of the Object navigator when you open a report in Report Builder. Some important components are Data Model, Layout Model, Parameter form, Triggers. Let’s discuss about each one of them in detail.
Data Model:
The Data Model is a work area in which you define what data to retrieve when the report is submitted. You create and define queries, groups, columns, parameters, and links which are called data model objects to determine what data needs to be extracted from the database as part of a report.
Tool Palette in Data Model view:
Layout Model:
Layout Model is a work area in which you can define the format (using objects like frames, repeating frames, fields, boilerplate, anchors, and Graphics objects) of your report output. When you run a report, Report Builder uses the Layout Model as a default template for the report output.
Layout Tool Palette:
# | Object | Object Name | Description |
1 | | Select Tool | To select one or more objects |
2 | | Frame Select | To select frame or repeating frame and all the objects within them. |
3 | | Rotate | To rotate Objects |
4 | | Reshape | To change the shape of the objects |
5 | | Magnify | To magnify the area |
6 | | Line | To draw a line |
7 | | Rectangle | To draw a rectangular object |
8 | | Rounded Rectangle | To draw a rounded rectangular object |
9 | | Ellipse | To draw a elliptic object |
10 | | Arc | To draw arc |
11 | | Polyline | To create a Polyline object |
12 | | Polygon | To draw a polygon object |
13 | | Text | To create a Text object |
14 | | Freehand | To create a free form obk=ject |
15 | | Frame | To create a frame. Frames are used to surround other objects and protect them from being overwritten or pushed by other objects |
16 | | Repeating Frame | To create a repeating frame. Repeating frames surround all of the fields that are created for a group’s columns meaning each repeating frame must be associated with a group created in the Data model. The repeating frame prints (is fired) once for each record of the group. |
17 | | Link file | To create an object that is read in from file |
18 | | Field | To create a field |
19 | | Chart | To create a Chart |
20 | | Button | To create a button |
21 | | Anchor | To create an anchor between two objects. Since the size of some layout objects may change when the report runs, you need anchors to define where you want objects to appear relative to one another. |
22 | | OLE2 | To create OLE2 object |
Parameter Form enables you to define the parameters for your report.
Tool Palette:
Report Customization steps:
When you have to customize a standard report, it is always advisable not to make changes to the standard report itself, instead rename it to another report and make the changes to it.
Steps:
- Download the original rdf from the file system.
- Open it in Report builder.
- Save it with a different name that meets the client’s naming conventions.
- Make the necessary changes to it.
- Save and compile the report.
- Move it to the custom top/reports/US
- Register it as a concurrent program in Oracle Applications under custom application.
Steps to change the report output to a Pipe delimited output:
The requirement here is to customize the standard “Receipt Adjustment report” to get a delimited output file instead of the regular layout. The output file should have header information like shown below on the top of the output page followed by the receipt adjustment data whose fields are separated by ‘~’.
Vendor Name~PO Number~PO Line~Po Line Description~Item Number~Category~Organization~Ship To Location~Qty Ordered~Net Qty Received~Qty Billed~Qty Accepted~Qty Rejected~Qty Cancelled~Received Qty Corrected~Net Qty RTV~Qty RTV Corrected~Receipt Num~Transaction Date~Transaction Type~Parent Transaction~Transaction amount~Unit
Regular Layout generated by the standard report:
We need Pipe delimited Output file like the below:
To achieve this:
We have to get rid of the current layout and create a new layout with 2 objects:
Frame to print the header information.
Repeating Frame to print the data.
- We need to create a Formula column in the Data model that will get the concurrent program’s output filename. We will use this file to write our pipe delimited report output to.
Steps:
- Download the original report POXRVRTN.rdf
- Open the report in the Report Builder. File>Open
Rename it according Custom naming conventions followed by the client. Here we will rename it to XXERP_POXRVRTN
Tools> Property Palette
Give the name as: XXERP_POXRVRTN
- To Create a Formula column to derive the output file name:
- Double click on the Data model in the Object Navigator.
- Click in the tool palette
- Click and drag a rectangle.
Double-click the formula column created in the data model to open up its property palette where you can set its properties.
Name: Give the name as C_OUTPUT_FILE
Data Type: Choose Character
Width: 300
PL/SQL Formula: Insert the below code which gets the Concurrent program’s output filename from the database.
function C_OUTPUT_FILEFormula return Char is
v_filename fnd_concurrent_requests.outfile_name%type;
begin
SELECT outfile_name
INTO v_filename
FROM fnd_concurrent_requests
WHERE request_id =
_CONC_REQUEST_ID;
RETURN(v_filename);
exception
when others then
RETURN(null);
end;
- Double click on the Layout model in the Object Navigator.
- Remove all the objects placed in the layout model except “No Data Found” Object.
Place a Frame and a repeating frame one below the other as shown below.
To place a frame in the Layout:
Click
in the tool palette.
Click and drag a rectangle.
Double-click the frame object in the layout to open up its property palette where you can set its properties.
Some important properties are discussed here.
Possible Values that you can enter are Contract, Expand, Fixed, and Variable.
To place a repeating frame in the Layout:
Click
in the tool palette.
Click and drag a rectangle.
Double Click on Repeating Frame to open up the property palette and rename it. Every repeating frame must be associated with a group defined in the Data model.
Here give the Source as “G_shipment_lines”.
Set the Vertical and horizontal elasticity to the required.
To print a pipe delimited text in the output file, we will use a format trigger on the frame and repeating frame.
A format trigger is a PL/SQL function executed before an object is formatted. This function must return a Boolean value (TRUE or FALSE). Depending on whether the function returns TRUE or FALSE, the current instance of the object is included or excluded from the report output. Format trigger can be used to highlight a value, for suppressing values and labels.
In the property palette of the Frame, under Advanced Layout section:
Double Click on the Format Trigger. This opens up a SQL Editor, where you can place the below code to print the header information to the output file.
function M_SHIPMENT_LINE_HDRFormatTrigg return boolean is
–Variable declaration
cmd_line VARCHAR2(3000);
v_file_name text_io.file_type;
begin
–Setting cmd_line variable to the header info
cmd_line := ‘Vendor Name’||’~'||’PO Number’||’~'||’PO Line’||’~'||’Po Line Description’||’~'||’Item Number’||’~'||’Category’||’~'||’Organization’||’~'||’Ship To Location’||’~'||’Qty Ordered’||’~'||’Net Qty Received’||’~'||’Qty Billed’||’~'||’Qty Accepted’||’~'||’Qty Rejected’||’~'||’Qty Cancelled’||’~'||’Received Qty Corrected’||’~'||’Net Qty RTV’||’~'||’Qty RTV Corrected’||’~'||’Receipt Num’||’~'||’Transaction Date’||’~'||’Transaction Type’||’~'||’Parent Transaction’||’~'||’Transaction amount’||’~'||’Unit’;
–Opening the concurrent request’s output file to write the data into it
–Always prefix “:” with the field,when you refer to a field in the data model like
:C_OUTPUT_FILE
v_file_name := TEXT_IO.FOPEN(:C_OUTPUT_FILE, ‘A’);
IF TEXT_IO.IS_OPEN(v_file_name) THEN
TEXT_IO.PUT_LINE(v_file_name, cmd_line);
END IF;
TEXT_IO.FCLOSE(v_file_name);
–If the return value is true then only this object will be included in the report output
return (TRUE);
end;
Similarly include the below code in the format trigger of the repeating frame to write the receipt records into the output file.
function R_shipment_linesFormatTrigger return boolean is
cmd_line VARCHAR2(2000);
v_file_name text_io.file_type;
begin
cmd_line := :Source||’~'||:Document_Number||’~'||:Line||’~'||:Description||’~'||:C_FLEX_ITEM_DISP||’~'||:C_FLEX_CAT_DISP||’~'||:Organization_name||’~'||:Ship_To_Location||’~' ||:Quantity_Ordered||’~'||:C_qty_net_rcvd||’~'||:qty_billed||’~'||:qty_accepted||’~'||:qty_rejected||’~'||:qty_cancelled||’~'||:C_qty_corrected||’~'||:C_qty_rtv_and_corrected||’~'||:C_qty_corrected_rtv||’~'||:Receipt_Number||’~'||:Receipt_Date||’~'||:Transaction_Type||’~’ ||:Parent_Transaction_Type||’~'||:Transaction_Quantity||’~'||:Transaction_Unit;
v_file_name := TEXT_IO.FOPEN(:C_OUTPUT_FILE, ‘A’);
IF TEXT_IO.IS_OPEN(v_file_name) THEN
TEXT_IO.PUT_LINE(v_file_name, cmd_line);
END IF;
TEXT_IO.FCLOSE(v_file_name);
return (TRUE);
end;
- Now that the changes are done, save the report.
- Connect to the database by navigating to File > Connect
Then compile the report by navigating to Program> Compile> All.
Errors will be listed if there are any. Correct them and recompile. If there are no errors and the compilation was successful, you will get the below message. Click OK and save again.
- Now move the report to the Custom top/Reports/US
- Register it as a concurrent program in Oracle Applications and assign it to the desired responsibilities. Please refer to Concurrent Program registration article for registration details.
Ur's
Amaralam