Geography Info - World Bank
by Viindoo
| Lines of Code | 455 |
| Technical name | viin_geography_info_world_bank |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/viin_geography_info_world_bank |
| Read description for | v 15.0 v 16.0 v 17.0 v 18.0 |
| Required Apps | Discuss (mail) |
| Included Dependencies | Viindoo Base Geography Info |
Country figures that stay current without anyone typing them
For teams that compare markets on population and income
Fill and refresh country population and income figures from World Bank data
Odoo 19.0 · Odoo Community · Odoo Enterprise · OPL-1
Extends Geography Info, which adds continents, languages, population and economic figures to every country.
What changes for your team
The countries you pick, filled in one step
Today: someone looks up population and GDP country by country and copies them in.
→ Tick the countries, choose Fetch From World Bank Data in Actions, and population, GDP, GNP, GNI, GNI (PPP) and both per-capita figures arrive. A notification says how many countries were updated, or warns when none could be.
A quarterly refresh nobody has to remember
Today: figures typed once go stale, and nobody notices until a report looks wrong.
→ A scheduled action updates every country that has an ISO3 code every three months. The administrator can change its interval or switch it off.
Only published figures are written
Today: a gap in a source table becomes a zero, or a guess, in your data.
→ Each country takes the most recent year the World Bank has data for, looking back up to ten years. A figure it does not publish keeps its current value, and countries it does not cover are skipped while the others update.
Ready on day one
The fetch action
In the Actions menu of the country list, for any selection.
The quarterly update
Installed as a scheduled action, running every three months.
For whoever hosts the server
Internet access to the World Bank and the Python library wbgapi. Nothing is configured in Odoo.
What is included
The fetch action and the scheduled update. The fields, the pivot and the chart they fill come from Geography Info, with which this module installs automatically.
Before you decide
What does the server send to the World Bank?
Only the three-letter country codes and the codes of the seven figures it asks for. No contact, company or business data leaves the database.
Do we need an account or a key?
No. The module reads the World Bank's open data; there is no key to enter.
What happens when the service cannot be reached?
Nothing is changed. A manual fetch warns that no country was updated; the next run tries again.
Are figures we typed ourselves kept?
A fetched value replaces the value typed for the same figure. A figure the World Bank does not publish for a country keeps what you typed.
Who can run it, and in which languages?
Administrators, from the Contacts configuration menu. The module ships in English and Vietnamese.
Try it, then ask us
The Live Preview opens the Countries screen of a demo database, and the Documentation tab covers setup and the fetch.
Pre-sales & partnership
viindoo.com/contactusTechnical support
viindoo.com/ticketTechnical requirements
- Odoo version: 19.0
- Editions: Odoo Community, Odoo Enterprise
- Required modules: Geography Info
- Python library: wbgapi
- License: OPL-1
- Languages: English, Vietnamese
Geography Info - World Bank
For administrators who want the country figures filled from the World Bank.
Note
Extends Geography Info - see its documentation.
Overview
This module fills the Population, GDP, GNP, GNI, GNI per Capita, GNI (PPP) and GNI per Capita (PPP) of countries with the latest values published by the World Bank, in US dollars. It works in two ways: you fetch the figures for selected countries yourself, or a scheduled action refreshes all countries every 3 months. It installs by itself with Geography Info.
Only countries with an ISO3 Code are updated. For each fetch the module takes the most recent year for which the World Bank has data, looking back up to ten years. A figure the World Bank does not publish for a country is left as it is.
Setup (for the Administrator)
The server needs internet access to the World Bank and the Python library wbgapi; ask whoever hosts your database to confirm both. Nothing is configured in Odoo.
The scheduled action is named Country Information: Update From World Bank Data. It runs every 3 months and is listed in Settings ‣ Technical ‣ Automation ‣ Scheduled Actions (developer mode). Change its interval or deactivate it there.
Administrator: fetch the figures
- Open Contacts ‣ Configuration ‣ Localization ‣ Countries.
- Tick the countries you want to update.
- Press Actions and choose Fetch From World Bank Data.
- Reload the list. The selected countries show the new figures.
When the fetch ends, a notification gives the outcome. On success it reads N of M countries were updated from the World Bank. If nothing could be updated it warns: No country was updated: the World Bank service is unreachable or has no data for the selected countries. In that case the figures stay unchanged. Countries for which the World Bank publishes no data (for example some territories such as Antarctica) are skipped automatically, and the others are still updated. Fetched values replace the values you typed for the same figures.
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
