Welcome to FreeBalance Help. Please use the menu to select the module for which you are looking for FreeBalance Help documentation. Please note that FreeBalance Help for a specific function can be accessed directly from that function's page within the application by selecting the FreeBalance Help icon. |
Governments across the world are modernizing and improving the effectiveness of Public Financial Management (PFM) systems. Within the context of accelerated globalization, PFM systems are an essential part of the development process. Information technology provides the key ingredient for the success of PFM reforms and modernizing fiscal management practices to support country growth. Government Resource Planning (GRP) systems assist governments in achieving aggregate fiscal control and better management of public funds. FreeBalance provides integrated GRP software to governments worldwide. About FreeBalance Founded in 1984, FreeBalance is a for-profit social enterprise and leading global provider of government resource planning software solutions for public financial management. FreeBalance solutions support government modernization, fiscal decentralization, and public finance reform. Public financial management reform is a key element of good governance and sustainable development. FreeBalance is headquartered in Ottawa, Canada, with sales and support offices in Washington, DC (United States), Lima (Peru), Lisbon (Portugal), London (Great Britain), Pristina (Kosovo) and St. John (Antigua and Barbuda). FreeBalance solutions have been implemented in countries across the globe, including Canada, United States, Sierra Leone, Guyana, Pakistan, Mongolia, Afghanistan, Antigua & Barbuda, Timor-Leste, Republic of Kosovo, and Panama. The FreeBalance Accountability Suite is a commercial off-the-shelf Integrated Financial Management Information System (IFMIS). The software has been designed specifically for government financial management. This design enables quick software configuration to government requirements and rapid implementation across all levels of government. This government-specific functionality includes international standards, commitment accounting, and budgetary controls. The FreeBalance Accountability Suite supports all aspects of the budget cycle and provides fiscal control over fund allocations, expenditures, appropriations, revenue administration, and civil service management. FreeBalance software is the most-widely deployed financial management application inside the Government of Canada. FreeBalance software is used by more than 30,000 public finance managers to manage billions of dollars of government expenditures and more than 700,000 public servants worldwide. |
FreeBalance launched a government Integrated Financial Management Information System (IFMIS) in 1994. The FreeBalance Accountability Suite™ became the most widely deployed financial application inside the Government of Canada.
Today, the FreeBalance Accountability Suite™ GRP is implemented globally within governments across the world. The Suite is recognized by the World Bank as the best solution for fragile states with low capacity, where governments need to initiate reform with a simple solution that has the flexibility to become more complex over time and reflect the government progress in implementing PFM reforms or a changing political context.
FreeBalance software is used by more than 60,000 public finance managers to manage hundreds of billions of dollars of government expenditures and more than 1.5 million civil servants across 18 time zones. Customers include the governments of Canada, Nunavut, Mongolia, Timor-Leste, Guyana, Sierra Leone, and Kosovo.
International Standards
The FreeBalance Accountability Suite supports good fiscal practice and internationally recognized standards such as:
100% Focused on Government
The FreeBalance Accountability Suite supports all aspects of the budget cycle and provides fiscal control over fund allocations, expenditures, appropriations, revenue administration, and human capital management.
FreeBalance is focused 100% on government. The underlying product architecture is designed for managing public finance. Unlike private sector finance, public finance is budget driven, not profit driven. Commitment accounting requires numerous control mechanisms between the initial budget approval and the completion of government fiscal transactions.
As a standard configuration (out-of-the-box), the FreeBalance Accountability Suite supports a wide range of budgetary controls in compliance with international public finance rules and codes of good fiscal practice:
The FreeBalance Accountability Suite adapts to meet many unique country needs including:
Integration
GRP systems need to integrate with a wide variety of automated sub-systems. The FreeBalance Accountability Suite leverages a component-based Services-Oriented Architecture (SOA) to facilitate integration:
Country-Specific Functionality
Governments worldwide select required functionality that reflects the unique country circumstances and can activate additional features and functionality as the political process evolves. The FreeBalance Accountability Suite is designed for managing government fiscal processes from the ground up. The FreeBalance GRP solution is implemented by activating functionality options through software configuration rather than bespoke programming and software source code customization.
Language and Localization
The support of local languages and terminology enables capacity building and government self-sustainability. The FreeBalance Accountability Suite is a multi-language GRP that adapts to meet unique language requirements:
Configuration
Configuration options enable rapid implementations and adjustments to support government legal reform. This approach includes:
Progressive Activation
Progressive activation supports the sequential activation of additional functionality though allowing ongoing changes to support evolving political processes and capacity building including:
Configuration and progressive activation makes the FreeBalance Accountability Suite sustainable by governments. The FreeBalance GRP does not require the significant software code customization needed for generic software to operate in government. And, the FreeBalance Accountability Suite does not require customization to support on-going PFM reform.
The FreeBalance Accountability Suite is a comprehensive Government Resource Planning software designed to support Public Financial Management:
Government Performance Management
Public Financials Management
Government Treasury Management
Public Expenditures Management
Government Receipts Management
Civil Service Management
The FreeBalance Accountability Platform or GRP is a pure-web Java Enterprise Edition (Java EE) Service-Oriented Architecture (SOA) platform designed for government financial management. Applications are deployed via Java Server Pages (JSP) supporting centralized, decentralized and hybrid deployment models. Platform The GRP is a technical software platform designed for government.
Capacity Building Capacity Building functionality is integral to the GRP design.
Information Security The FreeBalance Accountability Suite is deployed securely in government information environments.
|
To launch the GRP, open the URL provided by the system administrator in any of the certified browsers. The URL navigates to the logging screen of FreeBalance Accountability Suite.
Note: to properly access the GRP users must be connected to a network with adequate routing rights to reach the web application server provided by the system administrator.
After launching the GRP in the browser, the following window appears:
Notes:
Related documents:
The FreeBalance GRP uses the following Graphical User Interface (GUI) to interact with users, divided in four sections:
Title bar- The Government or department logo and name are displayed in the title bar, on the far right side the Help and language selection buttons are available.
Menu bars- Allows users to perform various tasks such as search, access new options, clear result access insert, update or search mode, as well as view a customizable list of frequently accessed features.
Window Display Area- Displays information relative to the currently active window. The screen typically contains fields, tabs, sub-tabs, buttons and information.
Right-hand Panel- Displays information related to the current application-user session.
From the above image:
This section provides detailed descriptions of common features and actions used throughout the GRP.
Overview
User 's address is taken into record through this tab. Users may have more than one addresses.
Fields
The following is a screenshot of the Addresses feature.
The following table lists and describes all visible fields for the Addresses feature, in their default order. Note that some fields depend on System Parameters and Rendering Control configuration to be visible and/or editable by users. Field names are subject to change through language label configuration.
Field | Description |
---|---|
Is Main | If true, indicates that this address is the user’s main address. |
Address Type | The type of address being input:
|
Country | Specifies the country name. |
Region | The region in which the address is located. |
Province | The province in which the address is located. |
District | The district in which the address is located. |
Divisional Secretariat | The divisional secretariat in which the address is located. |
Grama Niladhari Division | The grama niladhari division in which the address is located. |
City | The city of the user’s address. |
Address | The actual address of the application user. |
Zip Code | The zip code of the user’s address. |
Image is shown as reference material; position and names for labels, fields, and buttons are subject to the configuration of installed revision, System Parameters and Rendering Control.
Attachment | Size |
---|---|
Address.PNG | 15.52 KB |
Overview
The purpose of this feature is to enable users to attach different file types to a related record.
Fields
The following is a screenshot of the Attachments/Additional Information feature.
The following table lists and describes all visible fields for the Attachments/Additional Information feature, in their default order. Note that some fields depend on System Parameters and Rendering Control configuration to be visible and/or editable by users. Field names are subject to change through language label configuration.
Fields | Description |
---|---|
Id | It is system generated unique identification number. |
Attachment Classification | It represents the different types of documents, pre-defined in the system. |
Language | Allows users to select the language to store the title and description |
Title | Title of the document added by users. |
Description | User's description of the document. |
Attachment | Allows users to choose the file to attach. |
Date Time | Date and time of the last operation performed on the attachment. |
Date | Allows users to select the date related to the attachment. |
User | Name of the application-user that uploaded the attachment. |
Image is shown as reference material; position and names for labels, fields, and buttons are subject to the configuration of installed revision, System Parameters and Rendering Control.
Attachment | Size |
---|---|
Information.PNG | 9.06 KB |
Overview
Contacts refer to contact of the said user. A user may have more than one contacts.
Fields
The following is a screenshot of the Contact feature.
The following table lists and describes all visible fields for the Contact feature, in their default order. Note that some fields depend on System Parameters and Rendering Control configuration to be visible and/or editable by users. Field names are subject to change through language label configuration.
Field | Description |
---|---|
Is Main | Identifies if the contact added is the main point of contact. |
Contact Type | The kind of contact is selected from the drop-down box. For example, it can be a phone, mobile, or e-mail, etc. |
Contact Location Type | Type of location of the contact, such as home contact or work contact. |
Contact Value | The contact is defined in this field. |
Language | Defines the language to register the description. |
Description | Description regarding the contact is mentioned in this field. |
Image is shown as reference material; position and names for labels, fields, and buttons are subject to the configuration of installed revision, System Parameters and Rendering Control.
Attachment | Size |
---|---|
Contact.PNG | 10.44 KB |
Overview
This feature helps users add shortcuts to frequently used GRP features, as to avoid having to navigate or drill down from the main menu option repeatedly. Users can add the list of frequently used shortcuts with only one click, the cusomized list is exclusive for each application-user.
Add a Shortcut under My Menu
To add a shortcut under My Menu, follow the steps below:
Navigate to the feature to add (for example Admin ► System Security ► Users ► Change Password).
Remove a Shortcut under My Menu
To Remove a shortcut under My Menu, follow the steps below:
Generating a Report
System reports are documents containing information organized in a tabular form, generated on as required basis. Reports may refer to specific periods, events, occurrences, or subjects. This section shows the basics for generating pre-defined reports available on the GRP. In general, each module has a set of reports available. For each report, users can specify the period, sorting criteria, ascending/descending order options, and other optional values. The following image of a sample report shows the different section of a report screen.
Create a Record
To Create a Record follow the steps below:
A confirmation window appears to indicate that the record has been inserted.
Modify/Update a Record
To Modify or Update a Record follow the steps below:
A window appears to confirm the modification. Click OK to confirm.
Delete a Record
To Delete a Record follow the steps below:
4. Click OK to confirm and delete the record.
5. A window is displayed confirming the delete action.
To verify that the record has been deleted follow the steps below:
Users need to close the dialog box to continue working on the main window.
Perform Basic Search
The following steps are to be followed to perform a search for existing records.
Wildcards
The asterisk (*) or/and the underscore (_) may be used as wildcard characters in search fields.
Overview
The purpose of this feature is to enable users to attach supporting documents to a related record.
Fields
The following is a screenshot of the Supporting Documents Information feature.
The following table lists and describes all visible fields for the Supporting Documents feature, in their default order. Note that some fields depend on System Parameters and Rendering Control configuration to be visible and/or editable by users. Field names are subject to change through language label configuration.
Fields | Description |
---|---|
Id | It is system generated unique identification number. |
Attachment Classification | It represents the different types of documents, pre-defined in the system. |
Language | Allows users to select the language to store the title and descrip |
Title | Title of the document added by users. |
Description | User's description of the document. |
Date | Allows users to select the date related to the attachment. |
Image is shown as reference material; position and names for labels, fields, and buttons are subject to the configuration of installed revision, System Parameters and Rendering Control.
Overview
Workflow transitions are the different options available in a workflow process that helps in proceeding the approval/rejection process of a transaction into different stages.
Transitions
The table below depicts the default Workflow Transition states that are configured by default into the system for each feature; the transition column describes each available transition into the system and the resulted status upon selection of each transition:
Transition | Previous Status | Current Status | Next Status |
---|---|---|---|
None | None | Created | Approval Requested, Cancelled |
Cancel | Created | Cancelled | None |
Request for Approval | Created | Approval Requested | Approved, Rejected, Cancelled |
Reject | Approval Requested | Rejected | None |
Cancel | Approval Requested | Cancelled | None |
Approve | Approval Requested | Approved | None |
Transition to Approve from Approval Requested
Navigation
Click New Icon under or or at Contract Payment Retention.
Overview
This entity contains the collection of Coding Blocks used in Contract Line Items, Payment Retention and Guarantees entities. It is a collection because Coding Blocks are registered per Fiscal Year and Contracts can be multi-year. It is necessary a collection of Coding Blocks for all fiscal years covered by the Contract:
A Coding Block can be added by SELECTING a pre-existing one already recorded in the System, or by COMPOSING a Coding Block out of segments pre-defined in the Chart of Accounts.
To SELECT a Coding Block, follow these steps:
To COMPOSE a Coding Block, follow these steps:
The FreeBalance GRP GUI offers to users a wide array of functionalities, via different icons and buttons. The following sections group common icons and buttons by use-category, and list them in alphabetical order:
Main Window
Button/Icon | Name | Description |
---|---|---|
Collapse Information Pane | Allows users to collapse/expand the right-side information pane. | |
Full Screen | Full Screen button allows users to see the screen in full screen mode. | |
Help | Redirects users to the GRP Menu Document related to the active page. | |
Login | Logs the specified user-password combination into the application. | |
Menu | Allows users to access GRP features/functions. | |
My menu | Allows users to access GRP features/functions bookmarked by users. | |
Unread messages | Presents unread internal messages. |
Record Management
Button/Icon | Name | Description |
---|---|---|
Create / Add | Set screen to Insert Mode. Users can then create a new record through this button. | |
Delete | Click to remove the record. A window is displayed confirming the item is deleted. | |
Find | Allows users to find records. | |
Reset Password | Resets the user's password to the default value. | |
Results | Once a record has been created or searched for, users can return to the results screen when necessary. | |
Save | Click to save the information inputted. The record is stored and a confirmation message is presented. | |
Save and Return | Save changes and return to the previous screen. | |
Search | Set screen to Search Mode. Users can enter filter criteria and search existing entries. By default, when entering a feature, users are in Search Mode. | |
Update | Select to update all changes made to a record. |
Field Management
Button/Icon | Name | Description |
---|---|---|
Calendar | Allows users to select a calendar date. The following window appears: | |
Color Picker | Allows users to select color code. The following window appears: | |
Lookup | The Lookup tool allows users to browse and select existing items. Once selected, all available information automatically populates the corresponding fields. | |
Mandatory field | Indicates a field that is required. | |
Range Field | Allows users to select range of values. | |
Drop-down menu | All fields with a drop-down menu are limited to the information in the list. |
Data Tab Management
Button/Icon | Name | Description |
---|---|---|
Add Record | Adds the selected record from the list. | |
Collapse tree structure | Click to hide all items under a particular list. | |
Expand tree structure | Click to reveal all items under a particular list. | |
Move Down | Move selected items down one slot on the list. | |
Move to bottom of list | Move selected items to the bottom of the list. | |
Move to top of list | Move selected items to the top of the list. | |
Move Up | Move selected items up one slot on the list. | |
New | Add a new item to the detail tab. A screen appears allowing users to enter new information for a detail item. | |
Remove | Remove a record. A screen appears to confirm the record is deleted. | |
Move selected items to other list | Moves the selected items to other list. | |
Remove Record | Removes the selected record from the list. | |
Select All | Select all available records. | |
Unselect All | Unselect all available records. | |
Move all items to other list | Moves all items to the other list. | |
Remove all items from list | Removes all the items from the list. | |
Upward | Indicates data sorting criteria for report as upward. | |
Downward | Indicates data sorting criteria for report as downward. |
Transaction Management
Button/Icon | Name | Description |
---|---|---|
Audit | Allows users to view the audit history for the current record. The following screen appears: | |
List of Transacions | Lists transactions performed by the application user. | |
Proceed | Select to execute processes. | |
Workflow History | Allows users to view the history of workflow transitions for an item. The following screen appears: | |
Workflow Transition | Click this button to change the workflow status, and move the process to the next stage in the workflow. |
File Management
Button/Icon | Name | Description |
---|---|---|
Browse | Allows users to browser for a file. | |
Discard | Eliminate the selected file. | |
Execute Data Import | Allows users to execute the data import for the related screen. | |
Generate Data Import Template | Allows users to generate the template file related to the screen. | |
Import | Import a file from outside the GRP. When clicking the icon, a screen appears: Click the Browse icon, to search for a file. Click the icon to import an Excel or CSV file. |
Report Output Format
Button/Icon | Name | Description |
---|---|---|
Excel | When exporting a report, click the icon to export in Excel format. | |
Excel XLSX | When exporting a report, click the icon to export in Excel XLSX format. | |
HTML Export | When exporting a report, click the icon to export in HTML format. | |
MS Word | When exporting a report, click the icon to export in MS Word format. | |
ODS | When exporting a report, click the icon to export in ODS format. | |
ODT | When exporting a report, click the icon to export in ODT format. | |
When exporting a report, click the icon to export in PDF format. | ||
When exporting a report, click the icon to export in PDF format. | ||
RTF | When exporting a report, click the icon to export in RTF format. |
This document describes the compatible software recommended for deploying FreeBalance Accountability Suite or Government Resource Planning (GRP) software version 7, both from a server and client machine perspective. The values and versions presented are subject to change for final implementation in accordance with FreeBalance’s continual improvement of its applications and services.
The FreeBalance Accountability Suite or GRP is the only public financial management (PFM) solution designed exclusively for government. It is a flexible, modular financial management system that starts off simple but can scale to reflect the evolving needs of government and public-sector organizations.
The FreeBalance Accountability Suite is a web-based Java-powered platform designed for government financial management. Its applications support centralized environment, but are also flexible enough to accommodate decentralized & hybrid models. This capability allows Government officials, NGO’s and citizens to gain access through authorized users in a secure and stable web base environment.
There are certain standard client-side requirements that must be met in order for authorized users to access and take advantage of all the benefits of using the FreeBalance Accountability Suite. The following sections detail each of those requirements. Third party software configurations not mentioned within these sections, which are deemed as necessary by clients or FreeBalance implementation specialists, are to be subject of individual risk and impact analysis by FreeBalance Technical and Implementation specialists.
The FreeBalance Accountability Suite is accessed through a secure and stable layer architecture.
The initial point of access is gained through a Web Browser, through an internet or intranet connection. A decoupling point exists between the Client Side and the Server Side, this allows requirements from the Client Side to be independent from those on the Server Side. Providing flexible, yet stable and secure, software configuration combinations.
The Client Side consists of the systems platform that hold the software tools used by end-users to access the FreeBalance Accountability Suite. These systems are conformed at a minimum by a Web Browser and office suite applications used to manage information extracted from the FreeBalance Accountability Suite.
The specific requirements for the Client Side are as follows:
This section refers to requirements regarding essential software used at the client end System Platform (personal computer, notebook or laptop). Personal computer and laptops configurations vary depending on the manufacturer, model and year of make of the computer, the following list depicts the minimal recommended configuration that is to be used with the FreeBalance Accountability Suite.
Compatible Operating Systems
This section refers to requirements regarding the web browsers compatible with the FreeBalance Accountability Suite. Because of the large number of different web browsers on the market, and their different versions, the list of recommended browsers centers itself around those that are certified and recommended for use with the FreeBalance Accountability Suite.
Recommended Web Browsers
This section refers to requirements regarding the custom report generation software compatible with the FreeBalance Accountability Suite.
Compatible software
Other client side applications that are optional are listed below. These applications enable users to exploit the full potential of the FreeBalance Accountability Suite reporting capabilities, allowing them to execute information analysis for quick and effective decision making.
The following versions of office utility suites (word processors, spreadsheet programs, pdf readers) are recommended:
The web application is deployed as a series of layers that offer both stability and security when accessing the information managed through the FreeBalance Accountability Suite. The following sections detail the requirements necessary for providing users with all the benefits of using the FreeBalance Accountability Suite. Third party software configurations not mentioned within these sections, which are deemed as necessary by clients or FreeBalance implementation specialists, are to be subject of individual risk and impact analysis by FreeBalance Technical and Implementation specialists.
The Server Side consists of the systems platform that hold the software tools used to deploy FreeBalance Accountability Suite’s services to end users. This platform is conformed by a Web Server, Application Server and a Database Server.
Within the Server Side, a decoupling point exists separating the Web, Application and Database Server. Through the use of Hibernate ORM, the FreeBalance Accountability Suite can be seamlessly implemented with different Databases.
The specific requirements for the Server Side are as follows:
This section refers to requirements regarding supported software versions for the Web Server to host the FreeBalance Accountability Suite. The FreeBalance Accountability Suite main services are delivered to the end user through the web page published on this server.
This section refers to requirements regarding supported software versions for the Application Server to provide the FreeBalance Accountability Suite services. The Application server is compatible with the following software versions:
This section refers to requirements regarding supported software versions for the Database Server to host information managed through the FreeBalance Accountability Suite.
Supported DBMS Platforms:
This section refers to requirements regarding supported software versions for deploying a server cluster used by the FreeBalance Accountability Suite.
The following table summarizes the current compatibility matrix for FreeBalance Accountability Suite implementations.
Classification | Item | Client | Web Server | Application Server | Database Server |
---|---|---|---|---|---|
Operating Systems | Microsoft Windows | 7 Pro, 10 Pro |
|
|
|
CentOS | 7, 8 |
|
|
| |
Canonical Ubuntu | 16.04 LTS, 18.04 LTS |
|
|
| |
Web Browsers | Microsoft Internet Explorer | 9, 11 |
|
|
|
Microsoft Edge | Edge |
|
|
| |
Mozilla Firefox | 68.0 |
|
|
| |
Google Chrome | 75.0.x | ||||
Safari | 12.1.2 |
|
|
| |
Report Software
| Cristal Reports | 12.2 | |||
Jaspersoft Reports | 6.0.1 | ||||
Other Software | Microsoft Excel | 1997, 2007, 2010, 2013, 2016 |
|
|
|
Microsoft Word | 1997, 2007, 2010, 2013, 2016 | ||||
Libre Office | 4.x, 5.x |
|
|
| |
Open Office | 3.x |
|
|
| |
Adobe Reader | 6.x |
|
|
| |
Oracle JSE | JVM 6 (1.6.0.45) | ||||
Oracle JSE | JVM 7 (1.7.80) | ||||
Oracle JSE |
| JVM 8 (1.8.201) |
| ||
Web and Application Software | Apache Web Server |
| 2.4* |
|
|
Apache Tomcat |
|
| 6.0.45, 7.0.94 |
| |
Cluster Deployment Software | Apache Active MQ | 5.10.2 | |||
DBMS | Oracle MySQL |
|
|
| 5.7+ |
Oracle |
|
|
| 9i, 10g, 11g, 12c, 18c+ | |
Microsoft SQL Server |
|
|
| 2008, 2012, 2016, 2017+ |
+. Database and database manager installation are required prior to installing and configuring FreeBalance Accountability Suite.
Fields Operations
List Operations (Tabs)
FreeBalance Customer SupportThe user guides and on-line help utility are intended mainly for answering general questions about the FreeBalance Financial Accountability application. FreeBalance Inc. also has a comprehensive customer support System. At the time of System implementation, each customer organization designates certain individuals as Owner, Functional Prime and Technical Prime; these roles may overlap in some organizations. These individuals serve as the prime resources for providing assistance to other users within the organization, if applicable, and as points of contact (POC) for communicating with FreeBalance Support Services. Other users should contact one of these POCs who will, as necessary, contact our Customer Support Services staff. How to Contact FreeBalance Support Services If you are a POC for your organization and you require information or assistance beyond that provided by the documentation, please contact FreeBalance Support Services: By telephone: (613) 236-7785, between 8:00 a.m. and 6:00 p.m. (Eastern Time) By Using the FreeBalance Customer portal at http://www.freebalance.com/customer_login/ By e-mail: support@FreeBalance.com Our Customer Support Specialists will make every effort to answer your questions or help with specific problems. When contacting FreeBalance Customer Support, it is important to provide the following information:
|