Reports about the impact scenario project are generated using QGIS composer templates. The default template is shipped with the plugin, but you can easily create your own templates in QGIS and use them as a basis for your reports.
Localised templates are supported via the following simple schema:
If there is a specified template called /path/to/template/foo.qpt then the plugin looks in the template directory /path/to/template/ for a file called file foo-LANG.qpt, where “LANG” is the language code of the system locale.
If such a file exists it will be used for report creation, otherwise the original template /path/to/template/foo.qpt will be used.
A template contains the following types of elements:
These are elements which are not changed during report generation, e.g. some logos/images, additional texts, etc. You can safely remove such elements or replace them with your own as needed.
In this case the element name is not significant, only the token(s) it contains. At render time any of the tokens in these elements will be replaced with translated content (if an alternative locale is in effect) from the plugin according to the keywords listed below in this document.
In this case any content that may be present in the element is completely replaced by the realtime map renderer, although certain styling options (e.g. graticule settings on the map) will remain in effect.
These elements are recognised by their IDs and currently the plugin supports the following elements:
safe-logo — QGIS composer image, which is used for displaying the InaSAFE logo with website url
organisation-logo — QGIS composer image, which is used for displaying an organisational logo; By default a combined supporters logo is used; To use a custom logo image, set the path to your PNG file in the Options dialog (see Options for details).
impact-map — QGIS composer map, which is used for displaying the impact scenario
impact-legend — QGIS composer legend, which is used for displaying the legend of the impact scenario
impact-report — QGIS composer label, which is used for displaying the impact report table
Note
As QGIS composer doesn’t support automatic resizing of elements based on their contents, make sure that labels have dimensions large enough to show the full table.
This section describes tokenised keywords that are passed to the map template. To insert any of these keywords into the map template, simply enclose the key in [] (e.g. [place-name]) and it will be replaced by the text value (e.g. Tondano). The list includes static phrases which have been internationalised (and so they will be displayed in the language of the selected map local, defaulting to English where no translation is available).
The following tokenised keywords are supported:
You have a few options to customise the template without doing any programming. There are three primary ways you can achieve this:
The default template is provided as inasafe/safe_qgis/resources/qgis-composer-templates/inasafe.qpt and can be modified by opening the template using the QGIS map composer, making your changes and then overwriting the template or saving it in any directory.
You should take care to test your template changes before using it in a production environment.
In addition to the default template you can have as many custom templates as you want. Just create templates, put them in a folder and go to Plugins ‣ InaSAFE ‣ InaSAFE Options or click on the InaSAFE plugin toolbar’s Options button. In the Options dialog specify the Report template setting. It should contain the full path to the folder with your custom templates.