Skip to Content
Last modified by Helena K. on 2026/06/09 19:45
From version 33.2
edited by Helena K.
on 2026/06/09 19:20
Change comment: There is no comment for this version
To version 33.6
edited by Helena K.
on 2026/06/09 19:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -180,7 +180,7 @@
180 180  
181 181  === 5.2.2 Structure Submission Service ===
182 182  
183 -The registry must support a mechanism for submitting [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. This mechanism can be the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] REST interface for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] (this is defined in the corresponding GitHub project, dedicated to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] REST API: [[__https:~~/~~/github.com/sdmx-twg/sdmx-rest__>>https://https:github.comsdmx-twgsdmx-rest]]). In order for the architecture to be scalable, the finest-grained piece of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] that can be processed by the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR is a MaintainableArtefact, with the exception of [[Item Schemes>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]], where changes at an Item (% style="color:#e74c3c" %)level(%%) is also possible (see next section on the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]).
183 +The registry must support a mechanism for submitting [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]]. This mechanism can be the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] REST interface for [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] (this is defined in the corresponding GitHub project, dedicated to the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] REST API: [[__https:~~/~~/github.com/sdmx-twg/sdmx-rest__>>https://https:github.comsdmx-twgsdmx-rest]]). In order for the architecture to be scalable, the finest-grained piece of [[structural metadata>>doc:sdmx:Glossary 2\.1.Structural metadata.WebHome]] that can be processed by the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]]-RR is a MaintainableArtefact, with the exception of [[Item Schemes>>doc:sdmx:Glossary 2\.1.Item scheme.WebHome]], where changes at an Item [[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] is also possible (see next section on the [[SDMX Information Model>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]]).
184 184  
185 185  === 5.2.3 Structure Query Service ===
186 186  
... ... @@ -201,22 +201,22 @@
201 201  
202 202  The Data Registration Service allows [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] conformant files and web-accessible databases containing published data and [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] to be registered in the [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]]. The registration process MAY validate the content of the [[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadata-sets, and MAY extract a concise [[representation>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the contents in terms of (% style="color:#e74c3c" %)concept(%%) values (e.g., values of the data [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], metadata [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]), or entire keys, and storing this as a record in the registry to enable discovery of the original [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or
203 203  
204 -metadata-set. These are called (% style="color:#e74c3c" %)Constraints(%%) in the [[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]].
204 +metadata-set. These are called [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] in the [[SDMX-IM>>doc:sdmx:Glossary 2\.1.SDMX Information Model.WebHome]].
205 205  
206 206  The Data Registration Service MAY validate the following, subject to the access control mechanism implemented in the Registry:
207 207  
208 208  * that the data/metadata provider is allowed to register the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadataset;
209 -* that the content of the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadataset meets the validation (% style="color:#e74c3c" %)constraints(%%). This is dependent upon such (% style="color:#e74c3c" %)constraints(%%) being defined in the structural repository and which reference the relevant [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], [[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]], [[Data Provider>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]], Metadata Provider, [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], [[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]], [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]], Metadata [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]];
209 +* that the content of the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadataset meets the validation [[constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]. This is dependent upon such [[constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] being defined in the structural repository and which reference the relevant [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], [[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]], [[Data Provider>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]], Metadata Provider, [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], [[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]], [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]], Metadata [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]];
210 210  * that a queryable [[data source>>doc:sdmx:Glossary 2\.1.Data source.WebHome]] exists – this would necessitate the registration service querying the service to determine its existence;
211 211  * that a simple [[data source>>doc:sdmx:Glossary 2\.1.Data source.WebHome]] exists (i.e., a file accessible at a URL);
212 212  * that the correct [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] is used by the registered data;
213 213  * that the [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] ([[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]], [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]) are consistent with the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]];
214 -* that the valid [[representations>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the (% style="color:#e74c3c" %)concepts(%%) to which these [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] correspond conform to the definition in the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
214 +* that the valid [[representations>>doc:sdmx:Glossary 2\.1.Representation.WebHome]] of the [[concepts>>doc:sdmx:Glossary 2\.1.Concept.WebHome]] to which these [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] correspond conform to the definition in the [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].
215 215  
216 216  The Registration has an action [[attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] which takes one of the following values:
217 217  
218 218  (% style="width:893.835px" %)
219 -|(% style="width:241px" %)**Action [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] Value**|(% style="width:650px" %)**Behaviour**
219 +|(% style="width:241px" %)**Action Attribute Value**|(% style="width:650px" %)**Behaviour**
220 220  |(% style="width:241px" %)Append|(% style="width:650px" %)Add this registration to the registry
221 221  |(% style="width:241px" %)Replace|(% style="width:650px" %)Replace the existing Registration with this Registration identified by the id in the Registration of the Submit Registration Request
222 222  |(% style="width:241px" %)Delete|(% style="width:650px" %)Delete the existing Registration identified by the id in the Registration of the Submit Registration Request
... ... @@ -224,7 +224,7 @@
224 224  The Registration has three Boolean [[attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] which may be present to determine how an [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] compliant [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadataset indexing application must index the [[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] or metadatasets upon registration. The indexing application behaviour is as follows:
225 225  
226 226  (% style="width:896.835px" %)
227 -|**Boolean [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]**|(% style="width:712px" %)**Behaviour if Value is “true”**
227 +|**Boolean Attribute**|(% style="width:712px" %)**Behaviour if Value is “true”**
228 228  |indexTimeSeries|(% style="width:712px" %)A compliant indexing application must index all the [[time series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] keys
229 229  |indexDataSet|(% style="width:712px" %)(((
230 230  A compliant indexing application must index the range of actual (present) values for each [[dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] of the [[Dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].
... ... @@ -251,7 +251,7 @@
251 251  
252 252  [[Subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]] management involves a user submitting a [[subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]] request which contains:
253 253  
254 -* a query or (% style="color:#e74c3c" %)constraint(%%) expression in terms of a filter which defines the events for which the user is interested (e.g., new data for a specific [[dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], or for a domain [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]], or changes to a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]).
254 +* a query or [[constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] expression in terms of a filter which defines the events for which the user is interested (e.g., new data for a specific [[dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], or for a domain [[category>>doc:sdmx:Glossary 2\.1.Category.WebHome]], or changes to a [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]).
255 255  * a list of URIs or endpoints to which an XML [[notification>>doc:sdmx:Glossary 2\.1.Notification.WebHome]] message can be sent. Supported endpoint types will be email (mailto and HTTP POST (a normal http:~/~/ address);
256 256  * request for a list of submitted [[subscriptions>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]];
257 257  * deletion of a [[subscription>>doc:sdmx:Glossary 2\.1.Subscription.WebHome]];
... ... @@ -260,11 +260,11 @@
260 260  
261 261  === 5.2.7 Registry Behaviour ===
262 262  
263 -The following table defines the behaviour of the [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]] for the various Registry Interface messages. It should be noted, though, that as of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0, an extended versioning scheme newly including semantic versioning is foreseen for all [[Maintainable Artefacts>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]. Moreover, while the old versioning scheme is allowed, given there is no more
263 +The following table defines the behaviour of the [[SDMX Registry>>doc:sdmx:Glossary 2\.1.SDMX Registry.WebHome]] for the various Registry Interface messages. It should be noted, though, that as of [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.0, an extended versioning scheme newly incl
264 264  
265 -a "final" flag, there is no way guaranteeing the consistency across (% style="color:#e74c3c" %)version(%%) of a Maintainable, unless semantic versioning is used.
265 +uding semantic versioning is foreseen for all [[Maintainable Artefacts>>doc:sdmx:Glossary 2\.1.Maintainable artefact.WebHome]]. Moreover, while the old versioning scheme is allowed, given there is no more a "final" flag, there is no way guaranteeing the consistency across [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of a Maintainable, unless semantic versioning is used.
266 266  
267 -Given the above, the behaviour described in the following table concerns either draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using semantic versioning or any [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using the old versioning scheme. Nevertheless, in the case of semantic versioning the registry must respect the versioning rules when performing the actions below. For example, it is not possible to replace a non-draft [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] that follows semantic versioning, unless a newer (% style="color:#e74c3c" %)version(%%) is introduced according to the semantic versioning rules. Furthermore, even when draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] are submitted, the registry has to verify semantic versioning is respected against the previous non-draft (% style="color:#e74c3c" %)versions(%%). It is worth noting that the rules for semantic versioning and replacing or maintaining semantically versioned [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] applies to externally shared [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]. This means that any system may internally perform any change within a (% style="color:#e74c3c" %)version(%%) of an [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]], until the latter is shared outside of that system or becomes public. Then (as also explained in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”) the [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] must adhere to the Semantic Versioning rules.
267 +Given the above, the behaviour described in the following table concerns either draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using semantic versioning or any [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] using the old versioning scheme. Nevertheless, in the case of semantic versioning the registry must respect the versioning rules when performing the actions below. For example, it is not possible to replace a non-draft [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] that follows semantic versioning, unless a newer [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] is introduced according to the semantic versioning rules. Furthermore, even when draft [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] are submitted, the registry has to verify semantic versioning is respected against the previous non-draft [[versions>>doc:sdmx:Glossary 2\.1.Version.WebHome]]. It is worth noting that the rules for semantic versioning and replacing or maintaining semantically versioned [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] applies to externally shared [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]]. This means that any system may internally perform any change within a [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of an [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]], until the latter is shared outside of that system or becomes public. Then (as also explained in the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] Standards Section 6 “Technical Notes”) the [[Artefacts>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] must adhere to the Semantic Versioning rules.
268 268  
269 269  (% style="width:982.835px" %)
270 270  |(% style="width:217px" %)**Interface**|(% style="width:763px" %)**Behaviour**
© Semantic R&D Group, 2026