document-link¶

iati-activities/iati-activity/document-link

This is the reference page for the XML element document-link.

Definition¶

A link to an online, publicly accessible web page or document.

Rules¶

This element may occur any number of times.

Attributes¶

@url

The target URL of the external document, e.g. “http://www.example.org/doc.odt”.

This attribute is required.

This value must be of type xsd:anyURI.

@format

An IANA code for the MIME type of the document being referenced, e.g. “application/pdf”.

This attribute is required.

This value must be of type xsd:string.

This value must be on the FileFormat codelist.

Example Usage¶

Example document-link in an iati-activity.

This element is a parent for other child elements.

The @format attribute declares a valid code (application/vnd.oasis.opendocument.text) from the FileFormat codelist.

<document-link format="application/vnd.oasis.opendocument.text" url="http:www.example.org/docs/report_en.odt">
...
</document-link>

Full example with all child elements:

  <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>
   <description>
     <narrative> Description of the content of the project report or guidance on where to access the relevant information in this report </narrative>
   </description>
   <category code="A01" />
   <language code="en" />
   <document-date iso-date="2014-02-05" />
  </document-link>

The document-link element can be repeated in any iati-activity.

Changelog¶

2.03¶

The child element description was added.

1.02¶

Removed @language attribute from, and introduced an new language child element to, the document-link element.

Developer tools¶

Find the source of this documentation on github: