Changes for page 10 RepresentationMap

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

From version 10.1
edited by Artur
on 2025/05/22 14:56
Change comment: There is no comment for this version
To version 2.2
edited by Helena
on 2025/05/15 09:59
Change comment: Changed document title to [10 RepresentationMap].

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,0 @@
1 -Methodology.SDMX 3\.0 Standards\. Section 2\. Information model\: UML conceptual design.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.arturkryazhev
1 +xwiki:XWiki.helena
Content
... ... @@ -1,12 +1,10 @@
1 -{{box title="**Contents**"}}
2 -{{toc/}}
3 -{{/box}}
1 += 10 RepresentationMap =
4 4  
5 5  == 10.1 Scope ==
6 6  
7 7  A RepresentationMap describes a mapping between source value(s) and target value(s) where the values are restricted to those in a Codelist, ValueList or be of a certain data type, e.g., Integer.
8 8  
9 -The RepresentationMap (% style="color:#e74c3c" %)maps(%%) information from one or more sources, where the values for each source are used in combination to derive the output value for one or more targets. Each source value may match a substring of the original data (using startIndex and/or endIndex) or define a pattern matching rule described by a regular expression. The target value is provided as an absolute string, although it can make use of regular expression groups to carry across values from the source string to the target string without having to explicitly state the value to carry. An example is a regular expression which states ‘match a value starting with AB followed by anything, where the anything is marked a capture group’, the target can state ‘take the anything value and postfix it with AB’ thus enabling the mapping of ABX to XAB and ABY to YAB.
7 +The RepresentationMap maps information from one or more sources, where the values for each source are used in combination to derive the output value for one or more targets. Each source value may match a substring of the original data (using startIndex and/or endIndex) or define a pattern matching rule described by a regular expression. The target value is provided as an absolute string, although it can make use of regular expression groups to carry across values from the source string to the target string without having to explicitly state the value to carry. An example is a regular expression which states ‘match a value starting with AB followed by anything, where the anything is marked a capture group’, the target can state ‘take the anything value and postfix it with AB’ thus enabling the mapping of ABX to XAB and ABY to YAB.
10 10  
11 11  The absence of an output for an input is interpreted as ‘no output value for the given source value(s)’.
12 12  
... ... @@ -20,32 +20,36 @@
20 20  
21 21  ==== 10.1.2.1 Narrative ====
22 22  
23 -The RepresentationMap is a //MaintainableArtefact//. It (% style="color:#e74c3c" %)maps(%%) one or more source values to one or more target values, where values that are being (% style="color:#e74c3c" %)mapped(%%) are defined by the //ValueRepresentation//. A //ValueRepresentation// is an abstract container which is either a Codelist, ValueList or a FacetValueType. Source and target values are in a list where the list order is important as the RepresentationMapping sourceValues and targetValues must match the order. It is permissible to mix types for both source and target values, allowing for example a Codelist to (% style="color:#e74c3c" %)map(%%) to an Integer (which is a FacetValueType). The list of source or targets can also be mixed, for example a Codelist in conjunction with a FacetValueType and ValueList and can be defined as the source of a mapping, thus allowing rules such as ‘When CL_AREA=UK AND AGE=26 CURRENCY=$’.
21 +The RepresentationMap is a //MaintainableArtefact//. It maps one or more source values to one or more target values, where values that are being mapped are defined by the //ValueRepresentation//. A //ValueRepresentation// is an abstract container which is either a Codelist, ValueList or a FacetValueType. Source and target values are in a list where the list order is important as the RepresentationMapping sourceValues and targetValues must match the order. It is permissible to mix types for both source and target values, allowing for example a Codelist to map to an Integer (which is a FacetValueType). The list of source or targets can also be mixed, for example a Codelist in conjunction with a FacetValueType and ValueList and can be defined as the source of a mapping, thus allowing rules such as ‘When CL_AREA=UK AND AGE=26 CURRENCY=$’.
24 24  
25 25  ==== 10.1.2.2 Definitions ====
26 26  
25 +:
26 +::
27 +
27 27  (((
28 -(% style="width:862.294px" %)
29 -|(% style="width:218px" %)**Class**|(% style="width:200px" %)**Feature**|(% style="width:440px" %)**Description**
30 -|(% style="width:218px" %)RepresentationMap|(% style="width:200px" %)(((
29 +|**Class**|**Feature**|**Description**
30 +|RepresentationMap|(((
31 31  Inherits from
32 +
32 32  //MaintainableArtefact//
33 -)))|(% style="width:440px" %)Links source and target [[representations>>doc:Glossary.Representation.WebHome]], whose values may conform to a linked Codelist, ValueList or enumerated type such as Integer.
34 -|(% style="width:218px" %) |(% style="width:200px" %)source|(% style="width:440px" %)Association to one or more Codelist, ValueList, or FacetValue – mixed types are permissible
35 -|(% style="width:218px" %) |(% style="width:200px" %)target|(% style="width:440px" %)Association to one or more Codelist, ValueList, or FacetValue – mixed types are permissible
36 -|(% style="width:218px" %)RepresentationMapping|(% style="width:200px" %)(((
34 +)))|Links source and target representations, whose values may conform to a linked Codelist, ValueList or enumerated type such as Integer.
35 +||source|Association to one or more Codelist, ValueList, or FacetValue – mixed types are permissible
36 +||target|Association to one or more Codelist, ValueList, or FacetValue – mixed types are permissible
37 +|RepresentationMapping|(((
37 37  Inherits from
39 +
38 38  //AnnotableArtefact//
39 -)))|(% style="width:440px" %)Describes how the source value(s) (% style="color:#e74c3c" %)map(%%) to the target value(s)
40 -|(% style="width:218px" %) |(% style="width:200px" %)validFrom|(% style="width:440px" %)Optional period describing when the mapping is applicable
41 -|(% style="width:218px" %) |(% style="width:200px" %)validTo|(% style="width:440px" %)Optional period describing which the mapping is no longer applicable.
42 -|(% style="width:218px" %) |(% style="width:200px" %)sourceValues|(% style="width:440px" %)Input value for source in the RepresentationMap
43 -|(% style="width:218px" %) |(% style="width:200px" %)targetValues|(% style="width:440px" %)Output value for each (% style="color:#e74c3c" %)mapped(%%) target in the RepresentationMap
44 -|(% style="width:218px" %)MappedValue|(% style="width:200px" %) |(% style="width:440px" %)Describes an input value that is part of the sourceValues in a RepresentationMapping
45 -|(% style="width:218px" %) |(% style="width:200px" %)value|(% style="width:440px" %)The value to compare the source data with
46 -|(% style="width:218px" %) |(% style="width:200px" %)isRegEx|(% style="width:440px" %)If true, the value field should be treated as a regular expression when comparing with the source data
47 -|(% style="width:218px" %) |(% style="width:200px" %)startIndex|(% style="width:440px" %)If provided, a substring of the source data should be taken, starting from this index (starting at zero) before comparing with the //value// field for matching
48 -|(% style="width:218px" %) |(% style="width:200px" %)endIndex|(% style="width:440px" %)If provided, a substring of the source data should be taken, ending at this index (starting at zero) before comparing with the //value// field for matching
49 -|(% style="width:218px" %)TargetValue|(% style="width:200px" %) |(% style="width:440px" %)Describes the target value that is part of the targetValues of a RepresentationMapping
50 -|(% style="width:218px" %) |(% style="width:200px" %)value|(% style="width:440px" %)Represents a value for the targetValues of a RepresenationMapping
41 +)))|Describes how the source value(s) map to the target value(s)
42 +||validFrom|Optional period describing when the mapping is applicable
43 +||validTo|Optional period describing which the mapping is no longer applicable.
44 +||sourceValues|Input value for source in the RepresentationMap
45 +||targetValues|Output value for each mapped target in the RepresentationMap
46 +|MappedValue||Describes an input value that is part of the sourceValues in a RepresentationMapping
47 +||value|The value to compare the source data with
48 +||isRegEx|If true, the value field should be treated as a regular expression when comparing with the source data
49 +||startIndex|If provided, a substring of the source data should be taken, starting from this index (starting at zero) before comparing with the //value// field for matching
50 +||endIndex|If provided, a substring of the source data should be taken, ending at this index (starting at zero) before comparing with the //value// field for matching
51 +|TargetValue||Describes the target value that is part of the targetValues of a RepresentationMapping
52 +||value|Represents a value for the targetValues of a RepresenationMapping
51 51  )))
SDMX 3-0-0 SECTION 2 FINAL-1.0 (1)_en_8856508d.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -149.3 KB
Content
SUZ.Methodology.Code.MethodologyClass[0]
index
... ... @@ -1,1 +1,0 @@
1 -11