document-link¶

iati-organisations/iati-organisation/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-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>
  <category code="B01" />
  <language code="en" />
  <document-date iso-date="2014-02-05" />
  <recipient-country code="AF" />
 </document-link>

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

Changelog¶

2.03¶

The description element 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: