description

iati-activities/iati-activity/location/description

This is the reference page for the XML element description. See also the relevant overview page: Geography

Definition

A description that qualifies the location, not the activity.

Rules

This element must occur no more than once (within each parent element).

Example Usage

Example usage of description within a location of an iati-activity.:

  <location ref="AF-KAN">
   <location-reach code="1" />    
   <location-id vocabulary="G1" code="1453782" />
   <name>
  <narrative>Location name</narrative>
   </name>
   <description>
  <narrative>Location description</narrative>
   </description>
   <activity-description>
  <narrative>A description that qualifies the activity taking place at the location.</narrative>
   </activity-description>
   <administrative vocabulary="G1" level="1" code="1453782" />
   <point srsName="http://www.opengis.net/def/crs/EPSG/0/4326">
    <pos>31.616944 65.716944</pos>
   </point>
   <exactness code="1"/>
   <location-class code="2"/>
   <feature-designation code="ADMF"/>
  </location>
  <!--location-single ends-->
  <!--location-additional starts-->
  <location ref="KH-PNH">
   <location-reach code="1" />    
   <location-id vocabulary="G1" code="1821306" />
   <name>
  <narrative>Location #2 name</narrative>
   </name>
   <description>
  <narrative>Location #2 description</narrative>
   </description>
   <activity-description>
  <narrative>A description that qualifies the activity taking place at location #2</narrative>
   </activity-description>
   <administrative vocabulary="G1" level="1" code="1453782" />
   <point srsName="http://www.opengis.net/def/crs/EPSG/0/4326">
    <pos>11.5500 104.9167</pos>
   </point>
   <exactness code="1"/>
   <location-class code="2"/>
   <feature-designation code="ADMF"/>
  </location>
  <!--location-additional ends-->
  <!--sector starts-->
  <sector vocabulary="2" code="111" percentage="50" />
  <sector vocabulary="2" code="112" percentage="50" />
  <sector vocabulary="98" vocabulary-uri="http://example.com/vocab.html" code="A1" percentage="100" />
  <!--sector ends-->
  <!--country-budget-items starts-->
  <country-budget-items vocabulary="2">
   <budget-item code="1.1.1" percentage="50">
    <description>
     <narrative>Description text</narrative>
    </description> 
   </budget-item>
   <budget-item code="1.2.1"  percentage="50">
    <description>
     <narrative>Description text</narrative>
     </description> 
   </budget-item>
  </country-budget-items>
  <!--country-budget-items ends-->
  <!--humanitarian-scope starts-->
  <humanitarian-scope type="1" vocabulary="1-2" code="EQ-2015-000048-NPL">
 	  <narrative>Nepal Earthquake April 2015</narrative>
    <narrative xml:lang="fr"> Népal Earthquake Avril 2015</narrative>
  </humanitarian-scope>
  <humanitarian-scope type="1" vocabulary="99" vocabulary-uri="http://example.com/vocab.html" code="A1">
   <narrative xml:lang="en">Nepal Earthquake April 2015</narrative>
  </humanitarian-scope>
  <!--humanitarian-scope ends-->
  <!--policy-marker starts-->
  <policy-marker vocabulary="1" code="2" significance="3" />
  <policy-marker vocabulary="1" code="9" significance="4" />
  <policy-marker vocabulary="99" vocabulary-uri="http://example.com/vocab.html" code="A1" significance="3" />
  <!--policy-marker ends-->
  <!--collaboration-type starts-->
  <collaboration-type code="1" />
  <!--collaboration-type ends-->
  <!--default-flow-type starts-->
  <default-flow-type code="10" />
  <!--default-flow-type ends-->
  <!--default-finance-type starts-->
  <default-finance-type code="110" />
  <!--default-finance-type ends-->
  <!--default-aid-type starts-->
  <default-aid-type code="A01" />
  <!--default-aid-type ends-->
  <!--default-tied-status starts-->
  <default-tied-status code="3" />
  <!--default-tied-status ends-->
  <!--budget starts-->
  <budget type="1" status="1">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="EUR" value-date="2014-01-01">3000</value>
  </budget>
  <!--budget ends-->
  <!--planned-disbursement starts-->
  <planned-disbursement type="1">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="EUR" value-date="2014-01-01">3000</value>
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" type="10" ref="BB-BBB-123456789">
    <narrative>Agency B</narrative>
   </provider-org>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" type="23" ref="AA-AAA-123456789">
    <narrative>Agency A</narrative>
   </receiver-org>
  </planned-disbursement>
  <!--planned-disbursement ends-->
  <!--planned-disbursement-single-date starts-->
  <planned-disbursement type="1">
   <period-start iso-date="2014-01-01" />
   <period-end iso-date="2014-12-31" />
   <value currency="EUR" value-date="2014-01-01">3000</value>
  </planned-disbursement>
  <!--planned-disbursement ends-->  
  <!--capital-spend starts-->
  <capital-spend percentage="88.8" />
  <!--capital-spend ends-->
  <!--transaction starts-->
  <transaction ref="1234" humanitarian="1">
   <transaction-type code="1" />
   <transaction-date iso-date="2012-01-01" />
   <value currency="EUR" value-date="2012-01-01">1000</value>   
   <description>
    <narrative>Transaction description text</narrative>
   </description>
   <provider-org provider-activity-id="BB-BBB-123456789-1234AA" type="10" ref="BB-BBB-123456789">
    <narrative>Agency B</narrative>
   </provider-org>
   <receiver-org receiver-activity-id="AA-AAA-123456789-1234" type="23" ref="AA-AAA-123456789">
    <narrative>Agency A</narrative>
   </receiver-org>
   <disbursement-channel code="1" />
   <sector vocabulary="2" code="111" />
   <!--Note: only a recipient-region OR a recipient-country is expected-->
   <recipient-country code="TM" />
   <recipient-region code="616" vocabulary="1" />   
   <flow-type code="10" />
   <finance-type code="110" />
   <aid-type code="A01" />   
   <tied-status code="3" />
  </transaction>
  <!--transaction ends-->
  <!--document-link starts-->
  <document-link format="application/vnd.oasis.opendocument.text" url="http:www.example.org/docs/report_en.odt">
   <title>
    <narrative>Project Report 2013</narrative>	   
    <narrative xml:lang="fr">Rapport de projet 2013</narrative>
   </title>
   <category code="A01" />
   <language code="en" />
   <document-date iso-date="2014-02-05" />
  </document-link>
  <!--document-link ends-->
  <!--activity-website starts this element may be removed
  <activity-website>http://www.example.com/en/activity/ABC123</activity-website>
  activity-website ends-->
  <!--related-activity starts-->
  <related-activity ref="AA-AAA-123456789-6789" type="1" />
  <!--related-activity ends-->
  <!--legacy-data starts-->
  <legacy-data name="Project Status" value="7" iati-equivalent="activity-status" />
  <legacy-data name="cost" value="1000" iati-equivalent="transaction" />
  <!--legacy-data ends-->
  <!--conditions starts-->
  <conditions attached="1">
   <condition type="1">
    <narrative>Conditions text</narrative>
    <narrative xml:lang="fr">Conditions texte</narrative>
   </condition>
  </conditions>
  <!--conditions ends-->
  <!--result starts-->
  <result type="1" aggregation-status="1">
   <title>
    <narrative>Result title</narrative>    
   </title>
   <description>
    <narrative>Result description text</narrative>   
   </description>
   <indicator measure="1" ascending="1">
     <title>
      <narrative>Indicator title</narrative>   		 
     </title>
     <description>
      <narrative>Indicator description text</narrative>
     </description>
     <reference vocabulary="1" code="3429" />
     <reference vocabulary="7" code="861" />
     <reference vocabulary="99" code="B1" indicator-uri="http://example.com/indicators.html" />     
     <baseline year="2012" value="10">
      <comment>
       <narrative>Baseline comment text</narrative>
      </comment>
     </baseline>
     <period>
      <period-start iso-date="2013-01-01" />
      <period-end iso-date="2013-03-31" />
      <target value="10">
       <location ref="AF-KAN" />
       <location ref="KH-PNH" />
       <dimension name="sex" value="female" />
       <dimension name="age" value="adult" />
       <comment>
        <narrative>Target comment text</narrative>			
       </comment> 
      </target>
      <actual value="11">
       <location ref="AF-KAN" />
       <location ref="KH-PNH" />
       <dimension name="sex" value="female" />
       <dimension name="age" value="adult" />
       <comment>
         <narrative>Actual comment text</narrative>
       </comment> 
      </actual>
     </period>
   </indicator>
  </result>
  <!--result ends-->
  <!--crs-add starts-->
  <crs-add>
   <other-flags code="1" significance="1" />
   <loan-terms rate-1="4" rate-2="3">
    <repayment-type code="1" />
    <repayment-plan code="4" />
    <commitment-date iso-date="2013-09-01"/>
    <repayment-first-date iso-date="2014-01-01" />
    <repayment-final-date iso-date="2020-12-31" />
   </loan-terms>
   <loan-status year="2014" currency="GBP" value-date="2013-05-24">
     <interest-received>200000</interest-received>
     <principal-outstanding>1500000</principal-outstanding>
     <principal-arrears>0</principal-arrears>
     <interest-arrears>0</interest-arrears>
   </loan-status>
   <channel-code>21039</channel-code>
  </crs-add>
  <!--crs-add ends-->
  <!--fss starts-->
  <fss extraction-date="2014-05-06" priority="1" phaseout-year="2016">
   <forecast year="2014" value-date="2013-07-03" currency="GBP">10000</forecast>
  </fss>
  <!--fss ends-->
 </iati-activity>
  <!--iati-activity ends-->	
</iati-activities>
<!--iati-activities ends-->

Changelog

2.01

Freetext is no longer allowed with this element. It should now be declared with the new child narrative element.

1.04

The documentation in the schema has changed from “A human-readable description of the location (not the activity).”

Developer tools

Find the source of this documentation on github:

Subelements

Last updated on 2015-12-07