Products Reportek
Contents
The Reportek is a Zope Product that implements the second generation of the EIONET national repository.
Reportek depends on two lists that it must get from somewhere:
You can either get the list from http://ROD.eionet.europa.eu with XML-RPC or you can use the SmallObligations product to roll your own obligations and/or localities. See the file HINTS.txt for information.
The recommended method of installing the product is to run a buildout similar to the reportek-zopebuildout. All the requirements and prerequisites are documented in order for ease of deployment.
The envelopes.rdf is used by Reportnet's content registry to harvest deliveries made to the repository. It uses a format called RDF. If you don't want the content registry to harvest you don't need to install it.
Documents have the ability to display their content converted to text or HTML - really anything that is quicker to display than the native format. For this it uses external converters. Look in Document.py to see what. If you haven't installed a certain external program, then Document.py will fall back to the native format.
The folder Converters is automatically added in the Root folder after the product is installed. In order to use the converters installed on the server (local converters) you must add an object of type Converter in the Converters folder specifying the path to the actual converter file, the type of the files that can be converted by it and the type of the output files.
(eg. If you have installed the pdftotext converter then type in the Converter path (including the arguments) something like: pdftotext -raw %s for Linux or something like "C:\Program Files\pdftotext" -raw %s for Windows.)
Once a converter is added in the Report Document list, you will be given the possibility to choose among the available conversions (View document as) for every type of document.
You can use Zope's builtin User folder, or you can use LDAPUserFolder from http://www.dataflake.org. This will hook you into the CIRCA site directory, Your own organisation's or EEA's. That is up to you.
Four (Five) types of users are foreseen:
And then there still is the Zope Manager, who can fix everything if/when the security paradigme doesn't cut it.
A user can be one, more or all of these roles at the same time. Additionally, a user can only delete objects he himself have created. And in the case of files, only if the envelope is not released.
The purpose of this product is to make it easy to store the obligatory environmental reports from each country. There are several organisations who receive these reports and for each organisation there are several reports covering subjects such as water and air quality.
To deal with the many reports we let the user organise them in a hierarchial set of collections of his own choice. At the leaves of the structure are the envelopes. They contain all the files and necesary meta-data. The collections also have meta-data, but they only serve as default values for envelope creation.
To prepare a report you first create an envelope. Then you upload the files and finally you release it for the public.
You can find information on how to generate documentation in the reportek-zopebuildout's README generate documentation section.
You can find information on how to run the tests in the reportek-zopebuildout's README tests section.