Changes between Version 201 and Version 202 of CMDI 1.2/Specification


Ignore:
Timestamp:
06/20/16 15:04:59 (8 years ago)
Author:
Twan Goosen
Comment:

various changed transferred from google docs

Legend:

Unmodified
Added
Removed
Modified
  • CMDI 1.2/Specification

    v201 v202  
    582582
    583583==      CMD element definition ==
    584 CMD elements are a template for storing atomic values constrained by a value scheme in a CMD instance. The CCSL specification of an CMD element `MUST` contain the name of the element and `MAY` contain a concept link, the value schema, and information about the allowed cardinality of the element. Furthermore, it `MAY` be indicated if the element may have different instance values in multiple languages, which mandates an unlimited upper cardinality bound. A CMD element `MUST` either have one of the standard XML schema datatypes assigned to it, or be constrained by using regular expressions or vocabularies. The latter can be specified by giving the complete list of allowed values or by stating the URI of an external vocabulary (for details see [#valuerestrictions Value restrictions for elements and attributes]). If the instance's content of the element can be derived from other values, the element  `AutoValue` `MAY` be used to give indication about the derivation function. The CCSL does not prescribe or suggest a specific set of derivation functions.
     584CMD elements are a template for storing atomic values constrained by a value scheme in a CMD instance. The CCSL specification of an CMD element `MUST` contain the name of the element and `MAY` contain a concept link, the value schema, and information about the allowed cardinality of the element. Furthermore, it `MAY` be indicated if the element allows for values in more than one language, in which case an  unlimited upper cardinality bound is implied. A CMD element `MUST` either have one of the standard XML schema datatypes assigned to it, or be constrained by using regular expressions or vocabularies. The latter can be specified by giving the complete list of allowed values or by stating the URI of an external vocabulary (for details see [#valuerestrictions Value restrictions for elements and attributes]). If the instance's content of the element can be derived from other values, the element  `AutoValue` `MAY` be used to give indication about the derivation function. The CCSL does not prescribe or suggest a specific set of derivation functions.
    585585
    586586||||||= Name =||= Valuetype =||= Occurrences =||= Description =||
     
    625625   name="CreationDate"
    626626   ValueScheme="dateTime">
     627     <!-- ‘now’ is an informative example of an derivation function -->
    627628     <AutoValue>now</AutoValue>
    628629 </Element>
     
    718719
    719720==      Cue attributes ==
    720 All CMD attribute, element, and component specifications may contain additional attributes in the `cue` namespace. These `MAY` be used to give information about how the payload contained in the respective part of the CMD instance should be presented. Cues are grouped in component specific styles. Different styles for the same CMD component `MAY` be developed. The CCSL does not prescribe or suggest a specific set of cue attributes.
     721CMDI profiles provide the blueprint for a logical structuring of metadata instances. However, they provide very little explicit information about how the information contained in CMDI instances should be presented. Such information can be processed by viewers, editors and catalogues alike, leading to a potentially more uniform (across applications), visually pleasing and user friendly presentation of metadata. The usage of display information SHOULD always be optional for applications processing CMDI instances.
     722
     723For this purpose, all CMD attribute, element, and component specifications MAY contain additional attributes in the cue namespace. These MAY be used to give information about how the payload contained in the respective part of the CMD instance should be presented. Cues are grouped in component specific styles. Different styles for the same CMD component MAY be developed. The CCSL does not prescribe or suggest a specific set of cue attributes.
     724
     725Examples of aspects for which display cues may be introduced are display order, structural transformation (e.g. folding of hierarchies), labeling and visual styling.
    721726
    722727=== Examples ===
     
    734739}}}
    735740
     741{{{#!comment
     742TODO: Example with cues on <Component>
     743}}}
     744
    736745= Transformation of CCSL into a CMD profile schema definition =
    737746[=#transformationIntoSchema]
     
    827836
    828837=== Notes ===
    829  * The attributes `@cmd:Vocabulary`, `@cmd:ValueProperty`, `@cmd:ValueLanguage` and `@cmd:ConceptLink` are to be included in the schema document, not in the CMD instance.
     838 * `@cmd:Vocabulary`, `@cmd:ValueProperty`, `@cmd:ValueLanguage` and `@cmd:ConceptLink` `MAY` appear as attributes of XML attribute declarations and XML element declarations  in the schema document for a CMDI profile, and `MUST NOT` appear in the CMDI instance.
    830839
    831840----