narrative

iati-activities/iati-activity/location/description/narrative

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

Definition

The free text name or description of the item being described. This can be repeated in multiple languages.

Rules

The text in this element must be of type xsd:string.

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

Attributes

@xml:lang

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

This value must be on the Language codelist.

Example Usage

The narrative element can be used to declare freetext for the description child element of location.

  <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-->
The narrative element can be repeated for any language additional to the default language set in iati-activity, by using the xml:lang attribute. Example not shown.

Developer tools

Find the source of this documentation on github:

Last updated on 2015-12-07