Changes for page 10 Constraints

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

From version 12.1
edited by Artur
on 2025/05/27 15:51
Change comment: There is no comment for this version
To version 6.3
edited by Helena
on 2025/05/22 12:02
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.arturkryazhev
1 +xwiki:XWiki.helena
Content
... ... @@ -4,15 +4,15 @@
4 4  
5 5  == {{id name="_Toc371062"/}}10.1 Scope ==
6 6  
7 -The scope of this section is to describe the support in the metamodel for specifying both the access to and the content of a [[data source>>doc:sdmx:Glossary.Data source.WebHome]]. The information may be stored in a resource such as a registry for use by applications wishing to locate data and metadata which is available via the Internet. The (% style="color:#e74c3c" %)Constraint(%%) is also used to specify a sub set of a Codelist which may used as a partial [[code list>>doc:sdmx:Glossary.Code list.WebHome]] which is relevant in the context of the [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] to which the (% style="color:#e74c3c" %)Constraint(%%) is attached e.g. [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]], [[Dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]], Provision Agreement.
7 +The scope of this section is to describe the support in the metamodel for specifying both the access to and the content of a data source. The information may be stored in a resource such as a registry for use by applications wishing to locate data and metadata which is available via the Internet. The Constraint is also used to specify a sub set of a Codelist which may used as a partial code list which is relevant in the context of the artefact to which the Constraint is attached e.g. Data Structure Definition, Dataflow, Provision Agreement.
8 8  
9 -Note that in this metamodel the term [[data source>>doc:sdmx:Glossary.Data source.WebHome]] refers to both data and metadata sources, and [[data provider>>doc:sdmx:Glossary.Data provider.WebHome]] refers to both data and metadata providers.
9 +Note that in this metamodel the term data source refers to both data and metadata sources, and data provider refers to both data and metadata providers.
10 10  
11 -A [[data source>>doc:sdmx:Glossary.Data source.WebHome]] may be a simple file of data or metadata (in [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] format), or a database or [[metadata repository>>doc:sdmx:Glossary.Metadata repository.WebHome]]. A [[data source>>doc:sdmx:Glossary.Data source.WebHome]] may contain data for many data or [[metadataflows>>doc:sdmx:Glossary.Metadataflow.WebHome]] (called DataflowDefinition, and MetadataflowDefinition in the model), and the mechanisms described in this section allow an organisation to specify precisely the scope of the content of the [[data source>>doc:sdmx:Glossary.Data source.WebHome]] where this [[data source>>doc:sdmx:Glossary.Data source.WebHome]] is registered (SimpleDataSource, QueryDataSource).
11 +A data source may be a simple file of data or metadata (in SDMX-ML format), or a database or metadata repository. A data source may contain data for many data or metadataflows (called DataflowDefinition, and MetadataflowDefinition in the model), and the mechanisms described in this section allow an organisation to specify precisely the scope of the content of the data source where this data source is registered (SimpleDataSource, QueryDataSource).
12 12  
13 13  The DataflowDefinition and MetadataflowDefinition, themselves may be specified as containing only a sub set of all the possible keys that could be derived from a DataStructureDefinition or MetadataStructureDefinition.
14 14  
15 -These specifications are called (% style="color:#e74c3c" %)//Constraint//(%%) in this model.
15 +These specifications are called //Constraint// in this model.
16 16  
17 17  == {{id name="_Toc371063"/}}10.2 Inheritance ==
18 18  
... ... @@ -26,19 +26,19 @@
26 26  
27 27  ==== 10.2.2.1 Narrative ====
28 28  
29 -Any [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] that is derived from //ConstrainableArtefact// can have (% style="color:#e74c3c" %)constraints(%%) defined. The [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] that can have (% style="color:#e74c3c" %)constraint(%%) metadata attached are:
29 +Any artefact that is derived from //ConstrainableArtefact// can have constraints defined. The artefacts that can have constraint metadata attached are:
30 30  
31 31  * DataflowDefinition
32 32  * ProvisionAgreement
33 -* DataProvider – this is restricted to [[release calendar>>doc:sdmx:Glossary.Release policy - release calendar.WebHome]]
33 +* DataProvider – this is restricted to release calendar
34 34  * MetadataflowDefinition
35 35  * DataStructureDefinition
36 36  * MetadataStructureDefinition
37 -* [[DataSet>>doc:sdmx:Glossary.Data set.WebHome]]
38 -* SimpleDataSource – this is a registered [[data source>>doc:sdmx:Glossary.Data source.WebHome]] where the registration references the actual [[DataSet>>doc:sdmx:Glossary.Data set.WebHome]] or MetadataSet
37 +* DataSet
38 +* SimpleDataSource – this is a registered data source where the registration references the actual DataSet or MetadataSet
39 39  * QueryDataSource
40 40  
41 -Note that, because the (% style="color:#e74c3c" %)Constraint(%%) can specify a sub set of the [[component>>doc:sdmx:Glossary.Component.WebHome]] values implied by a specific //Structure// (such a specific DataStructureDefinition or specific MetadataStructureDefinition), the //ConstrainableArtefact//s must be associated with a specific //Structure//. Therefore, whilst the (% style="color:#e74c3c" %)Constraint(%%) itself may not be linked directly to a DataStructureDefinition or MetadataStructureDefinition, the [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] that it is constraining will be linked to a DataStructureDefinition or MetadataStructureDefinition. As a [[Data Provider>>doc:sdmx:Glossary.Data provider.WebHome]] does not link to any one specific [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] or [[MSD>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] the type of information that can be contained in a (% style="color:#e74c3c" %)Constraint(%%) linked to a DataProvider is restricted to [[Release Calendar>>doc:sdmx:Glossary.Release policy - release calendar.WebHome]].
41 +Note that, because the Constraint can specify a sub set of the component values implied by a specific //Structure// (such a specific DataStructureDefinition or specific MetadataStructureDefinition), the //ConstrainableArtefact//s must be associated with a specific //Structure//. Therefore, whilst the Constraint itself may not be linked directly to a DataStructureDefinition or MetadataStructureDefinition, the artefact that it is constraining will be linked to a DataStructureDefinition or MetadataStructureDefinition. As a Data Provider does not link to any one specific DSD or MSD the type of information that can be contained in a Constraint linked to a DataProvider is restricted to Release Calendar.
42 42  
43 43  == {{id name="_Toc371066"/}}10.3 Constraints ==
44 44  
... ... @@ -52,16 +52,16 @@
52 52  
53 53  ==== 10.3.2.1 Narrative ====
54 54  
55 -The (% style="color:#e74c3c" %)constraint(%%) mechanism allows specific (% style="color:#e74c3c" %)constraints(%%) to be attached to a //ConstrainableArtefact//. With the exception of ReferencePeriod, and ReleaseCalendar these (% style="color:#e74c3c" %)constraints(%%) specify a sub set of the total set of values or keys that may be present in any of the ConstrainableArtefacts.
55 +The constraint mechanism allows specific constraints to be attached to a //ConstrainableArtefact//. With the exception of ReferencePeriod, and ReleaseCalendar these constraints specify a sub set of the total set of values or keys that may be present in any of the ConstrainableArtefacts.
56 56  
57 -For instance a DataStructureDefinition specifies, for each [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], the list of allowable [[code>>doc:sdmx:Glossary.Code.WebHome]] values. However, a specific DataflowDefinition that uses the DataStructureDefinition may contain only a sub set 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>>doc:sdmx:Glossary.Dimension.WebHome]] values). In addition to this, a DataProvider that is capable of supplying data according to the DataflowDefinition has a ProvisionAgreement, and the DataProvider may also wish to supply (% style="color:#e74c3c" %)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 datasource in terms of the KeySets or CubeRegions contained within it.
57 +For instance a DataStructureDefinition specifies, for each Dimension, the list of allowable code values. However, a specific DataflowDefinition that uses the DataStructureDefinition may contain only a sub set 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 DataflowDefinition 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 datasource in terms of the KeySets or CubeRegions contained within it.
58 58  
59 -A //ConstrainableArtefact// can have two types of (% style="color:#e74c3c" %)//Constraint//(%%):
59 +A //ConstrainableArtefact// can have two types of //Constraint//:
60 60  
61 -1. ContentConstraint – is used solely as a mechanism to specify either the available set of keys (DataKeySet, MetadataKeySet) or set of [[component>>doc:sdmx:Glossary.Component.WebHome]] values (CubeRegion, MetadatTargetRegion) in a //DataSource// such as a [[DataSet>>doc:sdmx:Glossary.Data set.WebHome]] or a database (//QueryDatasource//), or the allowable keys that can be constructed from a DataStructureDefinition. Multiple such (% style="color:#e74c3c" %)constraints(%%) may be present for a //ConstrainableArtefact//. For instance, there may be a ContentConstraint that specifies the values allowed for the //ConstrainableArtefact //(role is allowableContent) which can be used for validation or for constructing a partial [[code list>>doc:sdmx:Glossary.Code list.WebHome]], whilst another (% style="color:#e74c3c" %)constraint(%%) can specify the actual content of a data or metadata source (role is actualContent).
62 -1. AttachmentConstraint – is used as a mechanism to define slices of the full set of data and to which metadata can be attached in a [[Data Set>>doc:sdmx:Glossary.Data set.WebHome]] or MetadataSet. These slices can be defined either as a set of keys (KeySet) or a set of [[component>>doc:sdmx:Glossary.Component.WebHome]] values (CubeRegion). There can be many AttachmentConstraints specified for a specific AttachableArtefact.
61 +1. ContentConstraint – is used solely as a mechanism to specify either the available set of keys (DataKeySet, MetadataKeySet) or set of component values (CubeRegion, MetadatTargetRegion) in a //DataSource// such as a DataSet or a database (//QueryDatasource//), or the allowable keys that can be constructed from a DataStructureDefinition. Multiple such constraints may be present for a //ConstrainableArtefact//. For instance, there may be a ContentConstraint that specifies the values allowed for the //ConstrainableArtefact //(role is allowableContent) which can be used for validation or for constructing a partial code list, whilst another constraint can specify the actual content of a data or metadata source (role is actualContent).
62 +1. AttachmentConstraint – is used as a mechanism to define slices of the full set of data and to which metadata can be attached in a Data Set or MetadataSet. These slices can be defined either as a set of keys (KeySet) or a set of component values (CubeRegion). There can be many AttachmentConstraints specified for a specific AttachableArtefact.
63 63  
64 -In addition to (DataKeySet, MetadataKeySet, CubeRegion, MetadataTargetRegion, a (% style="color:#e74c3c" %)Constraint(%%) can have a ReferencePeriod defining one of more date ranges (ValidityPeriod) specifying the [[time period>>doc:sdmx:Glossary.Time period.WebHome]] for which data or metadata are available in the //ConstrainableArtefact// and a ReleaseCalendar specifying when data are released for publication or reporting.
64 +In addition to (DataKeySet, MetadataKeySet, CubeRegion, MetadataTargetRegion, a Constraint can have a ReferencePeriod defining one of more date ranges (ValidityPeriod) specifying the time period for which data or metadata are available in the //ConstrainableArtefact// and a ReleaseCalendar specifying when data are released for publication or reporting.
65 65  
66 66  === {{id name="_Toc371069"/}}10.3.3 Relationship Class Diagram – Detail ===
67 67  
... ... @@ -75,142 +75,182 @@
75 75  
76 76  ==== 10.3.3.1 Explanation of the Diagram ====
77 77  
78 -A (% style="color:#e74c3c" %)//Constraint//(%%) is a //MaintainableArtefact//.
78 +A //Constraint// is a //MaintainableArtefact//.
79 79  
80 -A (% style="color:#e74c3c" %)//Constraint//(%%) has a choice of two ways of specifying value sub sets:
80 +A //Constraint// has a choice of two ways of specifying value sub sets:
81 81  
82 -1. As a set of keys that can be present in the [[DataSet>>doc:sdmx:Glossary.Data set.WebHome]] (DataKeySet) or MetadataSet (MetadataKeySet). Each DataKey or MetadataKey specifies a number of ComponentValues each of which reference a //[[Component>>doc:sdmx:Glossary.Component.WebHome]]// (e.g. [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]], TargetObject). Each ComponentValue is a value that may be present for a //[[Component>>doc:sdmx:Glossary.Component.WebHome]]// of a structure when contained in a [[DataSet>>doc:sdmx:Glossary.Data set.WebHome]] or MetadataSet. The MetadataKeySet must also identify the MetadataTarget as there can be many of each of these in a MetadataStructureDefinition. For the DataKeySet the equivalent identification is not necessary as there is only one DimensionDescriptor and one AttributeDescriptor.
83 -1. As a set of CubeRegions or MetadataTaregetRegions each of which defines a “slice” of the total structure (MemberSelection) in terms of one or more MemberValues that may be present for a //[[Component>>doc:sdmx:Glossary.Component.WebHome]]// of a structure when contained in a //[[DataSet>>doc:sdmx:Glossary.Data set.WebHome]]// or MetadataSet.
82 +1. As a set of keys that can be present in the DataSet (DataKeySet) or MetadataSet (MetadataKeySet). Each DataKey or MetadataKey specifies a number of ComponentValues each of which reference a //Component// (e.g. Dimension, TargetObject). Each ComponentValue is a value that may be present for a //Component// of a structure when contained in a DataSet or MetadataSet. The MetadataKeySet must also identify the MetadataTarget as there can be many of each of these in a MetadataStructureDefinition. For the DataKeySet the equivalent identification is not necessary as there is only one DimensionDescriptor and one AttributeDescriptor.
83 +1. As a set of CubeRegions or MetadataTaregetRegions each of which defines a “slice” of the total structure (MemberSelection) in terms of one or more MemberValues that may be present for a //Component// of a structure when contained in a //DataSet// or MetadataSet.
84 84  
85 -The difference between (1) and (2) above is that in (1) a complete key is defined whereas in (2) above the “slice” defines a list of possible values for each of the// [[Component>>doc:sdmx:Glossary.Component.WebHome]]//s but does not specify specific key combinations. In addition, in (1) the association between //[[Component>>doc:sdmx:Glossary.Component.WebHome]]// and DataKeyValue or MetadataKeyValue is constrained to the [[components>>doc:sdmx:Glossary.Component.WebHome]] that comprise the key or identifier, whereas in (2) it can contain other [[component>>doc:sdmx:Glossary.Component.WebHome]] types (such as [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]]). The value in ComponentValue.value and MemberValue.value must be consistent with the //[[Representation>>doc:sdmx:Glossary.Representation.WebHome]]// declared for the //[[Component>>doc:sdmx:Glossary.Component.WebHome]]// in the DataStructureDefinition or MetadataStructureDefinition. Note that in all cases the “operator” on the value is deemed to be “equals”. Furthermore, it is possible in a MemberValue to specify that child values (e.g. child [[codes>>doc:sdmx:Glossary.Code.WebHome]]) are included in the (% style="color:#e74c3c" %)constraint(%%) by means of the cascadeValues [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]].
85 +The difference between (1) and (2) above is that in (1) a complete key is defined whereas in (2) above the “slice” defines a list of possible values for each of the// Component//s but does not specify specific key combinations. In addition, in (1) the association between //Component// and DataKeyValue or MetadataKeyValue is constrained to the components that comprise the key or identifier, whereas in (2) it can contain other component types (such as attributes). The value in ComponentValue.value and MemberValue.value must be consistent with the //Representation// declared for the //Component// in the DataStructureDefinition or MetadataStructureDefinition. Note that in all cases the “operator” on the value is deemed to be “equals”. Furthermore, it is possible in a MemberValue to specify that child values (e.g. child codes) are included in the constraint by means of the cascadeValues attribute.
86 86  
87 -It is possible to define for the DataKeySet, DataKey, MetadataKeySet, MetadataKey, CubeRegion, MetadataTargetRegion, and MemberSelection whether the set is included (isIncluded = “true”) or excluded (isIncluded = ”false”) from the (% style="color:#e74c3c" %)constraint(%%) definition. This [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] is useful if, for example, only a small sub-set of the possible values are not included in the set, then this smaller sub-set can be defined and excluded from the (% style="color:#e74c3c" %)constraint(%%). Note that if the child construct is “included: and the parent construct is “excluded” then the child construct is included in the list of constructs that are “excluded”.
87 +It is possible to define for the DataKeySet, DataKey, MetadataKeySet, MetadataKey, CubeRegion, MetadataTargetRegion, and MemberSelection whether the set is included (isIncluded = “true”) or excluded (isIncluded = ”false”) from the constraint definition. This attribute is useful if, for example, only a small sub-set of the possible values are not included in the set, then this smaller sub-set can be defined and excluded from the constraint. Note that if the child construct is “included: and the parent construct is “excluded” then the child construct is included in the list of constructs that are “excluded”.
88 88  
89 -==== 10.3.3.2 Definitions ====
89 +**10.3.3.2 Definitions**
90 90  
91 -(% style="width:987.294px" %)
92 -|**Class**|**Feature**|(% style="width:471px" %)**Description**
93 -|//Constrainable// //[[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]]//|(((
91 +|**Class**|**Feature**|**Description**
92 +|//Constrainable// //Artefact//|(((
94 94  Abstract Class Sub classes are:
94 +
95 95  DataflowDefinition
96 +
96 96  Metadataflow
98 +
97 97  Definition
100 +
98 98  ProvisionAgreement
102 +
99 99  DataProvider
104 +
100 100  //QueryDatasource//
106 +
101 101  SimpleDatasource
108 +
102 102  DataStructure
110 +
103 103  Definition
112 +
104 104  MetadataStructure
114 +
105 105  Definition
106 -)))|(% style="width:471px" %)An [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] that can have (% style="color:#e74c3c" %)Constraints(%%) specified.
107 -| |content|(% style="width:471px" %)Associates the metadata that constrains the content to be found in a data or metadata source linked to the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]].
108 -| |attachment|(% style="width:471px" %)Associates the metadata that constrains the valid content of a Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] to which metadata may be attached.
109 -|(%%)(% style="color:#e74c3c" %)//Constraint//|(((
116 +)))|An artefact that can have Constraints specified.
117 +| |content|Associates the metadata that constrains the content to be found in a data or metadata source linked to the Constrainable Artefact.
118 +| |attachment|Associates the metadata that constrains the valid content of a Constrainable Artefact to which metadata may be attached.
119 +|//Constraint//|(((
110 110  Inherits from
121 +
111 111  //MaintainableArtefact//
123 +
112 112  Abstract class. Sub classes are:
125 +
113 113  AttachmentConstraint
127 +
114 114  ContentConstraint
115 -)))|(% style="width:471px" %)Specifies a sub set 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>>doc:sdmx:Glossary.Code list.WebHome]] and other valid content.
116 -| |+availableDates|(% style="width:471px" %)Association to the [[time period>>doc:sdmx:Glossary.Time period.WebHome]] that identifies the time range for which data or metadata are available in the [[data source>>doc:sdmx:Glossary.Data source.WebHome]].
117 -| |+dataContentKeys|(% style="width:471px" %)Association to a sub set of Data Key Sets (i.e. value combinations) that can be derived from the definition of the structure to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked.
118 -| |+metadataContentKeys|(% style="width:471px" %)Association to a sub set of Metdata Key Sets (i.e. value combinations) that can be derived from the definition of the Structure to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linke
119 -| |+dataContentRegion|(% style="width:471px" %)Association to a sub set of [[component>>doc:sdmx:Glossary.Component.WebHome]] values that can be derived from the [[Data Structure Definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked.
120 -| |+metadataContentRegion|(% style="width:471px" %)Association to a sub set of [[component>>doc:sdmx:Glossary.Component.WebHome]] values that can be derived from the [[Metadata Structure Definition>>doc:sdmx:Glossary.Metadata structure definition.WebHome]] to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked.
129 +)))|Specifies a sub set 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.
130 +| |+availableDates//    //|Association to the time period that identifies the time range for which data or metadata are available in the data source.
131 +| |+dataContentKeys|Association to a sub set of Data Key Sets (i.e. value combinations) that can be derived from the definition of the structure to which the Constrainable Artefact is linked.
132 +| |+metadataContentKeys|Association to a sub set of Metdata Key Sets (i.e. value combinations) that can be derived from the definition of the Structure to which the Constrainable Artefact is linke
133 +| |+dataContentRegion|Association to a sub set of component values that can be derived from the Data Structure Definition to which the Constrainable Artefact is linked.
134 +| |+metadataContentRegion|Association to a sub set of component values that can be derived from the Metadata Structure Definition to which the Constrainable Artefact is linked.
121 121  |ContentConstraint|(((
122 122  Inherits from
123 -(% style="color:#e74c3c" %)//Constraint//
124 -)))|(% style="width:471px" %)Defines a (% style="color:#e74c3c" %)Constraint(%%) in terms of the content that can be found in data or metadata sources linked to the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] to which this (% style="color:#e74c3c" %)constraint(%%) is associated.
125 -| |+role|(% style="width:471px" %)Association to the role that the (% style="color:#e74c3c" %)Constraint(%%) plays
126 -|ConstraintRole| |(% style="width:471px" %)Specifies the way the type of content of a (% style="color:#e74c3c" %)Constraint(%%) in terms of its purpose.
127 -| |allowableContent|(% style="width:471px" %)The (% style="color:#e74c3c" %)Constraint(%%) contains a specification of the valid sub set of the [[Component>>doc:sdmx:Glossary.Component.WebHome]] values or keys.
128 -| |actualContent|(% style="width:471px" %)The (% style="color:#e74c3c" %)Constraint(%%) contains a specification of the actual content of a data or metadata source in terms of the [[Component>>doc:sdmx:Glossary.Component.WebHome]] values or keys in the source.
137 +
138 +//Constraint//
139 +)))|Defines a Constraint in terms of the content that can be found in data or metadata sources linked to the Constrainable Artefact to which this constraint is associated.
140 +| |+role|Association to the role that the Constraint plays
141 +|ConstraintRole| |Specifies the way the type of content of a Constraint in terms of its purpose.
142 +| |allowableContent|The Constraint contains a specification of the valid sub set of the Component values or keys.
143 +| |actualContent|The Constraint contains a specification of the actual content of a data or metadata source in terms of the Component values or keys in the source.
129 129  |(((
130 -AttachmentConstraint
145 +Attachment
146 +
147 +Constraint
131 131  )))|(((
132 132  Inherits from
133 -(% style="color:#e74c3c" %)//Constraint//
134 -)))|(% style="width:471px" %)Defines a (% style="color:#e74c3c" %)Constraint(%%) in terms of the combination of [[component>>doc:sdmx:Glossary.Component.WebHome]] values that may be found in a [[data source>>doc:sdmx:Glossary.Data source.WebHome]], and to which a Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] may be associated in a structure definition.
135 -|DataKeySet| |(% style="width:471px" %)A set of data keys.
136 -| |isIncluded|(% style="width:471px" %)Indicates whether the Data Key Set is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
137 -| |+keys|(% style="width:471px" %)Association to the Data Keys in the set.
138 -|MetadataKeySet| |(% style="width:471px" %)A set of metadata keys.
139 -| |isIncluded|(% style="width:471px" %)Indicates whether the [[Metadata Key Set>>doc:sdmx:Glossary.Metadata key set.WebHome]] is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
140 -| |+keys|(% style="width:471px" %)Association to the Metadata Keys in the set.
141 -|DataKey| |(% style="width:471px" %)The values of a key in a data set.
142 -| |isIncluded|(% style="width:471px" %)Indicates whether the Data Key is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
143 -| |+keyValue|(% style="width:471px" %)Associates the [[Component>>doc:sdmx:Glossary.Component.WebHome]] Values that comprise the key.
144 -|MetadataKey| |(% style="width:471px" %)The values of a key in a metadata set.
145 -| |isIncluded|(% style="width:471px" %)Indicates whether the Metdadata Key is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
146 -| |+keyValue|(% style="width:471px" %)Associates the [[Component>>doc:sdmx:Glossary.Component.WebHome]] Values that comprise the key.
147 -|ComponentValue| |(% style="width:471px" %)The identification of and value of a [[Component>>doc:sdmx:Glossary.Component.WebHome]] of the key (e.g. [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]])
148 -| |value|(% style="width:471px" %)The value of [[Component>>doc:sdmx:Glossary.Component.WebHome]]
149 -| |+valueFor|(% style="width:471px" %)Association to the [[Component>>doc:sdmx:Glossary.Component.WebHome]] (e.g. [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]]) in the Structure to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked.
150 -|TimeDimensionValue| |(% style="width:471px" %)The value of the Time [[Dimension>>doc:sdmx:Glossary.Dimension.WebHome]] [[component>>doc:sdmx:Glossary.Component.WebHome]].
151 -| |timeValue|(% style="width:471px" %)The value of the [[time period>>doc:sdmx:Glossary.Time period.WebHome]].
152 -| |operator|(% style="width:471px" %)(((
153 -Indicates whether the specified value represents and exact time or [[time period>>doc:sdmx:Glossary.Time period.WebHome]], or whether the value should be handled as a range.
150 +
151 +//Constraint//
152 +)))|Defines a Constraint in terms of the combination of component values that may be found in a data source, and to which a Constrainable Artefact may be associated in a structure definition.
153 +|DataKeySet| |A set of data keys.
154 +| |isIncluded|Indicates whether the Data Key Set is included in the constraint definition or excluded from the constraint definition.
155 +| |+keys|Association to the Data Keys in the set.
156 +|MetadataKeySet| |A set of metadata keys.
157 +| |isIncluded|Indicates whether the Metadata Key Set is included in the constraint definition or excluded from the constraint definition.
158 +| |+keys|Association to the Metadata Keys in the set.
159 +|DataKey| |The values of a key in a data set.
160 +| |isIncluded|Indicates whether the Data Key is included in the constraint definition or excluded from the constraint definition.
161 +| |+keyValue|Associates the Component Values that comprise the key.
162 +|MetadataKey| |The values of a key in a metadata set.
163 +| |isIncluded|Indicates whether the Metdadata Key is included in the constraint definition or excluded from the constraint definition.
164 +| |+keyValue|Associates the Component Values that comprise the key.
165 +|ComponentValue| |The identification of and value of a Component of the key (e.g. Dimension)
166 +| |value|The value of Component
167 +| |+valueFor|Association to the Component (e.g. Dimension) in the Structure to which the Constrainable Artefact is linked.
168 +|TimeDimensionValue| |The value of the Time Dimension component.
169 +| |timeValue|The value of the time period.
170 +| |operator|(((
171 +Indicates whether the specified value represents and exact time or time period, or whether the value should be handled as a range.
172 +
154 154  A value of greaterThan or greaterThanOrEqual indicates that the value is the beginning of a range (exclusive or inclusive, respectively).
174 +
155 155  A value of lessThan or lessThanOrEqual indicates that the value is the end or a range (exclusive or inclusive, respectively).
156 -In the absence of the opposite bound being specified for the range, this bound is to be treated as infinite (e.g. any [[time period>>doc:sdmx:Glossary.Time period.WebHome]] after the beginning of the provided [[time period>>doc:sdmx:Glossary.Time period.WebHome]] for greaterThanOrEqual)
176 +
177 +In the absence of the opposite bound being specified for the range, this bound is to be treated as infinite (e.g. any time period after the beginning of the provided time period for greaterThanOrEqual)
157 157  )))
158 -|CubeRegion| |(% style="width:471px" %)A set of [[Components>>doc:sdmx:Glossary.Component.WebHome]] and their values that defines a sub set or “slice” of the total range of possible content of a data structure to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked.
159 -| |isIncluded|(% style="width:471px" %)Indicates whether the Cube Region is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
160 -| |+member|(% style="width:471px" %)Associates the set of [[Components>>doc:sdmx:Glossary.Component.WebHome]] that define the sub set of values.
161 -|MetadataTargetRegion| |(% style="width:471px" %)A set of [[Components>>doc:sdmx:Glossary.Component.WebHome]] and their values that defines a sub set or “slice” of the total range of possible content of a metadata structure to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked.
162 -| |isIncluded|(% style="width:471px" %)Indicates whether the Metadata Target Region is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
163 -| |+member|(% style="width:471px" %)Associates the set of [[Components>>doc:sdmx:Glossary.Component.WebHome]] that define the sub set of values.
164 -|MemberSelection| |(% style="width:471px" %)A set of permissible values for one [[component>>doc:sdmx:Glossary.Component.WebHome]] of the axis.
165 -| |isIncluded|(% style="width:471px" %)Indicates whether the [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] is included in the (% style="color:#e74c3c" %)constraint(%%) definition or excluded from the (% style="color:#e74c3c" %)constraint(%%) definition.
166 -| |+valuesFor|(% style="width:471px" %)Association to the [[Component>>doc:sdmx:Glossary.Component.WebHome]] in the Structure to which the Constrainable [[Artefact>>doc:sdmx:Glossary.Artefact.WebHome]] is linked, which defines the valid [[Representation>>doc:sdmx:Glossary.Representation.WebHome]] for the Member Values.
179 +|CubeRegion| |A set of Components and their values that defines a sub set or “slice” of the total range of possible content of a data structure to which the Constrainable Artefact is linked.
180 +| |isIncluded|Indicates whether the Cube Region is included in the constraint definition or excluded from the constraint definition.
181 +| |+member|Associates the set of Components that define the sub set of values.
182 +|MetadataTargetRegion| |A set of Components and their values that defines a sub set or “slice” of the total range of possible content of a metadata structure to which the Constrainable Artefact is linked.
183 +| |isIncluded|Indicates whether the Metadata Target Region is included in the constraint definition or excluded from the constraint definition.
184 +| |+member|Associates the set of Components that define the sub set of values.
185 +|MemberSelection| |A set of permissible values for one component of the axis.
186 +| |isIncluded|Indicates whether the Member Selection is included in the constraint definition or excluded from the constraint definition.
187 +| |+valuesFor|Association to the Component in the Structure to which the Constrainable Artefact is linked, which defines the valid Representation for the Member Values.
167 167  |SelectionValue|(((
168 168  Abstract class. Sub classes are:
190 +
169 169  MemberValue
192 +
170 170  TimeRangeValue
171 -)))|(% style="width:471px" %)A collection of values for the [[Member Selections>>doc:sdmx:Glossary.Member selection.WebHome]] that, combined with other [[Member Selections>>doc:sdmx:Glossary.Member selection.WebHome]], comprise the value content of the Cube Region.
194 +)))|A collection of values for the Member Selections that, combined with other Member Selections, comprise the value content of the Cube Region.
172 172  |MemberValue|(((
173 173  Inherits from
197 +
174 174  SelectionValue
175 -)))|(% style="width:471px" %)A single value of the set of values for the [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]].
176 -| |value|(% style="width:471px" %)A value of the member.
177 -| |cascadeValues|(% style="width:471px" %)Indicates that the child nodes of the member are included in the [[Member Selection>>doc:sdmx:Glossary.Member selection.WebHome]] (e.g. child [[codes>>doc:sdmx:Glossary.Code.WebHome]])
199 +)))|A single value of the set of values for the Member Selection.
200 +| |value|A value of the member.
201 +| |cascadeValues|Indicates that the child nodes of the member are included in the Member Selection (e.g. child codes)
178 178  |//TimeRangeValue//|(((
179 179  Inherits from
204 +
180 180  SelectionValue
206 +
181 181  Abstract Class
208 +
182 182  Concrete Classes
210 +
183 183  BeforePeriod
212 +
184 184  AfterPeriod
214 +
185 185  RangePeriod
186 -)))|(% style="width:471px" %)A time value or values that specifies the date or dates for which the constrained selection is valid.
216 +)))|A time value or values that specifies the date or dates for which the constrained selection is valid.
187 187  |BeforePeriod|(((
188 188  Inherits from
219 +
189 189  //TimeRangeValue//
190 -)))|(% style="width:471px" %)The period before which the constrained selection is valid.
191 -| |isInclusive|(% style="width:471px" %)Indication of whether the date is inclusive in the period.
221 +)))|The period before which the constrained selection is valid.
222 +| |isInclusive|Indication of whether the date is inclusive in the period.
192 192  |AfterPeriod|(((
193 193  Inherits from
225 +
194 194  //TimeRangeValue//
195 -)))|(% style="width:471px" %)The period after which the constrained selection is valid.
196 -| |isInclusive|(% style="width:471px" %)Indication of whether the date is inclusive in the period.
197 -|RangePeriod| |(% style="width:471px" %)The start and end periods in a date range.
198 -| |+start|(% style="width:471px" %)Association to the Start Period.
199 -| |+end|(% style="width:471px" %)Association to the End Period.
227 +)))|The period after which the constrained selection is valid.
228 +| |isInclusive|Indication of whether the date is inclusive in the period.
229 +|RangePeriod| |The start and end periods in a date range.
230 +| |+start|Association to the Start Period.
231 +| |+end|Association to the End Period.
200 200  |StartPeriod|(((
201 201  Inherits from
234 +
202 202  //TimeRangeValue//
203 -)))|(% style="width:471px" %)The period from which the constrained selection is valid.
204 -| |isInclusive|(% style="width:471px" %)Indication of whether the date is inclusive in the period.
236 +)))|The period from which the constrained selection is valid.
237 +| |isInclusive|Indication of whether the date is inclusive in the period.
205 205  |EndPeriod|(((
206 206  Inherits from
240 +
207 207  //TimeRangeValue//
208 -)))|(% style="width:471px" %)The period to which the constrained selection is valid.
209 -| |isInclusive|(% style="width:471px" %)Indication of whether the date is inclusive in the period.
210 -|ReferencePeriod| |(% style="width:471px" %)A set of dates that constrain the content that may be found in a data or metadata set.
211 -| |startDate|(% style="width:471px" %)The start date of the period.
212 -| |endDate|(% style="width:471px" %)The end date of the period.
213 -|ReleaseCalendar| |(% style="width:471px" %)The schedule of publication or reporting of the data or metadata
214 -| |periodicity|(% style="width:471px" %)The [[time period>>doc:sdmx:Glossary.Time period.WebHome]] between the releases of the data or metadata
215 -| |offset|(% style="width:471px" %)Interval between January 1^^st^^ and the first release of the data
216 -| |tolerance|(% style="width:471px" %)Period after which the data or metadata may be deemed late.
242 +)))|The period to which the constrained selection is valid.
243 +| |isInclusive|Indication of whether the date is inclusive in the period.
244 +|ReferencePeriod| |A set of dates that constrain the content that may be found in a data or metadata set.
245 +| |startDate|The start date of the period.
246 +| |endDate|The end date of the period.
247 +|ReleaseCalendar| |The schedule of publication or reporting of the data or metadata
248 +| |periodicity|The time period between the releases of the data or metadata
249 +| |offset|Interval between January 1^^st^^ and the first release of the data
250 +| |tolerance|Period after which the data or metadata may be deemed late.
251 +
252 +
253 +
254 +
255 +
256 +