Publishing data from an infrastructure transparency portal¶
OC4IDS can be used to publish standardized open data on infrastructure projects where information is already collected and disclosed through infrastructure transparency portals, whether by CoST Multi-Stakeholder Groups, government agencies or civil society organizations.
Publishing standardized open data reduces barriers to use of data and supports the development of reusable tools and methodologies for working with data on infrastructure projects.
If you also collect detailed data on contracting processes, this can be published using the Open Contracting Data Standard (OCDS).
Linking to related information
Infrastructure transparency portal creators should consider what other types of information might be important to citizens, in addition to the in depth scrutiny related information in OC4IDS.
For example, Highways England provides links to congestion and traffic restriction information alongside information on roads projects.
Some of the following steps may require support from a technical expert. You can also contact the OC4IDS Helpdesk (firstname.lastname@example.org) for guidance.
(1) Make a commitment¶
Consider making or advocating for a public commitment to publish standardized open data using OC4IDS and OCDS.
Commitments are important to help align implementation with the goals of publishing open data and to help overcome technical, political or bureaucratic barriers to publication.
Refer to the OCDS implementation journey for information and resources about making commitments related to OCDS. Refer to the CoST and OGP guidance note for guidance on making OGP commitments related to CoST.
(2a) Map project-level data and summary contracting process data¶
Map existing data structures to OC4IDS.
The OC4IDS Field-Level Mapping Template can be used to document your mapping.
Your mapping might identify:
Gaps in your data where data in OC4IDS is not currently collected or disclosed in your system. Use OC4IDS as a guide to the information that is important to users and consider whether your system and business processes could be updated to collect and publish additional information.
Gaps in OC4IDS where data is collected by your system but doesn't map to OC4IDS. Rather than being excluded from your publication, such information should be included as additional fields in your data. Refer to extending the schema for information on including additional fields in your data.
(2b) Map detailed contracting process data¶
If you collect detailed data on contracting processes, refer to the OCDS implementation journey for information and resources about mapping and publishing your contracting data using OCDS.
Include an identifier for the infrastructure project that each contracting process relates to in your OCDS data, following the guidance on project identifiers in OCDS.
(3) Build your data, systems and processes¶
Create an OC4IDS JSON file for each project your system has information on and use the OC4IDS Data Review Tool to check that the files are structurally correct against OC4IDS.
You can use a
blank example OC4IDS JSON file to get started.
If you are also publishing contracting data using OCDS, create an OCDS release each time the data about a contracting process changes and use the OCDS Data Review Tool to check your OCDS releases.
Make sure you have systems and/or business processes in place to keep the data you produce up to date.
(4) Publish your data¶
Publish your OC4IDS JSON fields (as either static files or via an API) at a stable URL, such as:
If you are also publishing contracting data using OCDS, publish each new release of data as a JSON file at a stable URL such as:
Make sure your project-level files include links in the
contractingProcesses/releases section to each related OCDS file.
To make your data easier to access, consider providing:
A regularly updated bulk file of all your data for download
Flattened (spreadsheet or CSV) representations of your data
A page on your website with details of how users can access your data
Flatten-tool can be used to convert between JSON and spreadsheet/CSV format data.
Refer to the OCDS documentation for more information on providing data in multiple formats.