ValueMapping¶
Fully qualified class name: DDICDIModels::DDICDILibrary::Classes::FormatDescription::ValueMapping
Definition¶
Physical characteristics for the value of an instance variable stored in a data point as part of a physical segment layout.
Examples¶
A variable “age” might be represented in a file as a string with a maximum length of 5 characters and a number pattern of ##0.0
Explanatory notes¶
An instance variable has details of value domain and data type, but will not have the final details of how a value is physically represented in a data file. A variable for height, for example, may be represented as a real number, but may be represented as a string in multiple ways. The decimal separator might be, for example a period or a comma. The string representing the value of a payment might be preceded by a currency symbol. The same numeric value might be written as “1,234,567” or “1.234567”. A missing value might be written as “.”, “NA”, “.R” or as “R”. The value mapping describes how the value of an instance variable is physically expressed. The properties of the value mapping as intended to be compatible with the W3C Metadata Vocabulary for Tabular Data (https://www.w3.org/TR/tabular-metadata/) as well as common programming languages and statistical packages. The ‘format’ property, for example, can draw from an external controlled vocabulary such as the set of formats for Stata, SPSS, or SAS.
Diagram
Attributes
Name |
Inherited from |
Description |
Data Type |
Multiplicity |
Default value |
---|---|---|---|---|---|
decimalPositions |
- own class - |
The number of decimal positions expressed as an integer. Used when the decimal position is implied (no decimal separator is present) See DDI 3.2 ManagedNumericRepresentation_decimalPositions |
Integer |
0..1 |
|
defaultDecimalSeparator |
- own class - |
Default value is “.” (period). The character separating the integer part from the fractional part of a decimal or real number. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) 6.4.2: “decimalChar: A string whose value is used to represent a decimal point within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified.” |
String |
0..1 |
. |
defaultDigitGroupSeparator |
- own class - |
Default value is null. A character separating groups of digits (for readability). In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 groupChar: “A string whose value is used to group digits within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified.” |
String |
0..1 |
|
defaultValue |
- own class - |
A default string indicating the value to substitute for an empty string. From https://www.w3.org/TR/tabular-metadata/ Inherited 5.7 “default - An atomic property holding a single string that is used to create a default value for the cell in cases where the original string value is an empty string. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the default property is the empty string, “”. The value of this property becomes the default annotation for the described column.” |
String |
1..1 |
|
format |
- own class - |
This defines the format of the physical representation of the value. From https://www.w3.org/TR/tabular-metadata/ 5.11.2 format: “An atomic property that contains either a single string or an object that defines the format of a value of this type, used when parsing a string value as described in Parsing Cells in [tabular-data-model]. The value of this property becomes the format annotation for the described datatype.” See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4.2 “Formats for numeric datatypes” this may include decimalChar, groupChar, pattern “By default, numeric values must be in the formats defined in [xmlschema11-2]. It is not uncommon for numbers within tabular data to be formatted for human consumption, which may involve using commas for decimal points, grouping digits in the number using commas, or adding percent signs to the number.” See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4. Formats for Booleans “ Boolean values may be represented in many ways aside from the standard 1 and 0 or true and false.” See https://www.w3.org/TR/tabular-metadata/ 6.4.4. Formats for dates and times “By default, dates and times are assumed to be in the format defined in [xmlschema11-2]. However dates and times are commonly represented in tabular data in other formats.” See https://www.w3.org/TR/tabular-metadata/ 6.4.5 Formats for durations “Durations MUST be formatted and interpreted as defined in [xmlschema11-2], using the [ISO8601] format -?PnYnMnDTnHnMnS. For example, the duration P1Y1D is used for a year and a day; the duration PT2H30M for 2 hours and 30 minutes.” See https://www.w3.org/TR/tabular-metadata/ 6.4.6 Formats for other types “If the datatype base is not numeric, boolean, a date/time type, or a duration type, the datatype format annotation provides a regular expression for the string values, with syntax and processing defined by [ECMASCRIPT]. If the supplied value is not a valid regular expression, implementations MUST issue a warning and proceed as if no format had been provided.” From DDI3.2 ManagedNumericRepresentation@format “A format for number expressed as a string.” From DDI3.2 ManagedDateTimeRepresentation_DateFieldFormat “Describes the format of the date field, in formats such as YYYY/MM or MM-DD-YY, etc. If this element is omitted, then the format is assumed to be the XML Schema format corresponding to the type attribute value.” |
0..1 |
||
identifier |
- own class - |
Identifier for objects requiring short- or long-lasting referencing and management. |
0..1 |
||
isRequired |
- own class - |
If the value of this property is True indicates that a value is required for the referenced instance variable. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) 5.7 Inherited Properties: “required: A boolean atomic property taking a single value which indicates whether the cell value can be null. See Parsing Cells in [tabular-data-model] for more details. The default is false, which means cells can have null values. The value of this property becomes the required annotation for the described column.” |
Boolean |
0..1 |
false |
length |
- own class - |
The length in characters of the physical representation of the value. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) 5.11.2 “length: A numeric atomic property that contains a single integer that is the exact length of the value. The value of this property becomes the length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details.” Corresponds to DDI2.5 var/location/width and DDI 3.2 PhysicalLocation/Width. |
Integer |
0..1 |
|
maximumLength |
- own class - |
The largest possible value of the length of the physical representation of the value. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) 5.11.2: “maxLength: A numeric atomic property that contains a single integer that is the maximum length of the value. The value of this property becomes the maximum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details.” |
Integer |
0..1 |
|
minimumLength |
- own class - |
The smallest possible value for the length of the physical representation of the value. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) 5.11.2: “minLength: An atomic property that contains a single integer that is the minimum length of the value. The value of this property becomes the minimum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details.” |
Integer |
0..1 |
|
nullSequence |
- own class - |
A string indicating a null value. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) 4.3: “null: the string or strings which cause the value of cells having string value matching any of these values to be null.” From the same source, Inherited 5.7: “null: An atomic property giving the string or strings used for null values within the data. If the string value of the cell is equal to any one of these values, the cell value is null. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the null property is the empty string ‘’. The value of this property becomes the null annotation for the described column.” |
String |
0..1 |
|
numberPattern |
- own class - |
A pattern description of the format of a numeric value. In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 pattern: “A number format pattern as defined in [UAX35] http://www.unicode.org/reports/tr35/tr35-31/tr35-numbers.html#Number_Format_Patterns. Implementations MUST recognise number format patterns containing the symbols 0, #, the specified decimalChar (or “.” if unspecified), the specified groupChar (or “,” if unspecified), E, +, % and ‰. Implementations MAY additionally recognise number format patterns containing other special pattern characters defined in [UAX35]. If the supplied value is not a string, or if it contains an invalid number format pattern or uses special pattern characters that the implementation does not recognise, implementations MUST issue a warning and proceed as if the property had not been specified. If the datatype format annotation is a single string, this is interpreted in the same way as if it were an object with a pattern property whose value is that string. If the groupChar is specified, but no pattern is supplied, when parsing the string value of a cell against this format specification, implementations MUST recognise and parse numbers that consist of: an optional + or - sign, … Implementations MAY also recognise numeric values that are in any of the standard-decimal, standard-percent or standard-scientific formats listed in the Unicode Common Locale Data Repository. …” |
String |
0..1 |
|
physicalDataType |
- own class - |
The base datatype of the physical representation. An integer InstanceVariable might, for example, be stored as a floating point number. From the W3C Recommendation “Metadata Vocabulary for Tabular Data” (https://www.w3.org/TR/tabular-metadata/) Inherited 5.7: “datatype: An atomic property that contains either a single string that is the main datatype of the values of the cell or a datatype description object. If the value of this property is a string, it MUST be the name of one of the built-in datatypes defined in section 5.11.1 Built-in Datatypes and this value is normalized to an object whose base property is the original string value. If it is an object then it describes a more specialized datatype. If a cell contains a sequence (i.e. the separator property is specified and not null) then this property specifies the datatype of each value within that sequence. See 5.11 Datatypes and Parsing Cells in [tabular-data-model] for more details. The normalized value of this property becomes the datatype annotation for the described column.” |
0..1 |
||
scale |
- own class - |
The scale of the number expressed as an integer. A multiplier to be used in combination with the value to determine the measurement. (E.g., a number expressed in 100’s with a value of 5 and a scale of 100 would be 500). |
Integer |
0..1 |
Associations
Direction |
Association |
Description |
Multiplicity of ValueMapping |
Package of Other Class |
Other Class |
Multiplicity of other class |
Aggregation Kind |
Inherited from |
---|---|---|---|---|---|---|---|---|
to |
InstanceVariable has ValueMapping |
0..1 |
0..* |
none |
- own class - |
|||
from |
ValueMapping formats DataPoint |
1..1 |
0..* |
none |
- own class - |
|||
to |
PhysicalSegmentLayout has ValueMapping |
0..* |
- own package - |
0..* |
none |
- own class - |
||
from |
ValueMapping uses PhysicalSegmentLocation |
Uses a physical segment location to describe where in the physical record a segment representing the data point is. This could be, for example, described as a start position and end position value for characters in a text record via the segment by text extension of physical segment location. |
0..* |
- own package - |
0..1 |
none |
- own class - |
|
to |
ValueMappingPosition indexes ValueMapping |
Assigns a position to a value mapping within a physical segment. |
1..1 |
- own package - |
0..* |
none |
- own class - |
|
to |
ValueMappingRelationship hasSource ValueMapping |
Specialization of source to variable mapping. |
0..* |
- own package - |
0..* |
none |
- own class - |
|
to |
ValueMappingRelationship hasTarget ValueMapping |
Specialization of target to variable mapping. Restricts cardinality. |
0..* |
- own package - |
0..* |
none |
- own class - |
Syntax representations / encodings
All syntax representations except the Canonical XMI are provided as reference points for specific implementations, or for use as defaults if sufficient in the form presented.
Fragment for the class ValueMapping (entire model as XMI)
1<packagedElement xmlns:StandardProfile="http://www.eclipse.org/uml2/5.0.0/UML/Profile/Standard"
2 xmlns:uml="http://www.eclipse.org/uml2/5.0.0/UML"
3 xmlns:xmi="http://www.omg.org/spec/XMI/20131001"
4 xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping"
5 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping"
6 xmi:type="uml:Class">
7 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedComment"
8 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedComment"
9 xmi:type="uml:Comment">
10 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping"/>
11 <body>Definition
12==========
13Physical characteristics for the value of an instance variable stored in a data point as part of a physical segment layout.
14
15Examples
16========
17A variable "age" might be represented in a file as a string with a maximum length of 5 characters and a number pattern of ##0.0
18
19Explanatory notes
20=================
21An instance variable has details of value domain and data type, but will not have the final details of how a value is physically represented in a data file. A variable for height, for example, may be represented as a real number, but may be represented as a string in multiple ways. The decimal separator might be, for example a period or a comma. The string representing the value of a payment might be preceded by a currency symbol. The same numeric value might be written as "1,234,567" or "1.234567". A missing value might be written as ".", "NA", ".R" or as "R". The value mapping describes how the value of an instance variable is physically expressed. The properties of the value mapping as intended to be compatible with the W3C Metadata Vocabulary for Tabular Data (https://www.w3.org/TR/tabular-metadata/) as well as common programming languages and statistical packages. The 'format' property, for example, can draw from an external controlled vocabulary such as the set of formats for Stata, SPSS, or SAS.</body>
22 </ownedComment>
23 <name>ValueMapping</name>
24 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-decimalPositions"
25 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-decimalPositions"
26 xmi:type="uml:Property">
27 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-decimalPositions-ownedComment"
28 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-decimalPositions-ownedComment"
29 xmi:type="uml:Comment">
30 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-decimalPositions"/>
31 <body>The number of decimal positions expressed as an integer. Used when the decimal position is implied (no decimal separator is present) See DDI 3.2 ManagedNumericRepresentation_decimalPositions</body>
32 </ownedComment>
33 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-decimalPositions-lowerValue"
34 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-decimalPositions-lowerValue"
35 xmi:type="uml:LiteralInteger"/>
36 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-decimalPositions-upperValue"
37 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-decimalPositions-upperValue"
38 xmi:type="uml:LiteralUnlimitedNatural">
39 <value>1</value>
40 </upperValue>
41 <name>decimalPositions</name>
42 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#Integer"
43 xmi:type="uml:PrimitiveType"/>
44 </ownedAttribute>
45 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDecimalSeparator"
46 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDecimalSeparator"
47 xmi:type="uml:Property">
48 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDecimalSeparator-ownedComment"
49 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDecimalSeparator-ownedComment"
50 xmi:type="uml:Comment">
51 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDecimalSeparator"/>
52 <body>Default value is "." (period). The character separating the integer part from the fractional part of a decimal or real number. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 6.4.2: "decimalChar: A string whose value is used to represent a decimal point within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified."</body>
53 </ownedComment>
54 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDecimalSeparator-lowerValue"
55 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDecimalSeparator-lowerValue"
56 xmi:type="uml:LiteralInteger"/>
57 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDecimalSeparator-upperValue"
58 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDecimalSeparator-upperValue"
59 xmi:type="uml:LiteralUnlimitedNatural">
60 <value>1</value>
61 </upperValue>
62 <name>defaultDecimalSeparator</name>
63 <defaultValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDecimalSeparator-defaultValue"
64 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDecimalSeparator-defaultValue"
65 xmi:type="uml:LiteralString">
66 <value>.</value>
67 </defaultValue>
68 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#String"
69 xmi:type="uml:PrimitiveType"/>
70 </ownedAttribute>
71 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDigitGroupSeparator"
72 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDigitGroupSeparator"
73 xmi:type="uml:Property">
74 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDigitGroupSeparator-ownedComment"
75 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDigitGroupSeparator-ownedComment"
76 xmi:type="uml:Comment">
77 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDigitGroupSeparator"/>
78 <body>Default value is null. A character separating groups of digits (for readability). In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 groupChar: "A string whose value is used to group digits within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified."</body>
79 </ownedComment>
80 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDigitGroupSeparator-lowerValue"
81 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDigitGroupSeparator-lowerValue"
82 xmi:type="uml:LiteralInteger"/>
83 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultDigitGroupSeparator-upperValue"
84 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultDigitGroupSeparator-upperValue"
85 xmi:type="uml:LiteralUnlimitedNatural">
86 <value>1</value>
87 </upperValue>
88 <name>defaultDigitGroupSeparator</name>
89 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#String"
90 xmi:type="uml:PrimitiveType"/>
91 </ownedAttribute>
92 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultValue"
93 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultValue"
94 xmi:type="uml:Property">
95 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultValue-ownedComment"
96 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultValue-ownedComment"
97 xmi:type="uml:Comment">
98 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultValue"/>
99 <body>A default string indicating the value to substitute for an empty string. From https://www.w3.org/TR/tabular-metadata/ Inherited 5.7 "default - An atomic property holding a single string that is used to create a default value for the cell in cases where the original string value is an empty string. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the default property is the empty string, "". The value of this property becomes the default annotation for the described column."</body>
100 </ownedComment>
101 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultValue-lowerValue"
102 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultValue-lowerValue"
103 xmi:type="uml:LiteralInteger">
104 <value>1</value>
105 </lowerValue>
106 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-defaultValue-upperValue"
107 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-defaultValue-upperValue"
108 xmi:type="uml:LiteralUnlimitedNatural">
109 <value>1</value>
110 </upperValue>
111 <name>defaultValue</name>
112 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#String"
113 xmi:type="uml:PrimitiveType"/>
114 </ownedAttribute>
115 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-format"
116 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-format"
117 xmi:type="uml:Property">
118 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-format-ownedComment"
119 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-format-ownedComment"
120 xmi:type="uml:Comment">
121 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-format"/>
122 <body>This defines the format of the physical representation of the value. From https://www.w3.org/TR/tabular-metadata/ 5.11.2 format: "An atomic property that contains either a single string or an object that defines the format of a value of this type, used when parsing a string value as described in Parsing Cells in [tabular-data-model]. The value of this property becomes the format annotation for the described datatype." See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4.2 "Formats for numeric datatypes" this may include decimalChar, groupChar, pattern "By default, numeric values must be in the formats defined in [xmlschema11-2]. It is not uncommon for numbers within tabular data to be formatted for human consumption, which may involve using commas for decimal points, grouping digits in the number using commas, or adding percent signs to the number." See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4. Formats for Booleans " Boolean values may be represented in many ways aside from the standard 1 and 0 or true and false." See https://www.w3.org/TR/tabular-metadata/ 6.4.4. Formats for dates and times "By default, dates and times are assumed to be in the format defined in [xmlschema11-2]. However dates and times are commonly represented in tabular data in other formats." See https://www.w3.org/TR/tabular-metadata/ 6.4.5 Formats for durations "Durations MUST be formatted and interpreted as defined in [xmlschema11-2], using the [ISO8601] format -?PnYnMnDTnHnMnS. For example, the duration P1Y1D is used for a year and a day; the duration PT2H30M for 2 hours and 30 minutes." See https://www.w3.org/TR/tabular-metadata/ 6.4.6 Formats for other types "If the datatype base is not numeric, boolean, a date/time type, or a duration type, the datatype format annotation provides a regular expression for the string values, with syntax and processing defined by [ECMASCRIPT]. If the supplied value is not a valid regular expression, implementations MUST issue a warning and proceed as if no format had been provided." From DDI3.2 ManagedNumericRepresentation@format "A format for number expressed as a string." From DDI3.2 ManagedDateTimeRepresentation_DateFieldFormat "Describes the format of the date field, in formats such as YYYY/MM or MM-DD-YY, etc. If this element is omitted, then the format is assumed to be the XML Schema format corresponding to the type attribute value."</body>
123 </ownedComment>
124 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-format-lowerValue"
125 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-format-lowerValue"
126 xmi:type="uml:LiteralInteger"/>
127 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-format-upperValue"
128 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-format-upperValue"
129 xmi:type="uml:LiteralUnlimitedNatural">
130 <value>1</value>
131 </upperValue>
132 <name>format</name>
133 <type xmi:idref="DDICDIModels-DDICDILibrary-DataTypes-StructuredDataTypes-ControlledVocabularyEntry"/>
134 </ownedAttribute>
135 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-identifier"
136 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-identifier"
137 xmi:type="uml:Property">
138 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-identifier-ownedComment"
139 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-identifier-ownedComment"
140 xmi:type="uml:Comment">
141 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-identifier"/>
142 <body>Identifier for objects requiring short- or long-lasting referencing and management.</body>
143 </ownedComment>
144 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-identifier-lowerValue"
145 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-identifier-lowerValue"
146 xmi:type="uml:LiteralInteger"/>
147 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-identifier-upperValue"
148 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-identifier-upperValue"
149 xmi:type="uml:LiteralUnlimitedNatural">
150 <value>1</value>
151 </upperValue>
152 <name>identifier</name>
153 <isID>true</isID>
154 <type xmi:idref="DDICDIModels-DDICDILibrary-DataTypes-StructuredDataTypes-Identifier"/>
155 </ownedAttribute>
156 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-isRequired"
157 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-isRequired"
158 xmi:type="uml:Property">
159 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-isRequired-ownedComment"
160 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-isRequired-ownedComment"
161 xmi:type="uml:Comment">
162 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-isRequired"/>
163 <body>If the value of this property is True indicates that a value is required for the referenced instance variable. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.7 Inherited Properties: "required: A boolean atomic property taking a single value which indicates whether the cell value can be null. See Parsing Cells in [tabular-data-model] for more details. The default is false, which means cells can have null values. The value of this property becomes the required annotation for the described column."</body>
164 </ownedComment>
165 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-isRequired-lowerValue"
166 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-isRequired-lowerValue"
167 xmi:type="uml:LiteralInteger"/>
168 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-isRequired-upperValue"
169 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-isRequired-upperValue"
170 xmi:type="uml:LiteralUnlimitedNatural">
171 <value>1</value>
172 </upperValue>
173 <name>isRequired</name>
174 <defaultValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-isRequired-defaultValue"
175 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-isRequired-defaultValue"
176 xmi:type="uml:LiteralBoolean">
177 <value>False</value>
178 </defaultValue>
179 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#Boolean"
180 xmi:type="uml:PrimitiveType"/>
181 </ownedAttribute>
182 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-length"
183 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-length"
184 xmi:type="uml:Property">
185 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-length-ownedComment"
186 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-length-ownedComment"
187 xmi:type="uml:Comment">
188 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-length"/>
189 <body>The length in characters of the physical representation of the value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.11.2 "length: A numeric atomic property that contains a single integer that is the exact length of the value. The value of this property becomes the length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details." Corresponds to DDI2.5 var/location/width and DDI 3.2 PhysicalLocation/Width.</body>
190 </ownedComment>
191 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-length-lowerValue"
192 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-length-lowerValue"
193 xmi:type="uml:LiteralInteger"/>
194 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-length-upperValue"
195 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-length-upperValue"
196 xmi:type="uml:LiteralUnlimitedNatural">
197 <value>1</value>
198 </upperValue>
199 <name>length</name>
200 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#Integer"
201 xmi:type="uml:PrimitiveType"/>
202 </ownedAttribute>
203 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-maximumLength"
204 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-maximumLength"
205 xmi:type="uml:Property">
206 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-maximumLength-ownedComment"
207 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-maximumLength-ownedComment"
208 xmi:type="uml:Comment">
209 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-maximumLength"/>
210 <body>The largest possible value of the length of the physical representation of the value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.11.2: "maxLength: A numeric atomic property that contains a single integer that is the maximum length of the value. The value of this property becomes the maximum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details."</body>
211 </ownedComment>
212 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-maximumLength-lowerValue"
213 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-maximumLength-lowerValue"
214 xmi:type="uml:LiteralInteger"/>
215 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-maximumLength-upperValue"
216 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-maximumLength-upperValue"
217 xmi:type="uml:LiteralUnlimitedNatural">
218 <value>1</value>
219 </upperValue>
220 <name>maximumLength</name>
221 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#Integer"
222 xmi:type="uml:PrimitiveType"/>
223 </ownedAttribute>
224 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-minimumLength"
225 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-minimumLength"
226 xmi:type="uml:Property">
227 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-minimumLength-ownedComment"
228 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-minimumLength-ownedComment"
229 xmi:type="uml:Comment">
230 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-minimumLength"/>
231 <body>The smallest possible value for the length of the physical representation of the value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.11.2: "minLength: An atomic property that contains a single integer that is the minimum length of the value. The value of this property becomes the minimum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details."</body>
232 </ownedComment>
233 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-minimumLength-lowerValue"
234 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-minimumLength-lowerValue"
235 xmi:type="uml:LiteralInteger"/>
236 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-minimumLength-upperValue"
237 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-minimumLength-upperValue"
238 xmi:type="uml:LiteralUnlimitedNatural">
239 <value>1</value>
240 </upperValue>
241 <name>minimumLength</name>
242 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#Integer"
243 xmi:type="uml:PrimitiveType"/>
244 </ownedAttribute>
245 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-nullSequence"
246 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-nullSequence"
247 xmi:type="uml:Property">
248 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-nullSequence-ownedComment"
249 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-nullSequence-ownedComment"
250 xmi:type="uml:Comment">
251 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-nullSequence"/>
252 <body>A string indicating a null value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 4.3: "null: the string or strings which cause the value of cells having string value matching any of these values to be null." From the same source, Inherited 5.7: "null: An atomic property giving the string or strings used for null values within the data. If the string value of the cell is equal to any one of these values, the cell value is null. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the null property is the empty string ''. The value of this property becomes the null annotation for the described column."</body>
253 </ownedComment>
254 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-nullSequence-lowerValue"
255 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-nullSequence-lowerValue"
256 xmi:type="uml:LiteralInteger"/>
257 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-nullSequence-upperValue"
258 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-nullSequence-upperValue"
259 xmi:type="uml:LiteralUnlimitedNatural">
260 <value>1</value>
261 </upperValue>
262 <name>nullSequence</name>
263 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#String"
264 xmi:type="uml:PrimitiveType"/>
265 </ownedAttribute>
266 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-numberPattern"
267 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-numberPattern"
268 xmi:type="uml:Property">
269 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-numberPattern-ownedComment"
270 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-numberPattern-ownedComment"
271 xmi:type="uml:Comment">
272 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-numberPattern"/>
273 <body>A pattern description of the format of a numeric value. In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 pattern: "A number format pattern as defined in [UAX35] http://www.unicode.org/reports/tr35/tr35-31/tr35-numbers.html#Number_Format_Patterns. Implementations MUST recognise number format patterns containing the symbols 0, #, the specified decimalChar (or "." if unspecified), the specified groupChar (or "," if unspecified), E, +, % and ‰. Implementations MAY additionally recognise number format patterns containing other special pattern characters defined in [UAX35]. If the supplied value is not a string, or if it contains an invalid number format pattern or uses special pattern characters that the implementation does not recognise, implementations MUST issue a warning and proceed as if the property had not been specified. If the datatype format annotation is a single string, this is interpreted in the same way as if it were an object with a pattern property whose value is that string. If the groupChar is specified, but no pattern is supplied, when parsing the string value of a cell against this format specification, implementations MUST recognise and parse numbers that consist of: an optional + or - sign, … Implementations MAY also recognise numeric values that are in any of the standard-decimal, standard-percent or standard-scientific formats listed in the Unicode Common Locale Data Repository. …"</body>
274 </ownedComment>
275 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-numberPattern-lowerValue"
276 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-numberPattern-lowerValue"
277 xmi:type="uml:LiteralInteger"/>
278 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-numberPattern-upperValue"
279 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-numberPattern-upperValue"
280 xmi:type="uml:LiteralUnlimitedNatural">
281 <value>1</value>
282 </upperValue>
283 <name>numberPattern</name>
284 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#String"
285 xmi:type="uml:PrimitiveType"/>
286 </ownedAttribute>
287 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedAttribute_1"
288 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedAttribute_1"
289 xmi:type="uml:Property">
290 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedAttribute_1-lowerValue"
291 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedAttribute_1-lowerValue"
292 xmi:type="uml:LiteralInteger"/>
293 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedAttribute_1-upperValue"
294 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedAttribute_1-upperValue"
295 xmi:type="uml:LiteralUnlimitedNatural">
296 <value>*</value>
297 </upperValue>
298 <association xmi:idref="DDICDIModels-DDICDILibrary-Classes-DataDescription-ValueMapping_formats_DataPoint"/>
299 <type xmi:idref="DDICDIModels-DDICDILibrary-Classes-DataDescription-DataPoint"/>
300 </ownedAttribute>
301 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedAttribute_2"
302 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedAttribute_2"
303 xmi:type="uml:Property">
304 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedAttribute_2-lowerValue"
305 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedAttribute_2-lowerValue"
306 xmi:type="uml:LiteralInteger"/>
307 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-ownedAttribute_2-upperValue"
308 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-ownedAttribute_2-upperValue"
309 xmi:type="uml:LiteralUnlimitedNatural">
310 <value>1</value>
311 </upperValue>
312 <association xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping_uses_PhysicalSegmentLocation"/>
313 <type xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-PhysicalSegmentLocation"/>
314 </ownedAttribute>
315 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-physicalDataType"
316 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-physicalDataType"
317 xmi:type="uml:Property">
318 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-physicalDataType-ownedComment"
319 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-physicalDataType-ownedComment"
320 xmi:type="uml:Comment">
321 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-physicalDataType"/>
322 <body>The base datatype of the physical representation. An integer InstanceVariable might, for example, be stored as a floating point number. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) Inherited 5.7: "datatype: An atomic property that contains either a single string that is the main datatype of the values of the cell or a datatype description object. If the value of this property is a string, it MUST be the name of one of the built-in datatypes defined in section 5.11.1 Built-in Datatypes and this value is normalized to an object whose base property is the original string value. If it is an object then it describes a more specialized datatype. If a cell contains a sequence (i.e. the separator property is specified and not null) then this property specifies the datatype of each value within that sequence. See 5.11 Datatypes and Parsing Cells in [tabular-data-model] for more details. The normalized value of this property becomes the datatype annotation for the described column."</body>
323 </ownedComment>
324 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-physicalDataType-lowerValue"
325 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-physicalDataType-lowerValue"
326 xmi:type="uml:LiteralInteger"/>
327 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-physicalDataType-upperValue"
328 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-physicalDataType-upperValue"
329 xmi:type="uml:LiteralUnlimitedNatural">
330 <value>1</value>
331 </upperValue>
332 <name>physicalDataType</name>
333 <type xmi:idref="DDICDIModels-DDICDILibrary-DataTypes-StructuredDataTypes-ControlledVocabularyEntry"/>
334 </ownedAttribute>
335 <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-scale"
336 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-scale"
337 xmi:type="uml:Property">
338 <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-scale-ownedComment"
339 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-scale-ownedComment"
340 xmi:type="uml:Comment">
341 <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-scale"/>
342 <body>The scale of the number expressed as an integer. A multiplier to be used in combination with the value to determine the measurement. (E.g., a number expressed in 100's with a value of 5 and a scale of 100 would be 500).</body>
343 </ownedComment>
344 <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-scale-lowerValue"
345 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-scale-lowerValue"
346 xmi:type="uml:LiteralInteger"/>
347 <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-FormatDescription-ValueMapping-scale-upperValue"
348 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#ValueMapping-scale-upperValue"
349 xmi:type="uml:LiteralUnlimitedNatural">
350 <value>1</value>
351 </upperValue>
352 <name>scale</name>
353 <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#Integer"
354 xmi:type="uml:PrimitiveType"/>
355 </ownedAttribute>
356</packagedElement>
Fragment for the class ValueMapping (entire XML Schema)
1<xs:element name="ValueMapping"
2 type="ValueMappingXsdType"
3 xml:id="ValueMapping">
4 <!-- based on the UML class DDICDIModels::DDICDILibrary::Classes::FormatDescription::ValueMapping -->
5 <xs:annotation>
6 <xs:documentation>Definition
7 ==========
8 Physical characteristics for the value of an instance variable stored in a data point as part of a physical segment layout.
9
10 Examples
11 ========
12 A variable "age" might be represented in a file as a string with a maximum length of 5 characters and a number pattern of ##0.0
13
14 Explanatory notes
15 =================
16 An instance variable has details of value domain and data type, but will not have the final details of how a value is physically represented in a data file. A variable for height, for example, may be represented as a real number, but may be represented as a string in multiple ways. The decimal separator might be, for example a period or a comma. The string representing the value of a payment might be preceded by a currency symbol. The same numeric value might be written as "1,234,567" or "1.234567". A missing value might be written as ".", "NA", ".R" or as "R". The value mapping describes how the value of an instance variable is physically expressed. The properties of the value mapping as intended to be compatible with the W3C Metadata Vocabulary for Tabular Data (https://www.w3.org/TR/tabular-metadata/) as well as common programming languages and statistical packages. The 'format' property, for example, can draw from an external controlled vocabulary such as the set of formats for Stata, SPSS, or SAS.</xs:documentation>
17 </xs:annotation>
18</xs:element>
19<xs:complexType name="ValueMappingXsdType"
20 xml:id="ValueMappingXsdType">
21 <xs:annotation>
22 <xs:documentation>Definition
23 ==========
24 Physical characteristics for the value of an instance variable stored in a data point as part of a physical segment layout.
25
26 Examples
27 ========
28 A variable "age" might be represented in a file as a string with a maximum length of 5 characters and a number pattern of ##0.0
29
30 Explanatory notes
31 =================
32 An instance variable has details of value domain and data type, but will not have the final details of how a value is physically represented in a data file. A variable for height, for example, may be represented as a real number, but may be represented as a string in multiple ways. The decimal separator might be, for example a period or a comma. The string representing the value of a payment might be preceded by a currency symbol. The same numeric value might be written as "1,234,567" or "1.234567". A missing value might be written as ".", "NA", ".R" or as "R". The value mapping describes how the value of an instance variable is physically expressed. The properties of the value mapping as intended to be compatible with the W3C Metadata Vocabulary for Tabular Data (https://www.w3.org/TR/tabular-metadata/) as well as common programming languages and statistical packages. The 'format' property, for example, can draw from an external controlled vocabulary such as the set of formats for Stata, SPSS, or SAS.</xs:documentation>
33 </xs:annotation>
34 <xs:sequence>
35 <xs:element name="decimalPositions"
36 type="xs:integer"
37 minOccurs="0"
38 maxOccurs="1"
39 xml:id="ValueMapping-decimalPositions">
40 <xs:annotation>
41 <xs:documentation>The number of decimal positions expressed as an integer. Used when the decimal position is implied (no decimal separator is present) See DDI 3.2 ManagedNumericRepresentation_decimalPositions</xs:documentation>
42 </xs:annotation>
43 </xs:element>
44 <xs:element name="defaultDecimalSeparator"
45 type="xs:string"
46 minOccurs="0"
47 maxOccurs="1"
48 xml:id="ValueMapping-defaultDecimalSeparator">
49 <xs:annotation>
50 <xs:documentation>Default value is "." (period). The character separating the integer part from the fractional part of a decimal or real number. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 6.4.2: "decimalChar: A string whose value is used to represent a decimal point within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified."</xs:documentation>
51 </xs:annotation>
52 </xs:element>
53 <xs:element name="defaultDigitGroupSeparator"
54 type="xs:string"
55 minOccurs="0"
56 maxOccurs="1"
57 xml:id="ValueMapping-defaultDigitGroupSeparator">
58 <xs:annotation>
59 <xs:documentation>Default value is null. A character separating groups of digits (for readability). In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 groupChar: "A string whose value is used to group digits within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified."</xs:documentation>
60 </xs:annotation>
61 </xs:element>
62 <xs:element name="defaultValue"
63 type="xs:string"
64 minOccurs="1"
65 maxOccurs="1"
66 xml:id="ValueMapping-defaultValue">
67 <xs:annotation>
68 <xs:documentation>A default string indicating the value to substitute for an empty string. From https://www.w3.org/TR/tabular-metadata/ Inherited 5.7 "default - An atomic property holding a single string that is used to create a default value for the cell in cases where the original string value is an empty string. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the default property is the empty string, "". The value of this property becomes the default annotation for the described column."</xs:documentation>
69 </xs:annotation>
70 </xs:element>
71 <xs:element name="format"
72 type="ControlledVocabularyEntryXsdType"
73 minOccurs="0"
74 maxOccurs="1"
75 xml:id="ValueMapping-format">
76 <xs:annotation>
77 <xs:documentation>This defines the format of the physical representation of the value. From https://www.w3.org/TR/tabular-metadata/ 5.11.2 format: "An atomic property that contains either a single string or an object that defines the format of a value of this type, used when parsing a string value as described in Parsing Cells in [tabular-data-model]. The value of this property becomes the format annotation for the described datatype." See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4.2 "Formats for numeric datatypes" this may include decimalChar, groupChar, pattern "By default, numeric values must be in the formats defined in [xmlschema11-2]. It is not uncommon for numbers within tabular data to be formatted for human consumption, which may involve using commas for decimal points, grouping digits in the number using commas, or adding percent signs to the number." See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4. Formats for Booleans " Boolean values may be represented in many ways aside from the standard 1 and 0 or true and false." See https://www.w3.org/TR/tabular-metadata/ 6.4.4. Formats for dates and times "By default, dates and times are assumed to be in the format defined in [xmlschema11-2]. However dates and times are commonly represented in tabular data in other formats." See https://www.w3.org/TR/tabular-metadata/ 6.4.5 Formats for durations "Durations MUST be formatted and interpreted as defined in [xmlschema11-2], using the [ISO8601] format -?PnYnMnDTnHnMnS. For example, the duration P1Y1D is used for a year and a day; the duration PT2H30M for 2 hours and 30 minutes." See https://www.w3.org/TR/tabular-metadata/ 6.4.6 Formats for other types "If the datatype base is not numeric, boolean, a date/time type, or a duration type, the datatype format annotation provides a regular expression for the string values, with syntax and processing defined by [ECMASCRIPT]. If the supplied value is not a valid regular expression, implementations MUST issue a warning and proceed as if no format had been provided." From DDI3.2 ManagedNumericRepresentation@format "A format for number expressed as a string." From DDI3.2 ManagedDateTimeRepresentation_DateFieldFormat "Describes the format of the date field, in formats such as YYYY/MM or MM-DD-YY, etc. If this element is omitted, then the format is assumed to be the XML Schema format corresponding to the type attribute value."</xs:documentation>
78 </xs:annotation>
79 </xs:element>
80 <xs:element name="identifier"
81 type="IdentifierXsdType"
82 minOccurs="0"
83 maxOccurs="1"
84 xml:id="ValueMapping-identifier">
85 <xs:annotation>
86 <xs:documentation>Identifier for objects requiring short- or long-lasting referencing and management.</xs:documentation>
87 </xs:annotation>
88 </xs:element>
89 <xs:element name="isRequired"
90 type="xs:boolean"
91 minOccurs="0"
92 maxOccurs="1"
93 xml:id="ValueMapping-isRequired">
94 <xs:annotation>
95 <xs:documentation>If the value of this property is True indicates that a value is required for the referenced instance variable. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.7 Inherited Properties: "required: A boolean atomic property taking a single value which indicates whether the cell value can be null. See Parsing Cells in [tabular-data-model] for more details. The default is false, which means cells can have null values. The value of this property becomes the required annotation for the described column."</xs:documentation>
96 </xs:annotation>
97 </xs:element>
98 <xs:element name="length"
99 type="xs:integer"
100 minOccurs="0"
101 maxOccurs="1"
102 xml:id="ValueMapping-length">
103 <xs:annotation>
104 <xs:documentation>The length in characters of the physical representation of the value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.11.2 "length: A numeric atomic property that contains a single integer that is the exact length of the value. The value of this property becomes the length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details." Corresponds to DDI2.5 var/location/width and DDI 3.2 PhysicalLocation/Width.</xs:documentation>
105 </xs:annotation>
106 </xs:element>
107 <xs:element name="maximumLength"
108 type="xs:integer"
109 minOccurs="0"
110 maxOccurs="1"
111 xml:id="ValueMapping-maximumLength">
112 <xs:annotation>
113 <xs:documentation>The largest possible value of the length of the physical representation of the value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.11.2: "maxLength: A numeric atomic property that contains a single integer that is the maximum length of the value. The value of this property becomes the maximum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details."</xs:documentation>
114 </xs:annotation>
115 </xs:element>
116 <xs:element name="minimumLength"
117 type="xs:integer"
118 minOccurs="0"
119 maxOccurs="1"
120 xml:id="ValueMapping-minimumLength">
121 <xs:annotation>
122 <xs:documentation>The smallest possible value for the length of the physical representation of the value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 5.11.2: "minLength: An atomic property that contains a single integer that is the minimum length of the value. The value of this property becomes the minimum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details."</xs:documentation>
123 </xs:annotation>
124 </xs:element>
125 <xs:element name="nullSequence"
126 type="xs:string"
127 minOccurs="0"
128 maxOccurs="1"
129 xml:id="ValueMapping-nullSequence">
130 <xs:annotation>
131 <xs:documentation>A string indicating a null value. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) 4.3: "null: the string or strings which cause the value of cells having string value matching any of these values to be null." From the same source, Inherited 5.7: "null: An atomic property giving the string or strings used for null values within the data. If the string value of the cell is equal to any one of these values, the cell value is null. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the null property is the empty string ''. The value of this property becomes the null annotation for the described column."</xs:documentation>
132 </xs:annotation>
133 </xs:element>
134 <xs:element name="numberPattern"
135 type="xs:string"
136 minOccurs="0"
137 maxOccurs="1"
138 xml:id="ValueMapping-numberPattern">
139 <xs:annotation>
140 <xs:documentation>A pattern description of the format of a numeric value. In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 pattern: "A number format pattern as defined in [UAX35] http://www.unicode.org/reports/tr35/tr35-31/tr35-numbers.html#Number_Format_Patterns. Implementations MUST recognise number format patterns containing the symbols 0, #, the specified decimalChar (or "." if unspecified), the specified groupChar (or "," if unspecified), E, +, % and ‰. Implementations MAY additionally recognise number format patterns containing other special pattern characters defined in [UAX35]. If the supplied value is not a string, or if it contains an invalid number format pattern or uses special pattern characters that the implementation does not recognise, implementations MUST issue a warning and proceed as if the property had not been specified. If the datatype format annotation is a single string, this is interpreted in the same way as if it were an object with a pattern property whose value is that string. If the groupChar is specified, but no pattern is supplied, when parsing the string value of a cell against this format specification, implementations MUST recognise and parse numbers that consist of: an optional + or - sign, … Implementations MAY also recognise numeric values that are in any of the standard-decimal, standard-percent or standard-scientific formats listed in the Unicode Common Locale Data Repository. …"</xs:documentation>
141 </xs:annotation>
142 </xs:element>
143 <xs:element name="physicalDataType"
144 type="ControlledVocabularyEntryXsdType"
145 minOccurs="0"
146 maxOccurs="1"
147 xml:id="ValueMapping-physicalDataType">
148 <xs:annotation>
149 <xs:documentation>The base datatype of the physical representation. An integer InstanceVariable might, for example, be stored as a floating point number. From the W3C Recommendation "Metadata Vocabulary for Tabular Data" (https://www.w3.org/TR/tabular-metadata/) Inherited 5.7: "datatype: An atomic property that contains either a single string that is the main datatype of the values of the cell or a datatype description object. If the value of this property is a string, it MUST be the name of one of the built-in datatypes defined in section 5.11.1 Built-in Datatypes and this value is normalized to an object whose base property is the original string value. If it is an object then it describes a more specialized datatype. If a cell contains a sequence (i.e. the separator property is specified and not null) then this property specifies the datatype of each value within that sequence. See 5.11 Datatypes and Parsing Cells in [tabular-data-model] for more details. The normalized value of this property becomes the datatype annotation for the described column."</xs:documentation>
150 </xs:annotation>
151 </xs:element>
152 <xs:element name="scale"
153 type="xs:integer"
154 minOccurs="0"
155 maxOccurs="1"
156 xml:id="ValueMapping-scale">
157 <xs:annotation>
158 <xs:documentation>The scale of the number expressed as an integer. A multiplier to be used in combination with the value to determine the measurement. (E.g., a number expressed in 100's with a value of 5 and a scale of 100 would be 500).</xs:documentation>
159 </xs:annotation>
160 </xs:element>
161 <xs:element name="ValueMapping_formats_DataPoint"
162 minOccurs="0"
163 maxOccurs="unbounded"
164 xml:id="ValueMapping_formats_DataPoint">
165 <xs:annotation>
166 <xs:documentation></xs:documentation>
167 </xs:annotation>
168 <xs:complexType>
169 <xs:complexContent>
170 <xs:restriction base="AssociationReferenceXsdType">
171 <xs:sequence>
172 <xs:element name="ddiReference"
173 type="InternationalRegistrationDataIdentifierXsdType"
174 minOccurs="0"
175 maxOccurs="1"
176 xml:id="ValueMapping_formats_DataPoint-ddiReference"/>
177 <xs:element name="validType"
178 minOccurs="1"
179 maxOccurs="1"
180 xml:id="ValueMapping_formats_DataPoint-validType">
181 <xs:simpleType>
182 <xs:restriction base="xs:NMTOKEN">
183 <xs:enumeration value="DataPoint"/>
184 </xs:restriction>
185 </xs:simpleType>
186 </xs:element>
187 </xs:sequence>
188 </xs:restriction>
189 </xs:complexContent>
190 </xs:complexType>
191 </xs:element>
192 <xs:element name="ValueMapping_uses_PhysicalSegmentLocation"
193 minOccurs="0"
194 maxOccurs="1"
195 xml:id="ValueMapping_uses_PhysicalSegmentLocation">
196 <xs:annotation>
197 <xs:documentation>Uses a physical segment location to describe where in the physical record a segment representing the data point is. This could be, for example, described as a start position and end position value for characters in a text record via the segment by text extension of physical segment location.</xs:documentation>
198 </xs:annotation>
199 <xs:complexType>
200 <xs:complexContent>
201 <xs:restriction base="AssociationReferenceXsdType">
202 <xs:sequence>
203 <xs:element name="ddiReference"
204 type="InternationalRegistrationDataIdentifierXsdType"
205 minOccurs="0"
206 maxOccurs="1"
207 xml:id="ValueMapping_uses_PhysicalSegmentLocation-ddiReference"/>
208 <xs:element name="validType"
209 minOccurs="0"
210 maxOccurs="unbounded"
211 xml:id="ValueMapping_uses_PhysicalSegmentLocation-validType">
212 <xs:simpleType>
213 <xs:restriction base="xs:NMTOKEN">
214 <xs:enumeration value="PhysicalSegmentLocation"/>
215 <xs:enumeration value="SegmentByText"/>
216 </xs:restriction>
217 </xs:simpleType>
218 </xs:element>
219 </xs:sequence>
220 </xs:restriction>
221 </xs:complexContent>
222 </xs:complexType>
223 </xs:element>
224 </xs:sequence>
225</xs:complexType>
Fragment for the class ValueMapping (main ontology)
1# class ValueMapping
2# based on the UML class DDICDIModels::DDICDILibrary::Classes::FormatDescription::ValueMapping
3cdi:ValueMapping
4 a rdfs:Class, owl:Class, ucmis:Class;
5 rdfs:label "ValueMapping";
6 rdfs:comment "Definition \n==========\nPhysical characteristics for the value of an instance variable stored in a data point as part of a physical segment layout.\n\nExamples \n========\nA variable \"age\" might be represented in a file as a string with a maximum length of 5 characters and a number pattern of ##0.0 \n\nExplanatory notes \n=================\nAn instance variable has details of value domain and data type, but will not have the final details of how a value is physically represented in a data file. A variable for height, for example, may be represented as a real number, but may be represented as a string in multiple ways. The decimal separator might be, for example a period or a comma. The string representing the value of a payment might be preceded by a currency symbol. The same numeric value might be written as \"1,234,567\" or \"1.234567\". A missing value might be written as \".\", \"NA\", \".R\" or as \"R\". The value mapping describes how the value of an instance variable is physically expressed. The properties of the value mapping as intended to be compatible with the W3C Metadata Vocabulary for Tabular Data (https://www.w3.org/TR/tabular-metadata/) as well as common programming languages and statistical packages. The 'format' property, for example, can draw from an external controlled vocabulary such as the set of formats for Stata, SPSS, or SAS."@en;
7
8.
9
10cdi:ValueMapping-decimalPositions
11 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
12 rdfs:label "decimalPositions";
13 rdfs:comment "The number of decimal positions expressed as an integer. Used when the decimal position is implied (no decimal separator is present) See DDI 3.2 ManagedNumericRepresentation_decimalPositions"@en;
14 rdfs:domain cdi:ValueMapping;
15 rdfs:range xsd:integer;
16.
17
18cdi:ValueMapping-defaultDecimalSeparator
19 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
20 rdfs:label "defaultDecimalSeparator";
21 rdfs:comment "Default value is \".\" (period). The character separating the integer part from the fractional part of a decimal or real number. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) 6.4.2: \"decimalChar: A string whose value is used to represent a decimal point within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified.\""@en;
22 rdfs:domain cdi:ValueMapping;
23 rdfs:range xsd:string;
24.
25
26cdi:ValueMapping-defaultDigitGroupSeparator
27 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
28 rdfs:label "defaultDigitGroupSeparator";
29 rdfs:comment "Default value is null. A character separating groups of digits (for readability). In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 groupChar: \"A string whose value is used to group digits within the number. If the supplied value is not a string, implementations MUST issue a warning and proceed as if the property had not been specified.\""@en;
30 rdfs:domain cdi:ValueMapping;
31 rdfs:range xsd:string;
32.
33
34cdi:ValueMapping-defaultValue
35 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
36 rdfs:label "defaultValue";
37 rdfs:comment "A default string indicating the value to substitute for an empty string. From https://www.w3.org/TR/tabular-metadata/ Inherited 5.7 \"default - An atomic property holding a single string that is used to create a default value for the cell in cases where the original string value is an empty string. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the default property is the empty string, \"\". The value of this property becomes the default annotation for the described column.\""@en;
38 rdfs:domain cdi:ValueMapping;
39 rdfs:range xsd:string;
40.
41
42cdi:ValueMapping-format
43 a rdf:Property, owl:ObjectProperty, ucmis:Attribute;
44 rdfs:label "format";
45 rdfs:comment "This defines the format of the physical representation of the value. From https://www.w3.org/TR/tabular-metadata/ 5.11.2 format: \"An atomic property that contains either a single string or an object that defines the format of a value of this type, used when parsing a string value as described in Parsing Cells in [tabular-data-model]. The value of this property becomes the format annotation for the described datatype.\" See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4.2 \"Formats for numeric datatypes\" this may include decimalChar, groupChar, pattern \"By default, numeric values must be in the formats defined in [xmlschema11-2]. It is not uncommon for numbers within tabular data to be formatted for human consumption, which may involve using commas for decimal points, grouping digits in the number using commas, or adding percent signs to the number.\" See https://www.w3.org/TR/tabular-metadata/ Tabular 6.4. Formats for Booleans \" Boolean values may be represented in many ways aside from the standard 1 and 0 or true and false.\" See https://www.w3.org/TR/tabular-metadata/ 6.4.4. Formats for dates and times \"By default, dates and times are assumed to be in the format defined in [xmlschema11-2]. However dates and times are commonly represented in tabular data in other formats.\" See https://www.w3.org/TR/tabular-metadata/ 6.4.5 Formats for durations \"Durations MUST be formatted and interpreted as defined in [xmlschema11-2], using the [ISO8601] format -?PnYnMnDTnHnMnS. For example, the duration P1Y1D is used for a year and a day; the duration PT2H30M for 2 hours and 30 minutes.\" See https://www.w3.org/TR/tabular-metadata/ 6.4.6 Formats for other types \"If the datatype base is not numeric, boolean, a date/time type, or a duration type, the datatype format annotation provides a regular expression for the string values, with syntax and processing defined by [ECMASCRIPT]. If the supplied value is not a valid regular expression, implementations MUST issue a warning and proceed as if no format had been provided.\" From DDI3.2 ManagedNumericRepresentation@format \"A format for number expressed as a string.\" From DDI3.2 ManagedDateTimeRepresentation_DateFieldFormat \"Describes the format of the date field, in formats such as YYYY/MM or MM-DD-YY, etc. If this element is omitted, then the format is assumed to be the XML Schema format corresponding to the type attribute value.\""@en;
46 rdfs:domain cdi:ValueMapping;
47 rdfs:range cdi:ControlledVocabularyEntry;
48.
49
50cdi:ValueMapping-identifier
51 a rdf:Property, owl:ObjectProperty, ucmis:Attribute;
52 rdfs:label "identifier";
53 rdfs:comment "Identifier for objects requiring short- or long-lasting referencing and management."@en;
54 rdfs:domain cdi:ValueMapping;
55 rdfs:range cdi:Identifier;
56.
57
58cdi:ValueMapping-isRequired
59 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
60 rdfs:label "isRequired";
61 rdfs:comment "If the value of this property is True indicates that a value is required for the referenced instance variable. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) 5.7 Inherited Properties: \"required: A boolean atomic property taking a single value which indicates whether the cell value can be null. See Parsing Cells in [tabular-data-model] for more details. The default is false, which means cells can have null values. The value of this property becomes the required annotation for the described column.\""@en;
62 rdfs:domain cdi:ValueMapping;
63 rdfs:range xsd:boolean;
64.
65
66cdi:ValueMapping-length
67 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
68 rdfs:label "length";
69 rdfs:comment "The length in characters of the physical representation of the value. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) 5.11.2 \"length: A numeric atomic property that contains a single integer that is the exact length of the value. The value of this property becomes the length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details.\" Corresponds to DDI2.5 var/location/width and DDI 3.2 PhysicalLocation/Width."@en;
70 rdfs:domain cdi:ValueMapping;
71 rdfs:range xsd:integer;
72.
73
74cdi:ValueMapping-maximumLength
75 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
76 rdfs:label "maximumLength";
77 rdfs:comment "The largest possible value of the length of the physical representation of the value. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) 5.11.2: \"maxLength: A numeric atomic property that contains a single integer that is the maximum length of the value. The value of this property becomes the maximum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details.\""@en;
78 rdfs:domain cdi:ValueMapping;
79 rdfs:range xsd:integer;
80.
81
82cdi:ValueMapping-minimumLength
83 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
84 rdfs:label "minimumLength";
85 rdfs:comment "The smallest possible value for the length of the physical representation of the value. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) 5.11.2: \"minLength: An atomic property that contains a single integer that is the minimum length of the value. The value of this property becomes the minimum length annotation for the described datatype. See Length Constraints in [tabular-data-model] for details.\""@en;
86 rdfs:domain cdi:ValueMapping;
87 rdfs:range xsd:integer;
88.
89
90cdi:ValueMapping-nullSequence
91 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
92 rdfs:label "nullSequence";
93 rdfs:comment "A string indicating a null value. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) 4.3: \"null: the string or strings which cause the value of cells having string value matching any of these values to be null.\" From the same source, Inherited 5.7: \"null: An atomic property giving the string or strings used for null values within the data. If the string value of the cell is equal to any one of these values, the cell value is null. See Parsing Cells in [tabular-data-model] for more details. If not specified, the default for the null property is the empty string ''. The value of this property becomes the null annotation for the described column.\""@en;
94 rdfs:domain cdi:ValueMapping;
95 rdfs:range xsd:string;
96.
97
98cdi:ValueMapping-numberPattern
99 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
100 rdfs:label "numberPattern";
101 rdfs:comment "A pattern description of the format of a numeric value. In W3C part of the datatype format From https://www.w3.org/TR/tabular-metadata/ tabular 6.4.2 pattern: \"A number format pattern as defined in [UAX35] http://www.unicode.org/reports/tr35/tr35-31/tr35-numbers.html#Number_Format_Patterns. Implementations MUST recognise number format patterns containing the symbols 0, #, the specified decimalChar (or \".\" if unspecified), the specified groupChar (or \",\" if unspecified), E, +, % and ‰. Implementations MAY additionally recognise number format patterns containing other special pattern characters defined in [UAX35]. If the supplied value is not a string, or if it contains an invalid number format pattern or uses special pattern characters that the implementation does not recognise, implementations MUST issue a warning and proceed as if the property had not been specified. If the datatype format annotation is a single string, this is interpreted in the same way as if it were an object with a pattern property whose value is that string. If the groupChar is specified, but no pattern is supplied, when parsing the string value of a cell against this format specification, implementations MUST recognise and parse numbers that consist of: an optional + or - sign, … Implementations MAY also recognise numeric values that are in any of the standard-decimal, standard-percent or standard-scientific formats listed in the Unicode Common Locale Data Repository. …\""@en;
102 rdfs:domain cdi:ValueMapping;
103 rdfs:range xsd:string;
104.
105
106cdi:ValueMapping-physicalDataType
107 a rdf:Property, owl:ObjectProperty, ucmis:Attribute;
108 rdfs:label "physicalDataType";
109 rdfs:comment "The base datatype of the physical representation. An integer InstanceVariable might, for example, be stored as a floating point number. From the W3C Recommendation \"Metadata Vocabulary for Tabular Data\" (https://www.w3.org/TR/tabular-metadata/) Inherited 5.7: \"datatype: An atomic property that contains either a single string that is the main datatype of the values of the cell or a datatype description object. If the value of this property is a string, it MUST be the name of one of the built-in datatypes defined in section 5.11.1 Built-in Datatypes and this value is normalized to an object whose base property is the original string value. If it is an object then it describes a more specialized datatype. If a cell contains a sequence (i.e. the separator property is specified and not null) then this property specifies the datatype of each value within that sequence. See 5.11 Datatypes and Parsing Cells in [tabular-data-model] for more details. The normalized value of this property becomes the datatype annotation for the described column.\""@en;
110 rdfs:domain cdi:ValueMapping;
111 rdfs:range cdi:ControlledVocabularyEntry;
112.
113
114cdi:ValueMapping-scale
115 a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
116 rdfs:label "scale";
117 rdfs:comment "The scale of the number expressed as an integer. A multiplier to be used in combination with the value to determine the measurement. (E.g., a number expressed in 100's with a value of 5 and a scale of 100 would be 500)."@en;
118 rdfs:domain cdi:ValueMapping;
119 rdfs:range xsd:integer;
120.
121
122
123cdi:ValueMapping_formats_DataPoint
124 a rdf:Property, owl:ObjectProperty, ucmis:Association;
125 # ASSOCIATION
126 rdfs:label "formats";
127 skos:altLabel "ValueMapping_formats_DataPoint";
128
129 rdfs:domain cdi:ValueMapping;
130 rdfs:range cdi:DataPoint;
131.
132
133cdi:ValueMapping_uses_PhysicalSegmentLocation
134 a rdf:Property, owl:ObjectProperty, ucmis:Association;
135 # ASSOCIATION
136 rdfs:label "uses";
137 skos:altLabel "ValueMapping_uses_PhysicalSegmentLocation";
138 rdfs:comment "Uses a physical segment location to describe where in the physical record a segment representing the data point is. This could be, for example, described as a start position and end position value for characters in a text record via the segment by text extension of physical segment location."@en;
139 rdfs:domain cdi:ValueMapping;
140 rdfs:range cdi:PhysicalSegmentLocation;
141.
Fragment for the class ValueMapping (main JSON-LD)
1{
2 "@context": [
3 {
4 "cdi": "http://ddialliance.org/Specification/DDI-CDI/1.0/RDF/",
5 "xsd": "http://www.w3.org/2001/XMLSchema#",
6 "ValueMapping": "cdi:ValueMapping",
7 "decimalPositions": {
8 "@id": "cdi:ValueMapping-decimalPositions",
9 "@type": "xsd:integer"
10 },
11 "defaultDecimalSeparator": {
12 "@id": "cdi:ValueMapping-defaultDecimalSeparator",
13 "@type": "xsd:string"
14 },
15 "defaultDigitGroupSeparator": {
16 "@id": "cdi:ValueMapping-defaultDigitGroupSeparator",
17 "@type": "xsd:string"
18 },
19 "defaultValue": {
20 "@id": "cdi:ValueMapping-defaultValue",
21 "@type": "xsd:string"
22 },
23 "format": {
24 "@id": "cdi:ValueMapping-format",
25 "@type": "@id",
26 "@context": "ControlledVocabularyEntry.jsonld"
27 },
28 "identifier": {
29 "@id": "cdi:ValueMapping-identifier",
30 "@type": "@id",
31 "@context": "Identifier.jsonld"
32 },
33 "isRequired": {
34 "@id": "cdi:ValueMapping-isRequired",
35 "@type": "xsd:boolean"
36 },
37 "length": {
38 "@id": "cdi:ValueMapping-length",
39 "@type": "xsd:integer"
40 },
41 "maximumLength": {
42 "@id": "cdi:ValueMapping-maximumLength",
43 "@type": "xsd:integer"
44 },
45 "minimumLength": {
46 "@id": "cdi:ValueMapping-minimumLength",
47 "@type": "xsd:integer"
48 },
49 "nullSequence": {
50 "@id": "cdi:ValueMapping-nullSequence",
51 "@type": "xsd:string"
52 },
53 "numberPattern": {
54 "@id": "cdi:ValueMapping-numberPattern",
55 "@type": "xsd:string"
56 },
57 "physicalDataType": {
58 "@id": "cdi:ValueMapping-physicalDataType",
59 "@type": "@id",
60 "@context": "ControlledVocabularyEntry.jsonld"
61 },
62 "scale": {
63 "@id": "cdi:ValueMapping-scale",
64 "@type": "xsd:integer"
65 },
66
67 "formats": {
68 "@id": "cdi:ValueMapping_formats_DataPoint",
69 "@type": "@id" },
70 "uses": {
71 "@id": "cdi:ValueMapping_uses_PhysicalSegmentLocation",
72 "@type": "@id" },
73 "has_OF_InstanceVariable": {
74 "@reverse": "cdi:InstanceVariable_has_ValueMapping",
75 "@type": "@id"
76 },
77 "has_OF_PhysicalSegmentLayout": {
78 "@reverse": "cdi:PhysicalSegmentLayout_has_ValueMapping",
79 "@type": "@id"
80 },
81 "indexes_OF_ValueMappingPosition": {
82 "@reverse": "cdi:ValueMappingPosition_indexes_ValueMapping",
83 "@type": "@id"
84 },
85 "hasSource_OF_ValueMappingRelationship": {
86 "@reverse": "cdi:ValueMappingRelationship_hasSource_ValueMapping",
87 "@type": "@id"
88 },
89 "hasTarget_OF_ValueMappingRelationship": {
90 "@reverse": "cdi:ValueMappingRelationship_hasTarget_ValueMapping",
91 "@type": "@id"
92 },
93 " comment ": "tag:json-should-support-trailing-commas"
94 }
95 ],
96 "generatedBy": "This code was generated by the Eclipse Acceleo project UCMIS M2T on 2024-03-16 23:40:10.",
97 "basedOn": "based on the UML data type DDICDIModels::DDICDILibrary::Classes::FormatDescription::ValueMapping"
98}