Reporting Obligations Database (ROD)
This service is part of Reportnet
The contents of ROD can be used in several different ways. Currently the main way is to browse the website. The contents of the database are also available for use as RSS, RDF and via XML-RPC. The purpose of this text is to give an introduction to how these technologies can be used to extract contents from ROD and overview what is available.
RDF and RSS
RDF and RSS are methods of distributing links to content from web sites for others to use. There are a wide-range of web sites that 'syndicate' their content in this way.
ROD offers several RSS and RDF feeds for syndication. This allows distributed users to display selected custom content from ROD in their own website or in an application such as an RSS newsreader. The data is available in a variety of formats. Choose your preferred format and import the data on your website or your Intranet. There are no restrictions on the use of these feeds.
Please let us know, so that we can let you know if we plan to change the service in any way. Please click on the title below to get the corresponding feed.
RSS (version 1.0)
- Reporting Obligation deadlines: available at: http://rod.eionet.europa.eu/events.rss; lists all reporting obligations with their deadline linked to environmental issues or countries specified in the URL. Only obligations with a numeric date deadline are listed. This feed is used for the Eionet calendar.
- Reporting Obligations: available at: http://rod.eionet.europa.eu/obligations.rss; lists all obligations linked to environmental issues or countries specified in the URL.
Note: Use http://rod.eionet.europa.eu/obligations.rss?issues=[issueId1],[issueId2], etc. or http://rod.eionet.europa.eu/obligations.rss?countries=[country1],[country2] Example: http://rod.eionet.europa.eu/obligations.rss?issues=8,9. The issue IDs are: 1 - Climate Change, 2 - Ozone Depletion, 3 - Acidification, 4 - Soil, 6 - Air quality, 7 - Noise, 8 - Natural Resources, 10 - Chemicals, 12 - Various other issues, 13 - Waste, 14 - Biodiversity Change and Nature, 15 - Water.
- Legislative Instruments: available at: http://rod.eionet.europa.eu/instruments.rss; lists all legislative instruments.
- Reporting Obligations: available at: http://rod.eionet.europa.eu/obligations.rdf; lists all reporting obligations with linked countries and environmental issues
- Legislative Instruments: available at: http://rod.eionet.europa.eu/instruments.rdf; lists all legislative Instruments.
- Countries and territories: available at http://rod.eionet.europa.eu/spatial.rdf; lists all countries and territories.
In the context of ROD, XML-RPC can be used to look up records in the database across the Internet. It is not an open door to query the whole of ROD as the procedures must have been anticipated and developed and made available for calling over XML-RPC. There are currently five procedures available to users:
- getActivities(): returns an ARRAY of STRUCTs that contains all the obligations in an ARRAY, with each obligation's information put into a STRUCT;
- getROComplete(): returns an ARRAY of STRUCTs that contains all the obligations in an ARRAY, with each obligation's information put into a STRUCT; all the fields of the obligations are returned;
- getROSummary(): returns an ARRAY of STRUCTs that contains all the obligations in an ARRAY, with each obligation's information put into a STRUCT; the STRUCT contains links to obligation, title, last update and description;
- getRODeadlines(): returns an ARRAY of STRUCTs that contains all the obligations in an ARRAY, with each obligation's information put into a STRUCT; the STRUCT contains the reporting client name and the next deadline;
- getCountries(): returns an ARRAY of STRUCTs that contains all countries from T_SPATIAL table; each STRUCT has got three country attributes:
- 'ISO' - the two-letter ISO code in capitals;
- 'URL' - 'http://rod.eionet.europa.eu/spatial/<T_SPATIAL.PK_SPATIAL_ID>' [T_SPATIAL.PK_SPATIAL_ID];
Other XML RPC methods can be put in place for key stakeholders if they specify what they want returned from ROD. If the returned information resembles the underlying logic for showing similar information on a web page then this can be fairly easy to implement. Sometimes all that is required is to do is to declare an existing method accessible over XML-RPC.
To make use of the ROD XML RPC, it needs to be called from a program. The following is an example for the Python programming language:
server = xmlrpclib.Server('http://rod.eionet.europa.eu/rpcrouter')
result = server.WebRODService.getActivities()
if not result:
print "No value returned"
The ROD XML RPC Router is: http://rod.eionet.europa.eu/rpcrouter. The service name is: WebRODService.