Skip to Content

Changes for page 10 Constraints

Last modified by Artur on 2025/09/10 11:19
From version 3.2
edited by Helena
on 2025/06/16 12:31
Change comment: There is no comment for this version
To version 4.1
edited by Helena
on 2025/06/16 12:33
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>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)Constraint(%%)**__
39 +__**Rules for a Dimension 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>>doc:sdmx:Glossary.Data set.WebHome]] with Evolving Structures**__
48 +__**Example Datasets 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,11 +239,13 @@
239 239  
240 240  [[image:1750065279010-260.png]]
241 241  
242 -**Figure 20: Example Scenario for (% style="color:#e74c3c" %)Constraints(%%) **(% style="color:#e74c3c" %)Constraints(%%) are declared as follows:
242 +**Figure 20: Example Scenario for Constraints **
243 243  
244 +Constraints are declared as follows:
245 +
244 244  [[image:1750065319060-899.png]]
245 245  
246 -**Figure 21: Example (% style="color:#e74c3c" %)Constraints(%%)**
248 +**Figure 21: Example Constraints**
247 247  
248 248  Notes:
249 249  
... ... @@ -280,19 +280,19 @@
280 280  
281 281  The (% style="color:#e74c3c" %)Constraints(%%) are defined as follows:
282 282  
283 -[[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] (% style="color:#e74c3c" %)Constraint
285 +DSD Constraint
284 284  
285 285  [[image:1750065367824-357.png]]
286 286  
287 -[[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] (% style="color:#e74c3c" %)Constraints
289 +Dataflow Constraints
288 288  
289 289  [[image:1750065392163-400.png]]
290 290  
291 -[[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] (% style="color:#e74c3c" %)Constraint
293 +Provision Agreement Constraint
292 292  
293 293  [[image:1750065461589-995.png]]
294 294  
295 -**10.4.7.2 Combination of (% style="color:#e74c3c" %)Constraints(%%)**
297 +**10.4.7.2 Combination of Constraints**
296 296  
297 297  The possible combination of constraining terms are explained in this section, following a few examples.
298 298  
... ... @@ -313,7 +313,7 @@
313 313  
314 314  On the above, let’s assume the following use cases with their constraining requirements:
315 315  
316 -**Use Case 1: A (% style="color:#e74c3c" %)Constraint(%%) on allowed values for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]**
318 +**Use Case 1: A Constraint on allowed values for some Dimensions**
317 317  
318 318  R1: Allow monthly and quarterly data
319 319  
... ... @@ -325,7 +325,7 @@
325 325  |(% style="width:131px" %)(% style="color:#3498db" %)FREQ|(% style="width:153px" %)(% style="color:#3498db" %)M, Q
326 326  |(% style="width:131px" %)(% style="color:#3498db" %)VIS_CTY|(% style="width:153px" %)(% style="color:#3498db" %)MX
327 327  
328 -**Use Case 2: A (% style="color:#e74c3c" %)Constraint(%%) on allowed combinations for some [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]**
330 +**Use Case 2: A Constraint on allowed combinations for some Dimensions**
329 329  
330 330  R1: Allow monthly data for Germany
331 331  
... ... @@ -339,7 +339,7 @@
339 339  |(% rowspan="2" style="width:105px" %)(% style="color:#2980b9" %)Key2|(% style="width:137px" %)(% style="color:#2980b9" %)FREQ|(% style="width:143px" %)(% style="color:#2980b9" %)Q
340 340  |(% style="width:137px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:143px" %)(% style="color:#2980b9" %)MX
341 341  
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
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
343 343  
344 344  R2: Allow Mexico for vis-à-vis country
345 345  
... ... @@ -352,7 +352,7 @@
352 352  |(% style="width:143px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:139px" %)(% style="color:#2980b9" %)MX
353 353  |(% style="width:143px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:139px" %)(% style="color:#27ae60" %)A
354 354  
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**
357 +**Use Case 4: A Constraint on allowed combinations for some Dimensions combined with specific Attribute values**
356 356  
357 357  R1: Allow monthly data, for Germany, with unit euro
358 358  
... ... @@ -368,7 +368,7 @@
368 368  |(% style="width:153px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:142px" %)(% style="color:#2980b9" %)MX
369 369  |(% style="width:153px" %)(% style="color:#27ae60" %)UNIT|(% style="width:142px" %)(% style="color:#27ae60" %)USD
370 370  
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**
373 +**Use Case 5: A Constraint on allowed values for some Dimensions together with some combination of Dimension values**
372 372  
373 373  R1: For annually and quarterly data, for Mexico and Germany, only A status is allowed
374 374  
... ... @@ -388,7 +388,7 @@
388 388  
389 389  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]]:
390 390  
391 -[[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] CubeRegion:
393 +DSD CubeRegion:
392 392  
393 393  (% style="width:280.294px" %)
394 394  |(% style="width:156px" %)(% style="color:#2980b9" %)FREQ|(% style="width:121px" %)(% style="color:#2980b9" %)M, Q, A
... ... @@ -409,7 +409,7 @@
409 409  |(% style="width:159px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:126px" %)(% style="color:#2980b9" %)MX, DE
410 410  |(% style="width:159px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:126px" %)(% style="color:#27ae60" %)A
411 411  
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]]**
414 +**Use case 6: A Constraint on allowed values for some Dimensions combined with allowed values for Measures**
413 413  
414 414  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'
415 415