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

From version 3.6
edited by Helena
on 2025/07/02 16:00
Change comment: There is no comment for this version
To version 3.8
edited by Helena
on 2025/07/02 16:08
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -531,37 +531,34 @@
531 531  |(% style="width:267px" %)decimals^^1^^|(% style="width:729px" %)xs:fractionDigits
532 532  |(% style="width:267px" %)pattern|(% style="width:729px" %)xs:pattern
533 533  
534 -Any other facets are informational only and will not affect the determined type.
534 +Any other [[facets>>doc:sdmx:Glossary.Facet.WebHome]] are informational only and will not affect the determined type.
535 535  
536 536  === 3.3.7 Representation for Not Applicable Dimensions ===
537 537  
538 -Not applicable dimensions, i.e., when reported measures or attributes are not attached to those dimensions, take as value the tilde ‘’ character. This is required for datasets defined by a DSD that has the ‘evolving structure’ property set to true and that includes data from dataflows, which only use a subset of dimensions as defined by a dimension constraint. This is also required for data-related higher-level (i.e., attached to dataflow or partial list of Dimensions) reference metadata attributes that don’t have a fixed pre-defined attachment.
538 +Not applicable [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]], i.e., when reported [[measures>>doc:sdmx:Glossary.Measure.WebHome]] or [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] are not attached to those [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]], take as value the tilde ‘’ character. This is required for [[datasets>>doc:sdmx:Glossary.Data set.WebHome]] defined by a [[DSD>>doc:sdmx:Glossary.Data structure definition.WebHome]] that has the ‘evolving structure’ property set to true and that includes data from [[dataflows>>doc:sdmx:Glossary.Dataflow.WebHome]], which only use a subset of [[dimensions>>doc:sdmx:Glossary.Dimension.WebHome]] as defined by a [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] (% style="color:#e74c3c" %)constraint(%%). This is also required for data-related higher-(% style="color:#e74c3c" %)level(%%) (i.e., attached to [[dataflow>>doc:sdmx:Glossary.Dataflow.WebHome]] or partial list of [[Dimensions>>doc:sdmx:Glossary.Dimension.WebHome]]) [[reference metadata>>doc:sdmx:Glossary.Reference metadata.WebHome]] [[attributes>>doc:sdmx:Glossary.Attribute.WebHome]] that don’t have a fixed pre-defined attachment.
539 539  
540 -To support a specific type and allow for a not applicable dimension value, the structure-specific schema must union the type with the common:NotApplicableType, which enumerates the tilde ‘’ character. This is as shown in the following example:
540 +To support a specific type and allow for a not applicable [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]] value, the structure-specific schema must union the type with the common:NotApplicableType, which enumerates the tilde ‘’ character. This is as shown in the following example:
541 541  
542 -xml
543 - <xs:simpleType name="DecimalOrNotApplicableType">
544 - <xs:union memberTypes="xs:decimal common:NotApplicableType"/>
545 - </xs:simpleType>
542 +> <xs:simpleType name="DecimalOrNotApplicableType">
543 +> <xs:union memberTypes="xs:decimal common:NotApplicableType"/>
544 +> </xs:simpleType>
546 546  
547 547  For enumerated types, the generated structure-specific schema can include the special value in the enumeration or create a union between the enumerated type and the common:NotApplicableType.
548 548  
549 549  Option 1: Augmenting the enumeration with the special value
550 550  
551 -xml
552 - <xs:simpleType name="CL\_SUBINDICATOR\_OR\_NOT\_APPLICABLE">
553 - <xs:union memberTypes="CL\_SUBINDICATOR common:NotApplicableType"/>
554 - </xs:simpleType>
550 +> <xs:simpleType name="CL\_SUBINDICATOR\_OR\_NOT\_APPLICABLE">
551 +> <xs:union memberTypes="CL\_SUBINDICATOR common:NotApplicableType"/>
552 +> </xs:simpleType>
555 555  
556 556  Option 2: Extending the enumeration with the special value
557 557  
558 -xml
559 - <xs:simpleType name="CL\_ SUBINDICATOR ">
560 - <xs:restriction base="xs:string">
561 - <xs:enumeration value="A"/>
562 - <xs:enumeration value=""/>
563 - <xs:restriction>
564 - </xs:simpleType>
556 +> <xs:simpleType name="CL\_ SUBINDICATOR ">
557 +> <xs:restriction base="xs:string">
558 +> <xs:enumeration value="A"/>
559 +> <xs:enumeration value=""/>
560 +> <xs:restriction>
561 +> </xs:simpleType>
565 565  
566 566  For convenience the common schema provides the union types for the following data types.
567 567  
... ... @@ -598,38 +598,35 @@
598 598  
599 599  === 3.3.8 Representation for Intentionally Missing Measure and Attribute Values ===
600 600  
601 -For intentionally missing measure and attribute values, even if mandatory, the following special values can be used:
598 +For intentionally missing [[measure>>doc:sdmx:Glossary.Measure.WebHome]] and [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] values, even if mandatory, the following special values can be used:
602 602  
603 603  * NaN for all numeric types (float, double)
604 604  * #N/A for all other types
605 605  
606 -To support a specific type and allow for an intentionally missing measure or attribute value, the structure-specific schema must union the type with the common:MissingType, which enumerates the #N/A string. Note that XML natively already supports NaN for float and double values.
603 +To support a specific type and allow for an intentionally missing [[measure>>doc:sdmx:Glossary.Measure.WebHome]] or [[attribute>>doc:sdmx:Glossary.Attribute.WebHome]] value, the structure-specific schema must union the type with the common:MissingType, which enumerates the #N/A string. Note that XML natively already supports NaN for float and double values.
607 607  
608 608  This union is as shown in the following example:
609 609  
610 -xml
611 - <xs:simpleType name="DecimalOrMissingType">
612 - <xs:union memberTypes="xs:decimal common:MissingType"/>
613 - </xs:simpleType>
607 +> <xs:simpleType name="DecimalOrMissingType">
608 +> <xs:union memberTypes="xs:decimal common:MissingType"/>
609 +> </xs:simpleType>
614 614  
615 615  For enumerated types, the generated structure-specific schema can include the special value in the enumeration or create a union between the enumerated type and the common:MissingType.
616 616  
617 617  Option 1: Augmenting the enumeration with the special value
618 618  
619 -xml
620 - <xs:simpleType name="CL\_SUBINDICATOR\_OR\_NOT\_APPLICABLE">
621 - <xs:union memberTypes="CL\_SUBINDICATOR common:MissingType"/>
622 - </xs:simpleType>
615 + > <xs:simpleType name="CL\_SUBINDICATOR\_OR\_NOT\_APPLICABLE">
616 + > <xs:union memberTypes="CL\_SUBINDICATOR common:MissingType"/>
617 + > </xs:simpleType>
623 623  
624 624  Option 2: Extending the enumeration with the special value
625 625  
626 -xml
627 - <xs:simpleType name="CL\_ SUBINDICATOR ">
628 - <xs:restriction base="xs:string">
629 - <xs:enumeration value="A"/>
630 - <xs:enumeration value="#N/A"/>
631 - <xs:restriction>
632 - </xs:simpleType>
621 +> <xs:simpleType name="CL\_ SUBINDICATOR ">
622 +> <xs:restriction base="xs:string">
623 +> <xs:enumeration value="A"/>
624 +> <xs:enumeration value="#N/A"/>
625 +> <xs:restriction>
626 +> </xs:simpleType>
633 633  
634 634  For convenience the common schema provides the union types for the following data types.
635 635  
... ... @@ -666,24 +666,24 @@
666 666  
667 667  === 3.3.9 Representation with Complex Text Format ===
668 668  
669 -A representation which defines a complex text format will result in a complex type. The representation is complex if any of the following conditions are true:
663 +A [[representation>>doc:sdmx:Glossary.Representation.WebHome]] which defines a complex text format will result in a complex type. The [[representation>>doc:sdmx:Glossary.Representation.WebHome]] is complex if any of the following conditions are true:
670 670  
671 -* representation max occurs is greater than 1
665 +* [[representation>>doc:sdmx:Glossary.Representation.WebHome]] max occurs is greater than 1
672 672  * text format data type is XHMTL
673 673  * text format is multi-lingual
674 674  
675 675  The resulting complex type will be derived via restriction of the common:ValueType. In simple cases, there are pre-defined types that can be used:
676 676  
677 -* if the text format data type is XHTML, common:StructuredTextValueType can be used; note that this type cannot be further restricted – all other facets are ignored
678 -* if the text format is multi-lingual, common:TextValueType can be used; note that this type cannot be further restricted – all other facets are ignored
679 -* if the text format has no additional facets and the data type is:
680 - + Boolean, common:BooleanValueType can be used
681 - + String, common:StringValueType can be used
682 - + Integer, common:IntValueType can be used
683 - + Double, common:DoubleValueType can be used
684 - + ObservationalTimePeriod, common:ObservationalTimePeriodValueType can be used
671 +* if the text format data type is XHTML, common:StructuredTextValueType can be used; note that this type cannot be further restricted – all other [[facets>>doc:sdmx:Glossary.Facet.WebHome]] are ignored
672 +* if the text format is multi-lingual, common:TextValueType can be used; note that this type cannot be further restricted – all other [[facets>>doc:sdmx:Glossary.Facet.WebHome]] are ignored
673 +* if the text format has no additional [[facets>>doc:sdmx:Glossary.Facet.WebHome]] and the data type is:
674 +** Boolean, common:BooleanValueType can be used
675 +** String, common:StringValueType can be used
676 +** Integer, common:IntValueType can be used
677 +** Double, common:DoubleValueType can be used
678 +** ObservationalTimePeriod, common:ObservationalTimePeriodValueType can be used
685 685  
686 -If a pre-defined type cannot be used, one will have to be created. The complex type must define a simple content restriction of the common:ValueType. The restriction should define an anonymous simple type based on the text format data type and facets as described in the previous section.
680 +If a pre-defined type cannot be used, one will have to be created. The complex type must define a simple content restriction of the common:ValueType. The restriction should define an anonymous simple type based on the text format data type and [[facets>>doc:sdmx:Glossary.Facet.WebHome]] as described in the previous section.
687 687  
688 688  === 3.3.10 Type Names ===
689 689