Skip to Content

Changes for page 10 Constraints

Last modified by Artur on 2025/09/10 11:19
From version 3.3
edited by Helena
on 2025/06/16 12:33
Change comment: There is no comment for this version
To version 3.2
edited by Helena
on 2025/06/16 12:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -36,7 +36,7 @@
36 36  
37 37  The [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%) provides the explicit list of [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] that the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] uses from the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] that it references.  This enables the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] to evolve over time without breaking the compatibility of [[datasets>>doc:sdmx:Glossary.Data set.WebHome]] against the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]. 
38 38  
39 -__**Rules for a Dimension Constraint**__
39 +__**Rules for a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%)**__
40 40  
41 41  * A [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] must contain a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%) if the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] which it uses states that it is an evolving structure and the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] is late binding on the minor release (latest minor release of a given major (% style="color:#e74c3c" %)version(%%), e.g. 1.0+.0)
42 42  * The [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%) can only include [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] from the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] that is referenced by the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]].
... ... @@ -45,7 +45,7 @@
45 45  * When exporting data for the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], the [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] should only include the [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] specified by the [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%).
46 46  * When exporting data for the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] the [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] must contain the full set of [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] as specified by the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]. The tilde ‘’ character is used to represent a value which is not present due to the [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] not being included in the corresponding [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]].
47 47  
48 -__**Example Datasets with Evolving Structures**__
48 +__**Example [[Datasets>>doc:sdmx:Glossary.Data set.WebHome]] with Evolving Structures**__
49 49  
50 50  A [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] is built against a [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]].  The [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] contains data for two [[Dataflows>>doc:sdmx:Glossary.Dataflow.WebHome]].  [[Dataflows>>doc:sdmx:Glossary.Dataflow.WebHome]] ‘DF_POP’ uses a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%) which fixes its [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] to  FREQ and REF_AREA.  [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] ‘DF_POP_SA’ does not reference a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%), and as such includes all [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] as specified by the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]].  
51 51  
... ... @@ -239,13 +239,11 @@
239 239  
240 240  [[image:1750065279010-260.png]]
241 241  
242 -**Figure 20: Example Scenario for Constraints **
242 +**Figure 20: Example Scenario for (% style="color:#e74c3c" %)Constraints(%%) **(% style="color:#e74c3c" %)Constraints(%%) are declared as follows:
243 243  
244 -Constraints are declared as follows:
245 -
246 246  [[image:1750065319060-899.png]]
247 247  
248 -**Figure 21: Example Constraints**
246 +**Figure 21: Example (% style="color:#e74c3c" %)Constraints(%%)**
249 249  
250 250  Notes:
251 251  
... ... @@ -282,19 +282,19 @@
282 282  
283 283  The (% style="color:#e74c3c" %)Constraints(%%) are defined as follows:
284 284  
285 -DSD Constraint
283 +[[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] (% style="color:#e74c3c" %)Constraint
286 286  
287 287  [[image:1750065367824-357.png]]
288 288  
289 -Dataflow Constraints
287 +[[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] (% style="color:#e74c3c" %)Constraints
290 290  
291 291  [[image:1750065392163-400.png]]
292 292  
293 -Provision Agreement Constraint
291 +[[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] (% style="color:#e74c3c" %)Constraint
294 294  
295 295  [[image:1750065461589-995.png]]
296 296  
297 -**10.4.7.2 Combination of Constraints**
295 +**10.4.7.2 Combination of (% style="color:#e74c3c" %)Constraints(%%)**
298 298  
299 299  The possible combination of constraining terms are explained in this section, following a few examples.
300 300  
... ... @@ -315,7 +315,7 @@
315 315  
316 316  On the above, let’s assume the following use cases with their constraining requirements:
317 317  
318 -**Use Case 1: A Constraint on allowed values for some Dimensions**
316 +**Use Case 1: A (% style="color:#e74c3c" %)Constraint(%%) on allowed values for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]**
319 319  
320 320  R1: Allow monthly and quarterly data
321 321  
... ... @@ -327,7 +327,7 @@
327 327  |(% style="width:131px" %)(% style="color:#3498db" %)FREQ|(% style="width:153px" %)(% style="color:#3498db" %)M, Q
328 328  |(% style="width:131px" %)(% style="color:#3498db" %)VIS_CTY|(% style="width:153px" %)(% style="color:#3498db" %)MX
329 329  
330 -**Use Case 2: A Constraint on allowed combinations for some Dimensions**
328 +**Use Case 2: A (% style="color:#e74c3c" %)Constraint(%%) on allowed combinations for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]**
331 331  
332 332  R1: Allow monthly data for Germany
333 333  
... ... @@ -341,7 +341,7 @@
341 341  |(% rowspan="2" style="width:105px" %)(% style="color:#2980b9" %)Key2|(% style="width:137px" %)(% style="color:#2980b9" %)FREQ|(% style="width:143px" %)(% style="color:#2980b9" %)Q
342 342  |(% style="width:137px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:143px" %)(% style="color:#2980b9" %)MX
343 343  
344 -**Use Case 3: A Constraint on allowed values for some Dimensions combined with allowed values for some Attributes** R1: Allow monthly and quarterly data
342 +**Use Case 3: A (% style="color:#e74c3c" %)Constraint(%%) on allowed values for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] combined with allowed values for some [[Attributes>>doc:sdmx:Glossary.Attribute.WebHome]]** R1: Allow monthly and quarterly data
345 345  
346 346  R2: Allow Mexico for vis-à-vis country
347 347  
... ... @@ -354,7 +354,7 @@
354 354  |(% style="width:143px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:139px" %)(% style="color:#2980b9" %)MX
355 355  |(% style="width:143px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:139px" %)(% style="color:#27ae60" %)A
356 356  
357 -**Use Case 4: A Constraint on allowed combinations for some Dimensions combined with specific Attribute values**
355 +**Use Case 4: A (% style="color:#e74c3c" %)Constraint(%%) on allowed combinations for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] combined with specific [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] values**
358 358  
359 359  R1: Allow monthly data, for Germany, with unit euro
360 360  
... ... @@ -370,7 +370,7 @@
370 370  |(% style="width:153px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:142px" %)(% style="color:#2980b9" %)MX
371 371  |(% style="width:153px" %)(% style="color:#27ae60" %)UNIT|(% style="width:142px" %)(% style="color:#27ae60" %)USD
372 372  
373 -**Use Case 5: A Constraint on allowed values for some Dimensions together with some combination of Dimension values**
371 +**Use Case 5: A (% style="color:#e74c3c" %)Constraint(%%) on allowed values for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] together with some combination of [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] values**
374 374  
375 375  R1: For annually and quarterly data, for Mexico and Germany, only A status is allowed
376 376  
... ... @@ -390,7 +390,7 @@
390 390  
391 391  Nevertheless, there is a much easier approach to that; this is the cascading mechanism of (% style="color:#e74c3c" %)Constraints(%%) (as shown in 10.4.7.1). Hence, these rules would be expressed into two (% style="color:#e74c3c" %)levels(%%) of (% style="color:#e74c3c" %)Constraints(%%), e.g., [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] and [[Dataflows>>doc:sdmx:Glossary.Dataflow.WebHome]]:
392 392  
393 -DSD CubeRegion:
391 +[[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] CubeRegion:
394 394  
395 395  (% style="width:280.294px" %)
396 396  |(% style="width:156px" %)(% style="color:#2980b9" %)FREQ|(% style="width:121px" %)(% style="color:#2980b9" %)M, Q, A
... ... @@ -411,7 +411,7 @@
411 411  |(% style="width:159px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:126px" %)(% style="color:#2980b9" %)MX, DE
412 412  |(% style="width:159px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:126px" %)(% style="color:#27ae60" %)A
413 413  
414 -**Use case 6: A Constraint on allowed values for some Dimensions combined with allowed values for Measures**
412 +**Use case 6: A (% style="color:#e74c3c" %)Constraint(%%) on allowed values for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] combined with allowed values for [[Measures>>doc:sdmx:Glossary.Measure.WebHome]]**
415 415  
416 416  R1: Allow monthly data, for Germany, with unit euro, and [[measure>>doc:sdmx:Glossary.Measure.WebHome]] choice is  'A' R2: Allow quarterly data, for Mexico, with unit usd, and [[measure>>doc:sdmx:Glossary.Measure.WebHome]] choice is  'B'
417 417