You are viewing VERSION 2.02 of IATI Standard Reference View another version

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.

11.1.1: The last updated datetime of the activity must not be in the future.

@xml:lang

ISO 639-1 code specifying the default language used in narrative elements throughout the activity. 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.

4.1.1: The activity should specify a default language OR the language must be specified for each narrative element.

@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.

7.8.1: The activity should specify a default currency OR the currency must be specified for each monetary value.

@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.

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.

 <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">

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

 </iati-activity>

Changelog

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:

Subelements