Changes for page 12 Constraints

Last modified by Artur on 2025/09/10 11:19

From version 8.1
edited by Helena
on 2025/05/16 14:02
Change comment: There is no comment for this version
To version 7.2
edited by Helena
on 2025/05/16 14:00
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -55,8 +55,10 @@
55 55  
56 56  The constraint mechanism allows specific constraints to be attached to a //ConstrainableArtefact//. With the exception of ReleaseCalendar these constraints specify a subset of the total set of values or keys that may be present in any of the //ConstrainableArtefacts//.
57 57  
58 -For instance, a DataStructureDefinition specifies, for each Dimension, the list of allowable code values. However, a specific Dataflow that uses the DataStructureDefinition may contain only a subset of the possible range of keys that is theoretically possible from the DataStructureDefinition definition (the total range of possibilities is sometimes called the Cartesian product of the dimension values). In addition to this, a DataProvider that is capable of supplying data according to the Dataflow has a ProvisionAgreement, and the DataProvider may also wish to supply constraint information which may further constrain the range of possibilities in order to describe the data that the provider can supply. It may also be useful to describe the content of a data source in terms of the KeySets or CubeRegions contained within it.
58 +For instance, a DataStructureDefinition specifies, for each Dimension, the list of allowable code values. However, a specific Dataflow that uses the
59 59  
60 +DataStructureDefinition may contain only a subset of the possible range of keys that is theoretically possible from the DataStructureDefinition definition (the total range of possibilities is sometimes called the Cartesian product of the dimension values). In addition to this, a DataProvider that is capable of supplying data according to the Dataflow has a ProvisionAgreement, and the DataProvider may also wish to supply constraint information which may further constrain the range of possibilities in order to describe the data that the provider can supply. It may also be useful to describe the content of a data source in terms of the KeySets or CubeRegions contained within it.
61 +
60 60  A //ConstrainableArtefact// can have two types of //Constraint//s:
61 61  
62 62  1. DataConstraint – is used as a mechanism to specify, either the available set of keys (DataKeySet), or set of component values (CubeRegion) in a //DataSource// such as a Simpledatasource or a database (//QueryDatasource//), or the allowable keys that can be constructed from a DataStructureDefinition. Multiple such DataConstraints may be present for a //ConstrainableArtefact//. For instance, there may be a DataConstraint that specifies the values allowed for the //ConstrainableArtefact //(role is allowableContent) which can be used for validation or for constructing a partial code list for one Dimension, while another provides the validation for another Dimension within the same DSD.
... ... @@ -105,23 +105,37 @@
105 105  |**Class**|**Feature**|(% style="width:442px" %)**Description**
106 106  |//ConstrainableArt efact//|(((
107 107  Abstract Class Sub classes are:
110 +
108 108  Dataflow
112 +
109 109  DataProvider
114 +
110 110  DataStructureDefinition
116 +
111 111  Metadataflow
118 +
112 112  MetadataProvisionAgreement
120 +
113 113  MetadataSet
122 +
114 114  MetadataStructureDefinition
124 +
115 115  ProvisionAgreement
126 +
116 116  //QueryDatasource//
128 +
117 117  SimpleDatasource
118 118  )))|(% style="width:442px" %)An artefact that can have Constraints specified.
119 119  | |content|(% style="width:442px" %)Associates the metadata that constrains the content to be found in a data or metadata source linked to the Constrainable Artefact.
120 120  |//Constraint//|(((
121 121  Inherits from
134 +
122 122  //MaintainableArtefact//
136 +
123 123  Abstract class Sub classes are:
138 +
124 124  DataConstraint
140 +
125 125  MetadataConstraint
126 126  )))|(% style="width:442px" %)Specifies a subset of the definition of the allowable or actual content of a data or metadata source that can be derived from the Structure that defines code lists and other valid content.
127 127  | |+dataContentKeys|(% style="width:442px" %)(((
... ... @@ -183,8 +183,11 @@
183 183  | |+valuesFor|(% style="width:442px" %)Association to the Component in the Structure to which the Constrainable Artefact is linked, which defines the valid Representation for the Member Values.
184 184  |//SelectionValue//|(((
185 185  Abstract class. Sub classes are:
202 +
186 186  MemberValue
204 +
187 187  //TimeRangeValue//
206 +
188 188  LocalisedMemberValue
189 189  )))|(% style="width:442px" %)A collection of values for the Member Selections that, combined with other Member Selections, comprise the value content of the Cube Region.
190 190  | |validFrom|(% style="width:442px" %)Date from which the Selection Value is valid.
... ... @@ -191,6 +191,7 @@
191 191  | |validTo|(% style="width:442px" %)Date from which the Selection Value is superseded.
192 192  |MemberValue|(((
193 193  Inherits from
213 +
194 194  //SelectionValue//
195 195  )))|(% style="width:442px" %)A single value of the set of values for the Member Selection.
196 196  | |value|(% style="width:442px" %)A value of the member.
... ... @@ -197,6 +197,7 @@
197 197  | |cascadeValues|(% style="width:442px" %)Indicates that the child nodes of the member are included in the Member Selection (e.g., child codes)
198 198  |LocalisedMemberV alue|(((
199 199  Inherits from
220 +
200 200  //SelectionValue//
201 201  )))|(% style="width:442px" %)A single localised value of the set of values for a Member Selection.
202 202  | |value|(% style="width:442px" %)A value of the member.
... ... @@ -203,14 +203,20 @@
203 203  | |locale|(% style="width:442px" %)The locale that the values must adhere to in the dataset.
204 204  |//TimeRangeValue//|(((
205 205  Inherits from
227 +
206 206  //SelectionValue//
229 +
207 207  Abstract Class Concrete Classes:
231 +
208 208  BeforePeriod
233 +
209 209  AfterPeriod
235 +
210 210  RangePeriod
211 211  )))|(% style="width:442px" %)A time value or values that specifies the date or dates for which the constrained selection is valid.
212 212  |BeforePeriod|(((
213 213  Inherits from
240 +
214 214  //TimeRangeValue//
215 215  )))|(% style="width:442px" %)The period before which the constrained selection is valid.
216 216  | |isInclusive|(% style="width:442px" %)Indication of whether the date is inclusive in the period.
... ... @@ -217,6 +217,7 @@
217 217  | |period|(% style="width:442px" %)The time period which acts as the latest possible reported period
218 218  |AfterPeriod|(((
219 219  Inherits from
247 +
220 220  //TimeRangeValue//
221 221  )))|(% style="width:442px" %)The period after which the constrained selection is valid.
222 222  | |isInclusive|(% style="width:442px" %)Indication of whether the date is inclusive in the period.
... ... @@ -226,6 +226,7 @@
226 226  | |+end|(% style="width:442px" %)Association to the End Period.
227 227  |StartPeriod|(((
228 228  Inherits from
257 +
229 229  //TimeRangeValue//
230 230  )))|(% style="width:442px" %)The period from which the constrained selection is valid.
231 231  | |isInclusive|(% style="width:442px" %)Indication of whether the date is inclusive in the period.
... ... @@ -232,6 +232,7 @@
232 232  | |period|(% style="width:442px" %)The time period which acts as the start of the range
233 233  |EndPeriod|(((
234 234  Inherits from
264 +
235 235  //TimeRangeValue//
236 236  )))|(% style="width:442px" %)The period to which the constrained selection is valid.
237 237  | |isInclusive|(% style="width:442px" %)Indication of whether the date is inclusive in the period.