Oracle General Ledger

Financial Statement Generator FSG Report Writing Basics

FSG Definition Screens  

NAV : General Ledger : Reports > Define
This document details the configuration of FSG reports in the core general ledger screens. It has been written based on Oracle 11i functionality, but most features are applicable to previous versions. Although possible, the writing of FSG reports using ADI is not covered by this document, though many of the principles and suggestions still apply. The document has been written in the context of the recommendations in the more detailed µReport Writing Guidelines¶ document. The XML publishing feature available with 11.5.10 is not covered in this document. At a high level the recommended report writing process is as follows.  Define report on paper or spreadsheet with user.  Define Row Set in development environment and create a test report with existing seeded column sets to review data.  Once the Row Set data is correct work on the formatting such as spaces, indents and descriptions.  Create the column set and apply to the test report.  Create optional features such as content sets, row orders and display sets.  Once the report has been fully tested and signed off, migrate to production using the standard FSG transfer program.    

Once the request is complete you can then query your new component in the normal screens just like any of the existing ones. Where possible make full use of the µAutocopy¶ feature instead of writing components from scratch. All report components. including whole reports can be copied. Component : Whatever screen you access the autocopy from you will need to select the component you want to copy from the pick list. When you press the [Copy] button a concurrent request will create the new components so this may take a minute or two. Target : type in the new name of the component.  . Source : Select the name of the component you want to copy.FSG Definition : Autocopy        NAV : Reports > Autocopy All report components can be copied using the µAutocopy¶ feature for which most of the screens discussed below have a button.

Row Sets : Definition     NAV : Reports > Define > Row Sets Open the Row Set window below to either define a new Row Set or select an existing one to update. When you have selected the Row Set press the µDefine Rows¶ button to open the next screen. The screen works like a standard Oracle form so you can use either F11 or the torch button to query an existing Row Set. .

1.30.Row Sets : Row Definitions 1     NAV : Reports > Define > Row Sets Use this screen to define you rows within your Row Set. Format Options      Indent : Number of characters from left that row description will appear. start the Assets at 10 and the Liabilities at 500. Lines to Skip : This is the number of lines before or after the row to leave as a blank.2 & 3 are typical for a P&L report. Decide in advance how many total and sub-total levels you report will have.20. Line Item : This is the title of the row that will appear in the report. The values 0. Such as µ-¶ or µ=µ Page Breaks : Tick the box to page break before or after row .40 and then restart major areas of the report in a new range. This is used to show a visual split between different areas of the report. The highest level will have an indent of 0 and the lowest level of detail with have the highest indent.510. You can enter around 130 characters but bear in mind how this will appear on the report... Line : This is the row number that is used to reference the row in calculations. For example if writing a Balance sheet.. A Row Set can have from one to several hundred rows. It is recommended that you use sequences 10. Underline Characters : Used on totals.520. This will give you room to make adjustments later if needed.

. Thousands. Millions. YTD.Row Sets : Row Definitions 2   NAV : Reports > Define > Row Sets Advanced Options    Row Name : Max. Refer to report writing guide for more information. Generally used on column sets not row sets so can leave blank. Control Value : Used for budgets and entered currency. -12 is same period last year. Budget Currency : Leave blank to pick up total functional balance.  Balance Control : These can all be left blank unless required      Display Options : These are mostly defined in Column Set. This is used to reference the row in calculations Percent of Row : Used to reference another row that will be used to calculate a percentage Override Column Calculations : Refer to FSG guidelines document for more information on this. 999. Amount Type : PTD.  Display Row :Leave ticked unless this is a calculation to hide  Display Zero : Generally no. Offset : This is a reference to the number of periods from the period the report is submitted for.  Factor :Units. Actual.  Change Sign : eg.99 Generally used on column sets not row sets so can leave blank.999.  Level of Detail : Used with display sets. 30 Characters. To show revenue as positive on P&L  Change Sign on Variance : As above.  Format Mask : eg. or enter a value to pick up a translated balance. For example 0 is current period. QTD.999 or 999. but can be ticked to create fixed layout reports.

and are key in defining the structure and content of the report. Generally leave this as µT¶ for total as you can use content sets to expand the report at run time if needed. Accounts Low ± High :Always enter the minimum needed for the report. To open the account assignment screens press the button shown on the previous page. Summary : Only used with summary accounts. Set of Books : This is generally left blank to pick up the books of the responsibility the report is being run from. You can define multiple account assignments for each row.E or B. but you can report across multiple sets of books in a single report as long as they share the same chart of accounts ( Same ID not. Sign : µ+¶ or µ-¶ to indicate if the balance of the account range should be added or deducted. Tick to pick up summary account balance in the account range defined. just enter the specific natural account and leave the cost centre and balancing segment blank. not just common structure )     . Display :T.Row Sets : Account Assignments      NAV : Reports > Define > Row Sets > [ Account Assignments ] For most reports the account assignments are the main feature of the row set. The less you put in here the lower the maintenance and greater the future flexibility of the report. Activity :Usually µNet¶ but can be µDr¶ or µCr¶ if needed. but where possible you should make use of the parent accounts in you chart of accounts rather than hard-coding the detail into the report. For example for a P&L.

You can define multiple calculations for each row. Abs ) Generally the first value line should be µEnter¶ otherwise it can cause erroneous results with complex calculations.  Low / High : This is the row numbers. -. Median. Enter. (Refer to FSG Report Writing Guidelines document for more information )  Constant : This is an absolute value. If the formula is complex the work through it on a spreadsheet first before creating in an FSG. and you have the full range of mathematical operators available to define you formula. Average. but not both. ( You will see here the importance of the row name in selecting the right range of rows here. 20.  Operator : ( +. StdDev. *.Row Sets : Calculations    NAV : Reports > Define > Row Sets > [ Calculations ] Calculations and Account Assignments are mutually exclusive.  Row Name : Used to reference a specific row within the row set. . This means that each row can only have one or the other. 30.  Seq : This is the sequence of the calculation line. /. %. To open the calculation screen press the µCalculation¶ button on the µRows¶ window. For example you may enter a ratio figure or percentage to use. Use the 10. 40 sequence to allow you to make amendments later if needed.

. ( Refer to FSG Report Writing Guidelines document for more information ) The screen works like a standard Oracle form so you can use either F11 or the torch button to query an existing Column Set.Column Set : Definition       NAV : Reports > Define > Column Sets Open the Column Set window below to either define a new Column Set or select an existing one to update. The µDefine Column Sets¶ window works like the Row Set on described already. When you have selected the Column Set press the µDefine Columns¶ or µBuild Column Set¶ button to open the next screen and continue with the definition. and can be used to define all information relating to a column set. The µBuild Column Set¶ window is a graphical layout for the initial structure definition of the column set and for the final formatting of column headings. If you are defining a new column set then follow the standard naming conventions for your organisation.

or enter a value to pick up a translated balance. Follow the 10. All column sets should use one of a few values for the first column to match the standard suite of row orders defined. Budget Currency : Leave blank to pick up total functional balance.999. Column Sets are used mainly for defining the period. 80 & 130 characters. If left blank then the default is a 0 offset. QTD. Examples are :PTD.30 sequence so that you have room to make changes later if needed. Sequence : This is the reference number for the column order and calculations.999 or 999. Format Mask : Controls the format of the data in the column. . For example 999.20. Whilst Row Sets are used mainly for defining the accounts.99 or 999. Position : This is the position in number of characters that the first column is from the left side of the page.Column Set : Column Definition 1   NAV : Reports > Define > Column Sets > [ Define Columns ] Column Sets are the other required component of every FSG report. balance type or a secondary account segment such as cost centre. Billions and Percentiles      Balance Control :     Amount Type : This is usually required on a column set.999. For example 0 is current period.99 Factor : If left bank then default is µUnits¶ but can also select from Thousands. For example 40. YTD. Millions. Control Value : Used for budgets and entered currency. -12 is same period last year. Offset : This is a reference to the number of periods from the period the report is submitted for. Actual.

. This is used to reference the column in calculations Description : Used with above to give additional information. but can be ticked Change Sign : To switch +ve values to ±ve and vis-versa. It is used to assign a specific value. Does not appear on the actual report. Override Value : Works with the segment override field on the column set definition. Change Sign on Variance : As above  Account Assignments & Calculations:   The account assignment and calculation features for column sets are the same as those described for Row Sets already so please refer to previous pages. ( Refer to FSG Report Writing Guidelines document for more information ). Remember that if using assignments on rows and columns the report will show the intersecting value of the two. Percent of Column : The sequence number of the column you want to use as the denominator ( the 100% column) for a percentage calculation on this column.Column Set : Column Definition 2   NAV : Reports > Define > Column Sets > [ Define Columns ] Advanced Options      Column Name : Max. Override Row Calculations : Tick to set your column calculations to override any row calculations.  Display Options :      Level of Detail : Used with display sets. Display Column :Leave ticked unless this is a calculation to hide Display Zero : Generally no. 30 Characters.

or you can choose to submit reports to only show exceptions. Flag : Enter the character used to highlight the exceptions such as * # x Condition : Select one of the conditions ( = . Define column exceptions to highlight account balances to management for additional review. There usefulness is limited because they are based on constant values that would need ongoing review and maintenance.Column Set : Exceptions   NAV : Reports > Define > Column Sets > [Define Columns] > [ Exceptions] Exceptions are an optional component and not generally used on standard FSG reports. > >= and <>) Constant : Enter a value for the condition to match. Exceptions will appear with a µflag¶ next to them in the report. You can enter multiple conditions. but in order to work. then any value in the report must match all of the conditions. <=.      . < .

 Heading : This is the four rows that define the individual column headings.  &BUDGET : This will show the budget name based on the control values used. Use the folder tool buttons in the top left to change the column orders and width. You can press the button [Create Default Headings] and then update manually. Updates made here are applied to the column definitions in the previous screen and vis-versa. . Amount Type & Offset : These are all taken from the main column definition screen  &POI : Period of Interest.  [More Column Options] : This shows some additional setup fields that are also available in the main column definition screen so refer to previous pages for details. Name. These must be defined in this screen as they cannot be defined anywhere else.  Sequence.Column Set : Build Column Set      NAV : Reports > Define > Column Sets > [ Build Column Set ] Define or review the column definitions in a more graphical format. You can create default column headings. but it is likely that you will want to enter your own as described below.  Format Mask : This is taken from the main column definition screen. is a reference to the period name that will appear on the column heading based in the offset and the period the report was run for.

PT : Total by page ( or spreadsheet TAB in ADI). column. This effectively allows multiple reporting styles from a single report definition. . Name & Description : Enter a name and description for your content set following a standard naming convention so that the definition can be understood by the users .  Display :The default is µN¶ which means no override ± ± ± ± ± ±      CT : Total by Column. Summary : Normally left blank. This can be in the 10.Content Sets : Definition   NAV : Reports > Define > Content Sets Content Sets allow you to control the layout and level of detail of existing reports when they are submitted. PE : Expand by page ( or spreadsheet TAB in ADI). page or report ) Refer to the document µFSG Report Writing Guidelines¶ for suggestions of how to define a suite of standard content sets that can be used to add flexibility to your reports. Type : This determines how the report will be processed by the server. RT : Total by row. RE : Expand by row. As with row sets only select values in specific segments and leave other segments blank. but select yes to base the content set on summary accounts within the ranges defined for each line. Generally leave this as Sequentially. Sequentially will be slower but use less resources. RB : Both expand and total by row.30 sequence. Account Assignments : A content set can have multiple account assignments.  Seq : Enter the sequence order for the content set assignments.  Low / High : Enter the low and high range for specific account segments.20. Content sets determine which specific account segments are expanded in more detail and how that expansion occurs ( By row.

 Seq : Enter the sequence order for each segment to be displayed in.  Ranking : Ascending or Descending Account Display : This defines how the detail of rows expanded by a row set or content set will show on the report. This may vary when different column sets are used. Order : Column number as it appears in a report.Row Order : Definition     NAV : Reports > Define > Order Refer to the report writing user guide for suggestions of how to define a suite of standard row orders that can be used to add flexibility to your reports.  Name : Enter column name or. . Enter µ0¶ for segments you do not want displayed. Refer to the report writing user guide for more information on this. For example 40.  Segment : Select the segment name  Order by : Value or Description  Display : Value. Every segment must have a value. but this doesn¶t have to match the order on the CoA definition.   NOTE : Be careful to match the total width of the descriptions for the row order to the size of your pre-defined column sets. 80 & 130 characters. Name & Description : Enter a name and description for your row order following a standard naming convention so that the definition can be understood by the users ( refer to report writing user guide) Rank By Column : This is used to specify which columns values in a report are used to order the expanded rows. Description or Both  Width : Enter the width in characters for each segment. Have more or less characters that the column set will lead to unexpected results on the report output. It only has an impact on rows and account segments that have been expanded.

 . Column & Content Sets ) so that users can run them quickly and consistently. Required Components : Select an existing Row Set and Column Set from the pick lists. and the title appears on the report output. title and description following a standard naming convention so that the definition can be understood by other users. Name Title & Description: Enter a report name. Every report must have at a minimum a Row Set and a Column Set. All other components are optional. The report name and description are visible in the screens when selecting which report to run.Report : Definition 1      NAV : Reports > Define > Report FSG reports should be defined for the key monthly reports to group together report components ( Row. or can be left as default. Consider giving users access to this screen even if they are not allowed to define other components. Multiple reports can share the same components.

1.  Display Set : These work independently to control the parts of the report visible to different users.1. but you can also enter a specific currency . If you are not using a content set then the Row Order works with any expanded rows.2 & 1. but are redundant if ADI is being used. Other Components : Optionally select values for these fields.  Content Set : If the content set is expanding rows then select a row order that controls the same segments.2. Level of Detail : This works with the level of detail on the row set definition to have different reports from the same definition. but only if translated balances exist for that currency. µRound then Calculate¶ or µCalculate then Round¶.Report : Definition 2   NAV : Reports > Define > Report Optional Components : Optionally select the additional report components.  Currency : This is usually left blank to pick up the functional currency of the set of books.     Rounding Options : It is sometimes statutory requirement to perform this in a certain order. This can be left blank and the default will be µFinancial Analyst¶ Output Option : The default is text and this will work with publishing the reports as text direct from the apps and with publishing to spreadsheets via ADI. For example to look just at a specific Cost Centre. .  Segment Override : You can hard code a segment override into a report.3 or 3.  Row Order : Although the segments must match the content set they can be in a different order. The other options are to change the format of reports published from the apps. If you want to report entered currency then refer to the control values section on the following page. but it is normal to leave this field blank have only select when required at the time the report is being run. All of these are available each time you run a report.2 would both work if the Content Set is expanding segments 3.

Encumbrance and Currency information to FSG reports.       When using control values to define currency. which applies to the whole report and only works with translated balances. Note that it is only available when control values exist in one or more of the report components. They are referenced on the columns and/or rows as number and then in the report this numbers are linked to budgets to currency¶s. . You can enter multiple control values if you want to use more than one currency or budget. The advantage of this method is that you can hard code the control values in the detailed components ( Rows & Columns ) and then each year when the budget changes just update the control values on the report once and link that value to a new budget. It is different to selecting the currency on the report definition. This will only apply to the rows or columns with the matching control value. Access the this screen by pressing the control values button on the report definition screen.Report : Control Values   NAV : Reports > Define > Report > [ Control Values ] Control Values are used to add Budget. you have to select a currency type of Entered or Translated.

The same report can be run many times with different overrides. This can be any period in the past or future ( Doesn¶t have to be open ). Row Order & Display Set : You can add or change the optional report components at run time Rounding Options : The default rounding option can be updated at report run time. Default is the functional currency but any other currency for which translated balances exist can be used. Output Option : This is defaulted from the report definition but can be updated at report run time        . and is used as the basis for the µOffset¶ period in the report definitions. Content Set. If no translation exists then there will be no balances Request ID : This is populated automatically when the report is submitted Segment Override : This can be used to select specific segment values such as accounts or cost centres to filter the report by at run time. Columns with an offset of µ0¶ will show data for the accounting period selected here.Report : Submission    NAV : Reports > Request > Financial Report : select the name of the pre-defined report. Currency : This is the base currency for the report. Period : This is the accounting period the report is to be run for. Exceptions : You can tick the box to only show the pre-defined report exceptions in the output.

Report : Submission of Ad-Hoc Reports         NAV : Reports > Request > Financial > [ Define Ad-Hoc Report ] Use Ad-Hoc reports to define one of reports using any of the existing pre-defined report components. This can be used to meeting reporting requirements without the need to define new reports. press µOK¶ to return to the report submission screen You can then add the optional components in the normal way described on the previous page before submitting your ad-hoc report. Select the row set and column set you want using the pick list. . Row Set and Column Set from the report selected above. It will not update the original report. Once this is done. In the Create Ad-Hoc Report screen below you will see it has been pre-populated with the Title. You can update any of these to create your out version of this report and it only applies to this submission. Report : Select the name of a pre-defined report similar to the layout you want to define before you press the adhoc button. then enter any control values required.

Sign up to vote on this title
UsefulNot useful