GRP Help

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.

 

FreeBalance Fundamentals

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 Government Resource Planning System

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:

  • United Nations Common Functions of Government (COFOG): Functional classification to report government statistics to the International Monetary Fund (IMF) and the United Nations.
  • The International Monetary Fund Government Finance Statistics (GFS): Provides a comprehensive conceptual and accounting framework suitable for analyzing and evaluating fiscal policy and performance of the general government sector and broader public sector of any country
  • The International Monetary Fund Code of Good Practices on Fiscal Transparency: Method to assess government fiscal transparency with practical advice for improvement.
  • Generally Accepted Accounting Principles (GAAP): A collection of rules, procedures and conventions that define accepted accounting practices.  This includes broad guidelines and detailed procedures applied to both the public and private sectors.
  • International Accounting Standards BoardInternational Financial Reporting Standards (IFRS): International private and public sector reporting standards.
  • International Federation of Accountants International Public Sector Accounting Standards Board International Public Sector Accounting Standards (IPSAS): Cash and accrual reporting requirements for government and public sector organizations.
  • Millennium Challenge Corporation (MCC): Governance outcome measurements supported in performance objectives.
  • Medium Term Expenditure Frameworks (MTEF): Multiple year rational planning and budget formulation processes enabling the government to establish credible and transparent criteria for allocating public resources to strategic priorities while ensuring overall fiscal discipline.
  • The World Bank Treasury Reference Model: A development tool for fiscal managers and system developers, intended to help implement good practices in fiscal accounting and expenditure control.

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: 

  • Aggregate Fiscal Controls: The initial approved budgetary funds are mapped to the Chart of Accounts (COA) at a pre-determined COA hierarchy level for aggregate fiscal control.
  • Multiple Levels of Allotment Controls: Support for approved appropriations, warrants, cash controls, supplemental budgets and allocations, mapped to summary or detailed levels within the COA and to fiscal periods.
  • Multiple Commitment Levels: Pre-encumbrance, commitment and obligation controls.
  • Multi-Funds and Project Controls: Projects and Programs are linked with fund sources, including linking specific budgets, projects or programs to specific revenue sources or donors.

The FreeBalance Accountability Suite adapts to meet many unique country needs including:

  • Chart-of-Accounts design supporting consolidation, reporting objects, international standards, valid code combinations and accounting offsets.
  • Multiple currencies, adjustment of fiscal periods, multi-year commitments, year-end and period-end procedures.
  • Multiple accounting methods (cash, modified cash, modified accrual and full accrual).
  • Workflow, business rules, forms and report configuration.
  • Custom domains to support unique government information integrated with workflow, rules, forms and reports.

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: 

  • Government Systems Integration supports of bank, revenue and expenditure systems including multiple government tiers.
  • Systems Management Integration includes integration tools and support for identity management.
  • Office Integration support typical office software and e-mail.

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:

  • Language support facilitated through uploading translation files.
  • Multiple character set support includes Unicode.
  • Terminology adjustment after uploading translation.

Configuration

Configuration options enable rapid implementations and adjustments to support government legal reform.  This approach includes:

  • International Public Sector Accounting Standards built-in support.
  • Configuration of functions through parameterization including supporting unique needs that require customization in traditional software.
  • Progressive Activation to support PFM reform and modernization.

Progressive Activation

Progressive activation supports the sequential activation of additional functionality though allowing ongoing changes to support evolving political processes and capacity building including:

  • Multiple year Chart of Accounts to support changes to government structures, reporting requirements and performance considerations.
  • Upgrading accounting methods to full accrual accounting.
  • Adapting budgetary controls to support de-centralization, performance objectives, fiscal discipline and improved decision-making.
  • Adding additional modules to support the best-practice of phased PFM reform.

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.

 

FreeBalance Accountability Suite Modules

 

The FreeBalance Accountability Suite is a comprehensive Government Resource Planning software designed to support Public Financial Management:

Government Performance Management

  • Performance Budgeting modules to support credible budgets, forecasting and improved government performance including budget preparation, government performance management and a Key Performance Indicator (KPI) library.
  • Monitoring and Evaluation modules to support improved decision-making including records management, reporting, data mart, dashboards and alerts.
  • Government Transparency modules to support publishing performance and budget information to a transparency portal and computer-aided audit.

Public Financials Management

  • Budget and Commitment Accounting modules to support core government financial functions for unitary governments, national governments, line ministries, sub-national and municipal governments and projects.
  • Assets and Inventory modules to support government fixed assets, stores, fleet and facilities.
  • Projects and Job Costing modules to support project management link budgeting and project accounting to project estimates and forecasts.

Government Treasury Management

  • Bank Reconciliation to support multiple currency bank management including reconciliation processes, migration to a Treasury Single Account (TSA) and foreign exchange gains and losses.
  • Cash Management to optimize liquidity including cash forecasting based on the commitment cycle, historical trends and manager reports.
  • Debt and Investment Management supporting debt servicing and the modeling of debt and investment financial vehicles.

Public Expenditures Management

  • Expenditures and Purchasing to support expenditure controls for standard expenditures including payment management, multiple purchasing vehicles and the purchasing cycle.
  • Procurement to support fiscal discipline on large scale government acquisitions including tendering, e-procurement, contract and spend management.
  • Grants and Social Programs including government grant, loan and contribution management.

Government Receipts Management

  • Non-Tax Revenue to support government sales and other income including sales, permits and licensing.
  • Tax Revenue to support tax administration for income, business, import and property.
  • Billing and Receipts to support receipts collection including utility billing, collections and cashiering.

Civil Service Management

  • Human Resources to support civil service reform and management including movement, capacity building, salary planning, performance appraisal and recruitment.
  • Payroll and Pensions to support government rules for payroll and pensions.
  • Benefits and Self-Service including civil service benefits, travel and subsistence and self-service portals.

 

 

The FreeBalance Accountability Platform

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.

  • Platform Foundation to support GRP modules operating on a wide variety of operating system, database, computer and Internet browser platforms including open source and commercial options.
  • Integrated Development Environment built on Eclipse to enable governments to develop specialized and unique GRP modules.
  • Systems Management to support maintaining systems, users and groups while managing archival, retrieval and system integrity check.

Capacity Building

Capacity Building functionality is integral to the GRP design.

  • Adaptable Help and Documentation updates standard system help and documentation to show government practices and assist users.
  • Knowledge Management tools to support government practice knowledge bases.
  • Change and Task Management tools to support government reform and modernization.

Information Security

The FreeBalance Accountability Suite is deployed securely in government information environments.

  • Authentication and Authorization includes strong access and identity management.
  • Digital and Electronic Signatures includes biometric integration.
  • Secure Cheque Printing meets financial standards.

 

Launching the GRP

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.


 

Accessing the GRP

After launching the GRP in the browser, the following window appears:

  • Enter the username assigned by the system administrator.
  • Enter the default password, provided by the system administrator.
  • Change the password after the first login to the application.
  • Click on the  button to open the main window.

Notes:

  • The default password provided by the system administrator is used only for the first time users log into the application.
  • Usernams and passwords are case-sensitve.

Related documents:

Graphical User Interface

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:

  1. Organization's Name - Title of the organization.
  2. User Menu - The menu provides users with available features of the application.
  3. Personalized User Menu - The menu consists of saved directory unique to the application user.
  4. Language Bar - Language options are represented by national flags.  Click the flag to change language setting to the corresponding language.
  5. Help - The Help icon provides a link to this site. The question mark (?) icon presents users with the navigation hotkeys.
  6. Search - Search keywords to be directed to a particular entity.
  7. Workspace Name - Provides the title of the current entity.
  8. Navigation Path - The screen directory.  The navigation path acts as a guide to the location of a particular entity.
  9. Mode Selector - Choose the Mode.  The user can create a new entity, search the System for an existing entity, or view results.  By default, the screen will be in Search Mode.
  10. Mode - Describes the current Mode selected.  By default, the user will be in Search Mode.
  11. Search Button - Presents a list of existing data entries relating to the current entity.
  12. Workspace - The space displaying configurable parameters specific to the current screen.
  13. Drop-down List - Allows users to select an item from the predefined list.
  14. Tabs - Displaying sub-workspaces within the current entity.  Click to Tab to view the corresponding Workspace.
  15. Command Buttons - The icons provide applicable work functions for the current entity.
  16. List - Displays a list of applicable entities.  Headings are displayed at the top of the list to describe the category.
  17. Collapsible Information Panel - Collapses and expands the right-hand panel.
  18. Internal Messages - The number of unread messages is displayed.  A green icon indicates a new message.
  19. Session Details - Indicates the user currently logged in and language setting.  Click Logout to sign off from the application.
  20. Revision Number - Revision number of the application.

 

Common Features and Actions

This section provides detailed descriptions of common features and actions used throughout the GRP.

Addresses

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:

  • unknown,
  • home,
  • work.
CountrySpecifies the country name.

Region

The region in which the address is located.

Province

The province in which the address is located.

DistrictThe district in which the address is located.
Divisional SecretariatThe divisional secretariat in which the address is located.
Grama Niladhari DivisionThe grama niladhari division in which the address is located.
CityThe 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.

AttachmentSize
Address.PNG15.52 KB

Attachments/Additional Information

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.

FieldsDescription
IdIt is system generated unique identification number.
Attachment ClassificationIt represents the different types of documents, pre-defined in the system.
LanguageAllows users to select the language to store the title and description
TitleTitle of the document added by users.
DescriptionUser's description of the document. 
AttachmentAllows users to choose the file to attach.
Date TimeDate and time of the last operation performed on the attachment.
DateAllows users to select the date related to the attachment.
UserName 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.

 

AttachmentSize
Information.PNG9.06 KB

Contacts

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.

AttachmentSize
Contact.PNG10.44 KB

Customize My Menu

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).

  1. Then, right-click on it.
  2. A message is presented asking if users want to create the shortcut.

  1. Click OK to confirm.
  2. Click on My Menu to view the added shortcut.

 

Remove a Shortcut under My Menu

To Remove a shortcut under My Menu, follow the steps below:

  1. Navigate to the shortcut under My Menu
  2. Then, right-click.
  3. A message is presented asking if users want to remove the shortcut.

  1. Click OK to confirm.

Generating a Report

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.

 

For generating a report, use the following steps:
  1. Select the desired report from the appropriate module report menu (e.g. Purchasing >> Reports >> Purchase Requisition Listing Report). The report definition screen appears.
  2. Complete the Filter Criteria fields, according to particular needs.
  3. Add a note in the Comment field if users want to have a special note printed out on the report.
  4. Define the Sort By criteria, by passing one or more fields from the available left field list to the Sort By criteria list box at the right:
  • Click the Move all items to other list  or Remove all items from list  icon, to add or remove all fields to/from the Sort By criteria list box. 
  • Click the Move selected items to other list  or Remove selected item from list  icon, to add or remove fields from the Sort By criteria list box. 
  • Click the Move selected items to top of list  or Move selected items to bottom of list  icon, to add or remove fields from the Sort By criteria list box. 
  • Click the Move selected items up one in list  or Move selected items down one in list  icon, to change the sorting sequence.
  • Click the Refresh Sorting Order  icon to update sorting fields.
  1. Specify sorting direction for each field that defines the sorting criteria:
  • Click the Upward  or Downward  icon to change the sorting order to downward / upward, respectively.
  1. Specify Additional Options, as required.

 

 

How to Create, Modify and Delete Records

Create a Record 

To Create a Record follow the steps below:

  1. To create a new record, click on the New button   (screen is in Insert Mode).
  2. Complete all mandatory fields and tabs. Fields denoted by an asterisk (*) are mandatory.
  3. Click on the Save button  at the bottom to save the new information.  

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:

  1. Enter the information to be used as retrieval criteria in the appropriate field(s). If users prefer to see the list of all records, leave all fields blank, and click on the Find  button.
  2. Click on the record to modify (screen is in Update/Delete Mode).
  3. Make the necessary modification(s).
  4. Click on the Update  button at the bottom of the screen to save the modifications.

A window appears to confirm the modification. Click OK to confirm.

Delete a Record

To Delete a Record follow the steps below: 

  1. Enter the information to be used as retrieval criteria in the appropriate field(s). If users prefer to see the list of all records, leave all fields blank, and click on the Find  button.
  2. Click on the record to delete (screen is in Update/Delete Mode).
  3. Click on the Delete  button.
  4. A window appears asking to confirm the action: 

  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:

  1. Click on the Search  button.
  2. Enter filter criteria matching the record.
  3. Click on the Find  button.
  4. A 'No results' message appears.

Users need to close the dialog box to continue working on the main window.  

 

How to Search for a Record or Element

Perform Basic Search

The following steps are to be followed to perform a search for existing records.

  1. By default, when users access a form the screen opens in Search Mode. To access the Search Mode while in Update/Delete Mode, click the Search  button. Once clicked the screen changes to search mode.
  2. Enter the information to be used as retrieval/filter criteria in the appropriate field(s). Leave all fields blank to see a list of all records or apply appropriate filters
  3. Click on the Find  button. 
 

Wildcards

The asterisk (*) or/and the underscore (_) may be used as wildcard characters in search fields.

  • The asterisk (*) replaces all previous or subsequent characters. For example, in the  ID field for an entry with 10, if users enters 10*, the results show all IDs that start with 10. As another example, *2 retrieves 2, C2, 1232, but not 23. Because the system is looking for IDs ending with 2. Whereas *SMITH* will retrieve “JOHN SMITH”, CAROL SMITHERS, but not Carl Smith because the search is case sensitive. 
  • While searching the underscore (_) replaces one character. For example, if searching for the name MacDonald, but unsure whether a capital “D” was used or not. Users can enter Mac_onald. Since the search is case-sensitive, the result displays all records that meet the criteria: MacDonald and Macdonald (spelled with an upper or a lowercase D). Another example is 36_2* retrieves all information starting with 36 followed by any character and followed by a 2 like 3682-2, or 3692-1.
 

Supporting Documents

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.

FieldsDescription
IdIt is system generated unique identification number.
Attachment ClassificationIt represents the different types of documents, pre-defined in the system.
LanguageAllows users to select the language to store the title and descrip
TitleTitle of the document added by users.
DescriptionUser's description of the document. 
DateAllows 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.

Workflow Transitions

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:

TransitionPrevious StatusCurrent StatusNext Status
NoneNoneCreatedApproval Requested, Cancelled
CancelCreatedCancelledNone
Request for ApprovalCreatedApproval RequestedApproved, Rejected, Cancelled
RejectApproval RequestedRejectedNone
CancelApproval RequestedCancelledNone
ApproveApproval RequestedApprovedNone

 

Transition to Approve from Approval Requested

To set a record status as approved, follow the steps below:
  1. Position in the record to change status to Approved.
    • Note: As shown in default workflow transition states, to set a record as Approved, record status must be Approval Requested.
  2. Select Approve from the drop down list in the transition field and then click the Transition  button
  3. A transition window is presented, confirming the transition to apply. Add a description in the step note field in the transition window:
  4. Click on the Finish  button to complete the transition transaction, or click the Discard  button to abort the transition. Upon clicking the Finish  button a window is displayed confirming the record workflow transition executed.
  5. Click OK on the workflow transition executed window. The record status is now set to Approved.
  6. Once a record has been created or selected from the search results window, the Workflow History  button allows users to view the workflow history of the item. The following screen appears:

 

 

Creating Coding Blocks

Navigation

Click New Icon  under  or  or  at  Contract Payment Retention.

Overview

This entity contains the collection of Coding Blocks used in Contract Line ItemsPayment 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:

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 Coding Block, follow these steps:

  1. In the Coding Block window, click the Lookup icon  next to the Coding Block field, then click the Find icon  on the Coding Block window for recovering the list of all pre-defined Coding Blocks
  2. Select the desired Coding Block from the list, and
  3. Click the Save and Return icon  to record your selection and return to the previous window or click the Discard icon  to clear your current selection and return to the previous window.

To COMPOSE Coding Block, follow these steps:

  1. In the Coding Block window, click the New icon next to the Coding Block field.  Another window will display.
  2. For each Coding Block segment displayed select the appropriate element from the pull-down list.
    Alternative, you can click the Lookup icon , then click the Find icon  on the Element window for recovering the list of all pre-defined elements, and then click the required element to return to the previous window.  Also, you can click the Hierarchical Element Selection icon  to compose the Coding Block using the values from the pull-down lists; once all  hierarchical segments have been specified, click the Save and Return icon  to record your selection and return to the previous window or click the Discard icon  to clear your current selection and return to the previous window.
  3. Once all Coding Block segments have been specified, click the Save and Return icon  to record your selection and return to the previous window or click the Discard icon  to clear your current selection and return to the previous window.
  4. Click the Save and Return icon  to record your selection and return to the previous window or click the Discard icon  to clear your current selection and return to the previous window.

Glossary Of Icons And Buttons

 

 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/IconNameDescription
Collapse Information PaneAllows users to collapse/expand the right-side information pane.
Full ScreenFull 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.
LoginLogs the specified user-password combination into the application.
MenuAllows users to access GRP features/functions.
My menuAllows users to access GRP features/functions bookmarked by users.
Unread messagesPresents unread internal messages.

 

Record Management

Button/IconNameDescription
Create / AddSet 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.
FindAllows users to find records.
Reset PasswordResets 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 ReturnSave changes and return to the previous screen.
SearchSet 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/IconNameDescription
Calendar Allows users to select a calendar date.  The following window appears:
Color PickerAllows 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 fieldIndicates a field that is required.
Range FieldAllows users to select range of values.
Drop-down menuAll fields with a drop-down menu are limited to the information in the list.

 

Data Tab Management

Button/IconNameDescription
Add RecordAdds the selected record from the list.
Collapse tree structureClick to hide all items under a particular list.
Expand tree structureClick to reveal all items under a particular list.
Move DownMove selected items down one slot on the list.
Move to bottom of listMove selected items to the bottom of the list.
Move to top of listMove selected items to the top of the list.
Move UpMove 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 listMoves the selected items to other list.
Remove RecordRemoves the selected record from the list.
Select All Select all available records.
Unselect All Unselect all available records.
Move all items to other listMoves all items to the other list.
Remove all items from listRemoves all the items from the list.
UpwardIndicates data sorting criteria for report as upward.
DownwardIndicates data sorting criteria for report as downward.

 

Transaction Management

Button/IconNameDescription
Audit Allows users to view the audit history for the current record.  The following screen appears:

List of TransacionsLists transactions performed by the application user.
ProceedSelect to execute processes.
Workflow HistoryAllows users to view the history of workflow transitions for an item. The following screen appears:

Workflow TransitionClick this button to change the workflow status, and move the process to the next stage in the workflow.

 

File Management
 

Button/IconNameDescription
BrowseAllows users to browser for a file.
DiscardEliminate the selected file.
Execute Data ImportAllows users to execute the data import for the related screen.
Generate Data Import TemplateAllows 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/IconNameDescription
Excel When exporting a report, click the icon to export in Excel format.
Excel XLSXWhen exporting a report, click the icon to export in Excel XLSX format.
HTML ExportWhen exporting a report, click the icon to export in HTML format.
MS WordWhen 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.
PDF When exporting a report, click the icon to export in PDF format.
PDF 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.

 

System Requirements and Compatibility Matrix

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.

1. Overview of the FreeBalance Accountability Suite

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.

2. Client-Side System Requirements

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.

 

Overview of Client Side

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:

Systems Platform Requirements

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

  • Microsoft Windows versions 7 Pro and 10 Pro
  • CentOS Linux 7,8
  • Canonical Ubuntu 16.04 LTS, 18.04 LTS

Web Browser Requirements

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

  • Microsoft Internet Explorer 9 and 11
  • Microsoft Edge
  • Mozilla Firefox 68.0
  • Google Chrome 75.0.x
  • Safari 12.1.2

 

Report Software

This section refers to requirements regarding the custom report generation software compatible with the FreeBalance Accountability Suite.

Compatible software

  • Cristal Reports 12.2
  • Jaspersoft Reports 6.0.1

Other Software Product Requirements

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:

  • Microsoft Excel 1997, 2007, 2010, 2013, 2016
  • Microsoft Word 1997, 2007, 2010, 2013, 2016
  • Libre Office 4.x, and 5.x
  • Open Office 3.x
  • Adobe Reader 6.x
 

3. Server-Side System Requirements

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.

Overview of Sever Side

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:

Web Server Requirements

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.

  • Apache Web Server 2.4

 

Application Server Requirements

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:

  • Java JVM 6 (1.6.0.45)
  • Java JVM 7 (1.7.80)
  • Java JVM 8 (1.8.201)
  • Apache-tomcat- Version 6.0.45, 7.0.94

 

Database Requirements

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:

  • Oracle MySQL 5.7
  • Oracle 9i, 10g, 11g, 12c, 18c
  • Microsoft SQL Server 2008, 2012, 2016, 2017

 

Cluster Deployment Software Requirements

This section refers to requirements regarding supported software versions for deploying a server cluster used by the FreeBalance Accountability Suite.

  • Apache Active MQ 5.10.2

4. Compatibility Matrix

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 Reports6.0.1   

Other Software

Microsoft Excel

1997, 2007, 2010, 2013, 2016

 

 

 

Microsoft Word1997, 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 SoftwareApache Active MQ  5.10.2 

DBMS

Oracle MySQL

 

 

 

5.7+

Oracle

 

 

 

9i, 10g, 11g, 12c, 18c+

Microsoft SQL Server

 

 

 

2008, 2012, 2016, 2017+

*. Apache 2.2 is needed as well if server instance holds FreeBalance Online Help system.

+. Database and database manager installation are required prior to installing and configuring FreeBalance Accountability Suite.

Common Fields and Lists Operations

Fields Operations

  • Dates: Can be defined using the Calendar  button.
  • Lookup button: It is used for retrieving a pre-registered element. To use it, click on the Lookup  button, then click on the Find  button to retrieve the appropriate list, then select a record from that list.
  • Drop-down menu: All fields with a drop-down menu  are limited to the information in the list. Click on the down arrow () to view this list and select an item.

 

List Operations (Tabs)

  • Click the individual Select Checkbox (es) , to select and de-select the elements, as required.
  • Click the Select All  button or Unselect All  button, to select or de-select all elements, as required. 
  • Click the Remove  button to remove the selected elements, if required. (Note: Make sure that only the elements to be deleted are selected before pressing the Remove button. By default, all elements are selected.)
  • Click the New  button to create a new element, if required.

Obtaining Technical Assistance

FreeBalance Customer Support

The 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:

  • The exact wording of any displayed error messages.
  • A description of what happened and what you were doing when the problem occurred (if applicable).
  • A complete description of how you tried to solve the problem before contacting us.