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

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>Annual Report 2013</narrative>
  </title>
  <description>
    <narrative>Description of the annual report.</narrative>
  </description>
  <category code="B01" />
  <language code="en" />
  <document-date iso-date="2014-02-05" />
  <recipient-country code="AF">
    <narrative>Afghanistan</narrative>
   </recipient-country>
 </document-link>

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

Changelog

Developer tools

Find the source of this documentation on github:

• Schema

• Extra Documentation

Subelements

• title
• description
• category
• language
• document-date
• recipient-country