narrative

iati-activities/iati-activity/transaction/provider-org/narrative

This is the reference page for the XML element narrative.

Definition

The name of the organisation. This can be repeated in multiple languages

Rules

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

This element may occur any number of times.

Either narrative or @ref must be present.

Attributes

@xml:lang

A code specifying the language of text in this element. It is recommended that wherever possible only codes from ISO 639-1 are used. If not present, the default language is assumed.

This value should be on the Language codelist.

Example Usage

The narrative child element can be used to declare freetext for the provider-org element of a transaction.

  <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" vocabulary="1" />
   <aid-type code="1" vocabulary="2" />
   <tied-status code="3" />
  </transaction>
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.

Changelog

2.01

The narrative element was introduced in 2.01.

Developer tools

Find the source of this documentation on github: