iati-activity

iati-activities/iati-activity

This is the reference page for the XML element iati-activity.

Definition

Top-level element for a single IATI activity report.

Rules

This element must occur at least once (within each parent element).

Attributes

@last-updated-datetime

The last date/time that the data for this specific activity was updated. This date must change whenever the value of any field changes.

This value must be of type xsd:dateTime.

@last-updated-datetime must not be more recent than the current date

@xml:lang

A code specifying the default language of text in this activity. It is recommended that wherever possible only codes from ISO 639-1 are used. If this is not declared then the xml:lang attribute MUST be specified for each narrative element.

This value should be on the Language codelist.

@xml:lang must exist, otherwise all lang must exist.

@default-currency

Default ISO 4217 alphabetic currency code for all financial values in this activity report. If this is not declared then the currency attribute MUST be specified for all monetary values.

This value must be of type xsd:string.

This value must be on the Currency codelist.

@default-currency must exist, otherwise all currency must exist.

@humanitarian

A process flag to indicate that this activity relates entirely or partially to humanitarian aid.

This value must be of type xsd:boolean.

@hierarchy

The hierarchical level within the reporting organisation’s subdivision of its units of aid. (eg activity = 1; sub-activity = 2; sub-sub-activity = 3). If hierarchy is not reported then 1 is assumed. If multiple levels are reported then, to avoid double counting, financial transactions should only be reported at the lowest hierarchical level.

This value must be of type xsd:int.

@linked-data-uri

A Linked Data URI for a given activity (overrides iati-activities/@linked-data-default if set)

This value must be of type xsd:anyURI.

@budget-not-provided

A code indicating the reason why this activity does not contain any iati-activity/budget elements. The attribute MUST only be used when no budget elements are present.

This value must be of type xsd:string.

This value must be on the BudgetNotProvided codelist.

Example Usage

Example of iati-activity.

This element is a parent for other child elements.
This example provides a dateTime of 2014-09-10T07:15:37Z for the @last-updated-datetime attribute.
A dateTime in UTC time is indicated by adding a Z behind the time
This example date time format conforms to the xsd:dateTime standard.
The @xml:lang attribute declares a valid code (en) from the Language codelist.
The @default-currency attribute declares a valid code (USD) from the Currency codelist.
The optional @humanitarian attribute is set as 1
The optional @hierarchy attribute is set as 1
The optional @linked-data-uri attribute is also included.
The optional @budget-not-provided attribute is also included.
 <iati-activity xml:lang="en" default-currency="USD" last-updated-datetime="2014-09-10T07:15:37Z" humanitarian="1" linked-data-uri="http://data.example.org/123456789" hierarchy="1" budget-not-provided="1">

The iati-activity element acts as a container for other sub-elements. It is closed as follows:

 </iati-activity>

Changelog

2.03

The @budget-not-provided attribute was added.

2.02

The @humanitarian attribute was added.

2.01

The @version attribute was removed.

1.02

Introduced the @linked-data-uri attribute on iati-activity element

Developer tools

Find the source of this documentation on github: