Changes for page 10 Constraints
Last modified by Helena K. on 2026/06/10 09:45
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -107,7 +107,7 @@ 107 107 108 108 * Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] 109 109 110 -For a (%style="color:#e74c3c"%)Constraint(%%)based on a [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] the(%style="color:#e74c3c"%)Constraint(%%)can reference one or more of:110 +For a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] based on a [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] the [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] can reference one or more of: 111 111 112 112 * [[Data Structure Definition>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] 113 113 * [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]] ... ... @@ -114,7 +114,7 @@ 114 114 * [[Provision Agreement>>doc:sdmx:Glossary 2\.1.Provision agreement.WebHome]] 115 115 * [[Data Provider>>doc:sdmx:Glossary 2\.1.Data provider.WebHome]] 116 116 117 -For a (%style="color:#e74c3c"%)Constraint(%%)based on an [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] the(%style="color:#e74c3c"%)Constraint(%%)can reference one or more of:117 +For a [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] based on an [[MSD>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] the [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] can reference one or more of: 118 118 119 119 * [[Metadata Structure Definition>>doc:sdmx:Glossary 2\.1.Metadata structure definition.WebHome]] 120 120 * [[Metadataflow>>doc:sdmx:Glossary 2\.1.Metadataflow.WebHome]] ... ... @@ -122,54 +122,54 @@ 122 122 * Metadata Provider 123 123 * [[Metadata Set>>doc:sdmx:Glossary 2\.1.Metadata set.WebHome]] 124 124 125 -Furthermore, there can be more than one (%style="color:#e74c3c"%)Constraint(%%)specified for a specific object e.g., more than one(%style="color:#e74c3c"%)Constraint(%%)for a specific [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]].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:Glossary 2\.1.Constraint.WebHome]] for a specific [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]. 126 126 127 -In view of the flexibility of (%style="color:#e74c3c"%)constraints(%%)attachment, clear rules on their usage are required. These are elaborated below.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. 128 128 129 129 === 10.4.4 Multiple Constraints === 130 130 131 -There can be many (%style="color:#e74c3c"%)Constraints(%%)for any Constrainable [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]), subject to the following restrictions:131 +There can be many [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] for any Constrainable [[Artefact>>doc:sdmx:Glossary 2\.1.Artefact.WebHome]] (e.g., [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]]), subject to the following restrictions: 132 132 133 133 ==== 10.4.4.1 Cube Region ==== 134 134 135 -A (%style="color:#e74c3c"%)Constraint(%%)can contain multiple [[Member Selections>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] (e.g., [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]).135 +A [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] can contain multiple [[Member Selections>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] (e.g., [[Dimensions>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]]). 136 136 137 137 * A specific [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] (e.g., [[Dimension>>doc:sdmx:Glossary 2\.1.Dimension.WebHome]] FREQ) can only be contained in one Cube Region for any one attached object (e.g., a specific [[DSD>>doc:sdmx:Glossary 2\.1.Data structure definition.WebHome]] or specific [[Dataflow>>doc:sdmx:Glossary 2\.1.Dataflow.WebHome]]). 138 138 * [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]] values within a [[Member Selection>>doc:sdmx:Glossary 2\.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 (%style="color:#e74c3c"%)Constraint(%%)must be considered.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:Glossary 2\.1.Constraint.WebHome]] must be considered. 140 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:Glossary 2\.1.Code list.WebHome]]), or localised values (e.g., text for English only). Lack of locale means any [[language>>doc:sdmx:Glossary 2\.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 141 * Any values included in a [[Member Selection>>doc:sdmx:Glossary 2\.1.Member selection.WebHome]] for [[Components>>doc:sdmx:Glossary 2\.1.Component.WebHome]] with an array data type (i.e., [[Measures>>doc:sdmx:Glossary 2\.1.Measure.WebHome]], [[Attributes>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] or Metadata [[Attributes>>doc:sdmx:Glossary 2\.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:Glossary 2\.1.Code.WebHome]] ‘A’ for an [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] will allow any instance of the [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] that includes ‘A’, like [‘A’, ‘B’] or [‘A’, ‘C’, ‘D’]. Similarly, if [[Code>>doc:sdmx:Glossary 2\.1.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 (%style="color:#e74c3c"%)Constraint(%%)and wildcards can be used (e.g., any key position not reference explicitly is deemed to be "all values").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"). 146 146 147 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. 148 148 149 -In addition, [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] and Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] (%style="color:#e74c3c"%)constraints(%%)may accompany KeySets, in order to specify the allowed values per Key. Those are expressed following the rules for Cube Regions, as explained above.149 +In addition, [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]], [[Measure>>doc:sdmx:Glossary 2\.1.Measure.WebHome]] and Metadata [[Attribute>>doc:sdmx:Glossary 2\.1.Attribute.WebHome]] [[constraints>>doc:sdmx:Glossary 2\.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. 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 (%style="color:#e74c3c"%)Constraints(%%)are versioned, the latest(% style="color:#e74c3c"%)version(%%)of the(%style="color:#e74c3c"%)Constraint(%%)is used to generate the reporting restriction rules; all previous(% style="color:#e74c3c"%)versions(%%)are for historical information only.155 +When Data and Metadata [[Constraints>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] are versioned, the latest [[version>>doc:sdmx:Glossary 2\.1.Version.WebHome]] of the [[Constraint>>doc:sdmx:Glossary 2\.1.Constraint.WebHome]] is used to generate the reporting restriction rules; all previous [[versions>>doc:sdmx:Glossary 2\.1.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 (%style="color:#e74c3c"%)Constraints(%%)to evolve over time, increasing their(% style="color:#e74c3c"%)version(%%)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]].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:Glossary 2\.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]]. 158 158 159 159 Example: 160 160 161 -Data (% style="color:#e74c3c" %)Constraint(%%)1.0.0161 +Data Constraint 1.0.0 162 162 163 163 (% style="width:573.294px" %) 164 -|(% style="width:108px" %) [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:127px" %)Valid Value|(% style="width:150px" %)Valid from|(% style="width:185px" %)Valid to164 +|(% style="width:108px" %)Component|(% 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 (% style="color:#e74c3c" %)Constraint(%%)1.1.0169 +Data Constraint 1.1.0 170 170 171 171 (% style="width:576.294px" %) 172 -|(% style="width:110px" %) [[Component>>doc:sdmx:Glossary 2\.1.Component.WebHome]]|(% style="width:129px" %)Valid Value|(% style="width:145px" %)Valid from|(% style="width:189px" %)Valid to172 +|(% style="width:110px" %)Component|(% style="width:129px" %)Valid Value|(% style="width:145px" %)Valid from|(% style="width:189px" %)Valid to 173 173 |(% rowspan="3" style="width:110px" %)COUNTRY|(% style="width:129px" %)UK|(% style="width:145px" %) |(% style="width:189px" %) 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" %)