Acumatica Analytical Report

Download as pdf or txt
Download as pdf or txt
You are on page 1of 78

Reporting

F350 Analytical Reports

Training Guide

Last Revision: 11/14/2017


Acumatica ERP 2017 R2
| Contents | 2

Contents

Copyright......................................................................................................4

Introduction................................................................................................. 5

How to Use This Course...............................................................................6

Introduction to Acumatica ERP User Interface.............................................8

Overview of Analytical Reports.................................................................. 16


Row Sets.......................................................................................................................17
Column Sets.................................................................................................................. 19
Report Definitions...........................................................................................................22
Unit Sets.......................................................................................................................24
Data Sources................................................................................................................. 25

Best Practices............................................................................................ 26

Lesson 1: Creating a Copy of the Default Report........................................29


Company Overview.........................................................................................................30
Step 1.1: Creating a Copy of the Report.......................................................................... 31
Step 1.2: Editing the Row Set......................................................................................... 34
Step 1.3: Editing the Column Set.................................................................................... 40
Step 1.4: Creating a Copy of the Report: a Self-Study Exercise........................................... 44
Practice Exercise............................................................................................................ 46

Lesson 2: Building Reports Across Financial Periods..................................47

Lesson 3: Filtering Data in Reports by Using Unit Sets.............................. 51


Step 3.1: Configuring a Unit Set..................................................................................... 52
Step 3.2: Applying the Unit Set to the Report................................................................... 54

Lesson 4: Using Overlapping Data Sources................................................ 56


An Overlap of Data Sources............................................................................................ 57
Step 4.1: Creating the Report......................................................................................... 59
Step 4.2: Configuring the Row Set...................................................................................61
Step 4.3: Configuring the Column Set.............................................................................. 64

Lesson 5 (Optional): Eliminating Inter-Branch Balances in Reports........... 69


Step 5.1: Configuring Inter-Branch Transactions................................................................ 70
Step 5.2: Processing a Transaction Between Companies......................................................71
Step 5.3: Importing and Reviewing the ARM Report........................................................... 73
Step 5.4: Reviewing the Report Configuration................................................................... 75
Step 5.5: Using an Alternative Calculation for the After Eliminations Column..........................77
| Contents | 3

Appendix: Alphabetical Index.................................................................... 78


| Copyright | 4

Copyright

©2017 Acumatica, Inc.


ALL RIGHTS RESERVED.

No part of this document may be reproduced, copied, or transmitted without the express prior consent
of Acumatica, Inc.

11235 SE 6th, Suite 140


Bellevue, WA 98004

Restricted Rights
The product is provided with restricted rights. Use, duplication, or disclosure by the United States
Government is subject to restrictions as set forth in the applicable License and Services Agreement
and in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS
252.227-7013 or subparagraphs (c)(1) and (c)(2) of the Commercial Computer Software-Restricted
Rights at 48 CFR 52.227-19, as applicable.

Disclaimer
Acumatica, Inc. makes no representations or warranties with respect to the contents or use of this
document, and specifically disclaims any express or implied warranties of merchantability or fitness for
any particular purpose. Further, Acumatica, Inc. reserves the right to revise this document and make
changes in its content at any time, without obligation to notify any person or entity of such revisions or
changes.

Trademarks
Acumatica is a registered trademark of Acumatica, Inc. All other product names and services herein are
trademarks or service marks of their respective companies.

Software Version - 2017 R2


| Introduction | 5

Introduction
This course introduces the functionality of the analytical reports of Acumatica ERP. In this course, you
will create a copy of an existing analytical report and modify this copy; you will also create your own
report from scratch.
The course also describes the forms of the Analytical Report Manager toolkit that are used for the
development of analytical reports.
The course can be useful for Acumatica ERP business consultants who are interested in the developing
of financial reports. The course is intended for advanced Acumatica ERP users familiar with user
interface and main principles of the system's work.
After you complete the course, you will understand how to develop analytical reports by using
Acumatica ERP and become familiar with best practices of this development.
We recommend that you follow the lessons in the order in which they are provided in the course,
because some lessons use the results of the previous ones.
| How to Use This Course | 6

How to Use This Course


This course is designed for Acumatica ERP 2017 R2. To complete the course, you will deploy an instance
of Acumatica ERP for training, complete the lessons of the course in the order in which they are
presented, and pass the assessment test. That is, you will perform the following steps:

1. Create a company with the I100 data preloaded on an instance of Acumatica ERP 2017 R2. (See
the instructions below.)

2. Start with the overview of analytical reports and the Analytical Report Manager (ARM) toolkit.

3. Become acquainted with the best practices of ARM report development and with the structure of
the I100 company, which you will work with in this course.

4. Complete Lessons 1 through 5.

5. Take the F350 Certification Test: Analytical Reports at Acumatica University.

Important: The I100 company data that you preloaded for the training course may include documents
and transactions for other training courses. Thus, the reference numbers of the general ledger batches
and documents that you will create while competing the course may differ from those shown in the
screenshots in the training guide.
After you pass the assessment test and complete the course survey, you will get the Acumatica
University certificate of course completion.

What Is in a Lesson?
The lessons outline the procedures you are completing and describe the related concepts you are
learning. At the end of some lessons, under the Related Links section, you can find links to more
information about the concepts and forms that are used in the lesson, and about the related concepts
that are outside of the scope of this course.

What Are the Documentation Resources?


All the links listed in the Related Links sections refer to the documentation available on the https://
help.acumatica.com/ website. These and other topics are also included in the Acumatica ERP instance,
and you can find them under the Help menu.

How to Create a Company with the Needed Data


To go through the course, you need to install Acumatica ERP 2017 R2 or later and deploy an instance
of Acumatica ERP. You will use a company with the I100 data preloaded. You can add a company with
the needed data during the deployment of a new Acumatica ERP instance or after the instance has been
deployed. Below are the instructions to add a company with the I100 data to an existing Acumatica ERP
instance:

1. Open the Acumatica ERP Configuration Wizard and click Perform Application Maintenance.

2. On the Application Maintenance page of the wizard, select the instance you have deployed, and
then click Company Maintenance.

3. The SQL Server Authentication dialog box opens. In the dialog box, specify the credentials for
connecting to the database server, and then click OK. The Company Setup page opens.

4. To create a new company, click New, and then in the Insert Data column, select the I100 data
to be preloaded (see the following screenshot).
If you are deploying a new instance, you perform this step during the Company Setup step of the
Acumatica ERP Configuration Wizard.
| How to Use This Course | 7

5. Click Next, and on the Confirm Configuration page, click Finish.

Figure: Selecting the data to be preloaded to the new company

The system will add a new company to the Acumatica ERP instance and preload the selected data. The
first login defined in the system is admin, and the password to sign in to the new company is setup;
you will then be asked to change the password as needed.
| Introduction to Acumatica ERP User Interface | 8

Introduction to Acumatica ERP User Interface


Acumatica ERP now offers two user interfaces:
• Modern, introduced in 2017 R2, which is now used by default
• Classic, which is the user interface used in previous Acumatica ERP versions
The following sections describe the main aspects of working with Acumatica ERP user interface when
you complete this training guide:
1. Completing the Training in Modern UI
2. Configuring the Quick Menu for the Training
3. Completing the Training in Classic UI
4. Navigating to Forms: Tips

1. Completing the Training in the Modern UI


For completing the training, we recommend that you use the modern user interface, which provides an
enhanced new look and easy navigation in the system. The following sections provide an overview of
the modern UI and explain how to navigate in the system during the completion of the training.
To Navigate to a Form from a Quick Menu
Forms in the modern UI are grouped by workspaces, which are shown on the main menu on the left
side of the screen. When you select a workspace, the system shows its Quick Menu, which has links to
the most commonly used forms and reports of the workspace (see the screenshot below), listed under
categories to further organize them. You can click a form name to navigate to it.

Figure: Navigating to a form from a Quick Menu

To View All Forms in a Workspace


To find any form of a workspace that is not shown on the Quick Menu, you can click the Quick Menu title
bar to switch to All Items mode. In this mode, you can see the links to all forms that are included in
the selected workspace (see the screenshot below).
| Introduction to Acumatica ERP User Interface | 9

Figure: Displaying all items of the Finance workspace

To Add Forms to a Quick Menu


To add a form that currently is not shown on a Quick Menu of a particular workspace, open the needed
workspace, and on the workspace title bar, click the Edit button (see the previous screenshot). In
Configuration mode, select the check boxes next to the needed forms, and then click Exit to apply
your changes and exit Configuration mode.
| Introduction to Acumatica ERP User Interface | 10

Figure: Adding forms to a Quick Menu

The full list of forms used during the completion of this training is provided below in this topic. We
recommend that you be sure all these forms have been added to the applicable quick menus, to
simplify navigation during the completion of the training.
To Review and Open Documents on Substitute Forms
Substitute forms provide a quick and easy way to review the list of records created on the applicable
data entry forms. A substitute form is a generic inquiry that shows the summary information on the
records entered on the particular entry form. Substitute forms are initially brought up instead of the
corresponding entry forms when a user navigates to these forms in the Quick Menu.
For example, if you click Journal Transactions (under the Transactions category) on the Quick Menu
of the Finance workspace, the system opens the Journal Transactions substitute form (GL3010PL),
which shows the list of all transactions in the system (see the screenshot below). The substitute form
may show tabs that filter the documents by their type or status.
To open the Journal Transactions entry form (GL301000) for entering a new batch of transactions from
the Journal Transactions substitute form (GL3010PL), you need to click Add New Record button on the
form toolbar.
| Introduction to Acumatica ERP User Interface | 11

Figure: Viewing the Journal Transactions substitute form

If the training instructions ask you to open a particular document (such as a batch, an Accounts Payable
bill, or an Accounts Receivable invoice), you can find this document on the appropriate substitute form
and then click its reference number link to open this document on the data entry form. Alternatively,
you can open the data entry form itself, select the module or document type (depending on the form),
and in the Reference Nbr. box, click the selector icon and select the document by its reference
number (see the screenshot below).

Figure: Opening a document by its reference number

2. Configuring the Quick Menu for the Training


Before you start to complete the training, make sure the needed menu items (listed below along with
the categories of the workspace they should be listed under) are shown in the Quick Menus of the
| Introduction to Acumatica ERP User Interface | 12

corresponding workspaces and add the forms that are not shown. This will help you access the forms
quickly. The following items should be included in the Quick Menu of the corresponding workspaces:
All new analytical reports that you will create in this training will be placed in the Financial Statements
group in the Finance workspace. We recommend to add each newly configured report to the Quick Menu
as well.

• Finance workspace:

• Profiles > Chart of Accounts

• Preferences > Financial Year

• Preferences > Inter-Branch Account Mapping

• Preferences > Account Classes

• Preferences > Report Definitions

• Preferences > Row Sets

• Preferences > Column Sets

• Preferences > Unit Sets

• Receivables workspace:

• Transactions > Invoices and Memos

• Customization workspace:

• Profiles > Site Map

3. Completing the Training in the Classic UI


The following sections provide a quick overview of the classic UI and explain how to navigate in the
system during the completion of the training.
To Switch Back to the Classic UI
When you have created a new company and signed in to it, the modern user interface is enabled by
default. If you need to switch back to the classic UI, do the following:

1. In the top right corner, click the name of the current user, and click My Profile, as shown in the
following screenshot.

Figure: Opening the user profile

2. On the User Profile form (SM203010), which opens, select the Show Classic UI by Default
check box, and save your changes.
| Introduction to Acumatica ERP User Interface | 13

To switch back to the modern UI, again click the name of the current user in the top right corner and click
Switch to Modern UI in the menu (see the screenshot below).

Figure: Switching to the modern UI

To Navigate to Forms in the Classic UI


To help learners to search for particular forms during the training completion in the classic UI, the paths
to forms in this training guide are based on the classic UI. The main menu, at the top of the screen,
shows suites and the modules of the selected suite. The navigation pane, located on the left side of the
screen, shows the forms of the modules grouped by their functions. The path to a particular form is
specified as follows in the training:
Form Title (Form ID; Suite > Module > Tab > Node)
For example, the form with the following path is shown in the screenshot below:
General Ledger Preferences form (GL102000; Finance > General Ledger > Configuration > Setup)

Figure: General Ledger Preferences form in the classic UI

4. Navigating to Forms: Tips


The following tips apply to the modern and classic user interfaces and will help you to quickly find and
open any form.
How To Search for a Form by Its Title or ID
At any time, you can quickly search for a particular form by typing its title or ID in the Search box:
| Introduction to Acumatica ERP User Interface | 14

• In the modern UI, type the text in the Search box on the top of the screen (see the following
screenshot). The system shows the search results in the Search window, which opens when you
start typing the text in the Search box. Then on the Menu Items tab of the Search window, you
click the link to open the needed form.

Figure: Searching for a form by title in the modern UI

• In the classic UI, type the text in the Search box at the top of the navigation pane (see the
following screenshot). To navigate to the needed form, click it in the drop-down list with the
search results.

Figure: Searching for a form by its title in the classic UI

How To Navigate to Forms by Using the Form ID


In the training guide, each form is referred to by its ID. If you are not sure in which area a particular
form is located, instead of searching for the form, you can simply open it by using its form ID. You can
do this in both the modern UI and the classic UI as follows:
| Introduction to Acumatica ERP User Interface | 15

1. In the browser's address bar, change the form ID of the currently opened form to the form ID of
the needed form (see the screenshot below).

Figure: Entering the form ID

2. Press Enter. The system navigates to the form.


Related Links
Modern Acumatica ERP User Interface
Classic Acumatica ERP Interface
Managing Substitutes of Entry Forms
| Overview of Analytical Reports | 16

Overview of Analytical Reports


Analytical reports are a specific type of reports that you can construct in Acumatica ERP by using the
Analytical Report Manager toolkit. Reports that are constructed with this toolkit are called ARM reports
to distinguish them from the reports created in the Acumatica Report Designer.
For more information on developing reports with Report Designer, see the S130 Reporting: Inquiry, Report
Writing, Dashboards course at Acumatica University.

The Analytical Report Manager toolkit is specially designed for the creation of financial reports that
retrieve the amounts posted to particular general ledger accounts and subaccounts. You can use the
ARM toolkit rather than Report Designer to create the following types of reports:
• Financial reports that display data that is posted to the general ledger accounts and accumulated
in the General Ledger module
The system gets the data of the general ledger accounts from the GLHistory table of the database.
The transaction data is added to the table when the transactions are posted.

• Project accounting reports display data that is accumulated in the Project module
The ARM toolkit is a set of web-based tools, which are provided with Acumatica ERP. You need no
programming skills to use this toolkit for modifying existing financial reports and developing new ones,
such as Balance sheet and Income statement. You also need no knowledge about the structure of the
Acumatica ERP database to use the toolkit.
There are several predefined ARM reports in the Finance workspace of Acumatica ERP, such as:
• Balance Sheet
• Profit and Loss (income statement)
• Cash Flow
An ARM report consists of the following elements:
• The row set, which defines the rows to be used in the report.
• The column set, which defines the report title, the column headers, and the columns of the report.
• The report definition, which identifies this particular report. The report definition links together the
row set and the column set of the report and defines the report parameters. By using the report
definition, you can easily add the report to the site map.
• Optionally, the unit set, which defines the units to be used for the report. With units, the user can
quickly filter or consolidate the report data.
You can use each row set, column set, or unit set in one report definition or multiple definitions.
You can modify the predefined ARM reports and create new ones. To modify an existing report, we
recommend that you create a copy of the predefined report and modify this copy. To create an ARM
report from scratch, you have to perform the following steps:
• Create a row set.
• Create a column set.
• Optional: Create a unit set.
• Create a report definition, which uses the row set, the column set, and the unit set.
Further topics of this chapter briefly describe the tools of the Analytical Report Manager that are used to
perform these steps.
Related Links
Analytical Report Manager Overview
| Row Sets | 17

Row Sets
A row set defines the rows to be used in a report. You can create a row set on the Row Sets form
(CS206010), which is shown in the screenshot below.

Figure: The Row Sets form

In the summary area of the form, you should specify the Code, the Description, and the Type of the
data source. You can select the GL type to display in your report accounting data of the General Ledger
module, or the PM type to display data of the Project module.
In the table at the bottom of the form, you can add rows of the row set.
The order of rows in a row set depends on the values you specify in the Code column in the table. The
lower the code of a row, the higher the row will be listed in the row set. If you don't specify any sorting
conditions for the row set, the rows will be printed in the report in the order in which they are listed in
the row set.
You can renumber all rows of a row set if the code of the topmost row is an integer value. To renumber
all rows, click the Renumber button on the table toolbar. In the dialog box, which opens, specify the
number to be omitted after each row code in the Numbering Step box, and specify the length of codes
in the Length box. When you confirm renumbering by clicking the Renumber button of the dialog box,
the system will take the code of the topmost row, correct its length according to the specified Length,
and sequentially renumber each next row by adding the specified Numbering Step to the previous
row. The codes that are used in the Linked Row, the Base Row, and formulas of the row set will be
changed appropriately.
In the Description column, you can specify the description of the row to be printed in the report or the
description of a helper row (for example, the annotation of a sorting condition).
To print the descriptions in the report, you also have to include the description column in the column set.

In the Type column, you specify which type of data will be displayed in the particular row. You can
select one of the following row types:
• GL: A row of this type contains accounting data that satisfies the filtering conditions specified in
the Data Source column of the row.
• Caption: A row of this type is used to print in the report the text specified in the Description
column of the row. With no description, the row of this type is printed as an empty line, which can
be used to add space between groups of rows in the report.
| Row Sets | 18

• Line: A row of this type is printed in the report as a line. With these lines, you can improve the
report readability and visually segregate groups of lines printed in the report. You can specify the
line style in the Line Style column of the row and the thickness of the row in the Height column.
• Total: A row of this type is used when the Value column of the row contains a formula to
calculate a sum or another calculated value.
• Header: A row of this type contains the report header—that is, all lines of the report title and the
column headers, which are specified in the column set, are printed in this row.
• Sort: A row of this type contains the sorting conditions of some report rows in the Value column.
A row of this type is not printed in the report; instead, it affects the order of the data printed in
the report.
In the Value column, for rows of the Total type, you enter the formula that calculates a sum or another
calculated value. For rows of the Sort type, you specify the sorting conditions. For more information on
formulas, see the Related Links section of this topic.
The Format column of the row defines the format of the values printed in the row; this setting prevails
over the format specifier of the column. For more information on format specifiers, see the Related
Links section.
For rows of the GL type, you use the Data Source attribute to define the filtering conditions for data
selection. You can find examples of using the data source in the Data Sources topic and further in the
course.
In the Style column, you can specify the style of the row when it is printed in the report; this setting
prevails over the style specifier of the column.
You can select the check box in the Page Break column to start a new page of the report. The next
row after the row with this check box selected will be printed on a new page. The report title and the
column headers will be printed at the top of this new page automatically.
In the Height column, you can specify the row height.
In the Indent column, you can specify indentation for the row.
If the Suppress Empty check box is selected for a row of the GL or Total type and the row has no
values to print, it won't be printed in the report.
If the Hide Zero check box is selected for the row, an empty value will be printed in this report line
instead of a zero, if applicable.
You can use linked rows when some rows of the report should be printed depending on whether a
particular row is printed. If the linked row isn't printed in the report, all the rows with the code of the
linked row in the Linked Row column won't be printed in the report either.
In the Base Row column, you can specify the base row for the row to use the code or the value of
this base row in formulas. You can retrieve the code of the base row by using the @BaseRowCode
parameter, or the value of this base row by using the Value(row, column) function. You can find an
example of using this attribute to calculate the percentage as the value of the row relative to the value
of the base row in Lesson 1: Creating a Copy of the Default Report.
You can use the Column Group attribute of the row to print the values of this row in only the particular
report columns. You can find details on using this attribute in Lesson 5 (Optional): Eliminating Inter-
Branch Balances in Reports.
You can use the Unit Group attribute of the row to print this row for only the particular report units.
For more information about the form, see the Related Links section.
Related Links
Row Sets (CS206010)
Row Attributes
Data Source
Cell Formatting
Formulas
| Column Sets | 19

Column Sets
A column set defines the report title, the column headers, and the columns of the report. You can
create a column set on the Column Sets form (CS206020), which is shown in the screenshot below.

Figure: A column set on the Column Sets form

In the summary area of the form, you should specify the Code, the Description, and the Type of the
data source.
In the upper table of the form (item 1 in the screenshot above), you can define the report title, the
column headers, and all the data that should be printed on every report page. In the lower table (item
2), you can add the report columns and define column attributes.

You click in the toolbar of the upper table to add a line to the upper table—that is, to the report
header. The added line is the bottom line of the upper table. You can move a selected line of the upper
table up and down by clicking the appropriate arrow buttons on the toolbar of the upper table.

You click in the toolbar of the lower table to add a column to far right of both the upper and the
lower tables. In each table, you can move a selected column to the left and to the right by clicking the
| Column Sets | 20

appropriate arrow buttons on the table toolbar. The columns are moved in each table independently
from the columns in the other table of the form.
You can also move a column in either table by dragging its header to the needed position.
The Type attribute of the columns (shown in the lower table) specifies what data will be displayed in a
particular column. You can select one of the following row types:
• GL: A column of this type contains the data of the row set that also satisfies the filtering
conditions of the Data Source attribute of the column. The filtering conditions of rows of the GL
type and the filtering conditions of the column are applied simultaneously. You can find examples
of using the data source in the Data Sources topic and further in the course.
• Calc: A column of this type is used to calculate values with the formula that is specified in the
Value attribute.
• Descr: A column of this type displays the text of the Description attribute of the report row set.
You can also display the row description by using a formula with the @RowText parameter in a
column of the Calc type as follows: =@RowText.

The Value attribute is used for columns of the Calc type to define the formula that calculates a sum or
another calculated value. For more information on formulas, see the Related Links section.
You can round the values of a report column by specifying the Rounding attribute of the column. For
example, suppose that the value of one of the column cells is 1,234,567,891.23. You can select one of
the following types of rounding for the column and get the result shown:
• No Rounding: 1,234,567,891.23
• Whole Dollars: 1,234,567,891
• Thousands: 1,234,567.9
• Whole Thousands: 1,234,568
• Millions: 1,234.6
• Whole Millions: 1,235
• Billions: 1.2
• Whole Billions: 1
The Format attribute of the column defines the format of the values printed in the column; the format
specifier of the row prevails over this setting. For more information on format specifiers that you can
use for this attribute, see the Related Links section.
You can use the Printing Group attribute of report columns to specify the conditional printing of rows
in the particular columns. You can find details on using this attribute in Lesson 5 (Optional): Eliminating
Inter-Branch Balances in Reports.
You can use the Unit Group attribute of the column to print this column for only the particular report
units. You can find an example of using this attribute in Lesson 3: Filtering Data in Reports by Using
Unit Sets.
The Style attribute of the column defines the font style of each column printed in the report. To specify
the style of the report header and the column headers, in the upper table, you should specify the style
of each cell in the Formula Editor dialog box, which opens when you click the magnifier icon in the
selected cell. The style specifier of the row prevails over this setting.
The Data Source attribute is used for columns of the GL type to define the filtering conditions for
data selection. For a cell at the intersection of a row of the GL type and a column of the GL type, both
the filtering conditions of the row and the filtering conditions of the column are applied. For more
information on using the data source, see the Related Links section.
For more information about the form, see the Related Links section.
Related Links
Column Sets (CS206020)
Column Attributes
| Column Sets | 21

Data Source
Cell Formatting
Formulas
| Report Definitions | 22

Report Definitions
A report definition links together the row set and the column set of the report and defines the report
parameters. You can also use the report definition to add the report to the site map. You can create a
report definition on the Report Definitions form (CS206000).

Figure: The Profit and Loss report configured on the Report Definitions form

In the Report Definition section of this form (item 1 in the screenshot above), you can specify the row
set, the column set and the unit set; you also specify the following main settings of the report:
• Code: The report definition identifier, which can be up to 10 alphanumeric characters. You can
find advice on the naming convention in Best Practices topic.
• Description: The report description. We recommend that you specify a report description that
matches the title of the report in the site map (see the description of the Title setting below).
This will help you find the report definition when you are selecting it in the Code box.
• Type: The data source of the analytical report. You can select one of the following options:
• GL: The General Ledger module is used as the data source.
• PM: The Projects module is used as the data source.
In the Default Data Source Settings section (item 2), you can specify report parameters and their
default values. By using these parameters, the user can filter the report data. If you select the Request
check box to the right of any parameter, this parameter will appear on the Report Parameters tab of
the report form, and the user will have to provide a value for this parameter to run the report.
| Report Definitions | 23

In the Site Map section (item 3), you can select the Location of the report in the site map and specify
the report Title. You must specify these settings to make the report available in the site map
In the Page Settings section (item 3), you can specify the paper size and orientation.
In the remaining sections of the form, you can define the margins, print area, and default font style, all
of which determine how the text in the report will be formatted and printed.
To preview the report, on the form toolbar, you can click Preview.
For more information on report definitions, see the Related Links section.
The following screenshot shows a final report, which is affected by the settings specified during report
configuration as follows:
• Item 1 on the screenshot: The report title, which is specified in the upper table of the Column
Sets form (CS206020).
• Item 2: The column headers, which are specified in the upper table of the Column Sets form
(CS206020).
• Item 3: Report columns, which are specified in the lower table of the Column Sets form
(CS206020). Lines of these columns are the report rows, which are specified on the Row Sets
form (CS206010).
• Item 4: The descriptions of rows, which are specified on the Row Sets form (CS206010) for each
row, and printed in a column for which the Descr type is specified in the lower table of the Column
Sets form (CS206020).

Figure: The Profit & Loss report (GL635000)

Related Links
Report Definitions (CS206000)
Printing Style
Reports
| Unit Sets | 24

Unit Sets
A unit set defines the units that the user can use directly on the report to quickly filter or consolidate
the report data. You can create a unit set on the Unit Sets form (CS206030).

Figure: A unit set configured on the Unit Sets form

In the summary area of the form, you should specify the Code, the Description, and the Type of the
data source.
On the Unit Sets form (CS206030) and in the report, the units are organized in a hierarchical structure
and ordered by unit code. On the left pane of the Unit Sets form (CS206030), this hierarchical structure
is reflected (item 1 in the screenshot above). You can select a unit in the left pane, and add child units
to it in the right pane (item 2). In the report, the descriptions of units are shown.
The topmost unit is applied to the report by default when you run the report. You can select any unit to
be applied to the report by default by selecting this unit in the Start Unit box on the Report Definition
form (CS206000).
Although you can have an unlimited number of units in a unit set, keep in mind that having too many
units can significantly slow down the report performance, because the system generates the report
corresponding to every single unit defined for the report when you run the report.
For every unit, you can specify either the formula (in the Value column) or the Data Source to define
the data processing rules for the report. These attributes are described in greater detail in Lesson 3:
Filtering Data in Reports by Using Unit Sets.
You can print particular columns and rows in some units and hide those columns and rows for other
units. In the Printing Group of a unit, you can specify a custom code that can be up to 10 symbols in
length (only numbers and letters are allowed in the code). Then you can specify this code as the Unit
Group of the rows and the Unit Group of the columns to be printed for only that unit. These rows and
columns will be hidden for other units.
For more information about the form, see the Related Links section.
Related Links
Unit Sets (CS206030)
Unit Attributes
| Data Sources | 25

Data Sources
For each analytical report, to retrieve the amounts posted to particular general ledger accounts and
subaccounts, you select the GL type for the row or column. In the Data Source attribute of the row or
column, you click the magnifier icon to brings up the dialog box, as shown in the screenshot below.

Figure: The Data Source dialog box

In this dialog box, you can specify the conditions under which the amounts should be retrieved and
select the amount type, such as the ending balance or turnover. In the dialog box, you can specify the
following conditions:
• A ledger
• An account class
• An account (in the Start Account box) or range of accounts (in the Start Account and End
Account boxes)
• A range of non-segmented accounts (by using a mask in the Start Account box)
• A subaccount (in the Start Sub. box) or range of subaccounts (in the Start Sub. and End Sub.
boxes)
• A range of non-segmented subaccounts (by using a mask in the Start Sub. box)
• A branch (in the Start Branch box) or range of branches (in the Start Branch and End
Branches boxes)
• A financial period (in the Start Period box) or range of financial periods (in the Start Period and
End Period boxes)
• A shift of the financial period by year or period (in the Offset box)
• An amount type
Also, for a row, in the Expand box of the data source, you can also select the expansion mode by
account or subaccount—that is, whether the row should be displayed as multiple rows, each of which
correspond to one account or subaccount from the specified range. If you use expansion of a row, in the
Row Description field, you can select the source of the row description that will be displayed for each
line of the expanded set.
For more information on using the data source, see the Related Links section of this topic.
Related Links
Data Source
| Best Practices | 26

Best Practices
We recommend that you heed the following pieces of advice when you are developing an Analytical
Report Manager (ARM) report:
• Develop naming conventions so that you can easily identify report definitions, row sets, and
columns sets that are used together in the same reports. If you have multiple column sets that
are used with the same row set in different report definitions, you can name the column sets with
a prefix that helps you identify the row set with which the column set is used.
For example, in the lessons of this course, the names (codes) of the report definition, the row set,
and the column set of each report are similar.
The codes of all the predefined reports—report definitions, column sets, row sets, and unit sets
—start with D. In the I100 company that is used in this course, the codes of the custom reports
start with C. For your reports, we recommend that you start the codes from any character except
D.
• Specify a report description that matches the report title.
On the Report Definition form (CS206000), specify a Description that matches the Title of the
report in the Site Map area. This will help you find the report when you select its definition by the
code.
• If you want to modify a default report, create a copy of it, including the row set and the column
set, and modify the copy.
• While you are modifying the report, save each portion of your changes to the row set or the
column set regularly. For example, save the row set after you have added each new row. Further
in this course, we won't be providing steps advising you to save your changes to keep the
instructions simple.
• Execute your report regularly to review the changes you have made. That will ease a
troubleshooting, if the set of changes isn't very big. Further in this course, we won't be providing
steps advising you to review your changes to keep the instructions simple.
• When you are creating a report, reserve row codes—that is, omit a particular number after each
row code. For example, if the code of the first row of your row set is 0010, omit the numbers
0011 through 0019 and add the next row with the 0020 code. Similarly omit the numbers 0021
through 0029 and use the 0030 code for the next row, and so on.
The order of rows in a row set depends on their codes. If you don't specify any sorting conditions
for the row set, the rows are printed in the report in the order in which they are listed in the row
set.
Reserving row codes gives you the ability to add new rows between existing ones. For example, if
you decide to expand a row of an existing report, you will be able to add a subtotal after this row.
• Keep all rows with sorting conditions together in the row set.
The location of sorting rows in the row set doesn't affect sorting conditions. We recommend that
you add the sorting conditions to the end of the row set and keep all conditions listed together for
easier maintenance of the row set.
• Save parameters as a template to run a report quickly.
To run a report quickly (for example, for test scenarios), you can specify the report parameters on
the report form and then save them as a default report template. Because you have created the
default template, you can just open the report and then run it immediately without specifying all
the report parameters. You can use templates for test scenarios as well as for other routine tasks.
You can also specify default values of the report parameters in the report definition. If you do,
remember to clear these default values when you finish developing the report.
• Use account classes to aggregate the data of some accounts instead of using complicated masks.
| Best Practices | 27

Selecting accounts by account classes is a flexible approach that is also easy to use and maintain.
Moreover, the selection of data by account classes works relatively faster than selection by
account-subaccount ranges specified in the data source.
When you define the chart of accounts, you can simultaneously define the account classes for
further use in the analytical reports. To select a set of some accounts in the data source of a
report row or a report column, you can create an account class and assign this class to the
needed accounts. You can define any number of custom account classes, if needed.
For more information about account classes, see the Related Links section.
• Use appropriate formulas for the analytical reports if the sign of the trial balance is reversed.
The Sign of the Trial Balance option, which you can specify on the General Ledger Preferences
form (GL102000), defines how the trial balance is displayed on reports and inquiries:
• If the sign of the trial balance is normal, the credit balances for liability and income accounts
are displayed with the plus sign so that the following equation takes place:
Assets + Expenses = Liabilities + Income
• If the sign of the trial balance is reversed, the credit balances for liability and income
accounts are displayed with the minus sign so that the following equation is correct:
Assets + Expenses + Liabilities + Income = 0
YTD Net Income is excluded from these equations.
However, the reversed sign of the trial balance doesn't affect analytical reports, because analytical
reports don't consider the type of accounts. That is, the second equation isn't correct for
analytical reports, which always show the credit balance of liabilities and incomes with the positive
sign.
• Use uppercase references to the codes of rows and units in formulas.
The codes of rows in row sets and units in unit sets can be up to 10 alphanumeric characters. The
letters of codes are always uppercase. It's very important to use the appropriate letter case of
codes in formulas. For example, the expression =@RowCode1+@RowCode2 returns an exception
because lowercase letters are specified in the codes.
In formulas, you have also to precede a row code and a unit code with the @ character, such as
=@UNITCODE1+@UNITCODE2. However, you shouldn't use the @ character with a row code or a
unit code in functions. Thus, for example, you would use =Sum('ROWCODE01', 'ROWCODE10')
rather then =Sum(@ROWCODE01, @ROWCODE10).
• Be careful when you delete columns on the Column Sets form (CS206020). To delete a column, in
the lower table, select the column and click the Delete button in the table toolbar (item 3 in the
screenshot below). The column will be deleted in both the upper and the lower tables. To delete
any row of the report header, in the upper table, select the row and click the Delete Row button
in the table toolbar (item 2). The Delete button in the form toolbar (item 1) is used to delete the
entire column set.
| Best Practices | 28

Figure: Deleting rows on the Column Sets form

Related Links
Account Classes (GL202000)
Column Sets (CS206020)
Row Sets (CS206010)
| Lesson 1: Creating a Copy of the Default Report | 29

Lesson 1: Creating a Copy of the Default Report


To build your own report, you create a report from scratch or you can create a copy of a predefined
report and modify the copy as needed.
In this lesson, you will create a copy of the Profit & Loss report (GL635000) and modify this copy to
present actual balances that are compared to the budget. You will go through the whole process of
modifying the analytical report to understand the report structure and the basic principles of working
with analytical reports.
During the lesson, you will be encouraged to do practice exercises.

Lesson Objectives
In this lesson, you will learn how to do the following:

• Make a copy of an analytical report

• Configure report rows

• Configure report columns

• Use aggregation by mask for non-segmented accounts

• Create totals for report rows

• Sort data of report rows

• Configure the visibility of report rows depending on visibility of the particular row

• Modify the report header and the column headers

• Calculate a percentage as a comparison of values of two particular rows

• Calculate a percentage as a comparison of values of two particular columns for each row
| Company Overview | 30

Company Overview
In this course, you will develop Analytical Report Manager (ARM) reports for two related companies:
Software Inc. and Computers Inc. The companies are separate legal entities managed by a parent
company, which is outside of the scope of this course. Both companies are located in the United States.
The Software company has one office, and the Computers company has two offices, eastern and
western. The image below illustrates the organizational structure of the companies.

Figure: The organization structure of the companies

The following branches represent the companies in the system:


• The SOFT branch represents Software Inc.
• The EAST represents the eastern office of Computers Inc.
• The WEST branch represents the western office of Computers Inc.
The parent company wasn't configured for use in the course. For more information on the company's
structure, see the F200 Financials: Intermediate course at Acumatica University.
| Step 1.1: Creating a Copy of the Report | 31

Step 1.1: Creating a Copy of the Report


Each analytical report consists of the report definition, the row set, the column set, and optionally the
unit set. Thus, making a copy of a report entails copying all these objects.
To create a copy of the Profit & Loss report (GL635000), you should copy its report definition, row set,
and column set. (This report does not have a unit set.) Do the following:
1. To find the code of the report definition, do the following:
a. On the Site Map form (SM200520; System > Customization > Manage), in the left
pane, open the following node: Company > Finance > General Ledger > Reports >
Financial Statements.
b. In the table in the right pane, find the report whose ScreenID is GL.63.50.00 and Title
is Profit & Loss (see the following screenshot).
The Url of the report, ~/Frames/RMLauncher.aspx?ID=DPL.rpx, contains the report
identifier DPL.rpx at the end. Here, DPL is the code of the report definition.

Figure: The report definition code

2. On the Report Definitions form (CS206000; Finance > General Ledger > Configuration >
Analytical Reports), open the DPL the report definition. You can find the code of the row set of
the report in the Row Set box, and the code of the column set of the report in the Column Set
box. They are CPL and DPLP, respectively.
You can omit Step 1 and open the report definition directly from the corresponding analytical
report form, if the ReportDesigner role is assigned to your user. If you were to do that, you would
click Edit Report on the report form toolbar, and the report Report Definitions form (CS206000)
with the definition of the report would open in a new browser tab.

3. To copy the row set of the report, do the following:


a. On the Row Sets form (CS206010; Finance > General Ledger > Configuration > Analytical
Reports), open the CPL row set.
b. On the form toolbar, click Copy Row Set.
c. In the New Row Set Code dialog box, which appears, specify MYPL as the New Code,
and click Copy.
d. In the Description box, type My P&L.
e. Save the row set you have created.
We recommend that you save your changes quite often even when there are no steps in
the lessons instructing you to do so.
| Step 1.1: Creating a Copy of the Report | 32

4. To copy the column set of the report, do the following:


a. On the Column Set form (CS206020; Finance > General Ledger > Configuration >
Analytical Reports), open the DPLP column set.
b. On the form toolbar, click Copy Column Set.
c. In the New Column Set Code dialog box, which appears, type MYPL as the New Code,
and click Copy.
d. In the Description box, type My Actual vs Budget.
e. Save the column set you have created.
5. To copy the report definition of the report, do the following:
a. On the Report Definitions form (CS206000; Finance > General Ledger > Configuration >
Analytical Reports), open the DPL report definition.
b. On the form toolbar, click Copy Report.
c. In the New Report Code dialog box, which appears, specify MYPL as the code, and click
Copy. This closes the dialog box; you are now working with the copied version of the
report with the MYPL code.
d. In the Report Definition section, change the settings of the report as follows (see the
screenshot below):
• Description: My P&L: Actual vs Budget
• Row Set: MYPL
• Column Set: MYPL
e. In the Site Map section, specify the following settings to add your report to the site map:
• Location: Company > Finance > General Ledger > Reports > Financial Statements
• Title: My P&L: Actual vs Budget

Figure: The definition of the My P&L: Actual vs Budget report

f. Save the report definition you have created.


g. Add the newly created report to the Quick Menu of the Finance workspace.
6. Navigate to the My P&L: Actual vs Budget report (Finance > General Ledger > Reports >
Financial Statements). Select ACTUALSOFT as the Ledger, select 12-2013 as the Financial
Period, and run the report to review it.
You may need to refresh the browser page to cause the newly created report to appear in the site
map (in the classic UI) or in the Finance workspace (in the Modern UI).
| Step 1.1: Creating a Copy of the Report | 33

You have created a report as a copy of an existing report and verified that the new report is available in
the navigation pane. In the next step, you will modify the row set of the new report.
| Step 1.2: Editing the Row Set | 34

Step 1.2: Editing the Row Set


A row set defines the rows with row descriptions for the report. In this step, you will modify the rows of
the report you created earlier as follows:
• Expand the report line Salaries by subaccounts, and show the descriptions of the expanded
subaccounts.
• Create a subtotal for the Salaries row.
• Expand the report line Services and Utilities by accounts, and show the descriptions and codes of
the expanded accounts.
To modify the row set, do the following:
1. Open the My P&L: Actual vs Budget report (Finance > General Ledger > Reports > Financial
Statements), select ACTUALSOFT as the Ledger, select 12-2013 as the Financial Period, and
run the report.
To run the report quickly at the next time (for example, for tests), you can specify the report
parameters on the report form and then save them as a default report template.

Notice that the Salaries row is displayed as a single summary row.


2. Click the link in the Salaries row to review the details of salaries by department. Suppose that
you have been asked to display salary rows by department in the report, and that departments
correspond to the particular subaccounts to which the expenses are recorded. You can satisfy
this requirement by configuring the row to expand automatically.
3. On the Row Sets form (CS206010; Finance > General Ledger > Configuration > Analytical
Reports), open the MYPL row set.
4. To expand the report line Salaries by subaccount, do the following (see the screenshot below):
a. Double-click the Data Source column of the row with the Salaries description, and click
the magnifier icon to bring up the dialog box for configuring the data source.
b. In the Expand box, select Sub to expand the row by subaccounts.
c. In the Row Description box, select Description to show descriptions of subaccounts in
the report.

Figure: Report line expanded by subaccounts

d. Click OK and then press Ctrl+Enter to close the dialog box and apply your changes to the
data source.
| Step 1.2: Editing the Row Set | 35

e. Change the value of the Indent column of the Salaries row to 20 to increase the row
indentation.
f. Save your changes.
If you were run the report, you would notice that salary amounts expanded by
subaccount are sorted in descending order and aren't grouped. This happens due to the
sorting conditions of the report, which you will improve further in Instruction 6 of this
lesson.
5. To create a subtotal for the expanded rows, do the following (see the screenshot below):
a. On the table toolbar, click Add Row, and specify the following settings for the row to
show the subtotal of the expanded rows:
• Code: 0302
• Description: Total Salaries
• Type: Total
• Value: =@0300
• Style > Bold: Selected
• Indent: 10
• Suppress Empty: Selected
• Base Row: 0400
The order of rows in which the system puts them when you save a row set depends on
the values of the Code column. You have specified the 0302 code for the Total Salaries
row to position the total row after the list of salary details (the Salaries row with the 0300
code).
Based on the Total row type and the expression specified in the Value column, the sum
of values of the Salaries row is shown in this row.
In formulas, you have to precede a row code with the @ character, as in the following
formula: =@0301+@0302+@0303. However, you shouldn't use the @ character with a row
code in functions, so it would be correct to use =Sum('0301', '0303').
Based on the selection of the Suppress Empty check box, the empty row, which has no
values to print, won't be printed in the report.
You will use the value you specified in the Base Row in Instruction 6 of this lesson.
b. Add a row with the following settings to show a line that separates the expanded rows
from the subtotal:
• Code: 0301
• Type: Line
• Height: 2
• Line Style: Solid
• Linked Row: 0302
You have specified a smaller code for this row to insert the row above the subtotal.
Based on the value you specified in the Linked Row column, if the row with the 0302
code isn't printed in the report, this row won't be printed in the report either.
c. Add a row with the following settings to show an empty row between the expanded rows
with the subtotal and the rows with other expenses:
• Code: 0303
• Type: Caption
• Height: 10
| Step 1.2: Editing the Row Set | 36

• Linked Row: 0302


Based on the type you specified for the row, the row is ordinary text. You also specified
no value for the row—thus, an empty row is shown after the subtotal in the report.
Note that you shouldn't review and modify the formula of the 0400 total row, which uses
the Sum() function, although the subtotal row is in the range of rows of the formula. This
is because the Sum() function doesn't use the rows with the Total type.

Figure: Configured new lines

d. Save your changes.


6. To modify the sorting conditions of the report, do the following:
a. In the row with the 0910 code, modify the expression of the Value column to the
following: =SortD('0305','0345','B'). Save your changes.
The SortD() function sorts the values in the specified range of rows—which in this case
starts at 0305, thus excluding rows 0300 through 0304 (the salary rows and the subtotal
row) from the sorting conditions—in the specified column in descending order. You have
specified a range of rows by using the first two attributes of the function, and a column of
the column set of the report by using the third attribute.
You can sort values in ascending order similarly by using the Sort() function instead of
SortD().

b. Add a new row with the following settings to sort the values of the Salaries row:
• Code: 0901
• Description: Sorting salaries
• Type: Sort
• Value: =SORTD('0300','0300','B')
The location of the rows of the Sort type in the row set doesn't affect the sorting
conditions.

c. Save your changes to the row set.


7. Open the My P&L: Actual vs Budget report (Finance > General Ledger > Reports > Financial
Statements). Select ACTUALSOFT as the Ledger, select 12-2013 as the Financial Period, and
run the report.
Review all the changes you have made. Notice that the Services and Utilities row is displayed as
a single summary row.
If you are keeping the report open in another tab, you should reopen the report to view the results
of the modifications you have made.
| Step 1.2: Editing the Row Set | 37

8. Click the link in the Services and Utilities row to review the details of expenses by accounts.
Suppose that you have been asked to display services and utilities rows by the type of expenses
in the report. The types of expenses correspond to the particular accounts to which the expenses
are recorded. You can satisfy this requirement by configuring the row to expand automatically.
9. To expand the report line Services and Utilities by account, do the following:
a. On the Row Sets form (CS206010), open the MYPL row set.
b. In the row with the Services and Utilities description, double-click the Data Source
column and click the magnifier icon to bring up the dialog box for configuring the data
source.
The data source defines the data filtering criteria, which the system applies to select the
data to be used in the report. Notice that the filtering criterion of the data source of the
Services and Utilities row is the EXSERVICE account class. That is, the data on accounts
of this class (see the screenshot below) is aggregated and presented in a single line in the
report.

Figure: Accounts of the EXSERVICE account class

Filtering the data by using the account class is quite convenient, but you can filter
the data in other ways. You can specify the range of the accounts by using one of the
following ways:
• Specify the range of accounts by the start account and the end account—that is,
select 740000 as the Start Account and 758000 as the End Account.
This range includes all the accounts between 740000 and 758000, and returns the
following accounts: 740000, 745000, 755000, and 758000.
• List all the accounts explicitly in the Start Account box separated by the comma as
follows: 740000,745000,755000,758000.
• Specify the range of accounts by using the colon in a mask in the Start Account
box, such as 740000:758000.
The range 740000:758000 includes all the accounts between 740000 and 758000.
This range returns the following accounts: 740000, 745000, 755000, 758000.
• Use the ? expanded wildcard character in a mask in the Start Account box as
follows: 74?000,75?000.
The ? wildcard character gives you the ability to match all possible options with any
single character in the specific position where the ? character is. For example, the
range 74?000,75?000 includes all the accounts starting with 74 and ending with
000 with a single character between them, and all the accounts starting with 75
| Step 1.2: Editing the Row Set | 38

and ending with 000 with a single character between them. This range returns the
following accounts: 740000, 745000, 755000, and 758000.
The range 7??000 includes all accounts starting with 7 and ending with 000 with
two characters between them. This range returns the following accounts: 740000,
745000, 755000, 758000, 760000, 770000, and 790000.
You can combine the ",", ":", and "?" characters to create complicated masks.
You can use masks for only non-segmented accounts, such as those as in the
configuration of the I100 company, or subaccounts. For example, in the I100
company, subaccounts are segmented, so you cannot specify a range of subaccounts,
such as CON??CA:CON??LA.
You can also use a mask for only subaccounts with the Unicode edit mask. The other
edit masks do not allow you to use special characters such as ,, :, or ?.

c. Clear the Account Class box.


d. In the Start Account box, type 74?000,75?000.
You have specified this mask instead of the account class for training purposes only. With
the current chart of accounts, results will be the same.
e. In the Expand box, select Account to expand the row by accounts.
f. In the Row Description box, select Description-Code to show the descriptions and codes
of accounts.
g. Click OK and then press Ctrl+Enter to close the dialog box and apply your changes to the
data source.
10. Save your changes to the row set.
11. Open the My P&L: Actual vs Budget report (Finance > General Ledger > Reports > Financial
Statements), select ACTUALSOFT as the Ledger, select 12-2013 as the Financial Period, run
the report, and review the changes you have made.
Notice that salaries are expanded by subaccount and have a subtotal (item 1 in the screenshot
below), and services and utilities are expanded by account (item 2).
| Step 1.2: Editing the Row Set | 39

Figure: The My P&L: Actual vs Budget report

You have successfully modified the row set. In Step 1.3: Editing the Column Set, you'll modify the
column set of the report.
| Step 1.3: Editing the Column Set | 40

Step 1.3: Editing the Column Set


A column set defines the report header and the set of columns to be used in the report. In this step,
you will modify the header and the columns of the copied report. You will do the following:
• Modify the report name in the report header.
• Change the value of the PTD column to the budget YTD amounts for the same period.
• Modify the headers of the YTD actual and budget columns to show a range of periods.
• Add a column after the actual YTD balance and calculate the percentage as a comparison of the
amount of each income or expense row and the income subtotals or the expense total of the same
column.
• Add a column after the budget column and calculate the percentage as a comparison of the values
of the actual YTD amount and the budget YTD amount for each report row.
To modify the column set, do the following:
1. On the Column Sets form (CS206020; Finance > General Ledger > Configuration > Analytical
Reports), open the MYPL column set.
The upper table of the form displays the report header and the column headers. The lower table
displays the columns included in the column set and their properties.
2. To modify the report name, in the upper table, in the second row, change the value in the A
column to ='My P&L: Actual vs Budget'.
3. To change the header of the YTD column and to present the range of periods in the header, do
the following:
a. In the upper table, in the fourth row, change the value of the B column to ='YTD
Actual'.
b. On the table toolbar, click New to add a row to the report header. The added row is the
bottom row of the upper table.
c. Select any cell of the added row.
d. On the toolbar of the upper table, click Shift Up to shift the selected row up by one
position.
e. In the added row, select the cell in the B column, and click the magnifier icon to open the
formula editor.
f. In the Style area of the formula editor, select Right in the Text Align box.
g. In the bottom area of the formula editor, enter the following expression.

=IIf(Left(@StartPeriod,2)='01',
Left(Report.GetPeriodDescription(@StartPeriod),3)+
' '+Right(@StartPeriod,4),
Left(Report.GetPeriodDescription('01'+Right(@StartPeriod,4)),3)+
' '+Right(@StartPeriod,4)+'-'+
Left(Report.GetPeriodDescription(@StartPeriod),3)+
' '+Right(@StartPeriod,4))

This expression displays the range of the periods from the first period of the year to the
period selected by the user. For example, if a user ran the report for the 03-2013 period,
the header would show Jan 2013-Mar 2013.
The expression you have entered as the first argument of the IIf() function compares
the two first characters of the Start Period parameter of the report (@StartPeriod)
with the text 01, which matches the first period of the financial year.
The expression you have entered as the second argument of the IIf() function is
returned if the first argument of the IIf() function is TRUE—that is, if the user has
selected the first period of the financial year as the Start Period parameter of the
report. The GetPeriodDescription() function returns the description of the selected
| Step 1.3: Editing the Column Set | 41

financial period specified on the Financial Periods from (GL201000). The Left() function
returns the three leftmost characters of the period description. The Right() function
returns the four rightmost characters of the period, which match the financial year of the
period.
The expression you have entered as the third argument of the IIf() function is returned
if the first argument of the IIf() function is FALSE—that is, if the user has selected as
the Start Period parameter of the report any period of the financial year except the first
period. The expression specified returns a range of the periods, where the last period
is the selected period, and the first period is the first period of the financial year of the
selected period.
h. Click OK to apply your changes to the cell.
4. To present the budget YTD amounts for the same period, modify column C as follows:
a. In the upper table, change the column header as follows:
• In the fourth row, change the value of the C column to ='YTD Budget'.
• In the fifth row, specify the following expression in the C column to show the range
of periods in the header:

=IIf(Left(@StartPeriod,2)='01',
Left(Report.GetPeriodDescription(@StartPeriod),3)+
' '+Right(@StartPeriod,4),

Left(Report.GetPeriodDescription('01'+Right(@StartPeriod,4)),3)+
' '+Right(@StartPeriod,4)+'-'+
Left(Report.GetPeriodDescription(@StartPeriod),3)+
' '+Right(@StartPeriod,4))

• Select the fifth row of the B column. On the table toolbar, click Copy Style.
• Select the fifth row of the C column. On the table toolbar, click Paste Style.
b. In the lower table, change the Data Source attribute of the C column by clicking the
magnifier icon and then specifying the following settings:
• Ledger: BUDGET
• Amount Type: Ending Balance
In the data source of column B, you have specified no ledger. Thus, column B will show
account balances of the ledger selected at the Ledger parameter on the report form.
5. To calculate the percentage as a comparison of the amount of each income or expense row of
the YTD column with the income subtotals or the expense total respectively, do the following:
a. On the toolbar of the lower table, click New to add a column. The added column is the
rightmost column of both the upper table and the lower table—that is, the D column.
When you add a column in the lower table, the column is added to both the upper table
and the lower table.

b. In the lower table, do the following:


• Click any cell of the added column to select the column.
• On the table toolbar, click Shift Left to shift the selected column to the left. The
column becomes the С column.
You can also move columns by dragging their headers (such as A, B, or C) to the
needed position in each of the tables of the form.
Columns are moved in each table individually; movements of columns do not affect
the positioning of columns in the other table of the form.

• Specify the following attributes of the column that is now C:


• Type: Calc
| Step 1.3: Editing the Column Set | 42

• Value: =B/Value(@BaseRowCode, 'B')


• Format: #,##0.00%
• Width: 140
The @BaseRowCode parameter returns the code of the base row. For each row of
the report, you can specify the base row in the Base Row column on the Row Sets
form (CS206010). The Value(row, column) function returns the value of the
specified row and column. Thus, the expression that you have specified divides the
value of each row of column B by the value of the base row of column B associated
with the row.
In the ARM reports, the system treats not-a-number (NaN) and infinity values
as empty values instead of throwing an exception. When you are constructing a
calculation formula in an analytical report, you don't need to handle the case of
division by zero in the expression. Instead of the expression =IIf(C>0, B/C, 0),
you can use a simpler one: =B/C.
The format specifier you have entered in the Format attribute denotes rounding
of the amount to hundreds with a period used as the decimal separator and a
percentage character at the end. The values of this column will be formatted as
shown in the following examples:
• 123.456 -> 123.46%
• 123 -> 123.00%
• .123456 -> 0.12%
For more information on formatting numeric values, see the documentation about
custom date and time format strings in .NET Framework.
c. In the upper table, configure the column header as follows:
• Select the added column, which is the rightmost column (D).
• On the table toolbar, click Shift Left to shift the selected column to the left. The
column becomes the С column.
• In the fourth row of the column, type ='% Actual Total'.
• Select the fourth row of the B column. On the table toolbar, click Copy Style.
• Select the fourth row of the С column. On the table toolbar, click Paste Style.
• Select the sixth row of the B column. On the table toolbar, click Copy Style.
• Select the sixth row of the С column. On the table toolbar, click Paste Style.
6. To calculate the percentage as a comparison of the values of the actual and budgeted YTD
amounts for each report row, do the following:
a. On the toolbar of the lower table, click New to add a column. The added column is the E
column.
b. In the upper table, do the following:
• In the fourth row of the E column, type the following header: ='% Budget'.
• Select the fourth row of the D column. On the table toolbar, click Copy Style.
• Select the fourth row of the E column. On the table toolbar, click Paste Style.
• Select the sixth row of the D column. On the table toolbar, click Copy Style.
• Select the sixth row of the E column. On the table toolbar, click Paste Style.
c. In the lower table, specify the following attributes of the E column:
• Type: Calc
• Value: =B/D
| Step 1.3: Editing the Column Set | 43

• Format: #,##0.00%
• Width: 140
You should use uppercase letters to specify columns in formulas, such as A, B, or C.
7. Save your changes to the column set.
8. Run the My P&L: Actual vs Budget report (Finance > General Ledger > Reports > Financial
Statements) with the following parameters to review the report you have created (see the
screenshot below):
• Ledger: ACTUALSOFT
• Financial Period: 12-2013
Notice that the values of the % Budget column are a result of a comparison of the values of the
YTD Actual and YTD Budget columns (item 1). The values of the % Actual Total column are
a result of a comparison of the row values and the subtotal of these rows (item 2).

Figure: The My P&L: Actual vs Budget report

You have successfully modified the column set and the entire report.
| Step 1.4: Creating a Copy of the Report: a Self-Study Exercise | 44

Step 1.4: Creating a Copy of the Report: a Self-Study Exercise


Now that you have completed Steps 1 to 3 of the lesson, you know how to create a copy of an
analytical report. To reinforce this knowledge, perform the following exercise on your own.
Do not omit this step, because the next lesson will use its results.

Your task is to create a copy of the Profit & Loss report (GL635000) by performing the following general
instructions:
1. Copy the column set of the Profit & Loss report (GL635000), and specify the code as MYPL2 and
the description as My P&L: Quarterly.
2. Copy the report definition of the Profit & Loss report (GL635000), and specify the code as MYPL2
and the descriptions and the title as My P&L: Quarterly.
3. In the report definition of the copied report, select MYPL as the row set and MYPL2 as the column
set.
4. In the Page Settings area of the report definition, select the Landscape check box to use
landscape orientation for the copied report.
5. Add the report to the site map in the Company > Finance > General Ledger > Reports >
Financial Statements node with the P&L: Quarterly title. The settings of the created report
definition should be the same as the ones shown on the following screenshot.

Figure: My P&L: Quarterly report definition

6. Execute the new P&L: Quarterly report with ACTUALSOFT selected as the Ledger and 12-2013
selected as the Financial Period parameters and make sure it looks as shown in the screenshot
below.
| Step 1.4: Creating a Copy of the Report: a Self-Study Exercise | 45

Figure: The My P&L: Quarterly report

You will modify this report in the next lesson.


| Practice Exercise | 46

Practice Exercise
To reinforce your knowledge, perform this practice exercise on your own.
Your task is to modify the My P&L: Actual vs Budget report you have created in this lesson. You should
expand the report line Sales by subaccount, and show the codes of the expanded subaccounts so that
the report executed with ACTUALSOFT selected as the Ledger and 12-2013 selected as the Financial
Period parameters looks as shown in the screenshot below.

Figure: The My P&L: Actual vs Budget report


| Lesson 2: Building Reports Across Financial Periods | 47

Lesson 2: Building Reports Across Financial


Periods
In the I100 data set that you have preloaded to your company, the financial year starts January 1 and
consists of 12 financial periods that match the calendar months, as shown in the screenshot below. You
can review the financial year structure on the Financial Year (GL101000) form.

Figure: The list of financial periods

In the self-study exercise of the previous lesson, you created the My P&L: Quarterly report, which is
a copy of the Profit & Loss report (GL635000) with the MYPL row set of the My P&L: Actual vs Budget
report that you had created in Lesson 1: Creating a Copy of the Default Report. In this lesson, you will
modify this report to show quarterly profits and losses from the first period of the selected financial
year to the last period of the selected financial year. You will do the following:
• Change the YTD column to show the account balances at the end of the previous financial year.
• Change the PTD column, and add three more columns to show the turnover of each quarter of the
selected financial year.
• Add a column to show the account balances at the end of the selected financial year.

Lesson Objective
In this lesson, you will learn how to do the following:

• Use offsets and masks to select the needed periods in the data source of the columns.

Reports That Span Financial Periods


To modify the column set of the My P&L: Quarterly report, do the following:

1. On the Column Sets form (CS206020; Finance > General Ledger > Configuration > Analytical
Reports), open the MYPL2 column set.
| Lesson 2: Building Reports Across Financial Periods | 48

2. To change the values of the YTD column to the ending balance of the last financial period of the
previous financial year, do the following:

a. To modify the column header, in the upper table, change the value in the B column of the
fourth row to ='FY-'+Report.FormatYear(@StartPeriod, -1).
The FormatYear(period, shift) function obtains the year of the specified period
and shifts the obtained year to the value of the shift attribute of the function. For
example, if a user select any financial period of the 2014 year, the expression you have
specified returns 2013.

b. In the lower table, change the Data Source attribute of the B column, specifying the
following settings (see the screenshot below):

• Start Period: 12

• Offset (Year, Period): -1 (year offset)

• End Period: 12

• Offset (Year, Period): -1 (year offset)

• Amount type: Ending Balance

The identifier of each financial period is a combination of the period number and the
financial year. For example, the identifier of the first period of 2014 is 01-2014. You have
used the mask 12 to get the last period of the selected financial year. You also specified
-1 as the offset of the financial periods by a year to subtract this number from the year of
the period.
Thus, the data that meets these filtering criteria is the account balances of the last
financial period of the previous financial year relative to the selected financial period.

Figure: The data filtering criteria

3. To present turnover amounts of the first quarter of the current financial year in the PTD column,
do the following:

a. Change the column header for the C column to


='Q1-'+Report.FormatYear(@StartPeriod).

b. In the Data Source of the C column, specify the following settings:

• Start Period: 01

• End Period: 03

• Amount Type: Turnover

4. To present the turnover amounts of the second quarter of the current financial year, in the lower
table, add a column with the following Data Source settings:

• Start Period: 04
| Lesson 2: Building Reports Across Financial Periods | 49

• End Period: 06

• Amount Type: Turnover

5. To present the turnover amounts of the third quarter of the current financial year, in the lower
table, add a column with the following Data Source settings:

• Start Period: 07

• End Period: 09

• Amount Type: Turnover

6. To present turnover amounts of the fourth quarter of the current financial year, in the lower
table, add a column with the following Data Source settings:

• Start Period: 10

• End Period: 12

• Amount Type: Turnover

When you specify an explicit range of periods in the data source and specify the end period
number, you have to consider the financial year structure and make sure that you have specified
the greatest possible end number of a period. For example, if you had an adjustment period
number 13 in the financial year, you would have to specify 13 in the End Period of the data source
to make the report cover all financial periods.

7. In the lower table, add a column with the following Data Source settings to show the account
balances at the end of the selected financial year:

• Start Period: 12

• End Period: 12

• Amount Type: Ending Balance

8. To adjust the report layout, do the following:

• In the upper table, do the following:

• In the second row, change the value in the A column to ='My P&L: Quarterly'.

• In the fourth row, specify the value in the D column as


='Q2-'+Report.FormatYear(@StartPeriod).

• In the fourth row, specify the value in the E column as


='Q3-'+Report.FormatYear(@StartPeriod).

• In the fourth row, specify the value in the F column as


='Q4-'+Report.FormatYear(@StartPeriod).

• In the fourth row, specify the value in the G column as


='FY-'+Report.FormatYear(@StartPeriod).

• For the fourth row, copy style from the C column and paste the style to the D, E, F,
and G columns.

• For the fifth row, copy style from the C column and paste the style to the D, E, F,
and G columns.

• In the lower table, do the following:

• Set the Width attribute of the A column to 350.

• Set the Width attributes of the B, C, D, E, F, and G columns to 100.

• Set the Format attributes of the D, E, F, and G columns to #,##0.00.


| Lesson 2: Building Reports Across Financial Periods | 50

9. Save your changes to the column set.

10. Run the My P&L: Quarterly report (Finance > General Ledger > Reports > Financial Statements)
with the following parameters to review the changes you have made (see the screenshot below):

• Ledger: ACTUALSOFT

• Financial Period: 01-2014

Figure: The My P&L: Quarterly report

You have created the report that shows quarterly profits and losses. In the report, you have reused the
MYPL row set that you had created for the budget performance report.
| Lesson 3: Filtering Data in Reports by Using Unit Sets | 51

Lesson 3: Filtering Data in Reports by Using Unit


Sets
In this lesson, you will add a unit set to the My P&L: Quarterly report you created in Lesson 2:
Building Reports Across Financial Periods to be able to switch between the consolidated report of both
companies (Software Inc. and Computers Inc.) and the detailed quarterly report of each company. You
will do the following:
• Create and configure a unit set with three units:
• For the first unit, you will show only the columns with the account balances of financial
years. In these columns, you will present consolidated data of the ACTUALCOMP and
ACTUALSOFT ledgers.
• For the second unit, you will show all the columns of the column set with the data of the
ACTUALCOMP ledgers.
• For the third unit, you will show all the columns of the column set with the data of the
ACTUALSOFT ledgers.
• Hide the Ledger parameter on the report form because the ledgers used will be determined by
the settings of the units themselves.
• Add a column to the column set to calculate the percentage, which shows the account balances
of the selected financial year to the account balances of the previous financial year. You will also
show this column for only the first unit of the unit set.

Lesson Objectives
In this lesson, you will learn how to do the following:

• Create and configure a unit set

• Apply the unit set to the report

• Configure the visibility of report columns depending on the particular unit of the unit set

• Show data from different data sources by using the unit set
| Step 3.1: Configuring a Unit Set | 52

Step 3.1: Configuring a Unit Set


You can use a unit set to organize the report structure in the following cases:
• When the groups of rows and columns included in the report use data from different data sources
• When formulas must be applied to calculate the report values based on the data from the
explicitly defined groups of columns and rows
A unit set can include one or more units that specify how the data is selected, calculated, and displayed
in reports. In the report, you can view data for each individual unit, which could be a branch or a
cost center, as well as data consolidated for all the units. To define the data that should be included
in the unit set and set up the formatting for the rows and columns, you can set the values of the unit
attributes covered in this lesson.
To create and configure the unit set, do the following:
1. On the Unit Sets form (CS206030; Finance > General Ledger > Configuration > Analytical
Reports), create a unit set with the following attributes:
• Code: MYPL
• Description: Companies
2. In the left pane, select the ROOT node of the unit set, which is the topmost system node, which
is not shown in the report.
3. In the table in the right pane, add a new row, and specify the following settings:
• Code: U1
• Description: Computers and Software Consolidated
• Value: =@U2+@U3
• Printing Group: 1
In the unit set and the report, the units are organized in a hierarchical structure and ordered by
unit code. You can select a unit in the left pane (which is called the parent unit in this context),
and add units to this selected unit in the right pane (which are called the child units in this
context). When you save the unit set, these child units will appear in the left pane under the
parent unit.
The topmost unit of the left pane excluding ROOT is applied to the report by default when you
run the report.
You can use the arrow buttons in the toolbar of the left pane to change the position of a unit in the
hierarchy.

You will use the U1 unit to show the consolidated account balances of the related companies
(Software Inc. and Computers Inc.). You will present the data of the ACTUALCOMP ledger in the
second unit, U2, and the data of the ACTUALSOFT ledger in the third unit, U3. The expression
=@U2+@U3 that you have entered as the value of the parent unit U1 consolidates the data of the
second and third units.
In formulas, you have to precede a unit code with the @ character, as you've done in the
expression =@U2+@U3. The letters of codes are always uppercase, so it is important to use
the appropriate letter case in formulas. The expression =@u2+@u3, for example, returns an
exception.
You will use the value you specified for the Printing Group attribute in the column set of the
report to determine which columns will be printed in the report for the U1 unit.
4. Save your changes to the unit set. The U1 unit appears in the left pane.
5. In the left pane, select the U1 unit.
6. In the table in the right pane, add two rows with the settings shown in the following table.
| Step 3.1: Configuring a Unit Set | 53

Code Description Printing Group Data Source > Ledger


U2 Computers Inc. 2 ACTUALCOMP
U3 Software Inc. 2 ACTUALSOFT

You will use these units to show all the columns of the report with the individual companies'
data.
7. Save your changes to the unit set.
You have created and configured the unit set. Now you will apply this unit set to the My P&L: Quarterly
report.
| Step 3.2: Applying the Unit Set to the Report | 54

Step 3.2: Applying the Unit Set to the Report


Each unit set can be used in a report or a group of reports, and each report can use only one unit set.
To apply the unit set that you have configured in the previous step to the My P&L: Quarterly report, and
to make the needed changes to the report, do the following:
1. To apply the unit set to the report and hide the Ledger parameter on the report form, do the
following:
a. On the Report Definitions form (CS206000; Finance > General Ledger > Configuration >
Analytical Reports), open the MYPL2 report definition.
b. In the Unit Set box, select MYPL to apply the unit set.
c. Clear the Request check box to the right of the Ledger box to hide the Ledger
parameter on the report form.
d. Save your changes to the report definition.
2. To configure the column set of the report, do the following:
a. On the Column Sets form (CS206020; Finance > General Ledger > Configuration >
Analytical Reports), open the MYPL2 column set.
b. To modify the report name, in the second row of the upper table, change the value in the
A column to ='My P&L: '+@UnitText.
The @UnitText parameter returns the unit description specified on the Unit Sets
(CS206030) form. Based on the expression you have specified, the report header will be
changed when you select a unit.
c. To calculate the year over year (YOY) annual performance, do the following:
• In the lower table, add a column, which will be the rightmost H column, with the
following attributes:
• Type: Calc
• Value: =G/B
• Format: #,##0.00%
• Width: 100
• Unit Group: 1
Based on the value you have specified for the Unit Group attribute of the column,
the column will be printed only for the first unit whose Printing Group value is the
same.
• In the upper table, do the following:
• In the fourth row of the H column, type the following header: ='% YOY'.
• For the fourth row, copy the style from the G column and paste the style to
the H column.
• For the fifth row, copy the style from the G column and paste the style to the
H column.
d. To show the quarterly columns for only the second and third units of the unit set, for the
quarterly columns C-F, specify 2 as the Unit Group, which is the Printing Group value
of the second and third units.
e. Save your changes to the column set.
3. Run the My P&L: Quarterly report (Finance > General Ledger > Reports > Financial Statements)
with the Financial Period parameter as 01-2014.
4. In the report toolbar, click to open the left pane with the report units (see the screenshot
below). Notice that the Computers and Software Consolidated unit is selected by default.
| Step 3.2: Applying the Unit Set to the Report | 55

Figure: The My P&L: Quarterly report consolidated for the two companies (unit U1)

5. In the left pane, select Software Inc. company that corresponds to the U3 unit, as shown in the
screenshot below, and review the report.

Figure: The My P&L: Quarterly report for Software Inc. (unit U3)
| Lesson 4: Using Overlapping Data Sources | 56

Lesson 4: Using Overlapping Data Sources


In this lesson, you will create a gross sales report, which shows the sales amounts broken down by
regions and service types. You will build a report whose rows correspond to regions and columns
correspond to different services. Each report cell shows the gross amount of the sales of services in the
region. You will do the following:
• Create the report definition
• Create the row set with a row for each region
• Create the column set with a column for each service
• Configure the report header

Lesson Objectives
In this lesson, you will learn how to do the following:

• Create a new analytical report

• Present the amounts aggregated by particular subaccount segments

• Retrieve the amounts posted to particular accounts and subaccounts, which belong to the
intersection of account and subaccount ranges specified in the column and the row

• Format the string values that are printed in the report


| An Overlap of Data Sources | 57

An Overlap of Data Sources


To retrieve to a report the amounts posted to general ledger accounts and subaccounts, you specify
the conditions in the data source of the report definition, row, column, or unit. If these data sources
overlap, the system retrieves the data by using the following rules:
• Accounts, subaccounts, branches, and their ranges of all data sources are merged. The system
retrieves the intersecting data that results from this merge. For example, if you have specified the
100–600 range of accounts for a row and the 400–900 range of accounts for a column and run a
report that uses the row set and the column set with these settings, the system will retrieve the
data for the 400–600 range of accounts. The image below illustrates this overlap.

Figure: The overlap of accounts

• The ledger, account class, financial periods, offsets of financial periods, and amount type are
used from only one data source. If conditions overlap between the unit, row, column, and report
definitions, the system uses the condition specified for the unit (if any). If no condition is specified
for the unit or there is no unit set in the report, the system uses the condition of the row. If no
condition is specified for the row, the system uses the condition of the column. If no condition is
specified in the unit, row, or column of the report, the condition from the report definition (if any)
is used. Thus, the data sources of an analytical report have the following level of priority, from the
highest to the lowest:
1. The unit
2. The row
3. The column
4. The report definition
The table below illustrates an example of how these rules work.

Data Source The unit The row The column The report
parameters definition
Ledger ACTUAL BUDGET
Account Class EXOFFICE EXBANK
Account Type Ending Balance Turnover
Start Period 04-2015 01-2015
End Period 06-2015 12-2015

For this example, the system uses the following consolidated conditions in the report:
• Ledger: ACTUAL (from the unit)
• Account Class: EXOFFICE (from the row)
• Account Type: Ending Balance (from the column)
• Start Period: 04-2015 (from the column)
• End Period: 06-2015 (from the row)
The image below illustrates the overlap of date ranges of the example above.
| An Overlap of Data Sources | 58

Figure: The overlap of date ranges

For more information on using the data source, see the Data Sources topic of this course and the
Related Links section of this topic.
Related Links
Data Source
| Step 4.1: Creating the Report | 59

Step 4.1: Creating the Report


To create a report, do the following:
1. On the Row Sets form (CS206010; Finance > General Ledger > Configuration > Analytical
Reports), create a row set with the following settings:
• Code: MYGS
• Description Sales by Region
2. Save your changes to the row set.
3. On the Column Sets form (CS206020; Finance > General Ledger > Configuration > Analytical
Reports), create a column set with the following settings:
• Code: MYGS
• Description: Sales by Service
4. Save your changes to the column set.
5. On the Report Definitions form (CS206000; Finance > General Ledger > Configuration >
Analytical Reports), create a report definition with the following settings, as shown in the
screenshot below:
• Report Definition:
• Code: MYGS
• Description Gross Sales by Region and Service
• Row Set: MYGS
• Column Set: MYGS
• Default Data Source Settings:
• Ledger > Request: Selected
• Start Period > Request: Selected
• The drop-down box on the right next to End Period: Request
• Site Map:
• Location: Company > Finance > General Ledger > Reports > Financial Statements
• Title: Gross Sales by Region and Service
• Page Settings:
• Paper Kind: Letter
• Landscape: Selected
• Default Font Style:
• Font: Arial
• Font Size: 11
| Step 4.1: Creating the Report | 60

Figure: The definition of the Gross Sales by Region and Service report

6. Save your changes to the report definition.


7. Refresh the page in the browser and find the Gross Sales by Regions and Service report (Finance
> General Ledger > Reports > Financial Statements) to make sure the reference to the new
report has been added to the menu. If you run the report, you will see a blank page because the
row and column sets of the report are empty.
You have created an empty report. In the next step, you'll configure the row set of this new report.
| Step 4.2: Configuring the Row Set | 61

Step 4.2: Configuring the Row Set


To configure the row set of the report you created in the previous step, do the following:
1. On the Row Sets form (CS206010; Finance > General Ledger > Configuration > Analytical
Reports), open the MYGS row set.
2. To show an empty line, which separates the report header from the report data, add a row with
the following attributes:
• Code: 0090
• Type: Caption
• Height: 6
• Linked Row: 0210
3. To show sales by each region, add to the row set the rows with the settings shown in the
following table.

Code Description Type Data Data IndentSuppress Hide Base


Source >Source > Empty Zero Row
Account Start Sub.
Class
0105 California GL Sales ???-??-CA 10 Selected Selected 0210
0110 District of GL Sales ???-??-DC 10 Selected Selected 0210
Columbia

0115 Florida GL Sales ???-??-FL 10 Selected Selected 0210


0120 Louisiana GL Sales ???-??-LA 10 Selected Selected 0210
0125 Nevada GL Sales ???-??-NV 10 Selected Selected 0210
0130 New York GL Sales ???-??-NY 10 Selected Selected 0210

The third segment of each subaccount is the sales region. By using appropriate masks in the
data source of the columns, you filter sales by region.
4. Add a row with the following attributes to show a line that separates the expanded rows from the
total:
• Code: 0205
• Type: Line
• Height: 2
• Line Style: Solid
• Linked Row: 0210
5. Add a row with the following attributes to show the total:
• Code: 0210
• Description: Total by Service
• Type: Total
• Value: =sum('0100', '0200')
• Style > Bold: Selected
• Suppress Empty: Selected
6. Add a row with the following attributes to show a line that separates the total and the
percentage, which shows the amount of each service to the total sales amount:
| Step 4.2: Configuring the Row Set | 62

• Code: 0215
• Type: Caption
• Height: 3
• Linked Row: 0210
7. To calculate the percentage of the sales by service relative to the total sales for each report
column, add a row with the following attributes:
• Code: 0220
• Description: Service % of Sales
• Type: Total
• Value: =Value('0210', @ColumnCode)/Value('0210', 'F')
The @ColumnCode parameter returns the code of the current column. The Value(row,
column) function returns the value of the specified row and column. The 0210 row of
the report shows sales by service. In the F column of the report, you will calculate sales by
region. In each cell, the total sales is printed. Thus, the expression that you have specified
divides the sales by service by the total sales.
• Format: #,##0.00%
The format specifier of the row prevails over the format specifier of the column. Thus, the
format of this row will differ from the format specified in the column set for the other row.
• Style > Bold: Selected
• Suppress Empty: Selected
• Linked Row: 0210
• Column Group: 1
You will use the value of this Column Group attribute in the column set of the report to
print the values of this row in only the particular columns.
8. Add a row with the following attributes to sort the total sales by region:
• Code: 0900
• Description: Sorting sales
• Type: Sort
• Value: =SORTD('0105','0130','F')
9. Save your changes to the row set. The resulting row set configuration is shown in the screenshot
below.

Figure: Row set configuration


| Step 4.2: Configuring the Row Set | 63

You have successfully configured the row set. In the next step, you'll configure the column set of the
report.
| Step 4.3: Configuring the Column Set | 64

Step 4.3: Configuring the Column Set


To configure the column set, do the following:
1. On the Column Sets form (CS206020; Finance > General Ledger > Configuration > Analytical
Reports), open the MYGS column set.
2. In the upper table, configure the report header as follows:
a. To present the company name, in the first row, do the following:
a. In the A column, select the cell and click the magnifier icon to open the formula
editor.
b. In the bottom area of the formula editor (item 1 in the screenshot below), enter
=Report.GetDefUI('RowCompanyBAccount.AcctName').
GetDefUI(object field) is an application function you can use to get the
value of the object field. Based on the value you entered, the expression
returns the company name.
c. In the Style area (item 2 in the screenshot below), select 14 as the Font Size,
and select the Bold check box.
d. Click OK to apply your changes to the cell.

Figure: Specifying the value and the style of a cell of the report header

b. To show the report name, add the second row. In the A column, enter ='Gross Sales by
Region and Service', select 14 as Font Size, and select the Bold check box.
c. To show the selected period range, add the third row. In the A column, select the Bold
check box, and enter the following expression.

=Format('For the period of {0: MMMM d, yyyy} to {1: MMMM d, yyyy}',


Report.GetPeriodStartDate(@StartPeriod),
Report.GetPeriodEndDate(@EndPeriod))

The GetPeriodStartDate(period) application function obtains the start date of the


specified period. Similarly, the GetPeriodEndDate(period) function obtains the
end date of the period.
The @StartPeriod parameter returns the financial period that a user selected as the
value of the Start Financial Period parameter on the report form. The @EndPeriod
parameter returns the financial period that a user selected as the value of the End
Financial Period parameter on the report form.
The Format(string, argument(s)) function replaces the format item in a specified
formatting string with the text equivalent of the arguments.
| Step 4.3: Configuring the Column Set | 65

In the expression you have entered, the formatting string is 'For the period
of {0: MMMM d, yyyy} to {1: MMMM d, yyyy}', the first argument is
Report.GetPeriodStartDate(@StartPeriod), and the second argument is
Report.GetPeriodEndDate(@EndPeriod). To paste an argument to the string,
you should use the following syntax: {argument number: formatting rules}.
The numbering of the arguments starts with 0. Thus, the {0: MMMM d, yyyy} piece
of the string will be replaced with the first argument, and the {1: MMMM d, yyyy}
piece of the string will be replaced with the second argument. MMMM d, yyyy represents
the formatting rules to be applied to the argument, where MMMM is the full name of the
month, d is the day of the month (from 1 through 31), and yyyy is the year as a four-
digit number. For more information on formatting date values, see the documentation
about custom date and time format strings in .NET Framework.
d. To separate the report header and the column headers with an empty line, add the fourth
row, and specify 10 as its Height.
e. For the column headers, add the fifth line. In the A column, select 12 as the Font Size,
and select the Bold check box.
f. To add a line that separates the column headers from the report data, add the sixth line,
and specify 1 as its Height. In the A column, select Black as Backgr. Color.
3. In the lower table, configure the report columns as follows:
a. To present descriptions of the rows of the row set, in the A column, specify the following
attributes:
• Type: Descr
You can use columns of the Descr type to print descriptions of rows specified in the
row set.
• Width: 300
• Extra Space: 10
You can specify indentation for the column by using this attribute.
• Suppress Line: Selected
Based on this selection, the report rows of the line type won't be printed in this
column.
• Printing Group: 1
Based on the specified Printing Group, the 0220 row whose Column Group
attribute has the same value will be printed in this column.
b. To show sales by service, add four columns from B to E—one column for each service—
with the attributes shown in the following table.

Attributes B C D E
Type GL GL GL GL
Format #,##0.00 #,##0.00 #,##0.00 #,##0.00
Width 110 110 110 110
Printing Group 1 1 1 1
Data Source > Start Sub. ???-CU-?? ???-TR-?? ???-SU-?? ???-CO-??
Data Source > Amount Type Turnover Turnover Turnover Turnover

The second segment of each subaccount is the revenue source—CU is customization, TR


is training, SU is support, and CO is consulting. By using appropriate masks in the data
source of the columns, you filter sales by type of service.
c. To show a total by region, add a new column, which will be F, with the following
attributes:
| Step 4.3: Configuring the Column Set | 66

• Type: GL
• Format: #,##0.00
• Width: 130
• Style > Bold: Selected
• Data Source > Amount Type: Turnover
You have specified no mask in the data source. Thus, this amount is a total amount
of all the services, which is retrieved from the general ledger.
You have also specified no value for the Printing Group attribute. So the 0220 row
of the row set won't be printed in this column.
Alternatively, you could calculate this total by selecting the Calс type for the column
and specifying one of the following expressions:

• =SUM('B', 'E')
• =B+C+D+E
d. To calculate the percentage as sales by region relative to total sales for each report row,
add a column, which will be G, with the following attributes:
• Type: Calc
• Value: =F/Value(@BaseRowCode, 'F')
• Format: #,##0.00%
• Width: 140
4. To configure the column headers, in the upper table, do the following:
• In the fifth row, enter the following values for the columns:
• A: ='Region'
• B: ='Customization'
• C: ='Training'
• D: ='Support'
• E: ='Consulting'
• F: ='Total by Region'
• G: ='Region % of Sales'
• In the fifth row, specify the following style settings for the B column:
• Text Align: Right
• Font Size: 12
• Bold: Selected
• For the fifth row, copy the style from the B column and paste the style to the C, D, E, F,
and G columns.
• For the sixth row, copy the style from the A column and paste the style to the B, C, D, E,
F, and G columns.
5. In the upper table, finish configuring the report header. Do the following:
a. To show the name of the user who executed the report, in the
first row, enter the following value in the G column: ='User: ' +
Report.GetDefUI('AccessInfo.DisplayName').
You can use the fields of the AccessInfo class to get information as follows:
• AccessInfo.DisplayName: The user login
| Step 4.3: Configuring the Column Set | 67

• AccessInfo.CompanyName: The company name


• AccessInfo.BusinessDate: The Acumatica ERP business date
• AccessInfo.BranchID: The branch identifier
b. To show the printing date, in the second row, enter the following value in the G column:
=Today().
Today() is a date and time function that returns the current date according to the system
date on the local computer. Alternatively, you can use the @Today predefined parameter to
get the same result.
If you also want to print the time, use the Now() date and time function. The Now()
and Today() functions return the date and time in the system time zone of the user's
computer. You can also use the NowUTC() and TodayUTC() functions to get the UTC
date and time without offset.
Instead of the current date, you can present the Acumatica ERP business date by using
the GetDefUI() function as follows: =Report.GetDefUI('AccessInfo.BusinessDate').
6. Save your changes to the column set. The resulting column set configuration is shown in the
screenshot below.

Figure: Column set configuration

7. Run the Gross Sales by Region and Service report (Finance > General Ledger > Reports >
Financial Statements) with the following parameters to review the report (see the screenshot
below):
• Ledger: ACTUALSOFT
• Start Financial Period: 01-2015
| Step 4.3: Configuring the Column Set | 68

• End Financial Period: 03-2015


You can click the amount and review transactions of any cell, the total column, and the total row.

Figure: The Gross Sales by Region and Service report

You have successfully configured the column set and created the report.
| Lesson 5 (Optional): Eliminating Inter-Branch Balances in Reports | 69

Lesson 5 (Optional): Eliminating Inter-Branch


Balances in Reports
This additional lesson, which demonstrates more techniques that you can use for developing ARM reports,
is not required for certification.

In this lesson, you will review the modified Balance Sheet report, which presents the account balances
before and after the elimination of due-to and due-from amounts that appear as a result of the
processing of automatically balanced inter-branch transactions. According to the story of our example,
the branches represent different entities, so the inter-branch transactions are inter-company. For more
information about inter-branch transactions, see the examples of the F200 Financials: Intermediate
course at Acumatica University.
For this lesson, we provide the prepared report that you can import into the system and analyze, to
save you time that would be spent on building the report from scratch. To view the sample report, you
will have to prepare the system configuration: extend the chart of accounts and configure the inter-
branch account mapping as described further in this lesson.

Lesson Objectives
In this lesson, you will learn how to do the following:

• Eliminate the amounts of the inter-branch transactions using an ARM report.

• Import an ARM report from XML.

• Use the Printing Group attribute of report columns to specify the conditional printing of rows in
particular columns.

• Merge report columns to print the amounts retrieved into two different columns in the column set
as a single column in the report.
| Step 5.1: Configuring Inter-Branch Transactions | 70

Step 5.1: Configuring Inter-Branch Transactions


To be able to process an automatically balanced inter-branch transaction to be shown in the report,
you need to configure inter-branch account mapping in the system. In this step, you will add a pair of
accounts for the inter-branch transactions from the Computers company to the Software company. To
configure the processing of the inter-branch transactions, do the following:
Although in this training you configure only one pair of accounts, which is sufficient for the example
of this lesson, normally you would have to add a second pair of accounts for the reversed inter-branch
transactions from the Software company to the Computers company. For more information about inter-
branch transactions, see the examples of the F200 Financials: Intermediate course at Acumatica University.

1. On the Account Classes form (GL202000; Finance > General Ledger > Configuration > Setup),
add the account classes whose settings are shown in the following table.

Account Class ID Type Description


IBAS Asset Inter-Branch AR
IBLIAB Liability Inter-Branch AP

2. Save your changes to the account classes.


3. On the Chart of Accounts form (GL202500; Finance > General Ledger > Configuration >
Manage), add accounts with the settings shown in the following table.

Account Account Class Description


120000 IBAS Due from Computers Inc.
210000 IBLIAB Due to Software Inc.

4. Save your changes to the chart of accounts.


5. On the Inter-branch Account Mapping form (GL101010; Finance > General Ledger >
Configuration > Manage), modify the inter-branch account mapping as follows:
a. Select WEST as the Originating Branch.
b. On the Transactions in Origination Branch tab, set 210000 as the Offset Account.
c. On the Transactions in Destination Branch tab, set 120000 as the Offset Account.
6. Save your changes to the inter-branch account mapping.
You have configured the inter-branch account mapping from the Western Office of the Computers
company to the Software company. That is enough for this lesson, but normally you would also
have to configure the following inter-branch account mapping for the companies:

• From the Eastern Office of the Computers company to the Software company

• From the Software company to the Western Office of the Computers company

• From the Software company to the Eastern Office of the Computers company

You have configured the processing of the inter-branch transactions. Now you need to process at least
one transaction that is automatically balanced according to the specified mapping to be able to see data
in the sample report that demonstrates the elimination of the amounts of the inter-branch transactions.
| Step 5.2: Processing a Transaction Between Companies | 71

Step 5.2: Processing a Transaction Between Companies


Suppose that on 1/31/2013, the Western Office of the Computers company issues an invoice to the
Jevy Computers customer in the amount of $100,000 for services delivered to the customer by the
Software company. To make an Accounts Receivable invoice transaction between companies, proceed as
follows:
1. Select the WEST branch as the current branch.
2. On the Invoices and Memos form (AR301000; Finance > Accounts Receivable > Work Area >
Enter), create an invoice with the following settings, as shown in the screenshot below:
• Type: Invoice
• Customer: C000000003
• Date: 1/31/2013
• Post Period: 01-2013
3. On the Financial Details tab, make sure that the Branch is WEST.
4. On the Document Details tab, add a row with the following settings for the $100,000 revenue
received by the Software company:
a. Branch: SOFT
b. Ext. Price: 100000.00
c. Account: 403000 (Sales - Consulting Services)
d. Subaccount: 000-00-00
5. In the Summary area, specify 100000.00 as the Amount, and clear the Hold check box.

Figure: The invoice for the inter-branch transaction

6. Save your changes to the invoice, and release the invoice.


7. On the Financial Details tab, open and review the generated batch, which is shown in the
screenshot below.
| Step 5.2: Processing a Transaction Between Companies | 72

Figure: The batch generated on release of the invoice

The last two journal entries are the balancing entries between the WEST and SOFT branches.
You have successfully created and released the invoice. Now you will import the Balance Sheet report,
which demonstrates the balances with the elimination of the due-to and due-from amounts between the
branches.
| Step 5.3: Importing and Reviewing the ARM Report | 73

Step 5.3: Importing and Reviewing the ARM Report


To import the modified Balance Sheet report, which shows the balances with the elimination of the due-
to and due-from amounts between the branches, do the following:
1. On the toolbar of the Report Definitions form (CS206000; Finance > General Ledger >
Configuration > Analytical Reports), click > Import from XML.
2. In the Upload XML File dialog box, which appears, select the MYBS.xml file, which is provided
with the course, and click Upload.
3. In the Site Map area, specify the following settings to add the imported report to the site map:
• Location: Company > Finance > General Ledger > Reports > Financial Statements
• Title: My Balance Sheet
4. Save your changes to the report definition.
You have successfully imported the entire report with the report definition, the row set, the
column set, and the unit set.
5. On the form toolbar, click Preview to open the report form.
6. Run the report with the predefined value of the Financial Period parameter (12-2013) to
review the report (see the following screenshot).

Figure: The My Balance Sheet report

As you can see, the My Balance Sheet report has four columns:
• The description column
• The Before Eliminations column (item 1), which shows the balances of all accounts,
including the due-to and due-from accounts that are presented in the Inter-Company
Eliminations rows of the assets and liabilities
| Step 5.3: Importing and Reviewing the ARM Report | 74

• The Eliminations column (item 2), which shows the balances of the due-to and due-from
accounts to be subtracted from the first column
• The After Eliminations column (item 3), which shows the balances of the accounts
excluding the due-to and due-from accounts
| Step 5.4: Reviewing the Report Configuration | 75

Step 5.4: Reviewing the Report Configuration


The My Balance Sheet report that you have imported has been created as a copy of the Balance Sheet
report (GL634000) and then modified. To review how this report modification was configured, do the
following:
1. On the Row Sets form (CS206010; Finance > General Ledger > Configuration > Analytical
Reports), select MYBS as the Code to open the row set of the My Balance Sheet report.
To show the amounts of the inter-branch transactions, the following rows were added to the row
set:
• The 00137 row (item 1 in the screenshot below) is used to show the inter-branch assets,
which are the balances of the accounts of the IBAS account class.
• The 00431 row is used to show the inter-branch liabilities, which are the balances of the
accounts of the IBLIAB account class.
To print in the Eliminations column only the inter-company rows, the Column Group attribute
of all the report rows of the GL type except the inter-company rows have been set to ALL (item 2
in the screenshot below). The rows with the ALL column group will be printed in only the report
columns whose Printing Group attribute equals ALL.

Figure: The row set of the My Balance Sheet report

2. On the Column Sets form (CS206020; Finance > General Ledger > Configuration > Analytical
Reports), select MYBS as the Code to open the column set of the report.
Column A is the original column of the Balance Sheet report, which contains the row
descriptions. The Printing Group attribute of this column was set to ALL to show the
descriptions of rows that refer to the ALL column group or have an empty column group.
Column B is also the original column of the Balance Sheet report. Its Printing Group attribute
was also set to ALL to show the values of the rows that refer to the ALL column group or have an
empty column group.
Column C was added to show only the totals and amounts of the inter-branch transactions. The
Printing Group attribute of this column is clear. Thus, all rows with the ALL column group won't
be printed in this column, which is the Eliminations column of the report.
Columns D was added to calculate the difference between the amounts of the B and C columns.
This column is the After Eliminations column of the report. Column D has no printing
group. Thus the values of the rows with the ALL column group in column B aren't available
for calculations in this column. The =B-C formula of column D calculates only the eliminated
balances of the inter-company transactions. If you print in the report only column D and don't
print column E, column D will contain only zero balances of the inter-company rows and totals.
| Step 5.4: Reviewing the Report Configuration | 76

Therefore, column E, which is configured similarly to column B and contains the copy of balances
of the Before Eliminations column, was added to the column set. Column E was hidden in
the report, and column D was merged with column E—that is, all empty cells of column D were
filled with the appropriate values of column E. When you merge columns, the value in the left
column (for which you specified Merge Next) prevails over the value in the right column (for
which you specified Hidden). Thus, the zero balances and the corrected totals of column D were
merged with column E into a single column in the report that shows the balances of accounts
after eliminations.

Figure: The column set of the My Balance Sheet report


| Step 5.5: Using an Alternative Calculation for the After Eliminations Column | 77

Step 5.5: Using an Alternative Calculation for the After


Eliminations Column
If you have only one printing group in a report, as we have in the imported My Balance Sheet report
(ALL), instead of having a helper hidden column and having to merge two columns as shown in Step
5.4, you can calculate the value of the After Eliminations column in a simpler way, which is shown
below.
This way of calculating the balances of the accounts excludes the due-to and due-from accounts. You
can use this way for reports whose row sets have only one printing group. To modify the My Balance
Sheet report, whose row set has only one printing group, do the following:
1. On the Column Sets form (CS206020; Finance > General Ledger > Configuration > Analytical
Reports), select MYBS as the Code to open the column set of the My Balance Sheet report.
2. In the lower table, change the attributes of column D as follows:
• Printing Group: ALL
• Printing Control: Print
The changes you have made allow the use of the values of rows with the ALL group of column B
for calculations in column D. Column D will also be printed in the report without being merged
with column E. Column E is still hidden.
3. Save your changes to the column set.
4. Run the My Balance Sheet report (Finance > General Ledger > Reports > Financial Statements)
with the predefined value of the parameter to review the report.
Notice that the amounts shown in the After Eliminations column haven't changed.
| Appendix: Alphabetical Index | 78

Appendix: Alphabetical Index


In this topic, you can find the links to the main concepts, tools, and attributes of the ARM reports
described in this course.
• Analytical Reports: Overview of Analytical Reports
• @BaseRowCode parameter: Step 1.3: Editing the Column Set
• Column Sets: Column Sets
• Data source:
• Using masks for accounts and subaccounts: Step 1.2: Editing the Row Set
• Using masks for periods: Lesson 2: Building Reports Across Financial Periods
• Using offsets for periods: Lesson 2: Building Reports Across Financial Periods
• @EndPeriod parameter: Step 4.3: Configuring the Column Set
• Format of the values of rows and columns: Step 1.3: Editing the Column Set
• GetPeriodEndDate function: Step 4.3: Configuring the Column Set
• GetPeriodStartDate function: Step 4.3: Configuring the Column Set
• Masks of accounts and subaccounts in the data source: Step 1.2: Editing the Row Set
• Masks of periods in the data source: Lesson 2: Building Reports Across Financial Periods
• Offsets of periods in the data source: Lesson 2: Building Reports Across Financial Periods
• Overlapped data sources: An Overlap of Data Sources
• Report Definitions: Report Definitions
• Row Sets: Row Sets
• Sort function: Step 1.2: Editing the Row Set
• SortD function: Step 1.2: Editing the Row Set
• @StartPeriod parameter: Step 4.3: Configuring the Column Set
• Unit Sets: Unit Sets
• @UnitText parameter: Lesson 3: Filtering Data in Reports by Using Unit Sets

You might also like