Skip to Content
Last modified by Artur on 2025/09/10 11:19
Hide last authors
Helena 1.1 1 All [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] is owned and maintained by a [[maintenance agency>>doc:sdmx:Glossary.Maintenance agency.WebHome]] (Agency identified by agencyID in the schemas). Similarly, all [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] (i.e., MetadataSets) is owned and maintained by a metadata provider organisation (MetadataProvider identified by metadataProviderID in the schemas). It is vital to the integrity of the [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]] that there are no conflicts in agencyID and metadataProviderID. In order to achieve this, [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] adopts the following rules:
2
3 1. Agencies are maintained in an AgencyScheme (which is a sub class of //OrganisationScheme//); Metadata Providers are maintained in a MetadataProviderScheme.
4 1. The [[maintenance agency>>doc:sdmx:Glossary.Maintenance agency.WebHome]] of the Agency/Metadata Provider Scheme must also be declared in a (different) AgencyScheme.
Elena 3.2 5 1. The "top-level" agency is [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] and this [[agency scheme>>doc:sdmx:Glossary.Agency scheme.WebHome]] is maintained by [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]].
6 1. Agencies registered in the top-level scheme can themselves maintain a single AgencyScheme and a single MetadataProviderScheme. [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] is an agency in the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] AgencyScheme. Agencies in any AgencyScheme can themselves maintain a single AgencyScheme and so on.
7 1. The AgencyScheme and MetadataProvideScheme cannot be versioned and thus have a fixed (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) set to ‘1.0’.
Helena 1.1 8 1. There can be only one AgencyScheme maintained by any one Agency. It has a fixed Id of 'AGENCIES'. Similarly, only one MetadataProvideScheme is maintained by one Agency and has a fixed id of 'METADATA_PROVIDERS'.
Elena 3.2 9 1. The format of the agency identifier is agencyId.agencyID etc. The top-level agency in this identification mechanism is the agency registered in the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] [[agency scheme>>doc:sdmx:Glossary.Agency scheme.WebHome]]. In other words, [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] is not a part of the hierarchical ID structure for agencies. [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] is, itself, a [[maintenance agency>>doc:sdmx:Glossary.Maintenance agency.WebHome]].
Helena 1.1 10
11 This supports a hierarchical structure of agencyID.
12
13 An example is shown below.
14
15 [[image:1750063904339-160.png]]
16
17 **Figure 16: Example of Hierarchic Structure of Agencies**
18
19 Each agency is identified by its full [[hierarchy>>doc:sdmx:Glossary.Hierarchy.WebHome]] excluding SDMX.
20
21 The XML representing this structure is shown below.
22
Helena 1.2 23 [[image:1750063968564-932.png]]
24
Helena 1.1 25 **Figure 17: Example Agency Schemes Showing a Hierarchy**
26
27 Examples of Structure definitions that show how Agencies are used, are presented below:
28
Helena 1.2 29 [[image:1750064031786-260.png]]
30
Helena 1.1 31 **Figure 18: Example Showing Use of Agency Identifiers**
32
33 Each of these [[maintenance agencies>>doc:sdmx:Glossary.Maintenance agency.WebHome]] has a Codelist with an identical id 'CL_FREQ'.
34
35 However, each is uniquely identified by means of the hierarchic agency structure.