narrative¶
iati-activities/iati-activity/planned-disbursement/provider-org/narrative
This is the reference page for the XML element narrative. See also the relevant overview page: Budgets
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.
The time between budget/period-start/@iso-date and budget/period-end/@iso-date must not be over a year
If count(@lang) = 0 evaluates to true, then count(narrative/@lang) > 0 and (count(narrative) = count(narrative/@lang)) must evaluate to true.
If count(transaction/provider-org/@ref) = 0 evaluates to true, then count(transaction/provider-org/narrative) > 0 must evaluate to true.
If count(@default-currency) = 0 evaluates to true, then count(crs-add/loan-status/@currency) > 0 must evaluate to true.
If count(@default-currency) = 0 evaluates to true, then count(fss/forecast/@currency) > 0 must evaluate to true.
If count(transaction/receiver-org/@ref) = 0 evaluates to true, then count(transaction/provider-org/narrative) > 0 must evaluate to true.
If count(other-identifier/owner-org/@ref) = 0 evaluates to true, then count(other-identifier/owner-org/narrative) > 0 must evaluate to true.
If count(sector[@vocabulary=98 or @vocabulary=99]) > 0 evaluates to true, then count(sector/narrative) > 0 must evaluate to true.
@xml-lang must exist, otherwise all lang must exist.
sector must exist, otherwise all sector must exist.
@default-currency must exist, otherwise all currency must exist.
@last-updated-datetime must not be more recent than the current date
Each expression defined in number(recipient-country/@percentage) >= 0.0 must resolve to true.
Each expression defined in number(recipient-region/@percentage) >= 0.0 must resolve to true.
Each expression defined in number(sector/@percentage) >= 0.0 must resolve to true.
Each expression defined in number(capital-spend/@percentage) >= 0.0 must resolve to true.
All elements in sector[@vocabulary != '1']/@vocabulary are evaluated under the rules inside {u'strict_sum': {u'cases': [{u'paths': [u"sector[@vocabulary = '$1']/@percentage"], u'sum': 100}]}}.
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 should be on the Language codelist.
The time between budget/period-start/@iso-date and budget/period-end/@iso-date must not be over a year
If count(@lang) = 0 evaluates to true, then count(narrative/@lang) > 0 and (count(narrative) = count(narrative/@lang)) must evaluate to true.
If count(transaction/provider-org/@ref) = 0 evaluates to true, then count(transaction/provider-org/narrative) > 0 must evaluate to true.
If count(@default-currency) = 0 evaluates to true, then count(crs-add/loan-status/@currency) > 0 must evaluate to true.
If count(@default-currency) = 0 evaluates to true, then count(fss/forecast/@currency) > 0 must evaluate to true.
If count(transaction/receiver-org/@ref) = 0 evaluates to true, then count(transaction/provider-org/narrative) > 0 must evaluate to true.
If count(other-identifier/owner-org/@ref) = 0 evaluates to true, then count(other-identifier/owner-org/narrative) > 0 must evaluate to true.
If count(sector[@vocabulary=98 or @vocabulary=99]) > 0 evaluates to true, then count(sector/narrative) > 0 must evaluate to true.
@xml-lang must exist, otherwise all lang must exist.
sector must exist, otherwise all sector must exist.
@default-currency must exist, otherwise all currency must exist.
@last-updated-datetime must not be more recent than the current date
Each expression defined in number(recipient-country/@percentage) >= 0.0 must resolve to true.
Each expression defined in number(recipient-region/@percentage) >= 0.0 must resolve to true.
Each expression defined in number(sector/@percentage) >= 0.0 must resolve to true.
Each expression defined in number(capital-spend/@percentage) >= 0.0 must resolve to true.
All elements in sector[@vocabulary != '1']/@vocabulary are evaluated under the rules inside {u'strict_sum': {u'cases': [{u'paths': [u"sector[@vocabulary = '$1']/@percentage"], u'sum': 100}]}}.
Example Usage¶
The narrative child element can be used to declare freetext for the provider-org element of a planned-disbursement.
<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>