participating-org

Definition

An organisation involved with the activity. May be a donor, fund, agency, etc. Specifying the @ref identifier is strongly recommended. May contain the organisation name as narrative.

If the reporting organisation plays a role in the activity it should be repeated here. One organisation may play more than one role (eg, funding and implementing): in such a case each role should be reported and the name of the organisation repeated.

Rules

This element must occur at least once (within each parent element).

Attributes

@ref

Machine-readable identification string for the organisation. Must be in the format {Registration Agency} - (Registration Number} where {Registration Agency} is a valid code in the Registration Agency code list and {Registration Number } is a valid identifier issued by the {Registration Agency}. If this is not present then the narrative MUST contain the name of the organisation.

This value must be of type xsd:string.

1.8.1: The participating-org identifier should not start or end with spaces or newlines.

1.8.13: The receiver-org identifier must not contain any of the symbols /, &, | or ?.

6.10.1: The participating organisation must have an identifier or a narrative.

@type

The type of organisation issuing the report. See IATI codelist for values.

This value must be of type xsd:string.

This value must be on the OrganisationType codelist.

@role

An IATI code describing the organisation’s role in the activity (donor, agency, etc.).

This attribute is required.

This value must be of type xsd:string.

This value must be on the OrganisationRole codelist.

@activity-id

A valid activity identifier published by the participating organisation which points to the activity that it has published to IATI that describes its role in this activity.

This value must be of type xsd:string.

1.9.1: The participating-org activity identifier should not start or end with spaces or newlines.

Example Usage

Example participating-org in an iati-activity.

An example organisation @ref of BB-BBB-123456789 is declared.

The @role attribute declares a valid code (2) from the OrganisationRole codelist.

The @type attribute declares a valid code (40) from the OrganisationType codelist.

The @activity-id attribute declares an IATI activity identifier.

<participating-orgref="BB-BBB-123456789"role="2"type="40"activity-id="BB-BBB-123456789-1234">
        <narrative>Name of Agency B</narrative>
</participating-org>

As demonstrated in the the above example, it is strongly recommended that the name of the organisation is provided (using the narrative child element) in addition to a valid organisation identifier. Where an organisation identifier is not present the name (using the narrative child element) is mandatory.

The participating-org element can be repeated in any iati-activity.

In this example, three participating-org are declared.

<participating-orgref="BB-BBB-123456789"role="1"type="40"activity-id="BB-BBB-123456789-1234">
   <narrative>Name of Agency B</narrative>
</participating-org>
<participating-orgref="CC-CCC-123456789"role="2"type="10"activity-id="CC-CCC-123456789-1234">
   <narrative>Name of Agency C</narrative>
</participating-org>
<participating-orgref="AA-AAA-123456789"role="3"type="21"activity-id="AA-AAA-123456789-1234">
   <narrative>Name of Agency A</narrative>
   <narrative xml:lang="fr">Nom de l'agence A</narrative>	 	
</participating-org>

Changelog

Developer tools

Find the source of this documentation on github:

• Schema

• Extra Documentation

Subelements

• narrative