Skip to Content
Last modified by Helena on 2025/09/10 11:19
From version 10.2
edited by Helena
on 2025/05/19 13:53
Change comment: Update document after refactoring.
To version 5.1
edited by Helena
on 2025/05/16 00:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +8 Maintenance Agencies and Metadata Providers
Parent
... ... @@ -1,1 +1,0 @@
1 -Methodology.SDMX STANDARDS\: SECTION 6\. TECHNICAL NOTES Version 3\.0.WebHome
Content
... ... @@ -1,12 +1,16 @@
1 -All [[structural metadata>>doc:xwiki:Glossary.Structural metadata.WebHome]] in [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] is owned and maintained by a [[maintenance agency>>doc:xwiki:Glossary.Maintenance agency.WebHome]] (Agency identified by agencyID in the schemas). Similarly, all [[reference metadata>>doc:xwiki: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:xwiki:Glossary.Structural metadata.WebHome]] that there are no conflicts in agencyID and metadataProviderID. In order to achieve this, [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] adopts the following rules:
1 +{{box title="**Contents**"}}
2 +{{toc/}}
3 +{{/box}}
2 2  
5 +All structural metadata in SDMX is owned and maintained by a maintenance agency (Agency identified by agencyID in the schemas). Similarly, all reference metadata (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 that there are no conflicts in agencyID and metadataProviderID. In order to achieve this, SDMX adopts the following rules:
6 +
3 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:xwiki:Glossary.Maintenance agency.WebHome]] of the Agency/Metadata Provider Scheme must also be declared in a (different) AgencyScheme.
5 -1. The "top-level agency is [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] and this [[agency scheme>>doc:xwiki:Glossary.Agency scheme.WebHome]] is maintained by [[SDMX>>doc:xwiki: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:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] is an agency in the [[SDMX>>doc:xwiki: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:#2ecc71" %)version(%%) set to ‘1.0’.
8 +1. The maintenance agency of the Agency/Metadata Provider Scheme must also be declared in a (different) AgencyScheme.
9 +1. The "top-level" agency is SDMX and this agency scheme is maintained by SDMX.
10 +1. Agencies registered in the top-level scheme can themselves maintain a single AgencyScheme and a single MetadataProviderScheme. SDMX is an agency in the SDMX AgencyScheme. Agencies in any AgencyScheme can themselves maintain a single AgencyScheme and so on.
11 +1. The AgencyScheme and MetadataProvideScheme cannot be versioned and thus have a fixed version set to ‘1.0’.
8 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'.
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:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] [[agency scheme>>doc:xwiki:Glossary.Agency scheme.WebHome]]. In other words, [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] is not a part of the hierarchical ID structure for agencies. [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] is, itself, a [[maintenance agency>>doc:xwiki:Glossary.Maintenance agency.WebHome]].
13 +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 agency scheme. In other words, SDMX is not a part of the hierarchical ID structure for agencies. SDMX is, itself, a maintenance agency.
10 10  
11 11  This supports a hierarchical structure of agencyID.
12 12  
... ... @@ -16,20 +16,121 @@
16 16  
17 17  **Figure 16: Example of Hierarchic Structure of Agencies**
18 18  
19 -Each agency is identified by its full [[hierarchy>>doc:xwiki:Glossary.Hierarchy.WebHome]] excluding SDMX.
23 +Each agency is identified by its full hierarchy excluding SDMX.
20 20  
21 21  The XML representing this structure is shown below.
22 22  
23 -[[image:1747385891229-249.png]]
27 +**<str:AgencySchemes>**
24 24  
29 +**<str:AgencyScheme agencyID="SDMX" id="AGENCIES">**
30 +
31 +**<com:Name xml:lang="en">Top-level Agency Scheme</com:Name>**
32 +
33 +**<str:Agency id="AA">**
34 +
35 +**<com:Name xml:lang="en">AA Name</com:Name>**
36 +
37 +**</str:Agency>**
38 +
39 +**<str:Agency id="BB">**
40 +
41 +**<com:Name xml:lang="en">BB Name</com:Name>**
42 +
43 +**</str:Agency>**
44 +
45 +**</str:AgencyScheme>**
46 +
47 +**<str:AgencyScheme agencyID="AA" id="AGENCIES">**
48 +
49 +**<com:Name xml:lang="en">AA Agencies</com:Name>**
50 +
51 +**<str:Agency id="CC">**
52 +
53 +**<com:Name xml:lang="en">CC Name</com:Name>**
54 +
55 +**</str:Agency>**
56 +
57 +**<str:Agency id="DD">**
58 +
59 +**<com:Name xml:lang="en">DD Name</com:Name>**
60 +
61 +**</str:Agency> &nbsp;&nbsp;**
62 +
63 +**</str:AgencyScheme>**
64 +
65 +**<str:AgencyScheme agencyID="BB" id="AGENCIES">**
66 +
67 +**<com:Name xml:lang="en">BB Agencies</com:Name>**
68 +
69 +**<str:Agency id="CC">**
70 +
71 +**<com:Name xml:lang="en">CC Name</com:Name>**
72 +
73 +**</str:Agency>**
74 +
75 +**<str:Agency id="DD">**
76 +
77 +**<com:Name xml:lang="en">DD Name</com:Name>**
78 +
79 +**</str:Agency> &nbsp;&nbsp;**
80 +
81 +**</str:AgencyScheme>**
82 +
83 +**<str:AgencyScheme agencyID="AA.DD" id="AGENCIES">**
84 +
85 +**<com:Name xml:lang="en">AA.DD Agencies</com:Name>**
86 +
87 +**<str:Agency id="EE">**
88 +
89 +**<com:Name xml:lang="en">EE Name</com:Name>**
90 +
91 +**</str:Agency>**
92 +
93 +**</str:AgencyScheme>**
94 +
95 +**</str:AgencySchemes>**
96 +
25 25  **Figure 17: Example Agency Schemes Showing a Hierarchy**
26 26  
27 -Examples of Structure definitions that show how Agencies are used, are presented below:
99 +Examples of Structure definitions that show how Agencies are used, are presented below:
28 28  
29 -[[image:1747386478432-897.png]]
101 +**<str:Codelist agencyID="SDMX" id="CL_FREQ" version="1.0.0" &nbsp;**
30 30  
103 +**urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=SDMX:CL_FREQ(1.0.0)">**
104 +
105 +**<com:Name xml:lang="en">Frequency</com:Name>**
106 +
107 +**</str:Codelist>**
108 +
109 +**<str:Codelist agencyID="AA" id="CL_FREQ" version="1.0.0" &nbsp;**
110 +
111 +**urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=AA:CL_FREQ(1.0.0)">**
112 +
113 +**<com:Name xml:lang="en">Frequency</com:Name>**
114 +
115 +**</str:Codelist>**
116 +
117 +**<str:Codelist agencyID="AA.CC" id="CL_FREQ" version="1.0.0" &nbsp;**
118 +
119 +**urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=AA.CC:CL_FREQ(1.0.0)">**
120 +
121 +**<com:Name xml:lang="en">Frequency</com:Name>**
122 +
123 +**</str:Codelist>**
124 +
125 +**<str:Codelist agencyID="BB.CC" id="CL_FREQ" version="1.0.0" &nbsp;&nbsp;&nbsp; urn="urn:sdmx:org.sdmx.infomodel.codelist.Codelist=BB.CC:CL_FREQ(1.0.0)">**
126 +
127 +|(((
128 +**<com:Name xml:lang="en">Frequency</com:Name> &nbsp;&nbsp;&nbsp;**
129 +
130 +**</str:Codelist> &nbsp;&nbsp;&nbsp;**
131 +)))
132 +
133 +
134 +
135 +
31 31  **Figure 18: Example Showing Use of Agency Identifiers**
32 32  
33 -Each of these [[maintenance agencies>>doc:xwiki:Glossary.Maintenance agency.WebHome]] has a Codelist with an identical id 'CL_FREQ'.
138 +Each of these maintenance agencies has a Codelist with an identical id 'CL_FREQ'.
34 34  
35 35  However, each is uniquely identified by means of the hierarchic agency structure.
1747385891229-249.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -98.5 KB
Content
1747386478432-897.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -45.6 KB
Content