This version is DEPRECATED, v2.03 is the latest version
Activity file
Definition
The activity file contains the data defined by the IATI activity standard.
It is an XML file, containing the relevant IATI activity standard fields for the publishing organisation.
Considerations
When using the IATI activity standard to produce an iati-identifier, the following should be considered:
An IATI publisher should publish at least one activity file.
An activity file should contain at least one
iati-activity
It should be updated at least annually.
It must be well-formed XML.
It must validate against the relevant version of the **IATI activity schema**
Any activity file must have
iati-activities
as the root element - to contain all other elements.The
generated-datetime
attribute ofiati-activities
- a date/time stamp for when the activity-file was generated - is highly recommended.The
generated-datetime
is declared at theiati-activities
level. Is not necessarily the same as thelast-updated-datetime
for the individualiati-activity
records within it.Across a set of activity files published by a single organisation, individual
iati-activity
, referenced via a uniqueiati-identifier
, should not be duplicated.A link to the activity file(s) should be published on the IATI Registry.
Ideally, this link would be to an activity file(s) on the publisher website or open data portal. However, third party tools are available to generate and host files on behalf of publishers.
- When creating the activity file it is recommended to avoid spaces and non-ascii characters in file names and urls. For example:
iatiactivity.xml
is preferable toIATI Activity.xml
.http://example.org/files/iatidata/iatiactivity.xml
is preferable tohttp://example.org/files/iati data/IATI Activity.xml
.
Further Guidance
For well-formed XML tests, see the W3C XML Validator
The IATI Validator tests data against the relevant version of the IATI organisation schema.