You use this program to set up the format and definitions of financial reports you want to print in your General Ledger module.
The Financial Report Writer is specifically designed to extract data only from the General Ledger. The Report Writer programs can be used to extract data from other modules, including the General Ledger.
You can produce consolidated financial reports for multiple companies using the Financial Report Writer, providing you are sharing the General Ledger files for those companies (see Company Setup).
Field | Description |
---|---|
Edit | |
Copy | Create a new report by copying an existing report definition (see Copy Report Definition). |
Functions | |
Import | Import financial report definitions from another SYSPRO database (see Import Report Definition). |
Export | Export financial report definitions to a file that can be imported into other SYSPRO databases (see Export Report Definition). |
Preferences | |
Default Report Options | Configure default settings you want to apply when you add a new report definition (see Report Options). |
The currently defined report definitions are displayed in this listview.
Column | Description |
---|---|
Report code | Indicates the code assigned to the report definition. |
Type | Indicates whether the report is a standard report that prints normally (Report) or an XML document that can be viewed using a web browser (XML). |
Title | Indicates the description of the report. |
When you add a new financial report, the report wizard is automatically enabled. The wizard helps you to create a financial report for printing or for publication as an XML document.
The options you define using the wizard can be maintained at a later stage.
Field | Description | ||||
---|---|---|---|---|---|
Report |
You use this field to enter the name (code) of the report. You should try to select meaningful report names, so that you are able to identify them easily and access them quickly.
|
||||
Title |
The report title indicates the description of the report. You can define your own report titles, utilizing a format that is meaningful to your company.
|
||||
What type of report output do you wish to create |
This indicates the type of report output that you wish to create.
|
||||
Report suitable for normal printing | Select this to create a standard report that prints
normally. You must select this option if you want to be able to generate the report using SYSPRO Reporting Services (SRS). See SYSPRO Reporting Services. |
||||
Report created as an XML document for web viewing | Select this to create an XML document that can be
viewed using a web browser. Such reports are constructed as
XML documents which also makes the content suitable for
exchanging the data with other companies. If you select this option, then you will be unable to generate the report using SYSPRO Reporting Services (SRS). See SYSPRO Reporting Services. |
||||
What type of report do you want | |||||
Use report template | Select this to use a report template supplied by SYSPRO to create your report outline. | ||||
Create my own |
Select this of you want to define your own report outline, without using a template. If you select this option, then the Create Report Outline function is enabled. |
||||
Create report outline |
This function enables you to define the columns required for your report. You use this function to define the type of information you want to include in each column of your financial statement. |
||||
Include detail lines from template |
These options are only available if you selected the Use report template option. Select this, if you want your report to include some standard detail lines that will make your report usable immediately.
|
||||
Balance sheet | This template includes statement of assets, liabilities, capital and profit/loss for year to date. | ||||
Income statement - actual versus budget | This template includes the income statement lines analyzing revenue, expenditure and profit/loss for actual and budget for month and year to date. | ||||
Income statement - month by month | This template includes income statement lines analyzing revenue, expenditure and profit/loss by month and totalled for the year to date. | ||||
Income statement - month and year to date | This template includes income statement lines showing revenue, expenditure and profit/loss for month, year to date and previous year. | ||||
Trial balance | This template is for a classical trial balance showing accounts with balances in debit or credit columns. | ||||
Use template | Select this function to apply the template you selected. | ||||
Modify Report Outline |
Select this function if you want to modify a selected template. This can either be done immediately, or at a later stage. |
||||
What detail lines do you require on your report | The body of the report contains details of the accounts to print, and how totals should be calculated and printed. | ||||
Detail Lines | You use this function to define the detail lines that you want to print on the financial report. | ||||
What report options do your require | These options control formatting of numeric values and account code selection. | ||||
Report Options | Select this to define the default report options for this specific report (see Report Options). | ||||
What headings do you require on your report | |||||
Headings | You use the Headings function to enter headings for your columns. | ||||
What multi-columns do you require | |||||
Multi-column Headings | You use this function to print text across a set of individual column headings. | ||||
XML document information |
The following information is only required when creating an XML document: The G/L report writer creates a series of XML documents (.xml files) as well as some XSL documents (.xsl files). The XML documents contain the data used in the report, whereas the XSL files are used to transform the XML data into a HTML format, suitable for rendering in a web browser. Additionally, there are Cascading Style Sheet (CSS) files that contain the formatting for the web pages (e.g. fonts, colours, etc). It is important to understand that one report may generate many files or documents and that these files have to be stored in a directory that you specify. This directory MUST be unique for each report created, otherwise existing XML documents may well be overwritten by subsequent reports. Once a report has been executed and the appropriate XML files created in a specified directory, you can revisit the report in a web browser for as long as those files remain there. Viewing a G/L report in a web browser does not require your to have SYSPRO or any other application running. In addition, the web-based report does not access any live SYSPRO data files; the web-based report is completely self-contained. This means that you can package all the files in any document directory and send them to a third-party via email for viewing remotely. Alternately, the web-based report can be viewed by anyone who has access to a web browser, and where the web browser has appropriate access to the document directory. You can use SYSPRO's built-in XML Report Viewer to view any XML document. The XML report viewer allows you to drill right down to the original source documents that created a transaction. Additionally, you can edit any XML-based report directly within the report viewer - this makes visually editing an existing report easier. The files or documents created by the G/L report writer are all stored in the same document directory. The following list details the files created:
|
||||
Document name |
You can enter any suitable name to create the primary XML document. The name cannot contain a space, and the following characters have a special meaning in XML and therefore cannot be used in the name: < , > , or &. Do not enter any extension. The extension .xml is added automatically. You can change the name at any time. However, it is recommended that you use reasonable names in order to subsequently identify the reports. For example: If the document name is defined as: XML60 and the document directory is defined as: C:\Temp\ReportXML60, then when the report is executed, the following files are created: C:\Temp\ReportXML60\XML60.XMLC:\Temp\ReportXML60\XML60.XSL Also, depending on the report options, various theme files are created: C:\Temp\ReportXML60\GLDETAIL.CSSC:\Temp\ReportXML60\GLDETAIL.XSL When creating user-defined themes, there are a number of other additional files that are created. |
||||
Directory |
Indicate the last section of the path into which the XML document(s) must be stored. This path must be unique per report and cannot contain the \ or : characters. All xml reports are saved in the predefined directory \Base\FinancialReportsXml\ which resides on the server. |
||||
Allow override at runtime |
Select this to be able to change the document directory at the time the Financial Report is executed. This is useful if you want to run the same report each month, but do not want to overwrite any previously created report. |
||||
Element name |
All XML documents must contain what is known as a root element. This is the top-level element in the XML tree. By default the element group is inserted. You can enter any suitable root element name. You may have to do this where the XML document has to conform to some standard. |
||||
Namespace required | Select this if you want to enter a namespace. | ||||
Namespace |
You use this to enter the namespace you require. The namespace is normally used if you want to create an XML document that conforms to an established XML standard such as XBRL. For example: A namespace entry of: http://www.xbrl.org/core/2000-07-31/instance generates a group element: <group xmlns=" http://www.xbrl.org/core/2000-07-31/instance"> |
||||
Transform XML document for web viewing |
Select this if you want your XML document to be transformed into HTML format suitable for viewing in a web browser. By default it is assumed that you want to create an XML document without any XSL formatting applied (i.e. output raw XML). This would be used if you intend to send your XML document to another company for purposes of exchanging data. The raw XML will show in the report maintenance preview. You will be able to amend the column and the report element names. When this option is selected, an XSL stylesheet that contains the script coding will be used to transform the XML document into an HTML page. |
||||
Specify folder to publish for web browser | Select this if you want to specify the publishing folder and details of where and how you want to publish your documents for viewing in an Intranet environment. | ||||
Folder | This indicates the folder into which the document must be published. | ||||
Drill down to ledger accounts |
Select this to drill down from any item value to the G/L accounts that were used in the calculation of that value. This option is only enabled if you have selected the option: Transform your XML document for web viewing.
|
||||
Drill down to transactions |
Select this to drill down from any G/L account to the transactions for each account.
Using this option may significantly increase the time it takes to generate the report. The amount of data to describe all the transactions can potentially be enormous. For this reason, such data is best left within the SYSPRO database and not copied to your XML directory. The XML Report Viewer allows you to view any HTML page, just as you would use a normal web browser. This option is only enabled if you have selected the option: Drill down to ledger accounts. |
||||
Periods to View |
Select this if you want to view the transactions by selected account types and period. This function is only enabled if you selected the option: Drill down to transactions. The available account types are: Liability accounts, capital accounts, Expense accounts, Revenue accounts and Asset accounts. For each of these you can select to view All periods (up to and including the current period) or the Current period only. |
||||
Drill down to source documents |
Select this if you want to drill down from any transaction to the source document that created the transaction. This option is only enabled if you selected the option: Drill down to transactions. Using this option may significantly increase the time it takes to generate the report. The amount of data to describe all the source documents for any transaction can potentially be enormous. For this reason, such data is best left within the SYSPRO database and not copied to your XML directory. To be able to view source documents, SYSPRO's G/L XML Report Viewer allows you to view any HTML page, just as you would use a normal web browser. The main difference is that when clicking on a hyperlink to 'drill down to accounts' the program will show the list of applicable ledger accounts in a normal listview, rather than as a HTML page. After this, you can drill down to the transactions and source documents, in much the same way as you would use the G/L Query program. |
||||
Add a visual theme |
A theme helps you create professional reports, by defining the visual appearance you require for the report. Themes are constructed using the Cascading Style Sheets (CSS) technology. A theme, therefore, is simply a collection of CSS elements. The contents of the CSS theme will be displayed in a notepad and you can edit the elements as required. Select this if you want to define a visual theme. You then need to define the theme type for the Main report, Account details and Transaction details in the fields below. If you do not select this option, then your report is created with standard default themes. |
||||
Select Theme for Main Report |
The theme for the main report defines the style of the executed report. The theme preview in the XML Wizard, always displays the selected theme for the theme type. |
||||
Select Theme for Accounts |
The theme for the account details report defines the style of the executed report after drilling down to the account details. The theme preview in the XML Wizard, always display the selected theme for the theme type. This option is only enabled, after selecting the option to Add a visual theme and the option to Drill down to ledger accounts. |
||||
Select Theme for Transactions |
The theme for the transaction details report, defines the style of the executed report after drilling down to the transaction details. The theme preview in the XML Wizard, always displays the selected theme for the theme type. This option is only enabled, after selecting the option to Add a visual theme, the option to Drill down to ledger accounts and the option to Drill down to transactions. |
||||
No visual theme | Select this if you want to create the report with the default themes. | ||||
More Style Options | This function enables you to define additional style options for your report. | ||||
% of overall page width |
This determines the width taken up by your report within the web browser, and allows you to manually define the column width as a percentage of the browser width. For instance, a value of 80 means that your report will take up exactly 80% of the web browser width - leaving a margin of 10% on either side of your report. If you wish the report to use the full width of the web browser enter 100. This defaults to a recommended percentage of 80%. The browser will not truncate the text in a column but will stretch the width of the column so that the longest piece of text fits. This means that the percentage cannot be used to fix the maximum width of a column. |
||||
Display border around report body |
This has the equivalent effect of applying an HTML table property to the report body. In essence, this will create a border effect around the report body. When adding a new report, this option defaults as being unselected. This option is only applicable if the Border Attribute is assigned in the Report Area of the relevant CSS style sheet. |
||||
Highlight rows |
Select this if you want to have a visual highlighting effect as you move your mouse over each row of the report in the web browser. When adding a new report, this option defaults as being unselected. |
||||
Company graphic |
Images in GIF, BMP or JPG files, may be copied into your document directory and then displayed as graphics in your reports. You can only assign one graphic per report, and it will automatically be output at the top of the report. Your company logo could be an image that you choose to output on your reports. Example If the document directory is defined as: c:\Temp\ReportXML60 then, before the report is executed, the logo and any backgrounds must be copied into the document directory: c:\Temp\ReportXML60\OUTDOORSCOLOGO.BMP c:\Temp\ReportXML60\BLUTEXTB.GIF |
||||
Show company graphic | Select this if you want to display an image in your report. For example, your company logo. | ||||
Graphic to show |
You use this to define the path and image to use. The image is output at the top of your report. This cannot be amended, however you can change the default alignment. The path must be accessible to your web browser when viewing your web-based reports. |
||||
Align image | This option enables you to define the position of the image at the top of the report. | ||||
Left | Select this if you want the image displayed on the top left hand side of the report. | ||||
Center | Select this if you want the image displayed in the top center of the report. | ||||
Right | Select this if you want the image displayed on the top right hand side of the report. | ||||
Close | Select this to return to the previous screen. | ||||
Only view report in web browser |
Traditionally the web browser is used only to View documents, after executing a report. If you intend to Print out your web-based report, you should select the View and Print Report from the Web Browser output option. This enables you to reprint the column headings after a certain number of rows. However, you can click on the Print button in your web browser in order to output the HTML page to a printer. If you do this, the web browser will simply print your page exactly as it is represented, and not as you might expect with appropriate page-breaks. When using the web browser, inline editing is not allowed. You must use the SYSPRO report viewer, if you wish to perform editing. When adding a new report, this option defaults to selected. |
||||
View and print report from web browser |
Traditionally the web browser is used only to View documents, after executing a report. This option allows you to View and Print your web-based G/L report. Select this option, if you intend to Print out your report as when adding a new report, the type of output defaults to; Only view report in web browser. This selection enables the option to Repeat column headings after a defined number of rows; which allows you to define an appropriate page-break. When using the web browser, Inline editing is not allowed. You must use the SYSPRO report viewer, if you wish to perform editing. |
||||
Repeat column headings after rows |
If you intend to use the web browser to print out your report, then this option allows you to specify when to repeat column headings. Traditionally the web browser is used only to View documents, after executing a report. This option allows you to view, print and define an appropriate page-break in your web-based G/L report. This option is only enabled after selecting the View and print report from web browser option. To define the appropriate page-break, enter the number of rows after which the report column headings should be repeated. This feature can also be used in conjunction with the SYSPRO report viewer. The number of rows is somewhat of a trial-and-error approach, since it depends on the style of your report (the fonts used and so on). An entry of 40 means that after every 40 rows displayed in the browser/viewer, the column headings will be repeated. Additionally, when printing the browser/viewer will make the printer skip to a new page before the new column headings are printed. When using the web browser, inline editing is not allowed. You must use the SYSPRO report viewer if you wish to perform editing. |
||||
Use SYSPRO's report viewer |
The report viewer is capable of viewing any web page, but is specifically designed to work with XML documents created from the G/L Financial Report Writer. This option allows you to view, print, define an appropriate page-break, perform inline editing and use the drill down feature. The XML Report Viewer was designed like all SYSPRO programs, in appearance and flexibility. It can also be used to view any XML document. To view an XML document select File, Open and enter the XML document to view. The Report Viewer allows you to Drill down to ledger accounts, G/L transactions and the source documents. First click on the relevant hyperlink in the web page, the ledger accounts that were used in the accumulation of the highlighted value will be displayed in the top right-hand listview. Any account lines that contain transactions will be shown with the column Transactions marked with Yes. Click on such marked lines and the transactions relating to that account will be displayed in the bottom right-hand listview. The Balances are, however, always for the current period only. Right click on G/L Account lines, to be able to call up the G/L Query program for this account or to post to this account, with the G/L Journal Entries program. To drill down to the source document simply right-click on any required transaction line and select either General Ledger Journal (if you wish to view this journal detail) or the source document to view (if appropriate). The information relating to both the ledger accounts and transactions displayed, will be extracted from the XML documents that were created along with the primary XML report. In other words, the information is shown as it was when the report was created. If the report was saved with the option: Inline editing selected, then you can edit the report by clicking on the hyperlink Inline editing. The report lines that make up the report will be shown in the web page. Click on the report line to change, and the relevant report definition line will be displayed. This allows you to instantly edit the line in the report definition. You can continue to modify any other lines until such time as you click on the Stop editing function. At this point, if any lines have been changed you will be prompted to execute the report. This does not have to be done immediately, as you can always execute the report later on (select File, Execute Report); but the contents of your XML report will not reflect any changes until the report has been executed again. |
||||
Allow inline editing |
Traditionally the web browser is used only to View documents, after executing a report. This option allows you to edit your report directly from the XML Report Viewer. When adding a new report, the type of output defaults to view the report in the web browser. After selecting the Allow inline editing option, the Report Viewer will automatically be selected, as you cannot perform editing in a web browser. The SYSPRO Report Viewer option, is then disabled as selected. If the report was saved with the option Inline editing selected, when viewing your XML report in the report viewer you will be able to click on the Inline editing function, and the report lines that you have used in the construction of your report will be displayed in the web page. Click on the report line to change and the relevant report definition line will be displayed. This allows you to instantly edit the line in the report definition. You can continue to modify any other lines until such time as you click on the Stop editing function. At this point, if any lines have been changed you will be prompted to execute the report. This does not have to be done immediately, as you can always execute the report later on (select File, Execute Report); but the contents of your XML report will not reflect any changes until the report has been executed again. |
This screen is displayed when you change a financial report:
Field | Description |
---|---|
Report | This indicates the code of the report you are maintaining. |
Title | This indicates the title defined for the report code. |
Function | |
Report Options | You use this function to maintain the default report options for the report. See Report Options. |
Run-time Prompts | You use this function to maintain up to 15 variables that you want to be prompted for at the time of running the report. See GL Run Time Prompt Maint. |
Column Maintenance | You use this function to determine the type of information you want to include in each column of your financial report. See GL Column Maint and Browse. |
Detail Line Maintenance | You use this function to add and change the detail lines that you want to print on the financial report. See GL Detail Lines. |
Header Maintenance |
You use this function to specify the information you want to print at the top of the report. See GL Header Footer Maintenance. The program defaults to using a standard header, which comprises three lines of text in the format of typical SYSPRO reports. |
Footer Maintenance | You use this function to specify the information you want to print at the bottom of the report. See GL Header Footer Maintenance. |
Multi-column Headings |
You use this function to print text across a set of individual column headings. See GL Multi-column Headings. For example: You would use multi-column headings to show the field: <--- Period-to-date ---> over column headings for actual and budget ledger values. |
Execute Report | You use this function to run the report and optionally to debug the report. See Execute Report. |
Close | Select this to return to the listview of defined financial reports. |
When you access the program for the first time, you need to define your default report options.
You use the Default Report Options option (accessed from the Preferences menu) to define the default settings that you want to assign to all new reports.
Although these default settings are automatically applied to reports you add, they can be changed against the individual reports as you define them.
If you define these preferences carefully, then you can save time by reducing unnecessary maintenance when adding new reports.
Once you have defined a report, you use the Report Options function to maintain the default report options for that specific report.
Field | Description | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report |
This displays the code of the report for which you are applying the defaults. This field remains blank when you initially set the default preferences for the financial reporter writer. |
||||||||||||||||||||
Report Title |
This displays the report title of the report for which you are applying the defaults. This field remains blank when you initially set the default preferences for the financial reporter writer. |
||||||||||||||||||||
Currency symbol |
The entry made here can be printed in columns, both for detail lines and totals on the report. If you want to enter a currency at run time, then you must leave this field blank. If you enter a currency at this field, then this is the currency that will be printed on the report, irrespective of your entries at run time. |
||||||||||||||||||||
Report type | |||||||||||||||||||||
Report | Select this to output new financial reports to your default printer. | ||||||||||||||||||||
Display | Select this to display new financial reports on the screen. | ||||||||||||||||||||
Extract | Select this to extract new financial reports to a file for use within a third party application's software. | ||||||||||||||||||||
Extract Options | For Extract type reports, indicate the file to which you want to output the report contents. This enables you to import the file into a third-party application's software. | ||||||||||||||||||||
Extract file name | Indicate the name of the file to which you want to output the report contents. The full pathname must be entered. | ||||||||||||||||||||
Include headers and footers | Select this option to include the report's headers and footers in the export file. You normally choose to exclude the report's headers and footers if you plan to import the extract file into a spreadsheet to use as raw data. | ||||||||||||||||||||
File options | |||||||||||||||||||||
Create file |
Select this to create a new extract file each time you run the report. The file is overwritten if it already exists. |
||||||||||||||||||||
Append to file | Select this to add the contents of the extract file to end of the file each time you run the report. | ||||||||||||||||||||
OK | Select this to accept the extract options you selected. | ||||||||||||||||||||
Cancel | Select this to return to the previous screen. | ||||||||||||||||||||
XML | Select this to enable the XML Wizard that will take you through the necessary steps to create a simple XML document. | ||||||||||||||||||||
XML Wizard | Select this to use the XML wizard to create the xml document. | ||||||||||||||||||||
Company selection | |||||||||||||||||||||
All companies when run | Select this to process financial reports for all companies entered at the time of running the financial report. | ||||||||||||||||||||
Only specified company | Select this to process financial reports only for the company specified at the Company id field below. | ||||||||||||||||||||
Exclude specified company | Select this to process financial reports for all companies except the company specified at the Company id field below. | ||||||||||||||||||||
Selected by report line | Select this if you want the system to prompt you for the company that you want to include, on each detail account line. | ||||||||||||||||||||
Company |
This indicates the company ID of the only company to be included or excluded for financial reports, depending on the option you selected in the previous fields. This option is only enabled if you selected either the Only specified company or Exclude specified company options. |
||||||||||||||||||||
Account selection |
If you select the option Ledger code, or Report index 1 or Report index 2, then the entire report is based on the either the ledger code or the index selected and cannot be changed per line. If you want to be able to select individual ledger codes based on your own criteria, you must select the option: Selected by report line. |
||||||||||||||||||||
Ledger code | Select this if you want the system to select accounts for inclusion in the report according to the ledger code. | ||||||||||||||||||||
Selected by report line |
Select this to be able to indicate the accounts to print in each section on each detail account line (see Account Selection Maintenance). If you select this option, then you can select to print details for a range of ledger accounts within a specific report index. If you do not select this option, then although you will be able to select account codes based on the Ledger code, Report index 1 or Report index 2, you will be unable to select to print specific account codes within Report index 1 and Report index 2. |
||||||||||||||||||||
Report index 1 | Select this be able to select accounts for inclusion in the report according to the financial report index 1 defined against each ledger code (General Ledger Codes). | ||||||||||||||||||||
Report index 2 | Select this to be able to select accounts for inclusion in the report according to the financial report index 2 defined against each ledger code (General Ledger Codes). | ||||||||||||||||||||
Selection by group code required |
Select this to select account codes based on a group code when defining detail account lines. For example: Group code A1 could mean "include this account on the cash line of the balance sheet". Group code B1 could mean "include this account on the Accounts Receivable line of the balance sheet", etc. In this way, you can automatically assign accounts to the correct place on the financial statement without having to worry about account ranges, account masks, or maintaining the financial statement every time you add a new account. However, because you only have one group code for each ledger account (General Ledger Codes) you cannot use the group code for multiple financial reports if you group your accounts differently on each of the reports. |
||||||||||||||||||||
Run time-mask |
Select this option to limit the inclusion of accounts to those matching a pattern or mask when running the report. For example: You may have a report that prints a profit and loss report for your company. Using a run-time mask and a suitable account structure, you could use that same report to produce a profit and loss for just one department or division of your company. To be able to do this, the department or division must be included in the account code in the same position (e.g. 6th and 7th digits) as the account code. You can then enter an account mask with question marks in the first 5 positions and the department or division number in the 6th and 7th. Of the accounts selected on the detail account lines, only those that include the department or division number in the 6th and 7th position are included in the report. |
||||||||||||||||||||
Run-time mask required | Select this to use a run-time mask. | ||||||||||||||||||||
Default mask |
If you require a run-time mask, then you must indicate a default mask containing at least one wildcard character (i.e. * or ?). The wildcard character ? means that any character is valid in this character position, while the wildcard character * matches all characters from this character to the end of the pattern. Thus, an * can be placed at the end of an account to indicated that the remaining characters must not be validated. Examples of Valid Masks:
Examples of Invalid Masks:
|
||||||||||||||||||||
Passwords | Define a password for maintaining or running the report. | ||||||||||||||||||||
Change password to run report |
Select this to use the Password System program to define or change a password for running the report. Once defined, the password will have to be entered by the operator before the report can be run. |
||||||||||||||||||||
Change password to maintain report |
Select this to use the Password System program to define or change a password for maintaining the report. Once defined, the password will have to be entered by the operator before the report can be changed. |
||||||||||||||||||||
OK | Select this to save your selections. | ||||||||||||||||||||
Close | Select this to return to the previous screen without maintaining a password. | ||||||||||||||||||||
Security | Define the security you require for maintaining or running the report. | ||||||||||||||||||||
Change security to run report | Select this to define the list of operators who can or cannot run the report. | ||||||||||||||||||||
Change security to maintain report | Select this to define the list of operators who can or cannot maintain the report. | ||||||||||||||||||||
OK | Select this to save your selections. | ||||||||||||||||||||
Cancel | Select this to return to the previous screen without maintaining the security. | ||||||||||||||||||||
Numeric Format | Select this to indicate how you require ledger values to be formatted in each of the report columns. | ||||||||||||||||||||
Numeric format | Indicate the format you require for numeric values. | ||||||||||||||||||||
Negative format |
The selection you make here is used by the system to determine how negative values are to be displayed on the report. Credit values are stored as negative numbers, and debit values are stored as positive numbers. |
||||||||||||||||||||
Rounding | The selection you make here is used by the system to round ledger values in each of the columns to the nearest unit (e.g. Dollar, pound), nearest thousand or nearest million. | ||||||||||||||||||||
Units | Select this to round to the nearest unit. | ||||||||||||||||||||
Thousands | Select this to round to the nearest thousand. | ||||||||||||||||||||
Millions | Select this to round to the nearest million. | ||||||||||||||||||||
Decimals | The selection you make here is used by the system to determine the number of decimals to include in each of the rounded ledger values included in the columns of the financial report. | ||||||||||||||||||||
None | Select this to exclude all decimals. | ||||||||||||||||||||
One | Select this to include a single decimal. | ||||||||||||||||||||
Two | Select this to include 2 decimals. | ||||||||||||||||||||
Zero values | The selection you make here determines how zero values are represented on reports. | ||||||||||||||||||||
Zero | Select this represent zero values as the number zero. | ||||||||||||||||||||
Blank | Select this to print zero values as blank. | ||||||||||||||||||||
Hyphen | Select this to represent zero values as a hyphen (-). | ||||||||||||||||||||
OK | Select this to accept your selections and to return to the previous screen. | ||||||||||||||||||||
Cancel | Select this to return to the previous screen, ignoring any changes you made. | ||||||||||||||||||||
Page Format |
Select this to indicate how you want to format the page dimensions of the report. The range of values you can enter for each option are displayed in brackets after the option. |
||||||||||||||||||||
Page length (30-99) |
This indicates the number of lines on the page, including the top and bottom margins. The default is 66 which assumes an 11 inch page printing 6 lines per inch. |
||||||||||||||||||||
Top margin (0-20) | This indicates the number of blank lines you require at the top of each page before the first header line. | ||||||||||||||||||||
Bottom margin (0-20) | This indicates the number of blank lines you require at the bottom of each page after the footer. | ||||||||||||||||||||
Line width (75-300) | This indicates the width of the report in characters. This value, together with the indentation, determines the total width of the report. | ||||||||||||||||||||
Indentation (0-60) | This indicates the number of characters that the report must be indented from the left side of the page. | ||||||||||||||||||||
OK | Select this to accept your selections and to return to the previous screen. | ||||||||||||||||||||
Cancel | Select this to return to the previous screen, ignoring any changes you made. | ||||||||||||||||||||
Multiple Sections |
Select this to print information from more than one ledger code across the same print line. This enables you, for example, to compare branches, departments, cost centers, companies, etc, across the page. |
||||||||||||||||||||
Multiple sections required | You must select this option in order to define and use this function. | ||||||||||||||||||||
Number of sections |
Indicate into how many sections you want to divide the page. An entry in the range of 2 to 9 can be entered. |
||||||||||||||||||||
Account selections | |||||||||||||||||||||
Mask for each section | Select this to enter one mask for each section of the page and one set of account selections for the detail line. | ||||||||||||||||||||
Selected by account line |
Select this if on each detail account line, you want to be able to indicate the accounts to print in each section (see Account Selection Maintenance). If you select this option, then you can select to print details for a range of ledger accounts within a specific report index. If you do not select this option, then although you will be able to select account codes based on the Ledger code, Report index 1 or Report index 2, you will be unable to select to print specific account codes within Report index 1 and Report index 2. |
||||||||||||||||||||
Both mask and by account line | Select this to specify a wildcard mask for each section, and on each detail account line you want to indicate the accounts to print in each section. | ||||||||||||||||||||
Section masks |
Enter the wildcard mask required for each section of the report. You cannot define section masks here if your account selection is based on the Selected by report line option. |
||||||||||||||||||||
OK | Select this to accept your selections and to return to the previous screen. | ||||||||||||||||||||
Cancel | Select this to return to the previous screen, ignoring any changes you made. | ||||||||||||||||||||
Save | Select this to save the preferences you selected. | ||||||||||||||||||||
Close | Select this to exit the program without saving the changes you made. |
This screen is displayed when you select the Change security to run report option from the Security screen. It enables you to define the list of operators who have access to running the report.
Field | Description |
---|---|
Report writer security | These options are mutually exclusive. You cannot have one list of operators who can run the report and another list of operators who cannot run the report. You can only have one list of operators who can either all run the report or cannot run the report. |
All operators can run report | Select this if you want all operators to be able to run the report. |
Listed operators can run report |
Select this if you want to define selected operators who are allowed to run the report. You use the Define list of operators options to define this list of operators. |
Listed operators cannot run report |
Select this if you want to define selected operators who are not allowed to run the report. You use the Define list of operators options to define this list of operators. |
Define list of operators |
These options enable you to define the list of operators who are or are not allowed to run the report, depending on your selection at the Report maintenance security option. These options are not enabled if you indicated that all operators can run the report. |
Copy Maintenance Security |
Normally, the operators who can maintain a report would also be given the authority to execute the report. You use this function to copy the list of operators you defined as being able to maintain the report to the list of operators who can also run the report. This saves you from having to define the list of operators twice - once for maintaining the report and once for executing the report. This function is not available if you selected the option: All operators can run the report. |
Operator | You use this field to enter the operator code you want to add to the list. |
Add |
Select this to add the operator to the list of operators who can/cannot run the report. Up to 20 operators can be added to the list. |
Remove | Select this to delete the highlighted operator from the list. |
Replace | Select this to simultaneously delete the highlighted operator from the list and add the operator defined in the Operator field to the list. |
Clear All | Select this to remove all operators from the list. |
Close | Select this to accept the information you entered and to return to the previous screen. |
This screen is displayed when you select the Change security to maintain report option from the Security screen. It enables you to define the list of operators who have access to changing the report.
Field | Description |
---|---|
Report maintenance security | These options are mutually exclusive. You cannot have one list of operators who can edit the report and another list of operators who cannot edit the report. You can only have one list of operators who can either all edit the report or cannot edit the report. |
All operators can edit report | Select this if you want all operators to be able to change the report. |
Listed operators can edit report |
Select this if you want to define selected operators who are allowed to maintain the report. You use the Define operator list options to define this list of operators. |
Listed operators cannot edit report |
Select this if you want to define selected operators who are not allowed to maintain the report. You use the Define operator list options to define this list of operators. |
Define operator list |
These options enable you to define the list of operators who are or are not allowed to maintain the report, depending on your selection at the Report maintenance security option. This option is not enabled if you indicated that all operators can edit the report. |
Operator | You use this field to enter the operator code you want to add to the list. |
Add |
Select this to add the operator entered in the previous field to the list of operators who can/cannot edit the report. Up to 20 operators can be added to the list. |
Remove | Select this to delete the highlighted operator from the list. |
Replace | Select this to simultaneously delete the highlighted operator from the list and add the operator defined in the Operator field to the list. |
Clear All | Select this to remove all operators from the list. |
Close | Select this to accept the information you entered and to return to the previous screen. |
When defining financial reports, you have two options which control how to round the values which are printed: Rounding (Units, Thousands. Millions) and Decimals (None, One, Two). When you use these two options, there will be instances where values printed on the report represent actual values rounded up or down by a certain amount. The difference between the actual value and the rounded value is referred to as the rounding error.
Examples:
Value | Rounding | Decimals | Printed Value | Added to Totals | Rounding Error |
---|---|---|---|---|---|
12345.67 | Units | Two | 12345.67 | 12345.67 | 0 |
12345.67 | Units | One | 12345.7 | 12345.70 | 0.03 |
12345.67 | Units | none | 12346 | 12346.00 | 0.33 |
12345.67 | Thousands | Two | 12.35 | 12350.00 | 4.33 |
12345.67 | Thousands | One | 12.3 | 12300.00 | 45.67- |
12345.67 | Thousands | None | 12 | 12000.00 | 345.67- |
1234567.9 | Millions | Two | 1.23 | 1230000.00 | 4567.89- |
1234567.9 | Millions | One | 1.2 | 1200000.00 | 34567.89- |
1234567.9 | Millions | None | 1 | 1000000.00 | 234567.89- |
The rounded values that are printed are the values added to the totals that you can print on report total lines. These total values are sorted in report variables TOTxCnn, which are total levels 0 to 9 for columns 1 to 50. The rounding error is accumulated by column in the report variables RNDnn, which are for columns 1 to 50. Unless you manipulate the values accumulated in these RNDnn variables, they accumulate the total rounding error by column, regardless of any total lines you print. You can access the RNDnn variables in calculation and variable lines when defining a report. They are available for you to view when using the debugging mode from the Execute Report function of the GL Define Financial Reports program.
You use the Run-time Prompts function to maintain up to 15 variables that you want to be prompted for at the time of running the report.
Field | Description |
---|---|
Add | The following fields are displayed when you add a run-time prompt variable. |
Prompt | |
Sequence | This field enables you to indicate the specific number in the sequence that you want the run-time prompt to be requested. |
Variable |
This field enables you to enter a specific type of variable that you want the system to request when you run the report. See Valid Variables. |
Text | This field enables you to enter the specific wording that you want the system to display on the screen when the run-time prompt is requested. |
Allow spaces or zeros |
If you defined a report value variable (i.e. VAL1-250), then this option enables you to indicate whether a zero value is valid when the report is run. If you defined a report text variable (i.e. TEXT1-8) then this option enables you to indicate whether a blank entry is valid when the report is run. |
Save | Select this to save the information you entered. |
Close | Select this to return to the previous screen. |
Change | The following fields are displayed for the highlighted variable when you select the Change function: |
Prompt | |
Sequence | This indicates the specific number in the sequence that the run-time prompt is requested. |
Variable |
This indicates the variable type assigned to the variable. Valid variable types are described in the table above (see Add function). |
Text | This indicates the wording that is displayed on the screen when the run-time prompt is requested. |
Allow spaces or zeros | If you defined a report value variable (i.e. VAL1-250), then this option enables you to indicate whether a zero value is valid when the report is run. If you defined a report text variable (i.e. TEXT1-8) then this option enables you to indicate whether a blank entry is valid when the report is run. |
Save | If you defined a report value variable (i.e. VAL1-250), then this option enables you to indicate whether a zero value is valid when the report is run. If you defined a report text variable (i.e. TEXT1-8) then this option enables you to indicate whether a blank entry is valid when the report is run. |
Close | Select this to return to the previous screen. |
Delete | This function enables you to remove the highlighted variable from the variables requested at run-time. |
Confirm Deletion | When you select the Delete function, you must confirm the deletion of the highlighted run-time prompt variable. |
OK | Select this to delete the highlighted variable. |
Cancel | Select this to return to the previous screen without deleting the variable. |
Select | |
Close | Select this to return to the previous screen. |
Valid variables and their usage are outlined in the following table:
Variable | Description | Usage | ||||
---|---|---|---|---|---|---|
VALnnn (where n is a number in the range 1 to 250) |
Report value You can use up to 250 report values in the report, up to 15 of which (the maximum number of prompts allowed) can be requested at run-time. |
At run-time you can enter values to be used in calculations. | ||||
PERn (where n is a number in the range 1 to 8) |
Ledger period number. You can define up to 8 different period selections to be asked at run time. |
At run-time you can select the period for which you
want to print the report.
|
||||
YEARn (where n is a number in the range 1 to 8) |
Ledger year You can define up to 8 different year selections to be asked at run time. |
At run-time you can select the year for which you
want to print the report.
|
||||
QTRn (where n is a number in the range 1 to 8) |
Ledger quarter You can define up to 8 different quarter selections to be asked at run time. |
At run-time you can select the quarter for which you want to print the report. | ||||
DATEn (where n is a number in the range 1 to 8) |
Date entered at run time You can define up to 8 different date selections to be asked at run time. |
At run-time you can enter the date to be printed in the header and footer. | ||||
TEXTn (where n is a number in the range 1 to 8) |
Text entered at run time You can define up to 8 30-character text strings to be asked at run time. |
At run-time you can enter text to be printed in the header and footer. |
You use the Column Maintenance function to determine the type of information you want to include in each column of your financial statement.
The Column Maintenance screen is divided into two parts: The Detail section (indicating the formatting selections you have made for the column) and the Preview section (enabling you to view the end result of any formatting performed in the Detail section of the screen).
Field | Description |
---|---|
Add | Select this to use the GL Report Column Browse program to add columns to the report and to define the details relevant to the type of column. |
Change | You use this function to maintain the highlighted column. |
Delete | You use this function to remove the highlighted column from the report. |
Save | Select this to save the information you entered for the report. |
Close | Select this to exit the program. |
You use the Add function to add columns to the report and to define the details relevant to the type of column.
Field | Description |
---|---|
Column type | |
Ledger field | Ledger fields can contain account text (e.g. The ledger code, description, group code, etc) or account values associated with a ledger code (e.g. Balances). |
Calculated | Select this if you want the column to include values from other columns and variables. |
Blank | Select this if you want this column to be used to create space between columns. |
Ledger field |
Enter the ledger account from which the data for the column must be taken. This field is only available if you selected the Column type as Ledger field. You can use the Browse icon to view and select the available ledger fields (see Ledger Field Query). |
Define Column |
This function enables you to set up the options for the column type you selected. If the Column type is defined as Ledger field, then the Ledger Field Column Definition screen is displayed. If the Column type is defined as Calculated, then the Calculations screen is displayed. If the Column type is defined as Blank, then the Blank Column Definition screen is displayed. |
Close | Select this to return to the previous screen. |
As you add columns to the report, the column details are displayed in a listview.
The following information is included in the listview for each column:
Column | Description |
---|---|
Column | Indicates the column number within the report. |
Column type | Indicates whether the column is a ledger field, is calculated or is blank. |
Field |
Indicates the ledger account from which the data for the column must be taken. This is displayed if the Column type is a Ledger field. |
Indicates whether the column must be printed on the report. | |
Width | Indicates the width of the column in characters. |
Show currency |
This defaults to Yes, unless:
|
Field | Description | Comment |
---|---|---|
ACCNO | Account number | The account code |
ACCDES | Account description | The description for the account code |
ACCGRP | Account group code | The group code defined against the account (see General Ledger Codes). |
ACCGRPD | Account group description | The description for the group code. Group codes are defined using the GL Groups program. |
ACCTYP | Account type | The account type defined against the account (see General Ledger Codes). |
ACCIDX1 | Account index 1 | The report index 1 defined against the account (see General Ledger Codes). |
ACCIDX2 | Account index 2 | The report index 2 defined against the account (see General Ledger Codes). |
ACCCOMP | Account company ID | |
BALCUR | Current balance | This retrieves the current account balance directly
from the talbe/file and is not calculated. You therefore
cannot drill down to the transactions which make up this
balance. This is useful if you want to produce a quick report of balances as the system does not have to process transactions to produce the report. |
BALOPENP | Opening balance for period | This is the opening balance for the period and is a calculated field. The drill down facility is therefore available for this field. |
BALOPENQ | Opening balance for quarter | This is the opening balance for the quarter and is a calculated field. The drill down facility is therefore available for this field. |
BALOPENY | Opening balance for year | This is the opening balance for the year and is a calculated field. The drill down facility is therefore available for this field. |
BALCLOSP | Closing balance for period | This is the closing balance for the period and is a calculated field. The drill down facility is therefore available for this field. |
BALCLOSQ | Closing balance for quarter | This is the closing balance for the quarter and is a calculated field. The drill down facility is therefore available for this field. |
BALCLOSY | Closing balance for year | This is the closing balance for the year and is a calculated field. The drill down facility is therefore available for this field. |
MOVEPER | Movement for period | |
MOVEQTR | Movement for quarter | |
MOVEYR | Movement for year | |
MOVEPROJ | Movement projected to year end | This is the actual movement for the current year, up to and including the period specified, plus the budgeted values for the remainder of the year. |
MOVEPERI | Movement up to and including period | |
MOVEQTRI | Movement up to and including quarter | |
MOVEPERN | Movement up to and not including period | |
MOVEQTRN | Movement up to and not including quarter | |
BUDPER | Budget for period | |
BUDQTR | Budget for quarter | |
BUDYR | Budget for year | |
BUDPERI | Budget up to and including period | |
BUDQTRI | Budget up to and including quarter | |
BUDPERN | Budget up to and not including period | |
BUDQTRN | Budget up to and not including quarter | |
The following fields apply to Commitment Accounting (see General Ledger Setup) | Commitment Accounting does not use the period end
dates for the sub modules. The transaction period is based
on the period end dates for the General Ledger, therefore
all your period end dates for the General Ledger must be
defined in order for Commitment Accounting to work
correctly. The uncommitted and committed values for the current year are calculated based on the period end dates for the General Ledger for the current year. The period end dates for the current year are used to determine the period end dates for the next year, and if a due date falls within the next year, it is displayed within the Next year period commitments (within GL Query). Any commitment with a due date that falls outside the next year's GL period end dates is included in the Future values within GL Query, and these are the future values are printed in the GL Financial Report Writer (COMMFUTR/UNCOMFUTR). |
|
UCOMPREV | Uncommitted value for previous year | |
UCOMFUTR | Uncommitted value for the future | |
UCOMPER | Uncommitted value for period | |
UCOMPERQ | Uncommitted value for quarter | |
UCOMPERN | Uncommitted up to and not including period | |
UCOMPERI | Uncommitted up to and including period | |
COMMPREV | Committed value for previous year | |
COMMFUTR | Committed value for the future | |
COMMPER | Committed value for period | |
COMMPERQ | Committed value for quarter | |
COMMPERN | Committed up to and not including period | |
COMMPERI | Committed up to and including period |
The following options and functions are displayed when you use the Define Column function to maintain the options for a column that is defined as a Ledger field.
Field | Description | ||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Ledger field | This indicates the ledger field for which you are maintaining the options. | ||||||||||||||||||||||||||||||||||||||||||||||||
Sequence number |
This indicates the sequence number for the column. The sequence in which columns are printed on a financial report is determined by the sequence number assigned to each column. |
||||||||||||||||||||||||||||||||||||||||||||||||
Section number |
If you are using multiple sections then you can enter the number of the section in which you want to include the column. The section in which you include the column determines the value or text that is shown in the column. The section's account mask and the account codes entered on the detail line are used to determine the appropriate account information to include in each section's column. |
||||||||||||||||||||||||||||||||||||||||||||||||
Column type |
This field enables you to indicate how you want values to be displayed in a column. The Column type field is not available if the ledger field selected is a text field. The options Debit only and Credit only in the Column set up allow you to select only debits or only credits to be printed in the column. For example: You set up two columns for the same field (e.g. BALCLOSY) on the report; one column is setup to print debits only and the other credits only. The problem is that in the Detail line setup, when adding two or more accounts together and summarizing them to be printed on one line, the debits are printed under the debit column and the credits under the credit column. This does not happen when printing a calculated field. The solution is to set the first two columns not to print. Then create two more columns which are both calculations and add column one and column two together. The two new columns must also be set to debit only and credit only. An example of this column set up is as follows:
|
||||||||||||||||||||||||||||||||||||||||||||||||
Debit | Select this if you want the system to show debit values as positive numbers and credit values as negative numbers. | ||||||||||||||||||||||||||||||||||||||||||||||||
Credit | Select this to reverse the sign of all values that are included in the column. | ||||||||||||||||||||||||||||||||||||||||||||||||
Debit only | Select this to only include detail lines with a debit or zero value. | ||||||||||||||||||||||||||||||||||||||||||||||||
Credit only | Select this to only include detail lines with a credit or zero value. | ||||||||||||||||||||||||||||||||||||||||||||||||
Credit only with reverse sign | Select this to only include detail lines with a credit (negative) value and you want them shown as positive values. | ||||||||||||||||||||||||||||||||||||||||||||||||
Print options | |||||||||||||||||||||||||||||||||||||||||||||||||
Print column |
Select this to print the values included in the column. You usually select not to print the column if you only want to retrieve ledger values for use in a calculation. |
||||||||||||||||||||||||||||||||||||||||||||||||
Print currency |
Select this to print the currency symbol on the first account line and in the totals. The currency symbol is only printed against the first line of the detail lines and against the totals. It is not printed against each detail line. This field is not available if the ledger field selected is a text field. |
||||||||||||||||||||||||||||||||||||||||||||||||
Width of column | When you add a column, this value defaults to a value suitable to the field being printed. You can enter a value between 1 and 40. | ||||||||||||||||||||||||||||||||||||||||||||||||
Print totals only | This field is not available if the ledger field selected is a text field. | ||||||||||||||||||||||||||||||||||||||||||||||||
Yes | Select this to print the column values only on total lines. | ||||||||||||||||||||||||||||||||||||||||||||||||
No | Select this to print the values on each detail account line. | ||||||||||||||||||||||||||||||||||||||||||||||||
Suppress | Select this if you do not want values printed on total lines. | ||||||||||||||||||||||||||||||||||||||||||||||||
Alternate currencies |
This option enables you to print the amounts for the column in an alternate currency.
|
||||||||||||||||||||||||||||||||||||||||||||||||
Fixed currency | Select this to define the alternate currency to use. | ||||||||||||||||||||||||||||||||||||||||||||||||
Currency |
Select the alternate currency you require for the column. Alternate currencies are defined using the GL Alternative Currency Setup program. |
||||||||||||||||||||||||||||||||||||||||||||||||
Headings |
You use the Headings function to enter headings for your columns. Column headings can be specified for each of the available column types (i.e. Ledger field, calculated, blank) and the method of entry is identical for each type of column. |
||||||||||||||||||||||||||||||||||||||||||||||||
Headings | Two heading lines are available which can contain text you have entered, or variables you have selected. | ||||||||||||||||||||||||||||||||||||||||||||||||
Line 1 |
You this to enter the first line of text for the heading or to select a variable for the first line of the heading. You use the Variables function to select the variable required. |
||||||||||||||||||||||||||||||||||||||||||||||||
Line 2 |
You this to enter the second line of text for the heading or to select a variable for the second line of the heading. You use the Variables function to select the variable required. |
||||||||||||||||||||||||||||||||||||||||||||||||
Variables | Select this to use the GL Report Writer Variable Query program to select a variable to be used as the first or second line of the heading if you have not entered text for the line. | ||||||||||||||||||||||||||||||||||||||||||||||||
Alignment | This option enables you to define the positioning of the headings for the column. | ||||||||||||||||||||||||||||||||||||||||||||||||
Left justified | Select this to position the heading at the beginning of the field. | ||||||||||||||||||||||||||||||||||||||||||||||||
Centered | Select this to position the heading in the middle of the field. | ||||||||||||||||||||||||||||||||||||||||||||||||
Right justified | Select this to position the heading at the end of the field. | ||||||||||||||||||||||||||||||||||||||||||||||||
Underline character | The character entered here is repeated across the column below the second line of the heading for the column. | ||||||||||||||||||||||||||||||||||||||||||||||||
Overline character | The character entered here is repeated across the column above the heading for the column. | ||||||||||||||||||||||||||||||||||||||||||||||||
OK | Select this to accept the information you entered. | ||||||||||||||||||||||||||||||||||||||||||||||||
Cancel | Select this to return to the previous screen. | ||||||||||||||||||||||||||||||||||||||||||||||||
Selections |
This function is available only for ledger fields which contain values relating to balances, movements or budgets. These can be periodic, quarterly or annual amounts. For each of the time frame selections that can be made (e.g. Current period, previous period, etc.) you can specify that these selections are to be made at run-time. |
||||||||||||||||||||||||||||||||||||||||||||||||
Period selection | This option is displayed for ledger field columns which contain a periodic value. You use this to select the period(s) for which balance, movement or budget values are represented on the report. | ||||||||||||||||||||||||||||||||||||||||||||||||
Single | Select this to print the period value for a single period. | ||||||||||||||||||||||||||||||||||||||||||||||||
Range | Select this to print the period value for a range of periods. | ||||||||||||||||||||||||||||||||||||||||||||||||
From period | |||||||||||||||||||||||||||||||||||||||||||||||||
Source |
This enables you to select the required period. The following options are available:
|
||||||||||||||||||||||||||||||||||||||||||||||||
Period number |
This indicates the first period in a range of periods you want to include for the column. If you selected to print the value for a single period, then you enter that period number in this field. |
||||||||||||||||||||||||||||||||||||||||||||||||
Periods | This function enables you to view the general ledger periods, period end dates and statuses for the current and previous year. | ||||||||||||||||||||||||||||||||||||||||||||||||
To period | |||||||||||||||||||||||||||||||||||||||||||||||||
Source | This enables you to select the required period. | ||||||||||||||||||||||||||||||||||||||||||||||||
Period number | This indicates the last period in a range of periods you want to include for the column. | ||||||||||||||||||||||||||||||||||||||||||||||||
Periods | This function enables you to view the general ledger periods, period end dates and statuses for the current and previous year. | ||||||||||||||||||||||||||||||||||||||||||||||||
Year selection | This option is displayed for ledger field columns which contain an annual value. You use this to select the year for which balance, movement or budget values are represented on the report. | ||||||||||||||||||||||||||||||||||||||||||||||||
Source |
This enables you to select the required year. Select the option: Entered at run-time, if you want to be able to select the required year at the time of generating the report. |
||||||||||||||||||||||||||||||||||||||||||||||||
Run-time variable (1-8) |
This option is only enabled if you selected the source as: Entered at run-time. This indicates the number of the year variable you created as a run-time prompt, so that you can enter the appropriate ledger year for this column. The number must be in the range of 1 to 8. The prompt text that you defined for the run-time prompt is displayed to confirm that you have selected the correct year variable. |
||||||||||||||||||||||||||||||||||||||||||||||||
OK | Select this to accept the information you entered. | ||||||||||||||||||||||||||||||||||||||||||||||||
Cancel | Select this to return to the previous screen. | ||||||||||||||||||||||||||||||||||||||||||||||||
Quarter selection | This option is displayed for ledger field columns which contain a quarterly value. You use this to select the quarter for which balance, movement or budget values are represented on the report. | ||||||||||||||||||||||||||||||||||||||||||||||||
Source |
This enables you to select the required quarter. Select the option: Entered at run-time, if you want to be able to select the required quarter at the time of generating the report. |
||||||||||||||||||||||||||||||||||||||||||||||||
Run-time variable (1-8) |
This option is only enabled if you selected the source as: Entered at run-time. This indicates the number of the quarter variable you created as a run-time prompt, so that you can enter the appropriate ledger quarter for this column. The number must be in the range of 1 to 8. The prompt text that you defined for the run-time prompt is displayed to confirm that you have selected the correct quarter variable. |
||||||||||||||||||||||||||||||||||||||||||||||||
OK | Select this to save the information you entered. | ||||||||||||||||||||||||||||||||||||||||||||||||
Cancel | Select this to return to the previous screen without saving the information you entered. |
You use the GL Report Writer Variable Query program to select a variable to be used as the first or second line of the heading if you have not entered text for the line.
Variables can only be assigned to the headings of columns that have been defined as a Ledger field and which have values relating to balances, movements or budgets.
Field | Description |
---|---|
Variable Query | This screen displays the name and description for each available variable. |
Select | You use this function to select the highlighted variable as the line of text you want to use for the heading line. |
Close | Select this to return to the previous screen. |
The following options and functions are displayed when you use the Define Column function to maintain the options for a column that is defined as a Calculated:
Field | Description |
---|---|
Sequence number |
If you are using multiple sections then you can enter the number of the section in which you want to include the column. The section in which you include the column determines the value or text that is shown in the column. The section's account mask and the account codes entered on the detail line are used to determine the appropriate account information to include in each section's column. |
Column type |
This field enables you to indicate how you want values to be displayed in a column. This field is not available if the ledger field selected is a text field. |
Debit | Select this if you want the system to show debit values as positive numbers and credit values as negative numbers. |
Credit | Select this if you want the system to reverse the sign of all values that are included in the column. |
Debit only | Select this if you want the system to only include detail lines with a debit or zero value. |
Credit only | Select this if you want the system to only include detail lines with a credit or zero value. |
Credit only with reverse sign | Select this if you want the system to only include detail lines with a credit (negative) value and you want them shown as positive values. |
Numeric format | You use this to select the format you require for numeric values. |
Column options | |
Express result as a percentage | Select this if you want the result to be multiplied by 100 and followed by a percentage sign (%) on the detail print line. |
Express percentage as positive |
Select this if you want to express all percentages calculated as positive percentage values. This option is only enabled if you selected the option: Express result as percentage. |
Recalculate at total level |
Select this if you want the calculation to be performed on the totals in a total report line. Otherwise the total for the calculated column is based on the accumulations from the detail account lines. |
Print column |
Select this if you want to print the values included in the column. You usually select not to print the column if you only want to retrieve ledger values for use in a calculation. |
Print currency |
Select this to print the currency symbol on the first account line and in the totals. The currency symbol is only printed against the first line of the detail lines and against the totals. It is not printed against each detail line. This field is not available if the ledger field selected is a text field. |
Width of column | When you add a column, this value defaults to a value suitable to the field being printed. You can enter a value between 1 and 40. |
Rounding | The selection you make here is used by the system to round ledger values in each of the columns to the nearest unit (e.g. Dollar, pound), nearest thousand or nearest million. |
Units | Select this to round to the nearest unit. |
Thousands | Select this to round to the nearest thousand. |
Millions | Select this to round to the nearest million. |
Decimals | The selection you make here is used by the system to determine the number of decimals to include in each of the rounded ledger values included in the columns of the financial report. |
None | Select this to exclude all decimals. |
One | Select this to include a single decimal. |
Two | Select this to include 2 decimals. |
Headings |
You use the Headings function to enter headings for your columns. Column headings can be specified for each of the available column types (i.e. Ledger field, calculated, blank) and the method of entry is identical for each type of column |
Headings | Two heading lines are available which can contain text you have entered, or variables you have selected. |
Line 1 |
You this to enter the first line of text for the heading or to select a variable for the first line of the heading. You use the Variables function to select the variable required. |
Line 2 |
You this to enter the second line of text for the heading or to select a variable for the second line of the heading. You use the Variables function to select the variable required. |
Variables |
You use this function to select a variable to be used as the first or second line of the heading if you have not entered text for the line. Variables can only be assigned to the headings of columns that have been defined as a Ledger field and which have values relating to balances, movements or budgets. |
Alignment | This option enables you to define the positioning of the headings for the column. |
Left justified | Select this to position the heading at the beginning of the field. |
Centered | Select this to position the heading in the middle of the field. |
Right justified | Select this to position the heading at the end of the field. |
Underline character | The character entered here is repeated across the column below the second line of the heading for the column. |
Overline character | The character entered here is repeated across the column above the heading for the column. |
OK | Select this to accept the information you entered. |
Cancel | Select this to return to the previous screen. |
Calculations |
You use this function to define a calculation (comprising up to three equations) to arrive at the value for a calculated column. The calculation contained in each equation is performed. When you select this function, the equations already defined are displayed. The following functions are available: |
Add | Select this to add a calculation column. |
Insert | Select this to insert a calculation column before the highlighted calculation. |
Change | Select this to change the highlighted calculation. |
Delete | Select this to remove the highlighted calculation. |
Close | Select this to return to the previous screen. |
OK | Select this to accept the changes you made and to return to the previous screen. |
Close | Select this to ignore any changes you made and to return to the previous screen. |
The following options are available when you select the Add, Insert or Change functions from the Calculations screen:
Each equation can include a maximum of four fields.
Field | Description |
---|---|
Result |
Enter COL to use the result of the equation for the column value. At least one of the equations must have COL as the result (i.e. The column being defined will contain this result). Enter VALnnn (where nnn is a three character numeric value) to save the result of the equation to a report variable. You can use the report variable in other equations in the calculation, provided they come after the equation that calculated the report variable. |
Op | Select the operation that the system must perform on the field. This may be addition (+), subtraction (-), multiplication (*), or division (/). |
Field |
Enter COLnn (where nn is a two character column number) for the calculation to be based on the current value in column nn. Enter VALnn (where nn is a two character report variable) for the calculation to be based on the report variable nn. Enter a fixed value to be used in the calculation. |
Columns | This function enables you to view and select from the columns already defined for the report. |
Valid entries | When you place the cursor in either of the Field, Op or Result fields, then the valid entries for those fields are displayed in this box. |
OK | Select this to accept the calculation you entered and return to the previous screen. |
Close | Select this to return to the previous screen. |
You use the Blank Column Definition function to define spaces between columns. This is normally used to make the information on the financial report easier to read, or so that additional information can be written manually on the report.
The following options and functions are displayed when you use the Define Column function to maintain the options for a column that is defined as Blank.
Field | Description |
---|---|
Sequence number |
If you are using multiple sections then you can enter the number of the section in which you want to include the column. The section in which you include the column determines the value or text that is shown in the column. The section's account mask and the account codes entered on the detail line are used to determine the appropriate account information to include in each section's column. |
Print options | |
Print column |
Select this if you want to print the values included in the column. You usually select not to print the column if you only want to retrieve ledger values for use in a calculation. |
Width of column |
When you add a column, this value defaults to a value suitable to the field being printed. You can enter a value between 1 and 40. |
Headings |
You use the Headings function to enter headings for your columns. Column headings can be specified for each of the available column types (i.e. Ledger field, calculated, blank) and the method of entry is identical for each type of column. |
Headings | Two heading lines are available which can contain text you have entered, or variables you have selected. |
Line 1 |
You this to enter the first line of text for the heading or to select a variable for the first line of the heading. You use the Variables function to select the variable required. |
Line 2 |
You this to enter the second line of text for the heading or to select a variable for the second line of the heading. You use the Variables function to select the variable required. |
Variables |
You use this function to select a variable to be used as the first or second line of the heading if you have not entered text for the line. Variables can only be assigned to the headings of columns that have been defined as a Ledger field and which have values relating to balances, movements or budgets. |
Alignment | This option enables you to define the positioning of the headings for the column. |
Left justified | Select this to position the heading at the beginning of the field. |
Centered | Select this to position the heading in the middle of the field. |
Right justified | Select this to position the heading at the end of the field. |
Underline character | The character entered here is repeated across the column below the second line of the heading for the column. |
Overline character | The character entered here is repeated across the column above the heading for the column. |
OK | Select this to accept the information you entered. |
Cancel | Select this to return to the previous screen. |
OK | Select this to accept the changes you made and to return to the previous screen. |
Cancel | Select this to ignore any changes you made and to return to the previous screen. |
You use the Detail Line Maintenance function to add and change the detail lines that you want to print on the financial report.
The lines already defined for the report are displayed in a listview.
The sequence in which lines are printed on a financial report is determined by the sequence number assigned to each detail line.
The content of each of the columns you defined is determined by the accounts selected for the detail lines.
You will be unable to access this function until at least one column has been defined. |
The following options can be selected from the listview menu:
Field | Description |
---|---|
File | |
Start At | Select this to navigate to a specific entry in the listview. |
Exit | Select this to return to the previous screen. |
Edit | |
Add | Select this to add a new detail line. |
Change | Select this to maintain the line currently highlighted in the listview. |
Delete | Select this to delete the line currently highlighted in the listview. |
Functions | |
Renumber | Select this to renumber the detail lines in the listview according to the sequence number assigned to each detail line. |
Options | Select this to use the Multimedia program to view multimedia objects defined against the |
Confirm Deletions | Select this if you want the system to prompt you to confirm the deletion of a line when you select to delete it. If you do not select this option, then the line is deleted without warning. |
These options are displayed when you select the Start At option from the File menu.
Field | Description |
---|---|
Start at line number | Enter the line number to which you want to navigate in the listview. |
OK | Select this to navigate to the line number you entered in the previous field. |
Cancel | Select this to return to the listview without navigating to a different entry. |
These options are displayed when you select the Renumber option from the Functions menu.
Field | Description |
---|---|
Renumber detail lines? | |
OK | Select this to renumber the detail lines in the listview according to the sequence number assigned to each detail line. |
Cancel | Select this to return to the listview without renumbering the lines. |
You use the Add option from the File menu to select the specific type of detail line that you want to assign to the report.
Field | Description |
---|---|
Line number |
The horizontal format of the report is defined as a series of sequentially numbered detail lines. This indicates the line number for the detail line in the listview. It indicates the order in which the lines are processed and printed on the report if you selected to print the line. |
Line type | This option enables you to select the type of line you want to add to the report. |
Account | Select this to add a line which extracts and prints values from individual General Ledger codes, a range of ledger codes, or ledger codes matching a wildcard pattern, for inclusion in the report. |
Total | Select this to add a line that will print subtotals and totals of values that you accumulated using Account and Calculation lines. |
Calculation | Select this if you want to add a line that will perform calculations and print values not defined in the column's definition. |
XML element | Select this to add a XML element to the report. This option is only enabled if the report type is XML (i.e. you are maintaining a XML document). |
Variable | Select this to define a variable number to use for printing of calculation and total results. |
Report text | Select this to add a text line to the report. The text line can contain headings or titles for sections of a balance sheet, or multiple lines of text such as notes to financial reports. |
User notations | Select this to use the Admin Notepad Editor (Monospaced Text) program to add a user
notation line to the report. These comments are not printed on the actual financial report. They only appear in the detail report listing produced by the GL List of Financial Reports program (or when you maintain the line) and are not actually printed on the financial reports. They typically include information on when to run the report, who needs the report, what variables are used, etc. |
Define Line | You use this function to add and maintain information specific to the line type you selected. |
Close | Select this to return to the listview without adding a new line type. |
You use the Account line type to select and print values from individual ledger codes, a range of ledger codes, or ledger codes matching a wildcard pattern.
You only select the accounts that you want included on the financial report line here; you create a column definition to determine the exact values that you want printed in each account.
This is the only place from which you can extract information from the General Ledger for inclusion on a financial report. All other detail line types are used to either manipulate these extracted amounts, place text on the report, or place user comments in the format.
You should create an account line for each line you want to print on a financial report, excluding totals and calculated amounts. However, there are instances where it makes sense to have multiple financial statement lines defined by a single detail account line, or where you have to create multiple detail account lines to have one financial report line.
When you select the Define Line function when adding an Account line type or you select to change an existing Account line type, the following options are displayed:
Field | Description |
---|---|
Details | This function enables you to define the details for the highlighted account line. |
Add | This function enables you to add additional account selections (sequences) for the account line. |
Change | This function enables you to change the account selections for the highlighted line. |
Delete | This function enables you to delete the highlighted account line. |
Section | |
Number | This field displays the currently selected section. |
Section |
This function is only available if you selected the Multiple Sections function in the Report Options and you did not select the Account selection: Mask for each section. You use this function to select the section you want to maintain. |
Save | Select this to save your changes and to return to the listview. |
Close | Select this to ignore any changes you made and to return to the listview. |
When you select to Add a detail account line, the following options and functions are available:
Field | Description | ||||
---|---|---|---|---|---|
Sequence number | If you are using multiple sections then you can enter the number of the section in which you want to include the account. | ||||
Account selection | You can only change the entry displayed in the Account selection field if within Report Options function you indicated that accounts are to be Selected by report line. | ||||
Single |
Select this if you want to include a single ledger account code, or a single account type in the value of the financial report line. If you select Single at the Account selection field, then the Print options field allows you to specify whether you want to use the account description or enter your own description. |
||||
Range |
Select this if you want to define a range of accounts to include in the value of the financial report line. If you select Range at the Account selection field, then the Print options field allows you to specify whether you want to list each account individually, or enter your own description. |
||||
From account |
This indicates the first account code in a range of account codes you want to include in the value of the financial report line. If you selected to include a single account, then you enter that account code in this field.
Additionally, you can use the ? wildcard character in this field. |
||||
To account |
This indicates the last account code in a range of account codes you want to include in the value of the financial report line. This option is only available if you selected to include a range of accounts. You cannot use wildcard characters in this field. |
||||
Print options |
You can only access the Print options section if within the Account line Details function you selected to Print each account selection. If you select Single at the Account selection field, then the Print options field allows you to specify whether you want to use the account description or enter your own description. If you select Range at the Account selection field, then the Print options field allows you to specify whether you want to list each account individually, or enter your own description. |
||||
List accounts individually |
This option is only available if you selected Range at the Account selection field. Select this to list each account individually. If you select this option, then you cannot enter your own description. |
||||
Use account description |
This option is only available if you selected Single at the Account selection field. Select this to use the description defined against the account code (General Ledger Codes). If you select this option, then you cannot enter your own description. |
||||
Description to use | You use this field to enter the text for your own description for the account code. | ||||
XML element | |||||
OK | Select this to add the account line. | ||||
Close | Select this to return to the previous screen without adding the currently displayed sequence number details. |
When you select the Details function for a highlighted line, the following options and functions are available:
Field | Description |
---|---|
Account selection | You can only change the entry displayed in this field if, within Report Options function, you indicated that accounts are to be Selected by report line. |
Ledger code | Select this if you want to define a range of ledger codes to print. |
Report index 1 |
Select this to base the account selection on the Report index 1 defined against each ledger code (General Ledger Codes). If you selected the report option: Selected by report line, then you can additionally specify a range of accounts to print within this report index. |
Report index 2 |
Select this to base the account selection on the Report index 2 defined against each ledger code (General Ledger Codes). If you selected the report option: Selected by report line., then you can additionally specify a range of accounts to print within this report index. |
Print option | |
Summarize to 1 report line |
Select this to print only one detail line for all lines selected (i.e. to consolidate all accounts selected into one line). If you select this option, then you can define the description for this summarized line in the Description field below. |
Print each account selection | Select this to print multiple report lines from one detail line. |
Do not print | Select this if you do not want to print the accounts selected on this detail line. |
Line skip option | |
Skip lines | Select this to indicate the number of blank lines to print before the first account line is printed. |
New page | Select this to indicate that you want to skip to a new page before printing the first account line. |
Specific line | Select this to indicate that you want to skip to a specific line on the page before printing the first account line. |
Lines to skip (0-9) |
If you selected either the Skip lines or Specific line options at the Line skip option field, then this field enables you to indicate the number of lines to skip or the specific line to skip to. If the specific line to skip to is above the current line of the report, the system skips to that line on the next page of the report. |
Line type | |
Debit | Select this if you want to show debit values as positive numbers and credit values as negative numbers. |
Credit | Select this if you want to show credit values as positive numbers and debit values as negative numbers. |
Debit only | Select this if you want to only include accounts with a debit value on this detail line. |
Credit only | Select this if you want to include only accounts with a credit value on this detail line. |
Company selection | You can only change the entry displayed in the Company selection field if within the Report Options function you indicated that companies are to be Selected by report line. |
Accumulate to total | The system calculates all the subtotal and total values that you want to print on the report, and uses total levels to keep separate total amounts for each numeric column. |
Add | Select this if you want the total value of the accounts included on this detail line to be added to a specified total level. |
Subtract | Select this if you want the total value of the accounts included on this detail line to be subtracted from a specified total level. |
None | Select this if you do not want the total value of the accounts included on this detail line to affect the total levels. |
To total level |
The system uses up to 10 total levels (0-9) per column to perform all the columnar maths required for the report. A separate total is maintained for each of the numeric columns on the report in one set of total levels. For example: If you had a financial report with three numeric columns and you defined an account line to add the total of the accounts selected on the line to total level 0, then the system would retain three total level 0 values, one for each column. Total levels are running totals, and the sum of account lines are added to (subtracted from) any value already in the total level. Total levels are zeroed at the beginning of every report and when you use a total line. |
Group selection |
You can only access the Group selection field if, within the Report Options function, you indicated that account selection by group code is required. The group code specified here is not a selection in itself, but acts as a filter on the account selection lines defined. At least one account selection line must be defined. |
All | Select this to include all group codes in the filter. |
Single | Select this to filter accounts on a single group code. |
Group | This indicates the single group code to use to filter the accounts. |
Description |
This field is only enabled if you selected the Print option: Summarize to 1 report line. This description is used to describe the value accumulated from the selected accounts, and is printed in the column that you included the ACCDES ledger text field. If you did not include this field in one of the columns, then this description is not printed on the financial report. |
XML element | This field is only enabled if you selected the Print option: Summarize to 1 report line. |
OK | Select this to accept the information you entered and to return to the previous screen. |
Cancel | Select this to ignore any information you entered and to return to the previous screen. |
You use the Total line type to print subtotals and totals of values that you have accumulated using account and calculation lines.
When you select the Define Line function when adding a Total line type or you select to change an existing Total line type, the following options are displayed:
Field | Description |
---|---|
Details | This function enables you to define the details for the highlighted total line. |
Save Table |
This function is only available if you selected the Save totals option from within the Details function. You use the Save Table function to save totals in up to 25 entries per total line. Each entry comprises the column from which you want the value extracted, the total level you want to save and the report variable to which you want the amount saved. The system saves the values from the total levels before it rolls or zeros any total levels. Values are saved in total levels one column at a time. For example: If you want to save the values in total level 3 from three columns, you need to save values to three report value variables. |
Add | This function enables you to add an entry for a total line. |
Change | This function enables you to maintain the entry details for the highlighted total line. |
Delete | This function enables you to delete the highlighted total entry. |
Save | Select this to save your changes and to return to the previous screen. |
Close | Select this to return to the previous screen without saving your changes. |
When you select the Add function to add a total line, the following options and functions are displayed:
Field | Description |
---|---|
Sequence number | If you are using multiple sections then you can enter the number of the section in which you want to include the total. |
Total range | You use this to enter a range of columns for which you want to print a total and manipulate a total level. |
From column | This indicates the first column in the range of columns you want to total. |
To column | This indicates the last column in the range of columns you want to total. |
Total level | This indicates the total level to which this total must be saved. |
Options | |
Zeroize total |
Select this option to reset the selected total level to zero for the columns selected by this total entry. You would use this function if you wanted to re-use a total level in the same report. For example: You may want to use total level 0 to add current assets and then use it again to add fixed assets. If you did not reset it to zero between these two sections of the financial report, the fixed asset total would also include the total current assets amount. |
Roll total |
Select this option if you want to add the selected total level to a higher total level for the range of columns entered. You would select this if you wanted to retain a total that you had accumulated but wanted to use the current total level for other purposes. For example, you may want to retain the total current assets amount to use in printing the total assets amount. In this case you could, roll the total level 0 amounts to total level 1 and zeroize level 0 when you print the total current assets amount. This retains the total current assets amount for inclusion in the total assets value in total level 1 and resets total level 0 to zero so that when you add up the total fixed asset amount it does not include the current assets amount. |
Roll to level | This indicates the level to which the total must be rolled. |
Description to print | If you make an entry at the Description to print field, then you can specify the column in which you want to print the description, or at a specific position on the same print line as the total value. |
Start description print at column | Select this if you want to define the column in which you want to start printing the description entered at the previous field. |
Column to print at | This indicates the column in which the description must be printed. |
Print position |
This indicates the print position at which the description must be printed. This option is not available if you selected to print the description starting in a particular column. |
OK | Select this to accept the information you entered. |
Cancel | Select this to return to the previous screen without saving the information for the current sequence number. |
When you select the Details function for a highlighted line, the following options and functions are available:
Field | Description | ||||
---|---|---|---|---|---|
Save totals |
Select this to be able to save up to 25 total values to report variables VAL01 to VAL250.
|
||||
Line type | |||||
Debit | Select this to leave the sign of values printed on the total line unchanged. | ||||
Credit | Select this to reverse the sign of all values printed on the total line (except percentages). | ||||
Print options | |||||
Print total line | Select this if you want to print the totals. | ||||
Line skip option | |||||
Skip lines | Select this to indicate the number of blank lines to print before the first total line is printed. | ||||
New page | Select this to indicate that you want to skip to a new page before printing the first total line. | ||||
Specific line | Select this to indicate that you want to skip to a specific line on the page before printing the first total line. | ||||
Lines to skip (0-9) |
If you selected either the Skip lines or Specific line options at the Line skip option field, then this field enables you to indicate the number of lines to skip or the specific line to skip to. If the specific line to skip to is above the current line of the report, the system skips to that line on the next page of the report. |
||||
Underline character |
If you want to underline the total, then you can enter the character to be used for the underline. For example = or -. If you do not want the total to be underlined, then leave this field blank. |
||||
Overline character |
If you want to print a line above the total, then you can enter the character to be used for the overline. For example = or -. If you do not want a line above the total, then leave this field blank. |
||||
OK | Select this to accept the information you entered. | ||||
Cancel | Select this to return to the previous screen without saving any changes you made. |
You use the Calculation line type if you want the system to perform calculations and print values not defined in the column's definition.
For example: You can print a gross profit percentage in a column that you have defined to include month-to-date values.
When you select the Define Line function when adding a Calculation line or you select to change an existing Calculation line type, the following options are displayed:
Field | Description |
---|---|
Result |
Enter COL to use the result of the equation for the column value. At least one of the equations must have COL as the result (i.e. The column being defined will contain this result). Enter VALnnn (where nnn is a three character numeric value) to save the result of the equation to a report variable. You can use the report variable in other equations in the calculation, provided they come after the equation that calculated the report variable. |
Op | Select the operation that the system must perform on the field. This may be addition (+), subtraction (-), multiplication (*), or division (/). |
Field |
Enter COLnn (where nn is a two character column number) for the calculation to be based on the current value in column nn. Enter VALnn (where nn is a two character report variable) for the calculation to be based on the report variable nn. Enter a fixed value to be used in the calculation. |
Columns | This function enables you to view and select from the columns already defined for the report. |
Valid entries | When you place the cursor in either of the Field, Op or Result fields, then the valid entries for those fields are displayed in this box. |
Details | This function enables you to define additional characteristics for the calculation line. |
Save | Select this to accept the calculation you entered and return to the previous screen. |
Close | Select this to return to the previous screen. |
When you select the Details function for a highlighted line, the following options and functions are available:
Field | Description |
---|---|
Express result as a percentage | Select this if you want the result of the calculation to be expressed as a percentage rather than as the calculation value. |
Line type | |
Debit | Select this if you want to show debit values as positive numbers and credit values as negative numbers. |
Credit | Select this if you want to show credit values as positive numbers and debit values as negative numbers. |
Rounding | The selection you make here is used by the system to round ledger values in each of the columns to the nearest unit (e.g. Dollar, pound), nearest thousand or nearest million. |
Units | Select this to round to the nearest unit. |
Thousands | Select this to round to the nearest thousand. |
Millions | Select this to round to the nearest million. |
Decimals | The selection you make here is used by the system to determine the number of decimals to include in each of the rounded ledger values included in the columns of the financial report. |
None | Select this to exclude all decimals. |
One | Select this to include a single decimal. |
Two | Select this to include 2 decimals. |
Accumulate to total | The system calculates all the subtotal and total values that you want to print on the report, and uses total levels to keep separate total amounts for each numeric column. |
Add | Select this if you want the total value of the calculation included on this detail line to be added to a specified total level. |
Subtract | Select this if you want the total value of the calculation included on this detail line to be subtracted from a specified total level. |
None | Select this if you do not want the total value of the calculation included on this detail line to affect the total levels. |
To total level |
The system uses up to 10 total levels (0-9) to perform all the columnar maths required for the report. A separate total is maintained for each of the numeric columns on the report in one set of total levels. Total levels are running totals, and the sum of calculation lines are added to (subtracted from) any value already in the total level. Total levels are zeroed at the beginning of every report and when you use a total line. |
Print options | You can only access the fields within the Print Options section if you select the Print calculation result option. |
Print calculation result | Select this to print the result of the calculation on the report. |
Line skip option | |
Skip lines | Select this to indicate the number of blank lines to print before the first calculation line is printed. |
New page | Select this to indicate that you want to skip to a new page before printing the first calculation line. |
Specific line | Select this to indicate that you want to skip to a specific line on the page before printing the first calculation line. |
Lines to skip (0-9) |
If you selected either the Skip lines or Specific line options at the Line skip option field, then this field enables you to indicate the number of lines to skip or the specific line to skip to. If the specific line to skip to is above the current line of the report, the system skips to that line on the next page of the report. |
Description to print | This indicates the actual text of the description you want to print. |
Start printing description at column | If you make an entry at the Description to print field, then you can specify the column in which you want to print the description, or to start printing the description at a specific position on the same print line as the calculation value. |
Column to print at | If you select the Start printing description at column field then you use this field to specify the column in which you want to print the description. |
Print position | Indicate the specific Print position on the report where you want the description to be printed. |
OK | Save the information you entered. |
Cancel | Select this to return to the previous screen. |
This screen is displayed when you select to add an XML element type detail line.
Field | Description |
---|---|
Element name | Enter the XML element to add. |
Save | Select this to save the element name. |
Close | Select this to return to the previous screen. |
You use the Variable option to print one or more variables across one line on the report and, optionally, add to (subtract from) the totals for the columns in which the variables are printed.
You can also enter a description to be printed on the line.
The following options are displayed when you select to Add a variable line:
Field | Description | ||||
---|---|---|---|---|---|
Sequence number | If you are using multiple sections then you can enter the number of the section in which you want to include the line. | ||||
Column number | This indicates the column in which you want to print the variable. | ||||
Variable number (1-50) |
This indicates the variable number that must be printed in the column specified at the previous field.
|
||||
OK | Select this to save your selections. | ||||
Close | Select this to return to the previous screen. |
The following options and functions are displayed when you select the Details function for a highlighted line:
Field | Description |
---|---|
Line type | |
Debit | Select this if you want the system to show debit values as positive numbers and credit values as negative numbers. |
Credit | Select this if you want the system to show credit values as positive numbers and debit values as negative numbers. |
Rounding |
The selection you make here is used by the system to round ledger values in each of the columns to the nearest unit (e.g. Dollar, pound), nearest thousand or nearest million. The selections displayed in the Rounding fields default to the settings made within the Report Options function. |
Units | Select this to round to the nearest unit. |
Thousands | Select this to round to the nearest thousand. |
Millions | Select this to round to the nearest million. |
Decimals |
The selection you make here is used by the system to determine the number of decimals to include in each of the rounded ledger values included in the columns of the financial report. The selections displayed in the Decimals fields default to the settings made within the Report Options function. |
None | Select this to exclude all decimals. |
One | Select this to include a single decimal. |
Two | Select this to include 2 decimals. |
Accumulate to total | The system calculates all the subtotal and total values that you want to print on the report, and uses total levels to keep separate total amounts for each numeric column. |
Add | Select this if you want the total value of the accounts included on this detail line to be added to a total level. |
Subtract | Select this subtract if you want the total value of the accounts included on this detail line to be subtracted from a total level. |
None | Select this if you do not want the total value of the accounts included on this detail line to affect the total levels. |
To total level |
The system uses up to 10 total levels (0-9) to perform all the columnar maths required for the report. A separate total is maintained for each of the numeric columns on the report in one set of total levels. For example: If you had a financial report with three numeric columns and you defined an account line to add the total of the accounts selected on the line to total level 0, then the system would retain three total level 0 values, one for each column. Total levels are running totals, and the sum of account lines are added to (subtracted from) any value already in the total level. Total levels are zeroed at the beginning of every report and when you use a total line. |
Print options | |
Print variable line |
Select this if you want to print the variable on the report. You can only access the fields within the Print Options section if you select the Print variable line option. |
Line skip option | |
Skip lines | Select this to indicate the number of blank lines to print before the first variable line is printed. |
New page | Select this to indicate that you want to skip to a new page before printing the first variable line. |
Specific line | Select this to indicate that you want to skip to a specific line on the page before printing the first variable line. |
Lines to skip (0-9) |
This field is not enabled if you selected New page at the previous field. If you selected either the Skip lines or Specific line options at the Line skip option field, then this field enables you to indicate the number of lines to skip, or the specific line to skip to. If the specific line to skip to is above the current line of the report, the system skips to that line on the next page of the report. |
Description to print | If you make an entry at the Description to print field, then you can specify the column in which you want to print the description, or to start printing the description at a specific position on the same print line as the variable value. |
Start printing text at column | Select this if you want to specify the column at which the text must be printed on the report line. |
Column to print at | If you select the Start printing text at column field then you use this field to specify the column in which you want to print the text. |
Print position | You use this to indicate the specific print position on the report where you want the text to be printed. |
OK | Select this to save the changes you made. |
Cancel | Select this to return to the previous screen. |
You use the Report text line type to print text lines on a financial report. These can be headings or titles for sections of a balance sheet, or multiple lines of text such as notes to financial reports.
This does not include column headings, page headers or page footers. You can either enter the text manually or import it into the report from an external file.
When you select the Define Line function when adding a Report text detail line or you select to change an existing Report text line type, the following options are displayed:
Field | Description |
---|---|
Text type | |
Single line | Select this if you want to define a single line of text to be printed on the report. |
Multiple lines | Select this if you want to print a number of lines on the report. |
Import from external file | Select this to indicate that the text is to be inserted from an external flat ASCII file at the time you print the report. |
Import file name |
This field is only enabled if you selected the Text type: Import from external file. This indicates the name of the file from which the text must be imported at the time of printing the report. |
Print options | |
Line skip option | |
Skip lines | Select this to indicate the number of blank lines to print before the first text line is printed. |
New page | Select this to indicate that you want to skip to a new page before printing the first text line. |
Specific line | Select this to indicate that you want to skip to a specific line on the page before printing the first text line. |
Lines to skip (0-9) |
This field is not enabled if you selected New page at the previous field. If you selected either the Skip lines or Specific line options at the Line skip option field, then this field enables you to indicate the number of lines to skip, or the specific line to skip to. If the specific line to skip to is above the current line of the report, the system skips to that line on the next page of the report. |
Center text | Select this if you want the text you enter to be centered on the report line on which it is printed. |
Start printing text at column |
Select this if you want to specify the column at which the text must be printed on the report line. This option is not available if you selected the Center text option. |
Column to print at | If you select the Start printing text at column field then you use this field to specify the column in which you want to print the text. |
Print position | You use this to indicate the specific Print position on the report where you want the text to be printed. |
Maintain Text | Select this to use the Admin Notepad Editor (Monospaced Text) program to enter the text that you want to print on the financial report. |
Save | Select this to save the information you entered. |
Close | Select this to return to the previous screen. |
You use the User notations option to enter comments concerning the financial report that only appear in the GL List of Financial Reports program.
These comments are not actually printed on the financial reports and usually include information on when to run the report, who needs the report, what variables are used, etc.
The Header Maintenance and Footer Maintenance functions enable you to define the text for the headings and the foot notes of your report respectively.
You use the Header Maintenance function to specify the information you want to print at the top of the report.
The program defaults to using a standard header, which comprises three lines of text in the format of typical SYSPRO reports.
Field | Description |
---|---|
Standard header required | Select this to use the standard SYSPRO report header for your report. |
Number of header lines |
Indicate the number of lines you want to use for your own defined header. If you do not require a header, enter zero in this field. |
Blank lines below header | Indicate the number of lines you want left blank after your own defined header and before the first detail line is printed. |
Header Fields |
Define the text and variables that will be the header of your report. You can only select this function if you are not using the standard header provided. |
Save | Save the information you entered and to return to the previous screen. |
Close | Ignore any changes you made and to return to the previous screen. |
You use the Header Fields function to define the text and variables that will be the header of your report.
A maximum of 25 header fields can be defined.
The Header Fields screen is divided into two parts: The Detail section (indicating the header lines already defined) and the Preview section (enabling you to view the end result of any formatting performed in the Detail section of the screen).
When you select the Add or Change function, the Header Maintenance screen is displayed.
Field | Description |
---|---|
Entry number |
When you add a new header field, then this defaults to the next available entry number. You can enter an existing entry number if you want to insert a new header field as that entry number. |
Text / variable | The text characters entered here are printed on the line at the position specified. |
Variables | This function enables you to select one of the available report variables. |
Line number | This refers to the specific line of the header on which the text or variable will be printed. |
Position (1-132) |
This refers to the specific horizontal position at which the text or variable must be printed. It cannot exceed the number of characters defined for the page format in the Report Options function. |
CSS style | |
CSS examples | |
Add to Styles | |
Run Time Prompts |
Maintain up to 15 variables that you want to be prompted for at the time of running the report. For example: You can enter the date of running the report and print this in the header. |
Prompt | |
Sequence | Indicate the specific number in the sequence that you want the run-time prompt to be requested. |
Variable | This field enables you to enter a specific type of variable that you want the system to request when you run the report. |
Text | Enter the specific wording that you want the system to display on the screen when the run-time prompt is requested. |
Allow spaces or zeros |
If you defined a report value variable (i.e. VAL1-250), then this option enables you to indicate whether a zero value is valid when the report is run. If you defined a report text variable (i.e. TEXT1-8) then this option enables you to indicate whether a blank entry is valid when the report is run. |
Save | Select this to save the information you entered and to return to the previous screen. |
Close | Select this to return to the previous screen without saving any changes you made. |
OK | Select this to save the information you entered. |
Cancel | Select this to return to the previous screen without saving any changes you made. |
You use the Footer Maintenance function to define the text and variables for the footer of your report.
Field | Description |
---|---|
Report footer required | Select this to print footer information on the report. |
Number of footer lines | Indicate the number of lines you want to use for the footer. |
Blank lines above footer | Indicate the number of lines you want left blank before the footer is printed and before the last detail line is printed. |
Footer Fields | Specify the information you want to print at the bottom of the report. |
Save | Save the information you entered and to return to the previous screen. |
Close | Ignore any changes you made and to return to the previous screen. |
You use the Footer Fields function to specify the information you want to print at the bottom of the report.
The Footer Fields screen is divided into two parts: The Detail section (indicating the footer lines already defined) and the Preview section (enabling you to view the end result of any formatting performed in the Detail section of the screen).
When you select the Add or Change function, the Footer Field Maintenance screen is displayed.
Field | Description |
---|---|
Entry number |
When you add a new footer field, then this defaults to the next available entry number. You can enter an existing entry number if you want to insert a new footer field as that entry number. |
Text / variable | The text characters entered here are printed on the line at the position specified. |
Variables | This function enables you to select one of the available report variables. |
Line number | This refers to the specific line of the footer on which the text or variable will be printed. |
Position (1-132) |
This refers to the specific horizontal position at which the text or variable must be printed. It cannot exceed the number of characters defined for the page format in the Report Options function. |
CSS style | |
CSS examples | |
Add to Styles | |
Run Time Prompts |
This function enables you to maintain up to 15 variables that you want to be prompted for at the time of running the report. For example: You can enter the date of running the report and print this in the header. |
Prompt | |
Sequence | This field enables you to indicate the specific number in the sequence that you want the run-time prompt to be requested. |
Variable | This field enables you to enter a specific type of variable that you want the system to request when you run the report. |
Text | This field enables you to enter the specific wording that you want the system to display on the screen when the run-time prompt is requested. |
Allow spaces or zeros |
If you defined a report value variable (i.e. VAL1-250), then this option enables you to indicate whether a zero value is valid when the report is run. If you defined a report text variable (i.e. TEXT1-8) then this option enables you to indicate whether a blank entry is valid when the report is run. |
Save | Select this to save the information you entered and to return to the previous screen. |
Close | Select this to return to the previous screen without saving any changes you made. |
OK | Select this to save the information you entered. |
Cancel | Select this to return to the previous screen without saving any changes you made. |
You use the Multi-column Headings function to print text across a set of individual column headings.
For example: You would use multi-column headings to show the field: <--- Period-to-date ---> over column headings for actual and budget ledger values.
The Multi-column Headings screen is divided into two parts: The Detail section (indicating the multi-column headings already defined) and the Preview section (enabling you to view the end result of any formatting performed in the Detail section of the screen).
You will be unable to access this function until at least one column has been defined. You will be unable to define a heading that extends over more columns than you have defined. |
Field | Description |
---|---|
Add | Select this to add a new multi-column heading. |
Change | Select this to change the highlighted multi-column heading. |
Delete | Select this to delete the highlighted multi-column heading. |
Save | Select this to save the information you entered. |
Close | Select this to return to the previous screen without saving any changes you made. |
When you select the Add or Change function, the Multi- column Heading Entry screen is displayed.
Up to 15 multi-column headings can be defined.
Field | Description |
---|---|
Entry number |
When you add a new multi-column header, then this defaults to the next available entry number. You can enter an existing entry number if you want to insert a new multi-column heading field as that entry number. |
From column | This indicates the first column over which the heading must start. |
To column | This indicates the last column over which the heading must end. |
Underline character |
If you want to underline the multi-column heading, then you can enter the character to be used for the underline. For example = or -. If you do not want the heading to be underlined, then leave this field blank. |
Heading text | You use this to define the actual heading text. |
Center heading text |
Select this if you want the heading to be centered over the range of columns selected. If you do not select this option, the heading starts at the first position of the first column defined in the From column field. |
OK | Select this to save the information you entered. |
Cancel | Select this to return to the previous screen without saving any changes you made. |
You use this function to run the financial report that you are currently maintaining.
This function operates in the same way as the GL Financial Reporting program, except that you can only generate the report you are currently maintaining.
Field | Description |
---|---|
Debug the report |
Select this to isolate problems that may be encountered at the time of running the report. For every line that is printed from a detail line in the report, the detail line number and the source of the line (e.g. Header, Footer, Mc Hdg, Col Hdg, Account, Total, Calc, Var, Text) is printed. If you select the Debug the report option, then at the Variable to debug field you can enter a specific variable that you want to monitor. |
Variable to debug | This indicates the specific variable that you want to monitor. The value of the variable is printed after the source of the line. |
OK |
Select this to generate the report and/or debug the selected variable. When the report is generated, the GL Financial Reporting program is accessed and given the current report code as the report to process. |
Cancel | Select this to return to the previous screen without generating the report. |
Refer to Reporting Options for an explanation of these options.
Once you have selected the required options and processed the report, if you are executing a XML report, you are given the option of viewing the report in SYSPRO's XML Report Viewer (see GL XML Report Viewer).
This function enables you to create a new report by copying an existing report definition.
This is useful if you want to create two similar reports. Once you have copied the report definition, you can maintain the new report and define only those options that differ between the two reports. This saves you having to re-define the entire report.
The listview pane of the GL Define Financial Reports program displays the reports currently defined.
Field | Description | ||||
---|---|---|---|---|---|
From |
This indicates the current report definition you want to copy to a new report. This is the report that you highlighted on the listview pane when you selected the Copy function. |
||||
Report | This indicates the report code of the report you are copying from. | ||||
Title | This indicates the report title of the report code displayed in the previous field. | ||||
To | You use these options to define the new report code you want to create from the report code displayed above. | ||||
Report |
You should try to select meaningful report names, so that you are able to identify them easily and access them quickly.
|
||||
Title |
The report title indicates the description of the report. You can define your own report titles, utilizing a format that is meaningful to your company.
|
||||
OK | Select this to copy the report definition. | ||||
Cancel | Select this to return to the previous screen without copying the report definition. |
You use the Import function (accessed from the Functions menu) to import financial report definitions from another SYSPRO database.
The import file is created by exporting the report definition from within the originating SYSPRO database (see Export Report Definition). |
Once the file is successfully imported, you are given the option to delete or retain the original import file.
See Activity considerations in Notes and warnings.
Field | Description | ||||
---|---|---|---|---|---|
Import file name |
This indicates the name of the import file, including the full path name. This defaults to GENPGA.EDI. In a client/server environment:
|
||||
File details | These fields display the details of the import file and cannot be changed. | ||||
Date of export | This indicates the date on which the import file was created. | ||||
SYSPRO version | This indicates the SYSPRO program version used to extract the import file. | ||||
Report exported | This indicates the report code of the report extracted to create the import file. | ||||
To | |||||
Report |
This indicates the report code you want to create from the import.
|
||||
Title | This indicates the title for the report code entered at the previous field. | ||||
OK | Select this to import the report definition. | ||||
Cancel | Select this to return to the previous screen without importing the report definition. |
You use the Export function (accessed from the Functions menu) to export financial report definitions to a file that can be imported into other SYSPRO databases.
The listview pane of the GL Define Financial Reports program displays the reports currently defined.
Field | Description |
---|---|
From | These fields display the report definition you want to export. |
Report |
This indicates the report code you want to extract. This is the report that was highlighted on the listview pane when you selected the Export function. |
Title | The report title indicates the description of the report. |
Export file name |
This indicates the name of the export file including the full path name that you want to create. This defaults to GENPGA.EDI, but can be changed. |
OK | Select this to export the report definition. |
Cancel | Select this to return to the previous screen without exporting the report definition. |
Due to the file changes made in SYSPRO 7, reports written in prior versions of the software are no longer supported.
Reports written in a prior version of the software cannot be imported into SYSPRO 7. The SYSPRO 7 conversion must be run to update the report to SYSPRO 7 format. The SYSPRO 7 format of the report can be exported and imported as required.
To use the GL XML Report Viewer program to run a SYSPRO 7 format report in a client-server environment, you need to specify the location of the report as being on the client machine or leave the location blank. The report will not run if you specify that the location of the folder is on the server.
Operator access to the following activities within this program can be restricted. You configure this using the Operators program.
The Import Report Definition options are disabled in a client/server environment when any of the following activities are denied against the operator code (Operators).
Activity | Description |
---|---|
Allowed to import from client | Controls whether an operator can use a SYSPRO import program to import data from a client machine (in a client/server environment). |
File Browse on server (C/S system) | Controls whether an operator use the browse function to load the Browse on Files and Folders program to locate files on the server in a client/server environment. Operators can still navigate to a file or folder on the server by typing in the full path name in the entry field. |
Reports created using the GL Define Financial Reports program can be run in SYSPRO Reporting Services (SRS) - refer to GL Financial Report Writer reports in SRS for additional information.
Convert a standard report to a web-based report
From the listview of the GL Define Financial Reports program, highlight the report you want to convert.
Select the Change option from the Edit menu.
Alternatively, select the Change icon.
Select Report Options.
At the Report type option, select XML.
Select the XML Wizard option.
From the wizard, define the options you require.
Note that you can change the report type at any time from XML to Report and back again without the underlying report being affected.