recipient-region

iati-activities/iati-activity/recipient-region

This is the reference page for the XML element recipient-region. See also the relevant overview page: Geography

Definition

A geopolitical region (above the country level) that will benefit from this activity. This element is primarily for administrative and geopolitical purposes. If the specific country/-ies are known, the activity report can use the recipient-country element instead. For geographical location, use the location element.

For the value of the @code attribute, see http://iatistandard.org/codelists/region

Attributes

@code

Machine readable code for the entity being described. The value should be available on a related codelist.

This value must be of type xsd:string.

This value must be on the Region codelist.

@vocabulary

The vocabulary from which the region code is drawn. If it is not present 1 - ‘OECD DAC’ is assumed.

This value must be of type xsd:string.

This value must be on the RegionVocabulary codelist.

@percentage

The percentage of the budget allocated to this item. Content must be a positive decimal number between 0 and 100, with no percentage sign. In version 1.03 of the IATI Standard this value became designated as a decimal value and no longer as a positive integer.

This value must be of type xsd:decimal.

@xml:lang

ISO 2 letter code specifying the language of text in this element.

This value must be on the Language codelist.

Example Usage

Example recipient-region with relevant Region code. The optional RegionVocabulary is also be declared

  <recipient-region code="498" vocabulary="1" />

When multiple recipient-region are declared, then the percentage values should sum to 100% for the specific iati-activity:

  <recipient-region code="498" percentage="50" vocabulary="1" />
  <recipient-region code="289" percentage="50" vocabulary="1" />

Additionally, the name of the Region can also be declared:

<recipient-region code="289">South of Sahara, regional<recipient-region>

Changelog

1.03

Where used, the percentage attribute is now designated as a decimal value and no longer as a positive Integer

Developer tools

Find the source of this documentation on github: