v2.02 Standard - Proposals & changes
 Share
The version of the browser you are using is no longer supported. Please upgrade to a supported browser.Dismiss

 
View only
 
 
ABCDEFGHIJKLMNOPQR
1

ItemDescriptionTypeCodelistXMLOccurRulesv2.02 change statusURL of discussion postURL of IATI-Schemas issueLinks cross-posted1st iteration schema change doneSchema tests done1st iteration documentation updated1st iteration ruleset updatedBA ReviewIssues found
2
iati-activitiesTop-level list of one or more IATI activity records.iati-activities
3
versionA number indicating the IATI specification version in use. This is mandatory and must be a valid version.xsd:stringVersioniati-activities/@version1..1
4
generated-datetimeA date/time stamp for when this file was generated. This is not necessarily the last-updated date for the individual activity records in it. Use of this attribute is highly recommended, to allow recipients to know when a file has been updated.xsd:dateTimeiati-activities/@generated-datetime0..1
5
linked-data-defaultIf a publisher chooses to publish linked data about their IATI activities then allowing them to declare where this data is published would support discovery of it, and any additional information they may choose to publish as Linked Data alongside it.

This attribute is a URI path upon which an activity identifier can be appended to get a dereferenceable URI for any activity contained within a file.

Where a publisher declares using one of these properties that authoritative linked data is accessible for an activity then consuming applications that are generating Linked Data from an IATI XML file should assert an owl:sameAs relationship to the relevant URI.
xsd:anyURIiati-activities/@linked-data-default0..1
6
iati-activityTop-level element for a single IATI activity report.iati-activities/iati-activity1..*
7
last-updated-datetimeThe last date/time that the data for this specific activity was updated. This date must change whenever the value of any field changes.xsd:dateTimeiati-activities/iati-activity/@last-updated-datetime0..1
8
xml:langISO 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.Languageiati-activities/iati-activity/@xml:lang0..1
9
default-currencyDefault 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.xsd:stringCurrencyiati-activities/iati-activity/@default-currency0..1
10
hierarchyThe 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.xsd:intiati-activities/iati-activity/@hierarchy0..1
11
humanitarianA process flag to indicate that this activity relates entirely or partially to humanitarian aidxsd:Booleaniati-activities/iati-activity/@humanitarian0..1Additionhttp://support.iatistandard.org/entries/106937796-Humanitarian-Flaghttps://github.com/IATI/IATI-Schemas/issues/277YYComplete: pass + fail on branchYN/Aok
12
linked-data-uriA Linked Data URI for a given activity (overrides iati-activities/@linked-data-defaultif set)xsd:anyURIiati-activities/iati-activity/@linked-data-uri0..1
13
iati-identifierA globally unique identifier for the activity.

This MUST be prefixed with EITHER the current IATI organisation identifier for the reporting organisation (reporting-org/@ref) OR a previous identifier reported in other-identifier, and suffixed with the organisation’s own activity identifier. The prefix and the suffix should be separated by a hyphen “-”.

Once an activity has been reported to IATI its identifier MUST NOT be changed in subsequent updates.
iati-activities/iati-activity/iati-identifier1..1iati-identifier should match the regex[^\/\&\|\?]+
14
xsd:stringiati-activities/iati-activity/iati-identifier/text()
15
reporting-orgThe organisation issuing the report. May be a primary source (reporting on its own activity as donor, implementing agency, etc) or a secondary source (reporting on the activities of another organisation).

Specifying the @ref attribute is mandatory. May contain the organisation name as content.

All activities in an activity xml file must contain the same @ref AND this @ref must be the same as the iati-identifier recorded in the registry publisher record of the account under which this file is published.
iati-activities/iati-activity/reporting-org1..1
16
refMachine-readable identification string for the organisation issuing the report. Must be in the format {RegistrationAgency}-{RegistrationNumber} where {RegistrationAgency} is a valid code in the RegistrationAgency code list and {RegistrationNumber } is a valid identifier issued by the {RegistrationAgency}xsd:stringiati-activities/iati-activity/reporting-org/@ref1..1reporting-org/@refshould match the regex[^\/\&\|\?]+
17
typeThe type of organisation issuing the report. See IATI codelist for values.xsd:stringOrganisation Typeiati-activities/iati-activity/reporting-org/@type1..1
18
secondary-reporterA flag indicating that the reporting organisation is a secondary publisher: publishing data for which it is not directly responsible. This flag must not be reported by primary source publishersxsd:booleaniati-activities/iati-activity/reporting-org/@secondary-reporter0..1
19
narrativeThe name of the organisation. May be repeated for different languages.iati-activities/iati-activity/reporting-org/narrative1..*
20
xsd:stringiati-activities/iati-activity/reporting-org/narrative/text()
21
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/reporting-org/narrative/@xml:lang0..1
22
titleA short, human-readable title that contains a meaningful summary of the activity. May be repeated for different languages.iati-activities/iati-activity/title1..1
23
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/title/narrative1..*
24
xsd:stringiati-activities/iati-activity/title/narrative/text()
25
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/title/narrative/@xml:lang0..1
26
descriptionA longer, human-readable description containing a meaningful description of the activity. May be repeated for different languages.iati-activities/iati-activity/description1..*
27
typeThe type of description being provided. This is not required if only one general description of the activity is reported.xsd:stringDescription Typeiati-activities/iati-activity/description/@type0..1
28
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/description/narrative1..*
29
xsd:stringiati-activities/iati-activity/description/narrative/text()
30
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/description/narrative/@xml:lang0..1
31
participating-orgAn organisation involved with the activity. May be a donor, fund, agency, etc. Specifying the @ref identifier is strongly recommended. May contain the organisation name as narrative.

If the reporting organisation plays a role in the activity it should be repeated here. One organisation may play more than one role (eg, funding and implementing): in such a case each role should be reported and the name of the organisation repeated.
iati-activities/iati-activity/participating-org1..*
32
refMachine-readable identification string for the organisation. Must be in the format {Registration Agency} - (Registration Number} where {Registration Agency} is a valid code in the Registration Agency code list and {Registration Number } is a valid identifier issued by the {Registration Agency}. If this is not present then the narrative MUST contain the name of the organisation.xsd:stringiati-activities/iati-activity/participating-org/@ref0..1participating-org/@ref should match the regex [^\/\&\|\?]+Either @ref or narrativemust be present.
33
typeThe type of organisation issuing the report. See IATI codelist for values.xsd:stringOrganisation Typeiati-activities/iati-activity/participating-org/@type0..1
34
roleAn IATI code describing the organisation’s role in the activity (donor, agency, etc.).xsd:stringOrganisation Roleiati-activities/iati-activity/participating-org/@role1..1
35
activity-idA valid activity identifier published by the participating organisationxsd:stringiati-activities/iati-activity/participating-org/@activity-id0..1Additionhttp://support.iatistandard.org/entries/82377659-Add-activity-id-attribute-to-participating-org-elementhttps://github.com/IATI/IATI-Schemas/issues/278YYComplete: pass + fail on branchYN/Asee Github for revised DescriptionYF
36
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/participating-org/narrative0..*Either narrative or @ref must be present.
37
xsd:stringiati-activities/iati-activity/participating-org/narrative/text()
38
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/participating-org/narrative/@xml:lang0..1
39
other-identifierAn other identifier for the activity. This may be a publishers own identifier that it wishes to record with the activity. This element is also used to trace changes to activity identifiers, for example when and organisation has changed it’s organisation identifier.iati-activities/iati-activity/other-identifier0..*
40
refThe identifier you wish to report. This can be used to report a number of different types of identifiers. See the OtherIdentifierType codelist for details and options.xsd:stringiati-activities/iati-activity/other-identifier/@ref1..1
41
typeThe type of identifier being reported, taken from the OtherIdentifierType codelist.xsd:stringOther Identifier Typeiati-activities/iati-activity/other-identifier/@type1..1
42
owner-org
Where apllicable, the organisation that owns the other identifier being reported. When used, then either other-identifier/owner-org/@ref or other-identifier/owner-org/narrative/text() MUST be present.
iati-activities/iati-activity/other-identifier/owner-org0..1
43
refAn organisation identifier. This is NOT MANDATORY but when used MUST contain a valid organisation identifier.xsd:stringiati-activities/iati-activity/other-identifier/owner-org/@ref0..1
44
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/other-identifier/owner-org/narrative0..*
45
xsd:stringiati-activities/iati-activity/other-identifier/owner-org/narrative/text()
46
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/other-identifier/owner-org/narrative/@xml:lang0..1
47
activity-statusThe current status of the activity. See codelist for values.iati-activities/iati-activity/activity-status1..1
48
codeAn IATI code defining the current status of the activity.xsd:stringActivity Statusiati-activities/iati-activity/activity-status/@code1..1
49
activity-dateThe planned and actual start and completion dates of the activity. Start dates may reflect either the commencement of funding, planning or physical activity. End dates should, wherever possible, reflect the ending of physical activity.

The narrative content may contain text (e.g. 2011Q1) for accurately recording less specific dates such as month, quarter, or year.
iati-activities/iati-activity/activity-date1..*activity-date[@type='1' or@type='2'] must be present. activity-date[@type='1'] must be before activity-date[@type='3']activity-date[@type='2'] must be before activity-date[@type='4']activity-date[@type='2'] must be today, or in the past.activity-date[@type='4'] must be today, or in the past.
50
typeAn IATI code defining the type of activity date being reported.xsd:stringActivity Date Typeiati-activities/iati-activity/activity-date/@type1..1
51
iso-datexsd:dateiati-activities/iati-activity/activity-date/@iso-date1..1
52
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/activity-date/narrative0..*
53
xsd:stringiati-activities/iati-activity/activity-date/narrative/text()
54
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/activity-date/narrative/@xml:lang0..1
55
contact-infoContact information for the activity. Specify whatever is available. You may repeat this element for each contact person.iati-activities/iati-activity/contact-info0..*
56
typeThe type of contact. See IATI codelist for values.xsd:stringContact Typeiati-activities/iati-activity/contact-info/@type0..1
57
organisationThe name of the organisation to contact for more information about the activity.iati-activities/iati-activity/contact-info/organisation0..1
58
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/contact-info/organisation/narrative1..*
59
xsd:stringiati-activities/iati-activity/contact-info/organisation/narrative/text()
60
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/contact-info/organisation/narrative/@xml:lang0..1
61
departmentThe department within the organisation to contact for more information about the activity.iati-activities/iati-activity/contact-info/department0..1
62
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/contact-info/department/narrative1..*
63
xsd:stringiati-activities/iati-activity/contact-info/department/narrative/text()
64
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/contact-info/department/narrative/@xml:lang0..1
65
person-nameThe name of the contact person for the activity.iati-activities/iati-activity/contact-info/person-name0..1
66
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/contact-info/person-name/narrative1..*
67
xsd:stringiati-activities/iati-activity/contact-info/person-name/narrative/text()
68
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/contact-info/person-name/narrative/@xml:lang0..1
69
job-titleThe job title of the contact person at the organisation.iati-activities/iati-activity/contact-info/job-title0..1
70
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/contact-info/job-title/narrative1..*
71
xsd:stringiati-activities/iati-activity/contact-info/job-title/narrative/text()
72
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/contact-info/job-title/narrative/@xml:lang0..1
73
telephoneThe contact telephone number. May be repeated for multiple numbers.iati-activities/iati-activity/contact-info/telephone0..*
74
xsd:stringiati-activities/iati-activity/contact-info/telephone/text()
75
emailThe contact email address. May be repeated for multiple addresses.iati-activities/iati-activity/contact-info/email0..*
76
xsd:stringiati-activities/iati-activity/contact-info/email/text()
77
websiteThe contact web address. May be repeated for multiple sites.iati-activities/iati-activity/contact-info/website0..*
78
xsd:anyURIiati-activities/iati-activity/contact-info/website/text()
79
mailing-addressThe contact mailing address.iati-activities/iati-activity/contact-info/mailing-address0..*
80
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/contact-info/mailing-address/narrative1..*
81
xsd:stringiati-activities/iati-activity/contact-info/mailing-address/narrative/text()
82
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/contact-info/mailing-address/narrative/@xml:lang0..1
83
activity-scopeThe geographical scope of the activity: regional, national, sub-national, etc.iati-activities/iati-activity/activity-scope0..1
84
codeThe geographical scope. See IATI codelist for values.xsd:stringActivity Scopeiati-activities/iati-activity/activity-scope/@code1..1
85
recipient-countryA country that will benefit from this activity. If a specific country is not known the recipient-region element should be used instead. For geographical location, use the location element.

Multiple countries and regions can be reported, in which case the percentage attribute MUST be used to specify the share of total commitments across all reported countries and regions.

The country can also be specified at transaction rather than activity level. If recipient-country OR recipient-region are reported at the transaction level, ALL transactions MUST contain a recipient-country or recipient-region element and iati-activity/recipient-country and iati-activity/recipient-region MUST NOT be used.
iati-activities/iati-activity/recipient-country0..*
86
codeISO 3166-1 alpha-2 code for the country.xsd:stringCountryiati-activities/iati-activity/recipient-country/@code1..1
87
percentageThe percentage of total commitments or total activity budget allocated to this country. Content must be a positive decimal number between 0 and 100, with no percentage sign. Percentages for all reported countries and regions MUST add up to 100%xsd:decimaliati-activities/iati-activity/recipient-country/@percentage0..1
88
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/recipient-country/narrative0..*
89
xsd:stringiati-activities/iati-activity/recipient-country/narrative/text()
90
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/recipient-country/narrative/@xml:lang0..1
91
recipient-regionA supranational geopolitical region that will benefit from this activity. For sub-national geographical location, use the location element.

Multiple countries and regions can be reported, in which case the percentage attribute MUST be used to specifiy the share of total commitments across all reported countries and regions. Recipient-region must not be used merely to describe the region of a country reported in recipient-region, but ONLY if the region is a recipient IN ADDITION to the country.

Region can also be reported at transaction rather than activity level. If transaction/recipient-country AND/OR transaction/recipient-region are used THEN ALL transaction elements MUST contain a recipient-country and/or recipient-region element AND iati-activity/recipient-region and iati-activity/recipient-region MUST NOT be used AND each transaction MUST only contain one recipient-country or recipient-region.
iati-activities/iati-activity/recipient-region0..*
92
codeEither an OECD DAC or UN region code. Codelist is determined by vocabulary attribute.xsd:string(Region)iati-activities/iati-activity/recipient-region/@code1..1
93
vocabularyAn IATI code for the vocabulary from which the region code is drawn. If it is not present 1 - ‘OECD DAC’ is assumed.xsd:stringRegion Vocabularyiati-activities/iati-activity/recipient-region/@vocabulary0..1
94
vocabulary-uriIf the vocabulary is 99 (reporting organisation), the URI where this internal vocabulary is definedxsd:anyURIiati-activities/iati-activity/recipient-region/@vocabulary-uri0..1Additionhttp://support.iatistandard.org/entries/105713163-Add-URI-attribute-to-elements-where-Reporting-organisation-vocabularies-are-usedhttps://github.com/IATI/IATI-Schemas/issues/279YYShould Pass Done; Should Fail IssueYN/AOK, but NB email request for Wendy to add overview guidance next week
95
percentageThe percentage of total commitments or total activity budget allocated to this region. Content must be a positive decimal number between 0 and 100, with no percentage sign. Percentages for all reported countries and regions MUST add up to 100%xsd:decimaliati-activities/iati-activity/recipient-region/@percentage0..1
96
narrativeThe free text name or description of the item being described. This can be repeated in multiple languages.iati-activities/iati-activity/recipient-region/narrative0..*
97
xsd:stringiati-activities/iati-activity/recipient-region/narrative/text()
98
xml:langISO 639-1 code specifying the language of text in this element. If a default language is specified in the iati-activity element it does not have to be repeated here.Languageiati-activities/iati-activity/recipient-region/narrative/@xml:lang0..1
99
locationThe sub-national geographical identification of the target locations of an activity. These can be described by gazetteer reference, coordinates, administrative areas or a textual description. Any number of locations may be reported.iati-activities/iati-activity/location0..*
100
refAn internal reference that describes the location in the reporting organisation’s own system.xsd:stringiati-activities/iati-activity/location/@ref0..1
Loading...
Main menu