Changes for page 10 Constraints
Last modified by Helena K. on 2026/06/10 09:45
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -xwiki:XWiki.he lena1 +xwiki:XWiki.arturkryazhev - Content
-
... ... @@ -4,55 +4,53 @@ 4 4 5 5 == 10.1 Introduction == 6 6 7 +(% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) are used as a way to restrict what data can be reported, or to report what data exists in a given context. There are three types of (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), which serve different purposes 7 7 8 -[[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] are used as a way to restrict what data can be reported, or to report what data exists in a given context. There are three types of [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]], which serve different purposes 9 +* Availability (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]] 10 +* [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]] 11 +* Reporting (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]] 9 9 10 -* Availability [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 11 -* [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 12 -* Reporting [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] 13 +An Availability (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) defines the data that exists in the context of a data query. 13 13 14 - An Availability [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]]defines the data that existsin the context ofadataquery.15 +They form part of the response message from the Availability REST API. Availability (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) are dynamically generated by a system based on the data that exists and the query context. Availability (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) are therefore not Identifiable structures (they have no URN). 15 15 16 - Theyformpart of theresponsemessage fromtheAvailabilityRESTAPI. Availability [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] aredynamically generatedbya systembased onthe datathat existsandthequery context.Availability [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] are therefore notIdentifiablestructures(theyhavenoURN).17 +A [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is a property of a [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], they are used to fix the [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] that they use in the [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] which they use. [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) enable [[Data Structure Definitions>>doc:sdmx:Glossary.Data structure definition.WebHome]] to evolve over time by having new [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] added, without having to undergo a major (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change. 17 17 18 -A [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]][[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] isa property of a [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], they areused tofix the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]that theyuseinthe[[Data Structure Definition>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]]which theyuse. [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]enable [[Data StructureDefinitions>>doc:sdmx:Glossary2\.1.Datastructuredefinition.WebHome]]toevolve overtimeby having new [[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]added,without havingto undergoamajor[[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] change.19 +A Reporting (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is used to define the set of allowed and/or disallowed values that can be reported in a data or metadata set. 19 19 20 -A Reporting [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is used to define the set of allowed and/or disallowed values that can be reported in a data or [[metadata set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]]. 21 - 22 22 == 10.2 Availability Constraint == 23 23 24 -An Availability [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is not a maintained structure, instead it is generated dynamically as a response to the availability REST API. The purpose of the Availability [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] is to define the distinct set of values that have data over 1 or more [[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]. Unlike a Data and Metadata [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], which can attach to multiple Constrainable structures (of the same type), an Availability [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] can only attach to only one structure. The attachment defines the context of the response (data exists for [[components>>doc:sdmx:Glossary2\.1.Component.WebHome]] in the context of). The subset of Constrainable structures the Availability [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] can attach to are:23 +An Availability (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is not a maintained structure, instead it is generated dynamically as a response to the availability REST API. The purpose of the Availability (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is to define the distinct set of values that have data over 1 or more [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]. Unlike a Data and Metadata (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), which can attach to multiple Constrainable structures (of the same type), an Availability (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can only attach to only one structure. The attachment defines the context of the response (data exists for [[components>>doc:sdmx:Glossary.Component.WebHome]] in the context of). The subset of Constrainable structures the Availability (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can attach to are: 25 25 26 -* [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]27 -* [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]28 -* [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]]25 +* [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] 26 +* [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] 27 +* Provision Agreement 29 29 30 30 == 10.3 Dimension Constraint == 31 31 32 -A [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] is a property of a [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]; its purpose is to explicitly list the [[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] from the corresponding [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] that are being used by the [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]].31 +A [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is a property of a [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]; its purpose is to explicitly list the [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] from the corresponding [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] that are being used by the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]. 33 33 33 +[[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) were introduced in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] 3.1 and are not required for most [[Dataflows>>doc:sdmx:Glossary.Dataflow.WebHome]] where the [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] must always contain the full complement of [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] as defined by the corresponding [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]. However, for some complex data collections, which may span long periods and where the full complement of required [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] are not necessarily known at design time, the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] is subject to increasing its Dimensionality over time. In this scenario it is possible to define the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] as an evolving structure, this property tells the user that the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] can have new [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] added without having to undergo a major (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change; a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] at (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) 1.0.0 for example would be able to add a new [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] and move to (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) 1.1.0; a change that would not ordinarily be allowed. A minor (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change on the addition of a new [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] is only possible if the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] defines itself as an evolving structure. This is a new property of the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] introduced in (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) 3.1 to satisfy this use case. The evolving structure property is either true or false, defaulting to false if not specified. Setting the evolving structure property to true requires a major (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change, and therefore can only be introduced on an x.0.0 release (e.g. 1.0.0). The evolving structure property can be set to false to indicate that there will be no additional [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] added to the Data Structure under the same major (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) number; setting the evolving structure property to false does not require require a major (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change on the Data Structure. 34 34 35 - [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] were introduced in [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] 3.1 andarenot required for most[[Dataflows>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]wherethe[[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] must always contain the fullcomplement of [[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]asdefined by the corresponding[[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]]. However,for some complex data collections, which may spanlongperiods andwherethefull complementofrequired [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]arenot necessarily known atdesigntime, the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]]is subject to increasing its Dimensionality over time. In this scenario it ispossibleto define the[[DSD>>doc:sdmx:Glossary 2\.1.Data structuredefinition.WebHome]] as an evolving structure,thispropertytellstheuserthatthe [[DSD>>doc:sdmx:Glossary2\.1.Data structuredefinition.WebHome]] can havenew[[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] added without having to undergo a major [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] change; a [[DSD>>doc:sdmx:Glossary2\.1.Datastructure definition.WebHome]]at[[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]]1.0.0 for examplewould be able to add a new[[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]andmove to [[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] 1.1.0; achange that would not ordinarily beallowed. A minor[[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] change on the additionof a new [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] isonly possible ifthe [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]defines itself as an evolvingstructure. This is a newproperty of the[[DSD>>doc:sdmx:Glossary 2\.1.Datastructuredefinition.WebHome]] introduced in [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] 3.1 to satisfy this use case. The evolving structure propertyis eithertrueorfalse, defaultingto falseifnot specified. Settingthe evolving structurepropertyto true requires amajor [[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] change, andtherefore can only be introducedonanx.0.0 release(e.g.1.0.0). The evolvingstructure propertycan be set to falseto indicate that there will be noadditional[[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] added to the Data Structure under the same major [[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] number; setting the evolving structure property to false does not require require a major[[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] changeon the Data Structure.35 +When a [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] references a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]], late binding on the minor release, and the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] has the evolving structure property set to true, then the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] must contain a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) to protect its Dimensionality from changing over time without a (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change. 36 36 37 - Whena[[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]referencesa[[DSD>>doc:sdmx:Glossary2\.1.Datastructure definition.WebHome]],late bindingontheminorrelease, andthe[[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] hastheevolving structure property set to true, thenthe[[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]mustcontaina[[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]][[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] toprotectitsDimensionalityfrom changingovertime withouta[[version>>doc:sdmx:Glossary2\.1.Version.WebHome]]change.37 +The [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) 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 - The [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]][[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]]provides the explicit list of[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]that the[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] uses from the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] that it references. This enables the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] to evolve over time without breaking the compatibility of [[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] againstthe [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]].39 +__**Rules for a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]]**__ 40 40 41 -__**Rules for a Dimension Constraint**__ 41 +* A [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] must contain a [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) 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>>doc:sdmx:Glossary.Version.WebHome]](%%), e.g. 1.0+.0) 42 +* The [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) 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]]. 43 +* A [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can only be changed if the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] undergoes a major (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) change 44 +* [[Datasets>>doc:sdmx:Glossary.Data set.WebHome]] reported against the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] must only contain reported values for the [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] specified in the [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%). 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>>doc:sdmx:Glossary.Constraint.WebHome]](%%). 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]]. 42 42 43 -* A [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] must contain a [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] if the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] which it uses states that it is an evolving structure and the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] is late binding on the minor release (latest minor release of a given major [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]], e.g. 1.0+.0) 44 -* The [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] can only include [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] from the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] that is referenced by the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]. 45 -* A [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] can only be changed if the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] undergoes a major [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] change 46 -* [[Datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] reported against the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] must only contain reported values for the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specified in the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]. 47 -* When exporting data for the [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]], the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] should only include the [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] specified by the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]. 48 -* When exporting data for the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] the [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] must contain the full set of [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] as specified by the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. The tilde ‘’ character is used to represent a value which is not present due to the [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] not being included in the corresponding [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]. 48 +__**Example [[Datasets>>doc:sdmx:Glossary.Data set.WebHome]] with Evolving Structures**__ 49 49 50 - __**Example Datasets with EvolvingStructures**__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>>doc:sdmx:Glossary.Constraint.WebHome]](%%) 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>>doc:sdmx:Glossary.Constraint.WebHome]](%%), 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 52 - A [[dataset>>doc:sdmx:Glossary2\.1.Data set.WebHome]] isbuiltagainsta[[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Datastructuredefinition.WebHome]]. The [[dataset>>doc:sdmx:Glossary2\.1.Data set.WebHome]] containsdata for two [[Dataflows>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]. [[Dataflows>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]‘DF_POP’uses a [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] which fixesits[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]to FREQandREF_AREA.[[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]‘DF_POP_SA’ does not reference a[[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]][[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], and as suchincludesall [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]as specified by the [[DSD>>doc:sdmx:Glossary 2\.1.Data structuredefinition.WebHome]].52 +The resulting [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] contains values ‘’ for both the [[SEX>>doc:sdmx:Glossary.Sex.WebHome]] and [[AGE>>doc:sdmx:Glossary.Age.WebHome]] [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] for the series related to DF_POP. 53 53 54 -The resulting [[dataset>>doc:sdmx:Glossary 2\.1.Data set.WebHome]] contains values ‘’ for both the [[SEX>>doc:sdmx:Glossary 2\.1.Sex.WebHome]] and [[AGE>>doc:sdmx:Glossary 2\.1.Age.WebHome]] [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] for the [[series>>doc:sdmx:Glossary 2\.1.Series.WebHome]] related to DF_POP. 55 - 56 56 (% style="width:758.294px" %) 57 57 |(% style="width:119px" %)**Dataflow**|(% colspan="7" style="width:635px" %)**FREQ REF_AREA SEX AGE OBS_VALUE TIME_PERIOD UNIT** 58 58 |(% style="width:119px" %)**DF_POP**|(% style="width:55px" %)A|(% style="width:103px" %)UK|(% style="width:79px" %) |(% style="width:92px" %) |(% style="width:93px" %)65|(% style="width:111px" %)2022|(% style="width:101px" %)6 ... ... @@ -61,112 +61,112 @@ 61 61 62 62 == 10.4 Reporting Constraints == 63 63 64 -A Reporting [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is a [[Maintainable Artefact>>doc:sdmx:Glossary2\.1.Maintainable artefact.WebHome]] which restricts the values that can be reported in a [[dataset>>doc:sdmx:Glossary2\.1.Data set.WebHome]] or [[metadata set>>doc:sdmx:Glossary2\.1.Metadata set.WebHome]] based on one or more inclusion or exclusion rules.62 +A Reporting (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is a [[Maintainable Artefact>>doc:sdmx:Glossary.Maintainable artefact.WebHome]] which restricts the values that can be reported in a [[dataset>>doc:sdmx:Glossary.Data set.WebHome]] or [[metadata set>>doc:sdmx:Glossary.Metadata set.WebHome]] based on one or more inclusion or exclusion rules. 65 65 66 -A reporting [[constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is one of the following concrete types:64 +A reporting (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is one of the following concrete types: 67 67 68 -* Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]69 -* Metadata [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]]66 +* Data (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]] 67 +* Metadata (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]] 70 70 71 71 === 10.4.1 Data Constraint === 72 72 73 -A Data [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is used to add additional restrictions to the allowable values reported in a [[dataset>>doc:sdmx:Glossary2\.1.Data set.WebHome]]. Data [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] can be applied to the follow structures which are collectively known as Constrainable structures:71 +A Data (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is used to add additional restrictions to the allowable values reported in a [[dataset>>doc:sdmx:Glossary.Data set.WebHome]]. Data (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can be applied to the follow structures which are collectively known as Constrainable structures: 74 74 75 -* [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]76 -* [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]77 -* [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]]78 -* [[Data Provider>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]]73 +* Data Structure Definition 74 +* Dataflow 75 +* Provision Agreement 76 +* Data Provider 79 79 80 -**Note** regardless of the Constrainable structure, the restricted values relate to the allowable content for the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] of the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] to which the constrained object relates.78 +**Note** regardless of the Constrainable structure, the restricted values relate to the allowable content for the [[Component>>doc:sdmx:Glossary.Component.WebHome]] of the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] to which the constrained object relates. 81 81 82 82 === 10.4.2 Metadata Constraint === 83 83 84 -A Metadata [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is used to add additional restrictions to the allowable values reported in a metadataset. Metadata [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] can be applied to the follow structures which are collectively known as Constrainable structures:82 +A Metadata (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is used to add additional restrictions to the allowable values reported in a metadataset. Metadata (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can be applied to the follow structures which are collectively known as Constrainable structures: 85 85 86 -* [[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]87 -* [[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]]88 -* Metadata [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]]84 +* Metadata Structure Definition 85 +* Metadataflow 86 +* Metadata Provision Agreement 89 89 * Metadata Provider 90 90 91 -**Note** regardless of the Constrainable structure, the restricted values relate to the allowable content for the [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] of the [[MSD>>doc:sdmx:Glossary2\.1.Metadata structure definition.WebHome]] to which the constrained object relates.89 +**Note** regardless of the Constrainable structure, the restricted values relate to the allowable content for the [[Component>>doc:sdmx:Glossary.Component.WebHome]] of the [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] to which the constrained object relates. 92 92 93 93 === 10.4.3 Scope of a Constraint === 94 94 95 -A [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is used specify the content of a data or metadata source in terms of the [[component>>doc:sdmx:Glossary2\.1.Component.WebHome]] values or the keys.93 +A (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is used specify the content of a data or metadata source in terms of the [[component>>doc:sdmx:Glossary.Component.WebHome]] values or the keys. 96 96 97 -In terms of data the [[components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] are:95 +In terms of data the [[components>>doc:sdmx:Glossary.Component.WebHome]] are: 98 98 99 -* [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]100 -* Time [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]101 -* Data [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]102 -* [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]103 -* Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]104 -* DataKeySets: the keys are the content of the KeyDescriptor – i.e., the [[series keys>>doc:sdmx:Glossary 2\.1.Series key.WebHome]] composed, for each key, by a value for each [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]].97 +* [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] 98 +* Time [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] 99 +* Data [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] 100 +* [[Measure>>doc:sdmx:Glossary.Measure.WebHome]] 101 +* Metadata [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] 102 +* DataKeySets: the keys are the content of the KeyDescriptor – i.e., the [[series keys>>doc:sdmx:Glossary.Series key.WebHome]] composed, for each key, by a value for each [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. 105 105 106 -In terms of [[reference metadata>>doc:sdmx:Glossary 2\.1.Reference metadata.WebHome]] the [[components>>doc:sdmx:Glossary2\.1.Component.WebHome]] are:104 +In terms of [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] the [[components>>doc:sdmx:Glossary.Component.WebHome]] are: 107 107 108 -* Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]106 +* Metadata [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] 109 109 110 -For a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] based on a [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] can reference one or more of:108 +For a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) based on a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can reference one or more of: 111 111 112 -* [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]113 -* [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]114 -* [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]]115 -* [[Data Provider>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]]110 +* Data Structure Definition 111 +* Dataflow 112 +* Provision Agreement 113 +* Data Provider 116 116 117 -For a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] based on an [[MSD>>doc:sdmx:Glossary2\.1.Metadata structure definition.WebHome]] the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] can reference one or more of:115 +For a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) based on an [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can reference one or more of: 118 118 119 -* [[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]]120 -* [[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]]121 -* Metadata [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]]117 +* Metadata Structure Definition 118 +* Metadataflow 119 +* Metadata Provision Agreement 122 122 * Metadata Provider 123 -* [[Metadata Set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]]121 +* [[Metadata Set>>doc:sdmx:Glossary.Metadata set.WebHome]] 124 124 125 -Furthermore, there can be more than one [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] specified for a specific object e.g., more than one [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] for a specific [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]].123 +Furthermore, there can be more than one (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified for a specific object e.g., more than one (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) for a specific [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]. 126 126 127 -In view of the flexibility of [[constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] attachment, clear rules on their usage are required. These are elaborated below.125 +In view of the flexibility of (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) attachment, clear rules on their usage are required. These are elaborated below. 128 128 129 129 === 10.4.4 Multiple Constraints === 130 130 131 -There can be many [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] for any Constrainable [[Artefact>>doc:sdmx:Glossary2\.1.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]]), subject to the following restrictions:129 +There can be many (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) for any Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]), subject to the following restrictions: 132 132 133 133 ==== 10.4.4.1 Cube Region ==== 134 134 135 -A [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] can contain multiple [[Member Selections>>doc:sdmx:Glossary2\.1.Member selection.WebHome]] (e.g.,[[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]).133 +A (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) can contain multiple [[Member Selections>>doc:sdmx:Glossary.Member selection.WebHome]] (e.g., Dimensions). 136 136 137 -* A specific [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] (e.g., [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] FREQ) can only be contained in one Cube Region for any one attached object (e.g., a specific [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] or specific[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]).138 -* [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] values within a [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]] may define a validity period. Otherwise, the value is valid for the whole validity of the Cube Region.139 -* For partial reference resolution purposes (as per the [[SDMX>>doc:sdmx:Glossary 2\.1.Statistical data and metadata exchange.WebHome]] REST API), the latest non-draft [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] must be considered.140 -* A [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] may include wildcarding of values (using character ‘%’ to represent zero or more occurrences of any character), as well as cascading through hierarchic structures (e.g., parents in [[Codelist>>doc:sdmx:Glossary2\.1.Code list.WebHome]]), or localised values (e.g., text for English only). Lack of locale means any[[language>>doc:sdmx:Glossary2\.1.Language.WebHome]] may match. Cascading values are mutual exclusive to localised values, as the former refer to coded values, while the latter refer to uncoded values.141 -* Any values included in a [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] for [[Components>>doc:sdmx:Glossary2\.1.Component.WebHome]] with an array data type (i.e., [[Measures>>doc:sdmx:Glossary2\.1.Measure.WebHome]], [[Attributes>>doc:sdmx:Glossary2\.1.Attribute.WebHome]] or Metadata [[Attributes>>doc:sdmx:Glossary2\.1.Attribute.WebHome]]), will be applied as single values and will not be assessed combined with other values to match all possible array values. For example, including the [[Code>>doc:sdmx:Glossary2\.1.Code.WebHome]] ‘A’ for an [[Attribute>>doc:sdmx:Glossary2\.1.Attribute.WebHome]] will allow any instance of the [[Attribute>>doc:sdmx:Glossary2\.1.Attribute.WebHome]] that includes ‘A’, like [‘A’, ‘B’] or [‘A’, ‘C’, ‘D’]. Similarly, if [[Code>>doc:sdmx:Glossary2\.1.Code.WebHome]] ‘A’ was excluded, all those arrays of values would also be excluded.135 +* A specific [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] (e.g., [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] FREQ) can only be contained in one Cube Region for any one attached object (e.g., a specific [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] or specific Dataflow). 136 +* [[Component>>doc:sdmx:Glossary.Component.WebHome]] values within a [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] may define a validity period. Otherwise, the value is valid for the whole validity of the Cube Region. 137 +* For partial reference resolution purposes (as per the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] REST API), the latest non-draft (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) must be considered. 138 +* A [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] may include wildcarding of values (using character ‘%’ to represent zero or more occurrences of any character), as well as cascading through hierarchic structures (e.g., parents in [[Codelist>>doc:sdmx:Glossary.Code list.WebHome]]), or localised values (e.g., text for English only). Lack of locale means any language may match. Cascading values are mutual exclusive to localised values, as the former refer to coded values, while the latter refer to uncoded values. 139 +* Any values included in a [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] for [[Components>>doc:sdmx:Glossary.Component.WebHome]] with an array data type (i.e., [[Measures>>doc:sdmx:Glossary.Measure.WebHome]], [[Attributes>>doc:sdmx:Glossary.Attribute.WebHome]] or Metadata [[Attributes>>doc:sdmx:Glossary.Attribute.WebHome]]), will be applied as single values and will not be assessed combined with other values to match all possible array values. For example, including the [[Code>>doc:sdmx:Glossary.Code.WebHome]] ‘A’ for an [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] will allow any instance of the [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] that includes ‘A’, like [‘A’, ‘B’] or [‘A’, ‘C’, ‘D’]. Similarly, if [[Code>>doc:sdmx:Glossary.Code.WebHome]] ‘A’ was excluded, all those arrays of values would also be excluded. 142 142 143 143 ==== 10.4.4.2 Key Set ==== 144 144 145 -Key Sets will be processed in the order they appear in the [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] and wildcards can be used (e.g., any key position not reference explicitly is deemed to be "all values").143 +Key Sets will be processed in the order they appear in the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) and wildcards can be used (e.g., any key position not reference explicitly is deemed to be "all values"). 146 146 147 -As the Key Sets can be "included" or "excluded" it is recommended that Key Sets with wildcards are declared before KeySets with specific [[series keys>>doc:sdmx:Glossary 2\.1.Series key.WebHome]]. This will minimize the risk that keys are inadvertently included or excluded.145 +As the Key Sets can be "included" or "excluded" it is recommended that Key Sets with wildcards are declared before KeySets with specific [[series keys>>doc:sdmx:Glossary.Series key.WebHome]]. This will minimize the risk that keys are inadvertently included or excluded. 148 148 149 -In addition, [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], [[Measure>>doc:sdmx:Glossary2\.1.Measure.WebHome]] and Metadata [[Attribute>>doc:sdmx:Glossary2\.1.Attribute.WebHome]] [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] may accompany KeySets, in order to specify the allowed values per Key. Those are expressed following the rules for Cube Regions, as explained above.147 +In addition, [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]], [[Measure>>doc:sdmx:Glossary.Measure.WebHome]] and Metadata [[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]] (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) may accompany KeySets, in order to specify the allowed values per Key. Those are expressed following the rules for Cube Regions, as explained above. 150 150 151 151 Finally, a validity period may be specified per Key. 152 152 153 153 === 10.4.4 Versioning === 154 154 155 -When Data and Metadata [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] are versioned, the latest [[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] of the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] is used to generate the reporting restriction rules; all previous [[versions>>doc:sdmx:Glossary2\.1.Version.WebHome]] are for historical information only.153 +When Data and Metadata (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) are versioned, the latest (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) of the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is used to generate the reporting restriction rules; all previous (% style="color:#e74c3c" %)[[versions>>doc:sdmx:Glossary.Version.WebHome]](%%) are for historical information only. 156 156 157 -If restrictions are applicable to certain periods in time, the validFrom and validTo properties can be set on the specific values. This allows [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] to evolve over time, increasing their [[version>>doc:sdmx:Glossary2\.1.Version.WebHome]] number as they do so, whilst being able to maintain a complete set of reporting restrictions for current and past[[datasets>>doc:sdmx:Glossary 2\.1.Data set.WebHome]].155 +If restrictions are applicable to certain periods in time, the validFrom and validTo properties can be set on the specific values. This allows (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) to evolve over time, increasing their (% style="color:#e74c3c" %)[[version>>doc:sdmx:Glossary.Version.WebHome]](%%) number as they do so, whilst being able to maintain a complete set of reporting restrictions for current and past datasets. 158 158 159 159 Example: 160 160 161 -Data Constraint 1.0.0 159 +Data (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) 1.0.0 162 162 163 163 (% style="width:573.294px" %) 164 -|(% style="width:108px" %)Component|(% style="width:127px" %)Valid Value|(% style="width:150px" %)Valid from|(% style="width:185px" %)Valid to 162 +|(% style="width:108px" %)[[Component>>doc:sdmx:Glossary.Component.WebHome]]|(% style="width:127px" %)Valid Value|(% style="width:150px" %)Valid from|(% style="width:185px" %)Valid to 165 165 |(% rowspan="3" style="width:108px" %)COUNTRY|(% style="width:127px" %)UK|(% style="width:150px" %) |(% style="width:185px" %) 166 166 |(% style="width:127px" %)FR|(% style="width:150px" %) |(% style="width:185px" %) 167 167 |(% style="width:127px" %)DE|(% style="width:150px" %) |(% style="width:185px" %) 168 168 169 -Data Constraint 1.1.0 167 +Data (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) 1.1.0 170 170 171 171 (% style="width:576.294px" %) 172 172 |(% style="width:110px" %)Component|(% style="width:129px" %)Valid Value|(% style="width:145px" %)Valid from|(% style="width:189px" %)Valid to ... ... @@ -174,55 +174,55 @@ 174 174 |(% style="width:129px" %)FR|(% style="width:145px" %) |(% style="width:189px" %)2012 175 175 |(% style="width:129px" %)DE|(% style="width:145px" %) |(% style="width:189px" %) 176 176 177 -When both [[versions>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of the Data [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] are in a system, an [[observation value>>doc:sdmx:Glossary2\.1.Observation value.WebHome]] reported against COUNTRY FR for [[time period>>doc:sdmx:Glossary2\.1.Time period.WebHome]] 2013 would be deemed invalid as the 1.1.0 rule would be applied.175 +When both (% style="color:#e74c3c" %)[[versions>>doc:sdmx:Glossary.Version.WebHome]](%%) of the Data (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) are in a system, an [[observation value>>doc:sdmx:Glossary.Observation value.WebHome]] reported against COUNTRY FR for [[time period>>doc:sdmx:Glossary.Time period.WebHome]] 2013 would be deemed invalid as the 1.1.0 rule would be applied. 178 178 179 179 === 10.4.6 Inheritance === 180 180 181 181 ==== 10.4.6.1 Attachment levels of a Constraint ==== 182 182 183 -There are three [[levels>>doc:sdmx:Glossary 2\.1.Level.WebHome]] of [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] attachment for which these inheritance rules apply:181 +There are three (% style="color:#e74c3c" %)[[levels>>doc:sdmx:Glossary.Level.WebHome]](%%) of (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) attachment for which these inheritance rules apply: 184 184 185 -* [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]/[[MSD>>doc:sdmx:Glossary2\.1.Metadata structure definition.WebHome]] – top [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]]186 -** [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]/[[Metadataflow>>doc:sdmx:Glossary2\.1.Metadataflow.WebHome]] – second [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]]187 -*** [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]] – third [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]]183 +* [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]/[[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] – top (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]] 184 +** [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]/[[Metadataflow>>doc:sdmx:Glossary.Metadataflow.WebHome]] – second (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]] 185 +*** [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] – third (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]] 188 188 189 -It is not necessary for a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] to be attached to a higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[artefact>>doc:sdmx:Glossary2\.1.Artefact.WebHome]]. e.g., it is valid to have a [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] for a [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]] where there are no [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] attached the relevant [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]] or [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]].187 +It is not necessary for a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) to be attached to a higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]]. e.g., it is valid to have a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) for a [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] where there are no (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) attached the relevant [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] or [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]. 190 190 191 191 ==== 10.4.6.2 Cascade rules for processing Constraints ==== 192 192 193 -The processing of the [[constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on either [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]/[[Metadataflow>>doc:sdmx:Glossary2\.1.Metadataflow.WebHome]] or [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]] must take into account the [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] declared at higher [[levels>>doc:sdmx:Glossary2\.1.Level.WebHome]]. The rules for the lower-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] (attached to [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]/ [[Metadataflow>>doc:sdmx:Glossary2\.1.Metadataflow.WebHome]] and [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]]) are detailed below.191 +The processing of the (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) on either [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]/[[Metadataflow>>doc:sdmx:Glossary.Metadataflow.WebHome]] or [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] must take into account the (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) declared at higher (% style="color:#e74c3c" %)[[levels>>doc:sdmx:Glossary.Level.WebHome]](%%). The rules for the lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) (attached to [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]/ [[Metadataflow>>doc:sdmx:Glossary.Metadataflow.WebHome]] and [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]]) are detailed below. 194 194 195 -Note that there can be a situation where a [[constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is specified at a lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] before a [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] is specified at a higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]]. Therefore, it is possible that a higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] makes a lower-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] invalid. [[SDMX>>doc:sdmx:Glossary2\.1.Statistical data and metadata exchange.WebHome]] makes no rules on how such a conflict should be handled when processing the [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] for attachment. However, the cascade rules on evaluating [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] for usage are clear – the higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] takes precedence in any conflicts that result in a less restrictive specification at the lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]].193 +Note that there can be a situation where a (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is specified at a lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) before a (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is specified at a higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%). Therefore, it is possible that a higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) makes a lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) invalid. [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] makes no rules on how such a conflict should be handled when processing the (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) for attachment. However, the cascade rules on evaluating (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) for usage are clear – the higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) takes precedence in any conflicts that result in a less restrictive specification at the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%). 196 196 197 197 ==== 10.4.6.3 Cube Region ==== 198 198 199 -It is not necessary to have a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on the higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[artefact>>doc:sdmx:Glossary2\.1.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] referenced by the [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]), but if there is such a [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] at the higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]](s) then:197 +It is not necessary to have a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) on the higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] referenced by the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]), but if there is such a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at the higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%)(s) then: 200 200 201 -* The lower-[[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] cannot be less restrictive than the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] specified for the same [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]] (e.g. [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]) at the next higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]], which constrains that [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]]. For example, if the [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] FREQ is constrained to A, Q in a [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]], then the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] at the [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]] or [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]] cannot be A, Q, M or even just M – it can only further constrain A, Q.202 -* The [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] at the lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] for any one [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]] further constrains the content for the same [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]] at the higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]](s).203 -* Any [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]], which is not referenced in a [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], is deemed to be constrained according to the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] specified at the next higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] which [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] that [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]].204 -* If there is a conflict when resolving the [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] in terms of a lower-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] being less restrictive than a higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], then the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] at the higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] is used.199 +* The lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) cannot be less restrictive than the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified for the same [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] (e.g. [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]) at the next higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%), which constrains that [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]]. For example, if the [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] FREQ is constrained to A, Q in a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]], then the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] or [[Provision Agreement>>doc:sdmx:Glossary.Provision agreement.WebHome]] cannot be A, Q, M or even just M – it can only further constrain A, Q. 200 +* The (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) for any one [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] further constrains the content for the same [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] at the higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%)(s). 201 +* Any [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]], which is not referenced in a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), is deemed to be constrained according to the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified at the next higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) which (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) that [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]]. 202 +* If there is a conflict when resolving the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) in terms of a lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) being less restrictive than a higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), then the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at the higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) is used. 205 205 206 -Note that it is possible for a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] at a higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] to constrain, say, four [[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] in a single [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], and a [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] at a lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] to constrain the same four in two, three, or four [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]].204 +Note that it is possible for a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at a higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) to constrain, say, four [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] in a single (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), and a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at a lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) to constrain the same four in two, three, or four (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%). 207 207 208 208 ==== 10.4.6.4 Key Set ==== 209 209 210 -It is not necessary to have a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] on the higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[artefact>>doc:sdmx:Glossary2\.1.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] referenced by the [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]), but if there is such a [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] at the higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]](s) then:208 +It is not necessary to have a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) on the higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] referenced by the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]]), but if there is such a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at the higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%)(s) then: 211 211 212 -* The lower-[[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] cannot be less restrictive than the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] specified at the higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]].213 -* The [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] at the lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] for any one [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]] further constrains the keys specified at the higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]](s).214 -* Any [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]], which is not referenced in a [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], is deemed to be constrained according to the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] specified at the next higher [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] which [[constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] that [[Member Selection>>doc:sdmx:Glossary2\.1.Member selection.WebHome]].215 -* If there is a conflict when resolving the keys in the [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] at two [[levels>>doc:sdmx:Glossary2\.1.Level.WebHome]], in terms of a lower-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] being less restrictive than a higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]], then the offending keys specified at the lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] are not deemed part of the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]].210 +* The lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) cannot be less restrictive than the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified at the higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%). 211 +* The (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) for any one [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] further constrains the keys specified at the higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%)(s). 212 +* Any [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]], which is not referenced in a (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), is deemed to be constrained according to the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified at the next higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) which (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) that [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]]. 213 +* If there is a conflict when resolving the keys in the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) at two (% style="color:#e74c3c" %)[[levels>>doc:sdmx:Glossary.Level.WebHome]](%%), in terms of a lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) being less restrictive than a higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%), then the offending keys specified at the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) are not deemed part of the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%). 216 216 217 -Note that a Key in a Key Set can have wildcarded [[Components>>doc:sdmx:Glossary 2\.1.Component.WebHome]]. For instance, the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] may simply constrain the [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] FREQ to "A", and all keys where the FREQ="A" are therefore valid.215 +Note that a Key in a Key Set can have wildcarded [[Components>>doc:sdmx:Glossary.Component.WebHome]]. For instance, the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) may simply constrain the [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] FREQ to "A", and all keys where the FREQ="A" are therefore valid. 218 218 219 219 The following logic explains how the inheritance mechanism works. Note that this is conceptual logic and actual systems may differ in the way this is implemented. 220 220 221 -1. Determine all possible keys that are valid at the higher [[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]].222 -1. These keys are deemed to be inherited by the lower-[[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] constrained object, subject to the [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] specified at the lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]].223 -1. Determine all possible keys that are possible using the [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] specified at the lower [[level>>doc:sdmx:Glossary2\.1.Level.WebHome]].224 -1. At the lower [[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] inherit all keys that match with the higher-[[level>>doc:sdmx:Glossary2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]].225 -1. If there are keys in the lower-[[level>>doc:sdmx:Glossary 2\.1.Level.WebHome]] [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] that are not inherited then the key is invalid (i.e., it is less restrictive).219 +1. Determine all possible keys that are valid at the higher (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%). 220 +1. These keys are deemed to be inherited by the lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) constrained object, subject to the (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified at the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%). 221 +1. Determine all possible keys that are possible using the (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) specified at the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%). 222 +1. At the lower (% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) inherit all keys that match with the higher-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%). 223 +1. If there are keys in the lower-(% style="color:#e74c3c" %)[[level>>doc:sdmx:Glossary.Level.WebHome]](%%) (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) that are not inherited then the key is invalid (i.e., it is less restrictive). 226 226 227 227 === 10.4.7 Constraints Examples === 228 228 ... ... @@ -230,20 +230,20 @@ 230 230 231 231 The following scenario is used. 232 232 233 -A [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] contains the following [[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]:231 +A [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] contains the following [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]: 234 234 235 235 * GEO – Geography 236 -* [[SEX>>doc:sdmx:Glossary2\.1.Sex.WebHome]]–[[Sex>>doc:sdmx:Glossary 2\.1.Sex.WebHome]]237 -* [[AGE>>doc:sdmx:Glossary2\.1.Age.WebHome]]–[[Age>>doc:sdmx:Glossary 2\.1.Age.WebHome]]234 +* SEX – Sex 235 +* AGE – Age 238 238 * CAS – Current Activity Status 239 239 240 -In the [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]], common [[code lists>>doc:sdmx:Glossary2\.1.Code list.WebHome]] are used and the requirement is to restrict these at various [[levels>>doc:sdmx:Glossary2\.1.Level.WebHome]] to specify the actual [[code>>doc:sdmx:Glossary2\.1.Code.WebHome]] that are valid for the object to which the [[Constraint>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] is attached.238 +In the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]], common [[code lists>>doc:sdmx:Glossary.Code list.WebHome]] are used and the requirement is to restrict these at various (% style="color:#e74c3c" %)[[levels>>doc:sdmx:Glossary.Level.WebHome]](%%) to specify the actual [[code>>doc:sdmx:Glossary.Code.WebHome]] that are valid for the object to which the (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) is attached. 241 241 242 242 [[image:1750065279010-260.png]] 243 243 244 244 **Figure 20: Example Scenario for Constraints ** 245 245 246 - [[Constraints>>doc:sdmx:Glossary2\.1.Constraint.WebHome]] are declared as follows:244 +Constraints are declared as follows: 247 247 248 248 [[image:1750065319060-899.png]] 249 249 ... ... @@ -252,73 +252,73 @@ 252 252 Notes: 253 253 254 254 255 -[[AGE>>doc:sdmx:Glossary 2\.1.Age.WebHome]] is constrained for the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] and is further restricted for the [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]] CENSUS_CUBE1.253 +[[AGE>>doc:sdmx:Glossary.Age.WebHome]] is constrained for the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] and is further restricted for the [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] CENSUS_CUBE1. 256 256 257 -* The same (% style="color:#e74c3c" %)Constraint(%%) applies to both [[Provision Agreements>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]].255 +* The same (% style="color:#e74c3c" %)[[Constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) applies to both Provision Agreements. 258 258 259 259 The cascade rules elaborated above result as follows: 260 260 261 -[[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]259 +[[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] 262 262 263 -* Constrained by eliminating [[code>>doc:sdmx:Glossary 2\.1.Code.WebHome]] 001 from the [[code list>>doc:sdmx:Glossary2\.1.Code list.WebHome]] for the [[AGE>>doc:sdmx:Glossary2\.1.Age.WebHome]] [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]].261 +* Constrained by eliminating [[code>>doc:sdmx:Glossary.Code.WebHome]] 001 from the [[code list>>doc:sdmx:Glossary.Code list.WebHome]] for the [[AGE>>doc:sdmx:Glossary.Age.WebHome]] [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. 264 264 265 -[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] CENSUS_CUBE1263 +[[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] CENSUS_CUBE1 266 266 267 -* Constrained by restricting the [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] for the [[AGE>>doc:sdmx:Glossary2\.1.Age.WebHome]] [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] to [[codes>>doc:sdmx:Glossary2\.1.Code.WebHome]] 002 and 003 (note that this is a more restrictive (% style="color:#e74c3c" %)constraint(%%) than that declared for the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] which specifies all [[codes>>doc:sdmx:Glossary2\.1.Code.WebHome]] except [[code>>doc:sdmx:Glossary2\.1.Code.WebHome]] 001).268 -** Restricts the CAS [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] to 003 and 004.265 +* Constrained by restricting the [[code list>>doc:sdmx:Glossary.Code list.WebHome]] for the [[AGE>>doc:sdmx:Glossary.Age.WebHome]] [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] to [[codes>>doc:sdmx:Glossary.Code.WebHome]] 002 and 003 (note that this is a more restrictive (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) than that declared for the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] which specifies all [[codes>>doc:sdmx:Glossary.Code.WebHome]] except [[code>>doc:sdmx:Glossary.Code.WebHome]] 001). 266 +** Restricts the CAS [[codes>>doc:sdmx:Glossary.Code.WebHome]] to 003 and 004. 269 269 270 -[[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] CENSUS_CUBE2268 +[[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] CENSUS_CUBE2 271 271 272 -* Restricts the [[code list>>doc:sdmx:Glossary 2\.1.Code list.WebHome]] for the CAS [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] to [[codes>>doc:sdmx:Glossary2\.1.Code.WebHome]] TOT and NAP.273 -** Inherits the [[AGE>>doc:sdmx:Glossary 2\.1.Age.WebHome]] (% style="color:#e74c3c" %)constraint(%%) applied at the(% style="color:#e74c3c" %)level(%%)of the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]].270 +* Restricts the [[code list>>doc:sdmx:Glossary.Code list.WebHome]] for the CAS [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] to [[codes>>doc:sdmx:Glossary.Code.WebHome]] TOT and NAP. 271 +** Inherits the [[AGE>>doc:sdmx:Glossary.Age.WebHome]] (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) applied at the level of the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]. 274 274 275 - [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]]CENSUS_CUBE1_IT273 +Provision Agreement CENSUS_CUBE1_IT 276 276 277 -* Restricts the [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] for the GEO [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] to IT and its children.278 -** Inherits the (% style="color:#e74c3c" %)constraints(%%) from [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] CENSUS_CUBE1 for the [[AGE>>doc:sdmx:Glossary2\.1.Age.WebHome]] and CAS[[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]].275 +* Restricts the [[codes>>doc:sdmx:Glossary.Code.WebHome]] for the GEO [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] to IT and its children. 276 +** Inherits the (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) from [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] CENSUS_CUBE1 for the [[AGE>>doc:sdmx:Glossary.Age.WebHome]] and CAS Dimensions. 279 279 280 - [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]]CENSUS_CUBE2_IT278 +Provision Agreement CENSUS_CUBE2_IT 281 281 282 -* Restricts the [[codes>>doc:sdmx:Glossary 2\.1.Code.WebHome]] for the GEO [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]] to IT and its children.283 -** Inherits the (% style="color:#e74c3c" %)constraints(%%) from [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] CENSUS_CUBE2 for the CAS [[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]].284 -** Inherits the [[AGE>>doc:sdmx:Glossary 2\.1.Age.WebHome]] (% style="color:#e74c3c" %)constraint(%%) applied at the(% style="color:#e74c3c" %)level(%%)of the [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]].280 +* Restricts the [[codes>>doc:sdmx:Glossary.Code.WebHome]] for the GEO [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] to IT and its children. 281 +** Inherits the (% style="color:#e74c3c" %)[[constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) from [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] CENSUS_CUBE2 for the CAS [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]. 282 +** Inherits the [[AGE>>doc:sdmx:Glossary.Age.WebHome]] (% style="color:#e74c3c" %)[[constraint>>doc:sdmx:Glossary.Constraint.WebHome]](%%) applied at the level of the [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]]. 285 285 286 -The (% style="color:#e74c3c" %)Constraints(%%) are defined as follows: 284 +The (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) are defined as follows: 287 287 288 - [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]] (% style="color:#e74c3c" %)Constraint286 +DSD Constraint 289 289 290 290 [[image:1750065367824-357.png]] 291 291 292 - [[Dataflow>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]] (% style="color:#e74c3c" %)Constraints290 +Dataflow Constraints 293 293 294 294 [[image:1750065392163-400.png]] 295 295 296 - [[Provision Agreement>>doc:sdmx:Glossary2\.1.Provision agreement.WebHome]] (% style="color:#e74c3c" %)Constraint294 +Provision Agreement Constraint 297 297 298 298 [[image:1750065461589-995.png]] 299 299 300 -**10.4.7.2 Combination of (% style="color:#e74c3c" %)Constraints(%%)**298 +**10.4.7.2 Combination of Constraints** 301 301 302 302 The possible combination of constraining terms are explained in this section, following a few examples. 303 303 304 -Let’s assume a [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] with the following [[Components>>doc:sdmx:Glossary2\.1.Component.WebHome]]:302 +Let’s assume a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] with the following [[Components>>doc:sdmx:Glossary.Component.WebHome]]: 305 305 306 306 (% style="width:459.294px" %) 307 -|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)FREQ308 -|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)JD_TYPE309 -|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)JD_CATEGORY310 -|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)VIS_CTY305 +|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)FREQ 306 +|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)JD_TYPE 307 +|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)JD_CATEGORY 308 +|(% style="width:204px" %)(% style="color:#3498db" %)[[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]|(% style="width:252px" %)(% style="color:#3498db" %)VIS_CTY 311 311 |(% style="width:204px" %)(% style="color:#2980b9" %)TimeDimension|(% style="width:252px" %)(% style="color:#2980b9" %)TIME_PERIOD 312 -|(% style="width:204px" %)(% style="color:#16a085" %)[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]|(% style="width:252px" %)(% style="color:#16a085" %)OBS_STATUS313 -|(% style="width:204px" %)(% style="color:#16a085" %)[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]|(% style="width:252px" %)(% style="color:#16a085" %)[[UNIT>>doc:sdmx:Glossary 2\.1.Statistical unit.WebHome]]314 -|(% style="width:204px" %)(% style="color:#16a085" %)[[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]|(% style="width:252px" %)(% style="color:#16a085" %)[[COMMENT>>doc:sdmx:Glossary2\.1.Comment.WebHome]]310 +|(% style="width:204px" %)(% style="color:#16a085" %)[[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]]|(% style="width:252px" %)(% style="color:#16a085" %)OBS_STATUS 311 +|(% style="width:204px" %)(% style="color:#16a085" %)[[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]]|(% style="width:252px" %)(% style="color:#16a085" %)UNIT 312 +|(% style="width:204px" %)(% style="color:#16a085" %)[[Attribute>>doc:sdmx:Glossary.Attribute.WebHome]]|(% style="width:252px" %)(% style="color:#16a085" %)[[COMMENT>>doc:sdmx:Glossary.Comment.WebHome]] 315 315 |(% style="width:204px" %)(% style="color:#f39c12" %)MetadataAttribute|(% style="width:252px" %)(% style="color:#e74c3c" %)CONTACT 316 -|(% style="width:204px" %)[[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]|(% style="width:252px" %)MULTISELECT317 -|(% style="width:204px" %)[[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]|(% style="width:252px" %)CHOICE314 +|(% style="width:204px" %)(% style="color:#e74c3c" %)[[Measure>>doc:sdmx:Glossary.Measure.WebHome]]|(% style="width:252px" %)(% style="color:#e74c3c" %)MULTISELECT 315 +|(% style="width:204px" %)(% style="color:#e74c3c" %)[[Measure>>doc:sdmx:Glossary.Measure.WebHome]]|(% style="width:252px" %)(% style="color:#e74c3c" %)CHOICE 318 318 319 319 On the above, let’s assume the following use cases with their constraining requirements: 320 320 321 -**Use Case 1: A (% style="color:#e74c3c" %)Constraint(%%)on allowed values for some[[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]**319 +**Use Case 1: A Constraint on allowed values for some Dimensions** 322 322 323 323 R1: Allow monthly and quarterly data 324 324 ... ... @@ -330,7 +330,7 @@ 330 330 |(% style="width:131px" %)(% style="color:#3498db" %)FREQ|(% style="width:153px" %)(% style="color:#3498db" %)M, Q 331 331 |(% style="width:131px" %)(% style="color:#3498db" %)VIS_CTY|(% style="width:153px" %)(% style="color:#3498db" %)MX 332 332 333 -**Use Case 2: A (% style="color:#e74c3c" %)Constraint(%%)on allowed combinations for some[[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]**331 +**Use Case 2: A Constraint on allowed combinations for some Dimensions** 334 334 335 335 R1: Allow monthly data for Germany 336 336 ... ... @@ -344,7 +344,7 @@ 344 344 |(% rowspan="2" style="width:105px" %)(% style="color:#2980b9" %)Key2|(% style="width:137px" %)(% style="color:#2980b9" %)FREQ|(% style="width:143px" %)(% style="color:#2980b9" %)Q 345 345 |(% style="width:137px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:143px" %)(% style="color:#2980b9" %)MX 346 346 347 -**Use Case 3: A (% style="color:#e74c3c" %)Constraint(%%)on allowed values for some[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]combined with allowed values for some[[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]** R1: Allow monthly and quarterly data345 +**Use Case 3: A Constraint on allowed values for some Dimensions combined with allowed values for some Attributes** R1: Allow monthly and quarterly data 348 348 349 349 R2: Allow Mexico for vis-à-vis country 350 350 ... ... @@ -357,11 +357,11 @@ 357 357 |(% style="width:143px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:139px" %)(% style="color:#2980b9" %)MX 358 358 |(% style="width:143px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:139px" %)(% style="color:#27ae60" %)A 359 359 360 -**Use Case 4: A (% style="color:#e74c3c" %)Constraint(%%)on allowed combinations for some[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]combined with specific[[Attribute>>doc:sdmx:Glossary2\.1.Attribute.WebHome]]values**358 +**Use Case 4: A Constraint on allowed combinations for some Dimensions combined with specific Attribute values** 361 361 362 -R1: Allow monthly data, for Germany, with [[unit>>doc:sdmx:Glossary2\.1.Statistical unit.WebHome]] euro360 +R1: Allow monthly data, for Germany, with unit euro 363 363 364 -R2: Allow quarterly data, for Mexico, with [[unit>>doc:sdmx:Glossary2\.1.Statisticalunit.WebHome]] usd362 +R2: Allow quarterly data, for Mexico, with unit usd 365 365 366 366 This may be expressed with the following DataKeySet: 367 367 ... ... @@ -368,12 +368,12 @@ 368 368 (% style="width:389.294px" %) 369 369 |(% rowspan="3" style="width:89px" %)(% style="color:#2980b9" %)Key1|(% style="width:153px" %)(% style="color:#2980b9" %)FREQ|(% style="width:142px" %)(% style="color:#2980b9" %)M 370 370 |(% style="width:153px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:142px" %)(% style="color:#2980b9" %)DE 371 -|(% style="width:153px" %)(% style="color:#27ae60" %) [[UNIT>>doc:sdmx:Glossary 2\.1.Statistical unit.WebHome]]|(% style="width:142px" %)(% style="color:#27ae60" %)EUR369 +|(% style="width:153px" %)(% style="color:#27ae60" %)UNIT|(% style="width:142px" %)(% style="color:#27ae60" %)EUR 372 372 |(% rowspan="3" style="width:89px" %)(% style="color:#2980b9" %)Key2|(% style="width:153px" %)(% style="color:#2980b9" %)FREQ|(% style="width:142px" %)(% style="color:#2980b9" %)Q 373 373 |(% style="width:153px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:142px" %)(% style="color:#2980b9" %)MX 374 -|(% style="width:153px" %)(% style="color:#27ae60" %) [[UNIT>>doc:sdmx:Glossary 2\.1.Statistical unit.WebHome]]|(% style="width:142px" %)(% style="color:#27ae60" %)USD372 +|(% style="width:153px" %)(% style="color:#27ae60" %)UNIT|(% style="width:142px" %)(% style="color:#27ae60" %)USD 375 375 376 -**Use Case 5: A (% style="color:#e74c3c" %)Constraint(%%)on allowed values for some[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]together with some combination of[[Dimension>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]values**374 +**Use Case 5: A Constraint on allowed values for some Dimensions together with some combination of Dimension values** 377 377 378 378 R1: For annually and quarterly data, for Mexico and Germany, only A status is allowed 379 379 ... ... @@ -389,11 +389,11 @@ 389 389 |(% style="width:137px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:183px" %)(% style="color:#2980b9" %)MX, DE 390 390 |(% style="width:137px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:183px" %)(% style="color:#27ae60" %)F 391 391 392 -The problem with this approach is that according to the business rule for (% style="color:#e74c3c" %)Constraints(%%), only one should be specified per [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]. Thus, if a software would perform some conflict resolution would end up with empty sets for FREQ and OBS_STATUS (as they do not share any values).390 +The problem with this approach is that according to the business rule for (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%), only one should be specified per [[Component>>doc:sdmx:Glossary.Component.WebHome]]. Thus, if a software would perform some conflict resolution would end up with empty sets for FREQ and OBS_STATUS (as they do not share any values). 393 393 394 -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 2\.1.Data structure definition.WebHome]] and [[Dataflows>>doc:sdmx:Glossary2\.1.Dataflow.WebHome]]:392 +Nevertheless, there is a much easier approach to that; this is the cascading mechanism of (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%) (as shown in 10.4.7.1). Hence, these rules would be expressed into two (% style="color:#e74c3c" %)[[levels>>doc:sdmx:Glossary.Level.WebHome]](%%) of (% style="color:#e74c3c" %)[[Constraints>>doc:sdmx:Glossary.Constraint.WebHome]](%%), e.g., [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] and [[Dataflows>>doc:sdmx:Glossary.Dataflow.WebHome]]: 395 395 396 - [[DSD>>doc:sdmx:Glossary2\.1.Data structure definition.WebHome]]CubeRegion:394 +DSD CubeRegion: 397 397 398 398 (% style="width:280.294px" %) 399 399 |(% style="width:156px" %)(% style="color:#2980b9" %)FREQ|(% style="width:121px" %)(% style="color:#2980b9" %)M, Q, A ... ... @@ -414,9 +414,9 @@ 414 414 |(% style="width:159px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:126px" %)(% style="color:#2980b9" %)MX, DE 415 415 |(% style="width:159px" %)(% style="color:#27ae60" %)OBS_STATUS|(% style="width:126px" %)(% style="color:#27ae60" %)A 416 416 417 -**Use case 6: A (% style="color:#e74c3c" %)Constraint(%%)on allowed values for some[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]combined with allowed values for[[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]]**415 +**Use case 6: A Constraint on allowed values for some Dimensions combined with allowed values for Measures** 418 418 419 -R1: Allow monthly data, for Germany, with [[unit>>doc:sdmx:Glossary2\.1.Statistical unit.WebHome]] euro, and [[measure>>doc:sdmx:Glossary2\.1.Measure.WebHome]] choice is 'A' R2: Allow quarterly data, for Mexico, with[[unit>>doc:sdmx:Glossary2\.1.Statisticalunit.WebHome]] usd, and [[measure>>doc:sdmx:Glossary2\.1.Measure.WebHome]] choice is 'B'417 +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' 420 420 421 421 This may be expressed with the following DataKeySet: 422 422 ... ... @@ -423,16 +423,16 @@ 423 423 (% style="width:404.294px" %) 424 424 |(% rowspan="4" style="width:99px" %)(% style="color:#2980b9" %)Key1|(% style="width:153px" %)(% style="color:#2980b9" %)FREQ|(% style="width:149px" %)(% style="color:#2980b9" %)M 425 425 |(% style="width:153px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:149px" %)(% style="color:#2980b9" %)DE 426 -|(% style="width:153px" %)(% style="color:#27ae60" %) [[UNIT>>doc:sdmx:Glossary 2\.1.Statistical unit.WebHome]]|(% style="width:149px" %)(% style="color:#27ae60" %)EUR427 -|(% style="width:153px" %)CHOICE|(% style="width:149px" %)A 424 +|(% style="width:153px" %)(% style="color:#27ae60" %)UNIT|(% style="width:149px" %)(% style="color:#27ae60" %)EUR 425 +|(% style="width:153px" %)(% style="color:#e74c3c" %)CHOICE|(% style="width:149px" %)(% style="color:#e74c3c" %)A 428 428 |(% rowspan="4" style="width:99px" %)(% style="color:#2980b9" %)Key2|(% style="width:153px" %)(% style="color:#2980b9" %)FREQ|(% style="width:149px" %)(% style="color:#2980b9" %)Q 429 429 |(% style="width:153px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:149px" %)(% style="color:#2980b9" %)MX 430 -|(% style="width:153px" %)(% style="color:#27ae60" %) [[UNIT>>doc:sdmx:Glossary 2\.1.Statistical unit.WebHome]]|(% style="width:149px" %)(% style="color:#27ae60" %)USD431 -|(% style="width:153px" %)CHOICE|(% style="width:149px" %)B 428 +|(% style="width:153px" %)(% style="color:#27ae60" %)UNIT|(% style="width:149px" %)(% style="color:#27ae60" %)USD 429 +|(% style="width:153px" %)(% style="color:#e74c3c" %)CHOICE|(% style="width:149px" %)(% style="color:#e74c3c" %)B 432 432 433 -**Use Case 7: A (% style="color:#e74c3c" %)Constraint(%%)with wildcards for[[Codes>>doc:sdmx:Glossary2\.1.Code.WebHome]]and removePrefix property**431 +**Use Case 7: A Constraint with wildcards for Codes and removePrefix property** 434 434 435 -For this example, we assume that the VIS_CTY [[representation>>doc:sdmx:Glossary2\.1.Representation.WebHome]]has been prefixed with prefix ‘AREA_’. In this(% style="color:#e74c3c" %)Constraint(%%), we need to remove the prefix.433 +For this example, we assume that the VIS_CTY representation has been prefixed with prefix ‘AREA_’. In this Constraint, we need to remove the prefix. 436 436 437 437 R1: Allow monthly and quarterly data 438 438 ... ... @@ -446,13 +446,13 @@ 446 446 |(% style="width:264px" %)(% style="color:#2980b9" %)FREQ|(% style="width:112px" %)(% style="color:#2980b9" %)M, Q 447 447 |(% style="width:264px" %)(% style="color:#2980b9" %)VIS_CTY (removePrefix=’AREA_’)|(% style="width:112px" %)(% style="color:#2980b9" %)M% 448 448 449 -**Use Case 8: A (% style="color:#e74c3c" %)Constraint(%%)with multilingual support on[[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]]**447 +**Use Case 8: A Constraint with multilingual support on Attributes** 450 450 451 451 R1: Allow monthly and quarterly data 452 452 453 453 R2: Allow Mexico for vis-à-vis country 454 454 455 -R3: Allow a [[comment>>doc:sdmx:Glossary 2\.1.Comment.WebHome]], in English, which includes the term adjusted for status453 +R3: Allow a [[comment>>doc:sdmx:Glossary.Comment.WebHome]], in English, which includes the term adjusted for status 456 456 457 457 This may be expressed with the following CubeRegion: 458 458 ... ... @@ -459,13 +459,13 @@ 459 459 (% style="width:382.294px" %) 460 460 |(% style="width:190px" %)(% style="color:#2980b9" %)FREQ|(% style="width:189px" %)(% style="color:#2980b9" %)M, Q 461 461 |(% style="width:190px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:189px" %)(% style="color:#2980b9" %)MX 462 -|(% style="width:190px" %)(% style="color:#27ae60" %)[[COMMENT>>doc:sdmx:Glossary 2\.1.Comment.WebHome]] (lang=’en’)|(% style="width:189px" %)(% style="color:#27ae60" %)%adjusted%460 +|(% style="width:190px" %)(% style="color:#27ae60" %)[[COMMENT>>doc:sdmx:Glossary.Comment.WebHome]] (lang=’en’)|(% style="width:189px" %)(% style="color:#27ae60" %)%adjusted% 463 463 464 -**Use Case 9: A (% style="color:#e74c3c" %)Constraint(%%)on allowed values for[[Dimensions>>doc:sdmx:Glossary2\.1.Dimension.WebHome]]combined with allowed** values for Metadata[[Attributes>>doc:sdmx:Glossary2\.1.Attribute.WebHome]]R1: Allow monthly and quarterly data462 +**Use Case 9: A Constraint on allowed values for Dimensions combined with allowed** values for Metadata Attributes R1: Allow monthly and quarterly data 465 465 466 466 R2: Allow Mexico for vis-à-vis country 467 467 468 -R3: Allow John Doe for (% style="color:#e74c3c" %)contact(%%)466 +R3: Allow John Doe for contact 469 469 470 470 This may be expressed with the following CubeRegion: 471 471 ... ... @@ -472,4 +472,4 @@ 472 472 (% style="width:388.294px" %) 473 473 |(% style="width:181px" %)(% style="color:#2980b9" %)FREQ|(% style="width:204px" %)(% style="color:#2980b9" %)M, Q 474 474 |(% style="width:181px" %)(% style="color:#2980b9" %)VIS_CTY|(% style="width:204px" %)(% style="color:#2980b9" %)MX 475 -|(% style="width:181px" %)(% style="color: rgb(243, 156, 18);color: rgb(231, 76, 60)" %)CONTACT|(% style="width:204px" %)(% style="color:#f39c12" %)John Doe473 +|(% style="width:181px" %)(% style="color:#f39c12" %)CONTACT|(% style="width:204px" %)(% style="color:#f39c12" %)John Doe