User Tools

Site Tools


Budget descriptions

As citizens, we need to understand what the different budgets are used for, where the money comes from, and where it goes. Numbers, codes and concepts are important, but don't say mean much to anyone who isn't familiar with municipal budgets. The budget descriptions enrich the information we make available to citizens.

The official description are usually not enough to understand the budgets. Our idea is that, working together, we can improve them and in doing so make municipal economy easier to understand.

Budget descriptions are the sum of information that facilitate the localization and comprehension of the budgets.

The description are important in OCAx because we depend on them to make the budgets truly understandable from all citizens. Good budget explications/descriptions will help, without doubt, to promote greater citizen participation and transform the official jargon, often technical, to a language more closer to the people.

We have already prepared some description that can be loaded into the OCAx database here:

Description are made up of four fields:

  • code: a number
  • label: Article, sub article, budget, sub budget, etc
  • concept: a short description of the budget
  • explicación: A more detailed text explaining the concept.

"Budget Search" and the descriptions

Citizens can search for budgets from the “Budgets” tab in the main OCAx menu. Available search fields are 'code' and 'text'. OCAx will search the description to find results. Budgets loaded in to the database that do not have a corresponding description will not show in the results.
Budgets without a description cannot be searched.

The three levels of descriptions

The three levels are:

State description: according to law. For example, in the case of Spanish municipalities this is the ORDEN EHA/3565/2008

Common description: A description defined by the collective knowledge of all OCMs. Together we choose descriptions that best suit each concept or budget.

Local description: This is the description your OCM defines, adapting it to your localality.

The state and common desctipions are loaded in to your OCAx database during the installation of the software. They cannot be modified. Common descriptions are in a constant state of joint development and new or improved description can be imported into your database.

Local descriptions can be created and modified by you. This is where each OCM should make an effort to facilitate descriptions in an easy to understand language for all citizens. Local descriptions explain budgets in such a way that people can relate to them at a local level.

OCAx tiene un orden de preferencia en el momento de escoger la descripción de las partidas a presentar al ciudadano: Local =⇒ Común =⇒ Oficial

When presenting the descriptions to the end user, OCAx selects the data from the three types of descriptions in a fixed order. Above all, the first data used is that of the local description, if there is no local description in the database, OCAx will then use the common description and in then the state descritpion.

In addition, OCAx saves the labels and concepts that were uploaded with each CSV when budgets are imported. This information is used if there is no data present in the description tables.
OCAx will tell you so with a message “Using data imported with CSV files.”

These three levels are then seen like this


If your site has two or more languages defined you should also make sure all your descriptions are translated. A list of languages is displayed for each description under 'View Description'

en/budgetdescriptions.txt · Last modified: 2015/03/11 09:33 by tuttle