participating-org ================= ``iati-activities/iati-activity/participating-org`` This is the reference page for the XML element ``participating-org``. .. index:: single: 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 ~~~~~~~~~~ .. _iati-activities/iati-activity/participating-org/.ref: @ref Machine-readable identification string for the organisation issuing the report. Must be in the format {RegistrationAgency}-{RegistrationNumber} where {RegistrationAgency} is a valid code in the Organisation Registration Agency code list and {RegistrationNumber} is a valid identifier issued by the {RegistrationAgency}. If this is not present then the narrative MUST contain the name of the organisation. This value must be of type xsd:string. ``participating-org/@ref`` should match the regex ``[^\/\&\|\?]+`` Either ``@ref`` or ``narrative`` must be present. .. _iati-activities/iati-activity/participating-org/.type: @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 :doc:`OrganisationType codelist `. .. _iati-activities/iati-activity/participating-org/.role: @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 :doc:`OrganisationRole codelist `. .. _iati-activities/iati-activity/participating-org/.activity-id: @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. .. _iati-activities/iati-activity/participating-org/.crs-channel-code: @crs-channel-code Under CRS++ Reporting Directives this code identifies the implementing agency. Codes ending in '00' are generic and are similar to the OrganisationType code. This value must be of type xsd:string. This value must be on the :doc:`CRSChannelCode codelist `. 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. | The ``@crs-channel-code`` attribute declares the CRS Channel Code for the participating organisation. .. code-block:: xml Name of Agency B 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. .. literalinclude:: ../../activity-standard-example-annotated.xml :language: xml :start-after: :end-before: Changelog ~~~~~~~~~ 2.03 ^^^^ | The definition of the ``@ref`` attribute was `updated `__. | The ``@crs-channel-code`` attribute was `added `__. 2.02 ^^^^ | The ``activity-id`` attribute was `added `__. 2.01 ^^^^ Freetext is no longer allowed with this element. It should `now be declared `__ with the new child ``narrative`` element. | The ``OrganisationRole`` codelist was changed to numeric codes Developer tools ~~~~~~~~~~~~~~~ Find the source of this documentation on github: * `Schema `_ * `Extra Documentation `_ Subelements ~~~~~~~~~~~ .. toctree:: :titlesonly: :maxdepth: 1 participating-org/narrative