Changes for page 13 Structure Mapping

Summary

• Page properties (1 modified, 0 added, 0 removed)
• Attachments (0 modified, 0 added, 1 removed)
  • 1747377208446-496.png

Details

Page properties

Content

...	...	@@ -39,9 +39,7 @@
39	39	Different source values can also map to the same target value, for example when deriving regions from country codes.
40	40
41	41	(% style="width:674.294px" %)
42		-|(% style="width:284px" %)**Source Component:
43		-REF_AREA**|(% style="width:387px" %)**Target Component:
44		-REGION**
	42	+|(% style="width:284px" %)**Source Component: REF_AREA**|(% style="width:387px" %)**Target Component: REGION**
45	45	|(% style="width:284px" %)FR|(% style="width:387px" %)EUR
46	46	|(% style="width:284px" %)DE|(% style="width:387px" %)EUR
47	47	|(% style="width:284px" %)IT|(% style="width:387px" %)EUR
...	...	@@ -134,26 +134,24 @@
134	134
135	135	A Representation Map mapping ISO 2-character to ISO 3-character Codelists would take the following form:
136	136
137		-(% style="width:763.294px" %)
138		-|(% style="width:252px" %)**CL_ISO_ALPHA2**|(% style="width:508px" %)**CL_ISO_ALPHA3**
139		-|(% style="width:252px" %)AF|(% style="width:508px" %)AFG
140		-|(% style="width:252px" %)AL|(% style="width:508px" %)ALB
141		-|(% style="width:252px" %)DZ|(% style="width:508px" %)DZA
142		-|(% style="width:252px" %)AS|(% style="width:508px" %)ASM
143		-|(% style="width:252px" %)AD|(% style="width:508px" %)AND
144		-|(% style="width:252px" %)etc…|(% style="width:508px" %)
	135	+|CL_ISO_ALPHA2|CL_ISO_ALPHA3
	136	+|AF|AFG
	137	+|AL|ALB
	138	+|DZ|DZA
	139	+|AS|ASM
	140	+|AD|AND
	141	+|etc…|
145	145
146	146	A Representation Map mapping free text country names to an ISO 2-character Codelist could be similarly described:
147	147
148		-(% style="width:770.294px" %)
149		-|(% style="width:247px" %)**Text**|(% style="width:520px" %)**CL_ISO_ALPHA2**
150		-|(% style="width:247px" %)"Germany"|(% style="width:520px" %)DE
151		-|(% style="width:247px" %)"France"|(% style="width:520px" %)FR
152		-|(% style="width:247px" %)"United Kingdom"|(% style="width:520px" %)GB
153		-|(% style="width:247px" %)"Great Britain"|(% style="width:520px" %)GB
154		-|(% style="width:247px" %)"Ireland"|(% style="width:520px" %)IE
155		-|(% style="width:247px" %)"Eire"|(% style="width:520px" %)IE
156		-|(% style="width:247px" %)etc…|(% style="width:520px" %)
	145	+|Text|CL_ISO_ALPHA2
	146	+|"Germany"|DE
	147	+|"France"|FR
	148	+|"United Kingdom"|GB
	149	+|"Great Britain"|GB
	150	+|"Ireland"|IE
	151	+|"Eire"|IE
	152	+|etc…|
157	157
158	158	Valuelists, introduced in SDMX 3.0, are equivalent to Codelists but allow the maintenance of non-SDMX identifiers. Importantly, their IDs do not need to conform to IDType, but as a consequence are not Identifiable.
159	159
...	...	@@ -161,11 +161,10 @@
161	161
162	162	In common with Codelists, each item in a Valuelist has a multilingual name giving it a human-readable label and an optional description. For example:
163	163
164		-(% style="width:780.294px" %)
165		-|(% style="width:126px" %)**Value**|(% style="width:153px" %)**Locale**|(% style="width:498px" %)**Name**
166		-|(% style="width:126px" %)$|(% style="width:153px" %)en|(% style="width:498px" %)United States Dollar
167		-|(% style="width:126px" %)%|(% style="width:153px" %)En|(% style="width:498px" %)Percentage
168		-|(% style="width:126px" %) |(% style="width:153px" %)fr|(% style="width:498px" %)Pourcentage
	160	+|Value|Locale|Name
	161	+|$|en|United States Dollar
	162	+|%|En|Percentage
	163	+| |fr|Pourcentage
169	169
170	170	Other characteristics of Representation Maps:
171	171
...	...	@@ -189,31 +189,30 @@
189	189
190	190	Below is an example set of regular expression rules for a particular component.
191	191
192		-(% style="width:708.294px" %)
193		-|(% style="width:133px" %)**Regex**|(% style="width:377px" %)**Description**|(% style="width:194px" %)**Output**
194		-|(% style="width:133px" %)A|(% style="width:377px" %)Rule match if input = 'A'|(% style="width:194px" %)OUT_A
195		-|(% style="width:133px" %)^[A-G]|(% style="width:377px" %)Rule match if the input starts with letters A to G|(% style="width:194px" %)OUT_B
196		-|(% style="width:133px" %)A~|B|(% style="width:377px" %)Rule match if input is either 'A' or 'B'|(% style="width:194px" %)OUT_C
	187	+|Regex|Description|Output
	188	+|A|Rule match if input = 'A'|OUT_A
	189	+|^[A-G]|Rule match if the input starts with letters A to G|OUT_B
	190	+|A~|B|Rule match if input is either 'A' or 'B'|OUT_C
197	197
198	198	Like all mapping rules, the output is either a Code, a Value or free text depending on the representation of the Component in the target Data Structure Definition.
199	199
200	200	If the regular expression contains capture groups, these can be used in the definition of the output value, by specifying \//**n** //as an output value where //**n**// is the number of the capture group starting from 1. For example
201	201
202		-(% style="width:720.294px" %)
203		-|(% style="width:199px" %)**Regex**|(% style="width:126px" %)**Target output**|(% style="width:192px" %)**Example Input**|(% style="width:200px" %)**Example Output**
204		-|(% style="width:199px" %)(((
205		-([0-9]{4})[0-9]([0-9]{1})
206		-)))|(% style="width:126px" %)\1-Q\2|(% style="width:192px" %)200933|(% style="width:200px" %)2009-Q3
	196	+|Regex|Target output|Example Input|Example Output
	197	+|(((
	198	+([0-9]{4})[0-
207	207
	200	+9]([0-9]{1})
	201	+)))|\1-Q\2|200933|2009-Q3
	202	+
208	208	As regular expression rules can be used as a general catch-all if nothing else matches, the ordering of the rules is important. Rules should be tested starting with the highest priority, moving down the list until a match is found.
209	209
210	210	The following example shows this:
211	211
212		-(% style="width:725.294px" %)
213		-|(% style="width:198px" %)**Priority**|(% style="width:148px" %)**Regex**|(% style="width:212px" %)**Description**|(% style="width:164px" %)**Output**
214		-|(% style="width:198px" %)1|(% style="width:148px" %)A|(% style="width:212px" %)Rule match if input = 'A'|(% style="width:164px" %)OUT_A
215		-|(% style="width:198px" %)2|(% style="width:148px" %)B|(% style="width:212px" %)Rule match if input = 'B'|(% style="width:164px" %)OUT_B
216		-|(% style="width:198px" %)3|(% style="width:148px" %)[A-Z]|(% style="width:212px" %)Any character A-Z|(% style="width:164px" %)OUT_C
	207	+|Priority|Regex|Description|Output
	208	+|1|A|Rule match if input = 'A'|OUT_A
	209	+|2|B|Rule match if input = 'B'|OUT_B
	210	+|3|[A-Z]|Any character A-Z|OUT_C
217	217
218	218	The input 'A' matches both the first and the last rule, but the first takes precedence having the higher priority. The output is OUT_A.
219	219
...	...	@@ -225,16 +225,14 @@
225	225
226	226	For instance:
227	227
228		-(% style="width:742.294px" %)
229		-|(% style="width:191px" %)**Input String**|(% style="width:154px" %)**Start**|(% style="width:211px" %)**Length**|(% style="width:182px" %)**Output**
230		-|(% style="width:191px" %)ABC_DEF_XYZ|(% style="width:154px" %)5|(% style="width:211px" %)3|(% style="width:182px" %)DEF
231		-|(% style="width:191px" %)XULADS|(% style="width:154px" %)1|(% style="width:211px" %)2|(% style="width:182px" %)XU
	222	+|Input String|Start|Length|Output
	223	+|ABC_DEF_XYZ|5|3|DEF
	224	+|XULADS|1|2|XU
232	232
233	233	Sub-strings can therefore be used for the conceptual rule //If starts with 'XU' map to Y// as shown in the following example:
234	234
235		-(% style="width:740.294px" %)
236		-|(% style="width:194px" %)**Start**|(% style="width:151px" %)**Length**|(% style="width:208px" %)**Source**|(% style="width:183px" %)**Target**
237		-|(% style="width:194px" %)1|(% style="width:151px" %)2|(% style="width:208px" %)XU|(% style="width:183px" %)Y
	228	+|Start|Length|Source|Target
	229	+|1|2|XU|Y
238	238
239	239	== 13.7 Mapping non-SDMX time formats to SDMX formats ==
240	240
...	...	@@ -246,16 +246,15 @@
246	246
247	247	The output of a time-based mapping is derived from the output Frequency, which is either explicitly stated in the mapping or defined as the value output by a specific Dimension or Attribute in the output mapping. If the output frequency is unknown or if the SDMX format is not desired, then additional rules can be provided to specify the output date format for the given frequency Id. The default rules are:
248	248
249		-(% style="width:771.294px" %)
250		-|(% style="width:187px" %)**Frequency**|(% style="width:159px" %)**Format**|(% style="width:422px" %)**Example**
251		-|(% style="width:187px" %)A|(% style="width:159px" %)YYYY|(% style="width:422px" %)2010
252		-|(% style="width:187px" %)D|(% style="width:159px" %)YYYY-MM-DD|(% style="width:422px" %)2010-01-01
253		-|(% style="width:187px" %)I|(% style="width:159px" %)YYYY-MM-DDThh:mm:ss|(% style="width:422px" %)2010-01T20:22:00
254		-|(% style="width:187px" %)M|(% style="width:159px" %)YYYY-MM|(% style="width:422px" %)2010-01
255		-|(% style="width:187px" %)Q|(% style="width:159px" %)YYYY-Qn|(% style="width:422px" %)2010-Q1
256		-|(% style="width:187px" %)S|(% style="width:159px" %)YYYY-Sn|(% style="width:422px" %)2010-S1
257		-|(% style="width:187px" %)T|(% style="width:159px" %)YYYY-Tn|(% style="width:422px" %)2010-T1
258		-|(% style="width:187px" %)W|(% style="width:159px" %)YYYY-Wn|(% style="width:422px" %)YYYY-W53
	241	+|Frequency|Format|Example
	242	+|A|YYYY|2010
	243	+|D|YYYY-MM-DD|2010-01-01
	244	+|I|YYYY-MM-DDThh:mm:ss|2010-01T20:22:00
	245	+|M|YYYY-MM|2010-01
	246	+|Q|YYYY-Qn|2010-Q1
	247	+|S|YYYY-Sn|2010-S1
	248	+|T|YYYY-Tn|2010-T1
	249	+|W|YYYY-Wn|YYYY-W53
259	259
260	260	In the case where the input frequency is lower than the output frequency, the mapping defaults to end of period, but can be explicitly set to start, end or mid-period.
261	261
...	...	@@ -268,70 +268,76 @@
268	268
269	269	Date and time formats are specified by date and time pattern strings based on Java's Simple Date Format. Within date and time pattern strings, unquoted letters from 'A' to 'Z' and from 'a' to 'z' are interpreted as pattern letters representing the components of a date or time string. Text can be quoted using single quotes (') to avoid interpretation. "''" represents a single quote. All other characters are not interpreted; they're simply copied into the output string during formatting or matched against the input string during parsing.
270	270
271		-Due to the fact that dates may differ per locale, an optional property, defining the locale of the pattern, is provided. This would assist processing of source dates, according to the given locale{{footnote}}Unidimensional datasets are those with a single 'indicator' or 'series code' dimension.{{/footnote}}. An indicative list of examples is presented in the following table:
	262	+Due to the fact that dates may differ per locale, an optional property, defining the locale of the pattern, is provided. This would assist processing of source dates, according to the given locale^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^44^^>>path:#sdfootnote44sym||name="sdfootnote44anc"]](%%)^^. An indicative list of examples is presented in the following table:
272	272
273		-(% style="width:772.294px" %)
274		-|(% style="width:190px" %)English (en)|(% style="width:230px" %)Australia (AU)|(% style="width:348px" %)en-AU
275		-|(% style="width:190px" %)English (en)|(% style="width:230px" %)Canada (CA)|(% style="width:348px" %)en-CA
276		-|(% style="width:190px" %)English (en)|(% style="width:230px" %)United Kingdom (GB)|(% style="width:348px" %)en-GB
277		-|(% style="width:190px" %)English (en)|(% style="width:230px" %)United States (US)|(% style="width:348px" %)en-US
278		-|(% style="width:190px" %)Estonian (et)|(% style="width:230px" %)Estonia (EE)|(% style="width:348px" %)et-EE
279		-|(% style="width:190px" %)Finnish (fi)|(% style="width:230px" %)Finland (FI)|(% style="width:348px" %)fi-FI
280		-|(% style="width:190px" %)French (fr)|(% style="width:230px" %)Belgium (BE)|(% style="width:348px" %)fr-BE
281		-|(% style="width:190px" %)French (fr)|(% style="width:230px" %)Canada (CA)|(% style="width:348px" %)fr-CA
282		-|(% style="width:190px" %)French (fr)|(% style="width:230px" %)France (FR)|(% style="width:348px" %)fr-FR
283		-|(% style="width:190px" %)French (fr)|(% style="width:230px" %)Luxembourg (LU)|(% style="width:348px" %)fr-LU
284		-|(% style="width:190px" %)French (fr)|(% style="width:230px" %)Switzerland (CH)|(% style="width:348px" %)fr-CH
285		-|(% style="width:190px" %)German (de)|(% style="width:230px" %)Austria (AT)|(% style="width:348px" %)de-AT
286		-|(% style="width:190px" %)German (de)|(% style="width:230px" %)Germany (DE)|(% style="width:348px" %)de-DE
	264	+|English (en)|Australia (AU)|en-AU
	265	+|English (en)|Canada (CA)|en-CA
	266	+|English (en)|United Kingdom (GB)|en-GB
	267	+|English (en)|United States (US)|en-US
	268	+|Estonian (et)|Estonia (EE)|et-EE
	269	+|Finnish (fi)|Finland (FI)|fi-FI
	270	+|French (fr)|Belgium (BE)|fr-BE
	271	+|French (fr)|Canada (CA)|fr-CA
	272	+|French (fr)|France (FR)|fr-FR
	273	+|French (fr)|Luxembourg (LU)|fr-LU
	274	+|French (fr)|Switzerland (CH)|fr-CH
	275	+|German (de)|Austria (AT)|de-AT
	276	+|German (de)|Germany (DE)|de-DE
287	287
288		-(% style="width:773.294px" %)
289		-|(% style="width:190px" %)German (de)|(% style="width:234px" %)Luxembourg (LU)|(% style="width:345px" %)de-LU
290		-|(% style="width:190px" %)German (de)|(% style="width:234px" %)Switzerland (CH)|(% style="width:345px" %)de-CH
291		-|(% style="width:190px" %)Greek (el)|(% style="width:234px" %)Cyprus (CY)|(% style="width:345px" %)el-CY__([[*>>https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]])__
292		-|(% style="width:190px" %)Greek (el)|(% style="width:234px" %)Greece (GR)|(% style="width:345px" %)el-GR
293		-|(% style="width:190px" %)Hebrew (iw)|(% style="width:234px" %)Israel (IL)|(% style="width:345px" %)iw-IL
294		-|(% style="width:190px" %)Hindi (hi)|(% style="width:234px" %)India (IN)|(% style="width:345px" %)hi-IN
295		-|(% style="width:190px" %)Hungarian (hu)|(% style="width:234px" %)Hungary (HU)|(% style="width:345px" %)hu-HU
296		-|(% style="width:190px" %)Icelandic (is)|(% style="width:234px" %)Iceland (IS)|(% style="width:345px" %)is-IS
297		-|(% style="width:190px" %)Indonesian (in)|(% style="width:234px" %)Indonesia (ID)|(% style="width:345px" %)in-ID__([[*>>https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]])__
298		-|(% style="width:190px" %)Irish (ga)|(% style="width:234px" %)Ireland (IE)|(% style="width:345px" %)ga-IE__([[*>>https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]])__
299		-|(% style="width:190px" %)Italian (it)|(% style="width:234px" %)Italy (IT)|(% style="width:345px" %)it-IT
	278	+[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_59eee18f.gif||alt="Shape8" height="1" width="192"]]
300	300
	280	+|German (de)|Luxembourg (LU)|de-LU
	281	+|German (de)|Switzerland (CH)|de-CH
	282	+|Greek (el)|Cyprus (CY)|el-CY[[__(*)__>>url:https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]][[url:https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]]
	283	+|Greek (el)|Greece (GR)|el-GR
	284	+|Hebrew (iw)|Israel (IL)|iw-IL
	285	+|Hindi (hi)|India (IN)|hi-IN
	286	+|Hungarian (hu)|Hungary (HU)|hu-HU
	287	+|Icelandic (is)|Iceland (IS)|is-IS
	288	+|Indonesian (in)|Indonesia (ID)|in-ID[[__(*)__>>url:https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]][[url:https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]]
	289	+|Irish (ga)|Ireland (IE)|ga-IE[[__(*)__>>url:https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]][[url:https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html#cldrlocale]]
	290	+|Italian (it)|Italy (IT)|it-IT
	291	+
301	301	Examples
302	302
303	303	22/06/1981 would be described as dd/MM/YYYY, with locale en-GB
	295	+
304	304	2008-mars-12 would be described as YYYY-MMM-DD, with locale fr-FR
	297	+
305	305	22 July 1981 would be described as dd MMMM YYYY, with locale en-US
	299	+
306	306	22 Jul 1981 would be described as dd MMM YYYY
	301	+
307	307	2010 D62 would be described as YYYYDnn (day 62 of the year 2010)
308	308
309	309	The following pattern letters are defined (all other characters from 'A' to 'Z' and from 'a' to 'z' are reserved):
310	310
311		-(% style="width:896.294px" %)
312		-|(% style="width:133px" %)**Letter**|(% style="width:414px" %)**Date or Time Component**|(% style="width:157px" %)**Presentation**|(% style="width:172px" %)**Examples**
313		-|(% style="width:133px" %)G|(% style="width:414px" %)Era designator|(% style="width:157px" %)Text|(% style="width:172px" %)AD
314		-|(% style="width:133px" %)yy|(% style="width:414px" %)Year short (upper case is Year of Week{{footnote}}yyyy represents the calendar year while YYYY represents the year of the week, which is only relevant for 53 week years{{/footnote}})|(% style="width:157px" %)Year|(% style="width:172px" %)96
315		-|(% style="width:133px" %)yyyy|(% style="width:414px" %)Year Full (upper case is Year of Week)|(% style="width:157px" %)Year|(% style="width:172px" %)1996
316		-|(% style="width:133px" %)MM|(% style="width:414px" %)Month number in year starting with 1|(% style="width:157px" %)Month|(% style="width:172px" %)07
317		-|(% style="width:133px" %)MMM|(% style="width:414px" %)Month name short|(% style="width:157px" %)Month|(% style="width:172px" %)Jul
318		-|(% style="width:133px" %)MMMM|(% style="width:414px" %)Month name full|(% style="width:157px" %)Month|(% style="width:172px" %)July
319		-|(% style="width:133px" %)ww|(% style="width:414px" %)Week in year|(% style="width:157px" %)Number|(% style="width:172px" %)27
320		-|(% style="width:133px" %)W|(% style="width:414px" %)Week in month|(% style="width:157px" %)Number|(% style="width:172px" %)2
321		-|(% style="width:133px" %)DD|(% style="width:414px" %)Day in year|(% style="width:157px" %)Number|(% style="width:172px" %)189
322		-|(% style="width:133px" %)dd|(% style="width:414px" %)Day in month|(% style="width:157px" %)Number|(% style="width:172px" %)10
323		-|(% style="width:133px" %)F|(% style="width:414px" %)Day of week in month|(% style="width:157px" %)Number|(% style="width:172px" %)2
324		-|(% style="width:133px" %)E|(% style="width:414px" %)Day name in week|(% style="width:157px" %)Text|(% style="width:172px" %)Tuesday; Tue
325		-|(% style="width:132px" %)U|(% style="width:414px" %)Day number of week (1 = Monday, ..., 7 = Sunday)|(% style="width:157px" %)Number|(% style="width:217px" %)1
326		-|(% style="width:132px" %)HH|(% style="width:414px" %)Hour in day (0-23)|(% style="width:157px" %)Number|(% style="width:217px" %)0
327		-|(% style="width:132px" %)kk|(% style="width:414px" %)Hour in day (1-24)|(% style="width:157px" %)Number|(% style="width:217px" %)24
328		-|(% style="width:132px" %)KK|(% style="width:414px" %)Hour in am/pm (0-11)|(% style="width:157px" %)Number|(% style="width:217px" %)0
329		-|(% style="width:132px" %)hh|(% style="width:414px" %)Hour in am/pm (1-12)|(% style="width:157px" %)Number|(% style="width:217px" %)12
330		-|(% style="width:132px" %)mm|(% style="width:414px" %)Minute in hour|(% style="width:157px" %)Number|(% style="width:217px" %)30
331		-|(% style="width:132px" %)ss|(% style="width:414px" %)Second in minute|(% style="width:157px" %)Number|(% style="width:217px" %)55
332		-|(% style="width:132px" %)S|(% style="width:414px" %)Millisecond|(% style="width:157px" %)Number|(% style="width:217px" %)978
333		-|(% style="width:132px" %)n|(% style="width:414px" %)Number of periods, used after a SDMX Frequency Identifier such as M, Q, D (month, quarter, day)|(% style="width:157px" %)Number|(% style="width:217px" %)12
	306	+|Letter|Date or Time Component|Presentation|Examples
	307	+|G|Era designator|[[Text>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#text]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#text]]|AD
	308	+|yy|Year short (upper case is Year of Week^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^45^^>>path:#sdfootnote45sym||name="sdfootnote45anc"]](%%)^^)|[[Year>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#year]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#year]]|96
	309	+|yyyy|Year Full (upper case is Year of Week)|Year|1996
	310	+|MM|Month number in year starting with 1|Month|07
	311	+|MMM|Month name short|Month|Jul
	312	+|MMMM|Month name full|Month|July
	313	+|ww|Week in year|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|27
	314	+|W|Week in month|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|2
	315	+|DD|Day in year|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|189
	316	+|dd|Day in month|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|10
	317	+|F|Day of week in month|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|2
	318	+|E|Day name in week|[[Text>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#text]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#text]]|Tuesday; Tue
334	334
	320	+[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_59eee18f.gif||alt="Shape9" height="1" width="192"]]
	321	+
	322	+|U|Day number of week (1 = Monday, ..., 7 = Sunday)|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|1
	323	+|HH|Hour in day (0-23)|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|0
	324	+|kk|Hour in day (1-24)|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|24
	325	+|KK|Hour in am/pm (0-11)|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|0
	326	+|hh|Hour in am/pm (1-12)|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|12
	327	+|mm|Minute in hour|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|30
	328	+|ss|Second in minute|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|55
	329	+|S|Millisecond|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|978
	330	+|n|Number of periods, used after a SDMX Frequency Identifier such as M, Q, D (month, quarter, day)|[[Number>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#number]]|12
	331	+
335	335	The model is illustrated below:
336	336
337	337	[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_295af259.jpg||height="265" width="477"]]
...	...	@@ -352,16 +352,17 @@
352	352	* microsecond
353	353	* nanosecond
354	354
355		-(% style="width:573.294px" %)
356		-|(% style="width:276px" %)**Numerical datetime systems**|(% style="width:117px" %)**Base**|(% style="width:177px" %)**Period**
357		-|(% style="width:276px" %)(((
	352	+|Numerical datetime systems|Base|Period
	353	+|(((
358	358	Epoch Time (UNIX)
	355	+
359	359	Milliseconds since 01 Jan 1970
360		-)))|(% style="width:117px" %)1970|(% style="width:177px" %)millisecond
361		-|(% style="width:276px" %)(((
	357	+)))|1970|millisecond
	358	+|(((
362	362	Windows System Time
	360	+
363	363	Milliseconds since 01 Jan 1601
364		-)))|(% style="width:117px" %)1601|(% style="width:177px" %)millisecond
	362	+)))|1601|millisecond
365	365
366	366	The example above illustrates numerical based datetime mapping rules for two commonly used time standards.
367	367
...	...	@@ -383,34 +383,41 @@
383	383
384	384	The main use case is setting the value of Observation Attributes in the target dataset.
385	385
386		-(% style="width:786.294px" %)
387		-|(% style="width:92px" %)**Rule**|(% style="width:377px" %)**Source**|(% style="width:315px" %)**Target**
388		-|(% style="width:92px" %)1|(% style="width:377px" %)(((
	384	+|Rule|Source|Target
	385	+|1|(((
389	389	If
	387	+
390	390	INDICATOR=XULADS; and TIME_PERIOD=2007.
391		-)))|(% style="width:315px" %)(((
	389	+)))|(((
392	392	Set
	391	+
393	393	OBS_CONF=F
394	394	)))
395		-|(% style="width:92px" %)2|(% style="width:377px" %)(((
	394	+|2|(((
396	396	If
	396	+
397	397	INDICATOR=XULADS; and TIME_PERIOD=2008.
398		-)))|(% style="width:315px" %)(((
	398	+)))|(((
399	399	Set
	400	+
400	400	OBS_CONF=F
401	401	)))
402		-|(% style="width:92px" %)3|(% style="width:377px" %)(((
	403	+|3|(((
403	403	If
	405	+
404	404	INDICATOR=XULADS; and TIME_PERIOD=2009.
405		-)))|(% style="width:315px" %)(((
	407	+)))|(((
406	406	Set
	409	+
407	407	OBS_CONF=F
408	408	)))
409		-|(% style="width:92px" %)4|(% style="width:377px" %)(((
	412	+|4|(((
410	410	If
	414	+
411	411	INDICATOR=XULADS; and TIME_PERIOD=2010.
412		-)))|(% style="width:315px" %)(((
	416	+)))|(((
413	413	Set
	418	+
414	414	OBS_CONF=**C**
415	415	)))
416	416
...	...	@@ -424,22 +424,27 @@
424	424
425	425	By specifying validity periods, the example from Section 13.8 can be re-written using two rules as follows:
426	426
427		-(% style="width:808.294px" %)
428		-|(% style="width:93px" %)**Rule**|(% style="width:385px" %)**Source**|(% style="width:328px" %)**Target**
429		-|(% style="width:93px" %)1|(% style="width:385px" %)(((
	432	+|Rule|Source|Target
	433	+|1|(((
430	430	If
	435	+
431	431	INDICATOR=XULADS.
	437	+
432	432	Validity Period start period=2007 end period=2009
433		-)))|(% style="width:328px" %)(((
	439	+)))|(((
434	434	Set
	441	+
435	435	OBS_CONF=F
436	436	)))
437		-|(% style="width:93px" %)2|(% style="width:385px" %)(((
	444	+|2|(((
438	438	If
	446	+
439	439	INDICATOR=XULADS.
	448	+
440	440	Validity Period start period=2010
441		-)))|(% style="width:328px" %)(((
	450	+)))|(((
442	442	Set
	452	+
443	443	OBS_CONF=F** **
444	444	)))
445	445
...	...	@@ -451,12 +451,37 @@
451	451
452	452	=== 13.10.1 Many to one mapping (N-1) ===
453	453
454		-[[image:1747377208446-496.png]]
	464	+|Source|Map To
	465	+|(((
	466	+**FREQ**="A"
455	455
	468	+ADJUSTMENT="N"
	469	+
	470	+**REF_AREA**="PL"
	471	+
	472	+**COUNTERPART_AREA**="W0"
	473	+
	474	+REF_SECTOR="S1"
	475	+
	476	+COUNTERPART_SECTOR="S1" ACCOUNTING_ENTRY="B"
	477	+
	478	+STO="B5G"
	479	+)))|(((
	480	+FREQ="A"
	481	+
	482	+REF_AREA="PL"
	483	+
	484	+COUNTERPART_AREA="W0"
	485	+
	486	+INDICATOR="IND_ABC"
	487	+)))
	488	+
456	456	The bold Dimensions map from source to target verbatim. The mapping simply specifies:
457	457
458	458	FREQ => FREQ
	492	+
459	459	REF_AREA=> REF_AREA
	494	+
460	460	COUNTERPART_AREA=> COUNTERPART _AREA
461	461
462	462	No Representation Mapping is required. The source value simply copies across unmodified.
...	...	@@ -475,45 +475,49 @@
475	475
476	476	The following representation mapping can be used to explicitly map each age to an output code.
477	477
	513	+:
	514	+
478	478	(((
479		-(% style="width:669.294px" %)
480		-|(% style="width:218px" %)**Source Input Free Text**|(% style="width:448px" %)**Desired Output Code Id**
481		-|(% style="width:218px" %)0|(% style="width:448px" %)A
482		-|(% style="width:218px" %)1|(% style="width:448px" %)A
483		-|(% style="width:218px" %)2|(% style="width:448px" %)A
484		-|(% style="width:218px" %)3|(% style="width:448px" %)B
485		-|(% style="width:218px" %)4|(% style="width:448px" %)B
	516	+|Source Input Free Text|Desired Output Code Id
	517	+|0|A
	518	+|1|A
	519	+|2|A
	520	+|3|B
	521	+|4|B
486	486	)))
487	487
488		-If this mapping takes advantage of regular expressions it can be expressed in two rules:
	524	+If this mapping takes advantage of regular expressions it can be expressed in two 3464 rules:
489	489
490		-(((
491		-(% style="width:675.294px" %)
492		-|(% style="width:219px" %)(((
493		-**Regular Expression**
494		-)))|(% style="width:453px" %)**Desired Output**
495		-|(% style="width:219px" %)[0-2]|(% style="width:453px" %)A
496		-|(% style="width:219px" %)[3-4]|(% style="width:453px" %)B
	526	+[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_8c1afe2b.gif||alt="Shape10" height="1" width="302"]]
497	497
498		-(% style="color:inherit; font-family:inherit; font-size:max(21px, min(23px, 17.4444px + 0.462963vw))" %)13.10.3 Observation Attributes for Time Period
	528	+__Regular Expression __Desired Output
	529	+
	530	+:
	531	+
	532	+(((
	533	+|[0-2]|A
	534	+|[3-4]|B
499	499	)))
500	500
	537	+=== 13.10.3 Observation Attributes for Time Period ===
	538	+
501	501	This use case is where a specific observation for a specific time period has an attribute 3468 value.
502	502
	541	+:
	542	+
503	503	(((
504		-(% style="width:689.294px" %)
505		-|(% style="width:220px" %)**Input INDICATOR**|(% style="width:223px" %)**Input TIME_PERIOD**|(% style="width:243px" %)**Output OBS_CONF**
506		-|(% style="width:220px" %)XULADS|(% style="width:223px" %)2008|(% style="width:243px" %)C
507		-|(% style="width:220px" %)XULADS|(% style="width:223px" %)2009|(% style="width:243px" %)C
508		-|(% style="width:220px" %)XULADS|(% style="width:223px" %)2010|(% style="width:243px" %)C
	544	+|Input INDICATOR|Input TIME_PERIOD|Output OBS_CONF
	545	+|XULADS|2008|C
	546	+|XULADS|2009|C
	547	+|XULADS|2010|C
509	509	)))
510	510
511		-Or using a validity period on the Representation Mapping:
	550	+__Or using a validity period on the Representation Mapping__:
512	512
513		-(% style="width:693.294px" %)
514		-|(% style="width:221px" %)**Input INDICATOR**|(% style="width:222px" %)**Valid From/ Valid To**|(% style="width:246px" %)**Output OBS_CONF**
515		-|(% style="width:221px" %)XULADS|(% style="width:222px" %)2008/2010|(% style="width:246px" %)C
	552	+[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_6dbf7f.gif||alt="Shape11" height="36" width="555"]] Input INDICATOR Valid From/ Valid To Output OBS_CONF
516	516
	554	+XULADS 2008/2010 C
	555	+
517	517	=== 13.10.4 Time mapping ===
518	518
519	519	This use case is to create a time period from an input that does not respect SDMXTime Formats.
...	...	@@ -520,33 +520,44 @@
520	520
521	521	The Component Mapping from SYS_TIME to TIME_PERIOD specifies itself as a time mapping with the following details:
522	522
	562	+:
	563	+
523	523	(((
524		-(% style="width:763.294px" %)
525		-|(% style="width:163px" %)**Source Value**|(% style="width:219px" %)**Source Mapping**|(% style="width:198px" %)**Target Frequency**|(% style="width:180px" %)**Output**
526		-|(% style="width:163px" %)18/07/1981|(% style="width:219px" %)dd/MM/yyyy|(% style="width:198px" %)A|(% style="width:180px" %)1981
	565	+|Source Value|Source Mapping|Target Frequency|Output
	566	+|18/07/1981|dd/MM/yyyy|A|1981
527	527	)))
528	528
529		-When the target frequency is based on another target Dimension value, in this example the value of the FREQ Dimension in the target DSD.
	569	+When the target frequency is based on another target Dimension value, in this example __the value of the FREQ Dimension in the tar__get DSD.
530	530
	571	+[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_dbe68698.gif||alt="Shape12" height="1" width="273"]]
	572	+
	573	+:
	574	+::
	575	+
531	531	(((
532		-(% style="width:734.294px" %)
533		-|(% style="width:165px" %)**Source Value**|(% style="width:220px" %)**Source Mapping**|(% style="width:161px" %)**Target Frequency**|(% style="width:251px" %)**Output Dimension**
534		-|(% style="width:165px" %)18/07/1981|(% style="width:220px" %)dd/MM/yyyy|(% style="width:161px" %)FREQ|(% style="width:251px" %)1981-07-18 (when FREQ=D)
	577	+|Source Value|Source Mapping|Target Frequency Output Dimension
535	535
536		-When the source is a numerical format
	579	+|18/07/1981 dd/MM/yyyy|FREQ| |1981-07-18 (when FREQ=D)
	580	+|(% rowspan="2" %)(((
	581	+__When the source is a numerical form__at
537	537
538		-(% style="width:892.294px" %)
539		-|(% style="width:165px" %)**Source Value**|(% style="width:133px" %)**Start Period**|(% style="width:191px" %)**Interv**|(% style="width:264px" %)**Target FREQ**|(% style="width:167px" %)**Output**
540		-|(% style="width:165px" %)1589808220|(% style="width:133px" %)1970|(% style="width:191px" %)millisecond|(% style="width:264px" %)1981-07-18 (when FREQ=D)|(% style="width:167px" %)2020-05
	583	+Source Value Start Period Interv
	584	+)))| | |
	585	+|al|(((
	586	+Target
541	541
542		-When the source frequency is lower than the target frequency additional information 3485 can be provided for resolve to start of period, end of period, or mid period, as shown 3486 in the following example:
	588	+FREQ
	589	+)))|Output
	590	+|(% colspan="2" %)1589808220 1970 millisecond|M|2020-05
543	543	)))
544	544
	593	+When the source frequency is lower than the target frequency additional information 3485 can be provided for resolve to start of period, end of period, or mid period, as shown 3486 in the following example:
	594	+
545	545	Source Value Source Mapping Target Frequency Output
546	546
547	547	Dimension
548	548
549		- 1981 yyyy D – End of Period 1981-12-31
	599	+[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_4ec4bb31.gif||alt="Shape13" height="173" width="555"]] 1981 yyyy D – End of Period 1981-12-31
550	550
551	551	When the start of year is April 1^^st^^ the Structure Map has YearStart=04-01:
552	552

1747377208446-496.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.helena

Size

...	...	@@ -1,1 +1,0 @@
1		-28.0 KB

Content