Changes between Version 235 and Version 236 of CMDI 1.2/Specification

Timestamp:

10/04/16 09:49:06 (8 years ago)

Author:

Twan Goosen

Comment:

first half of CCSL section

CMDI 1.2/Specification

@@ -497 +497 @@
 draw.io source: https://drive.google.com/drive/folders/0B6mqjTCSImiVSjhRMmJWUUQ0Nm8?usp%3Dsharing
 }}}
+```TODO:``` caption
+----
 
 A CCSL document `MUST` contain a CCSL header and the actual CMD component description. Its root element `MUST` contain an XML attribute `@isProfile` to indicate if the document specifies a CMD profile or a CMD component and it `MUST` contain an XML attribute `@CMDVersion` specifying the CMDI version ("1.2"). The root element `MAY` also contain an XML attribute `@CMDOriginalVersion` specifying the CMDI version that was originally used to create the component.
@@ -536 +538 @@
 |||| `<Header>` || `xs:complexType` || || Descriptive information about the component. ||
 || || `<ID>` || `xs:anyURI` || 1 || ID of the component specification. ||
-|| || `<Name>` || `xs:string` || 1 || Name of the component. ||
+|| || `<Name>` || `xs:NCName` || 1 || Name of the component. ||
 || || `<Description>` || `xs:string` || 0 or 1 || Description of the component. ||
 || || `<Status>` || `xs:string` ("development", "production", "deprecated"; see below for a description of each of the possible values) || 1 || Status in lifecycle. ||
@@ -545 +547 @@
 ==== Status values ====
  * '''development'''
-   * The component specification is under construction, i.e. can undergo change at any moment, and therefore only to be used for testing purposes.
+   * The component specification is under construction, i.e., can undergo change at any moment, and therefore only to be used for testing purposes.
  * '''production'''
-   * The component specification is stable and will not be changed anymore, i.e. can be used for production-level metadata instances.
+   * The component specification is stable and will not be changed anymore, i.e., can be used for production-level metadata instances.
  * '''deprecated'''
    * Usage of this component specification is discouraged, and usage of a successor component specification, if present, is encouraged.
@@ -639 +641 @@
 || |||| `@ConceptLink` || `xs:anyURI` || 0 or 1 || Concept link. ||
 || |||| `@ValueScheme` || `xs:string` (name of an XML Schema datatype) || 0 or 1 || Allowed data type (default: `string`). ||
-|| |||| `@CardinalityMin` || `xs:nonNegativeInteger` or `unbounded` || 0 or 1 || Minimum number of times this element has to occur (default: 1). ||
-|| |||| `@CardinalityMax` || `xs:nonNegativeInteger` or `unbounded` || 0 or 1 || Maximum number of times this element may occur  (default: 1). ||
+|| |||| `@CardinalityMin` || `xs:nonNegativeInteger` or "unbounded" || 0 or 1 || Minimum number of times this element has to occur (default: 1). ||
+|| |||| `@CardinalityMax` || `xs:nonNegativeInteger` or "unbounded" || 0 or 1 || Maximum number of times this element may occur  (default: 1). ||
 || |||| `@Multilingual` || `xs:boolean` || 0 or 1 || Indication that the element can have values in multiple languages  (default: false). ||
 || |||| `<Documentation>` || `xs:string` || 0 to unbounded || Documentation about the purpose of the element. ||
@@ -646 +648 @@
 || |||| `<AttributeList>` || `xs:complexType` || 0 or 1 || Additional attributes specified by the component creator. ||
 || || || `<Attribute>` || `xs:complexType` || 1 to unbounded || An additional attribute. ||
-|| |||| `<ValueScheme>` || `xs:complexType` || 0 or 1 || Value restrictions based on a regular expression or a specified vocabulary. See [#valuerestrictions Value restrictions for elements and attributes] for details. ||
+|| |||| `<ValueScheme>` || `xs:complexType` || 0 or 1 || Value scheme based on a regular expression or a specified vocabulary. See [#valuerestrictions Value schemes for elements and attributes] for details. ||
 || |||| `<AutoValue>` || `xs:string` || 0 to unbounded || Derivation rules for the element's content. ||
 
 === Additional constraints ===
- * For the defined CMD element, each documentation  `MUST` have a unique `@xml:lang` value. And there `MUST` not be more than one documentation with an empty or missing `@xml:lang`.
+ * For the defined CMD element, each documentation  `MUST` have a unique `@xml:lang` value. And there `MUST NOT` be more than one documentation with an empty or missing `@xml:lang`.
  * A CMD element `SHOULD` have either a `@ValueScheme` or a `<ValueScheme>`.
  * The value of the minimum cardinality `MUST` be lower or equal to the value of the maximum cardinality.
@@ -701 +703 @@
 || |||| `<Documentation>` || `xs:string` || 0 to unbounded || Documentation about the purpose of the attribute. ||
 || || || `@xml:lang` || `xs:language` || 0 or 1 || The language-tag of the language used by the documentation. ||
-|| |||| `<ValueScheme>` || `xs:complexType` || 0 or 1 ||Value restrictions based on a regular expression or a specified vocabulary. See [#valuerestrictions Value restrictions for elements and attributes] for details. ||
+|| |||| `<ValueScheme>` || `xs:complexType` || 0 or 1 ||Value scheme based on a regular expression or a specified vocabulary. See [#valuerestrictions Value schemes for elements and attributes] for details. ||
 || |||| `<AutoValue>` || `xs:string` || 0 to unbounded || Derivation rules for the attribute's content. ||
 
@@ -726 +728 @@
 </Attribute>
 }}}
-== Value restrictions for elements and attributes ==
+
+[=#valuerestrictions]
+== Value schemes for elements and attributes ==
 Apart from standard XML schema datatypes the content of a CMD element or attribute instance can be restricted by two means. The `<ValueScheme>` element `MAY` contain either an XML element `<pattern>` with the specification of a regular expression the element/attribute should comply with, or the definition of a controlled vocabulary of allowed values. CMDI 1.2 supports two approaches to describe such a vocabulary: