Merge branch 'MAS-2018-0047' into 'WI-0081-Smart_Device_Template_4_0'

Added a new directory to work on version 4.0 of SDT.

Changed the license to 3-clause BSD.
Changed various version numbers from 3.0 to 4.0.

See merge request !2

README.md

@@ -2,9 +2,9 @@
 
 Repository for the Smart Device Template (SDT).
 
-**Version 3.0**
+**Version 4.0**
 
-Note that this project runs under Apache 2.0 license. Read the [LICENSE](LICENSE) in this repository, or refer to [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
+Note that this project runs under the 3-Clause BSD License. Read the [LICENSE](LICENSE) in this repository, or refer to  [https://opensource.org/licenses/BSD-3-Clause](https://opensource.org/licenses/BSD-3-Clause).
 
 Any contributions made to this project must comply with the aforementioned license.
 
@@ -12,23 +12,23 @@ Any contributions made to this project must comply with the aforementioned licen
 
 The Smart Device Template (SDT) is a template which is used to model the capabilities, actions and events of connected devices. The intent of the SDT is to be able to model any type of connected device using a well accepted and standardised format. The main application of SDT is to enable a uniformly structured Application Programmer’s Interface (API) to applications that need to interact with connected devices. Usually, these applications would communicate to devices using an Abstraction Layer as an intermediary logic. The Abstraction Layer „hides“ the technology-specific, native language format of devices of different technology type from the applications.
 
-[Read the full Introduction.](SDT/schema3.0/docs/Introduction.md)
+[Read the full Introduction.](SDT/schema4.0/docs/Introduction.md)
 
 ## Quick Links
-- ['domain.xsd' Version 3.0](SDT/schema3.0/src/domain.xsd)
-- [UML Diagram of the SDT 3.0](SDT/schema3.0/docs/UML%20Diagram.md) ([source](SDT/schema3.0/docs/SDT_UML.uxf))
+- ['domain.xsd' Version 4.0](SDT/schema4.0/src/domain.xsd)
+- [UML Diagram of the SDT 4.0](SDT/schema4.0/docs/UML%20Diagram.md) ([source](SDT/schema4.0/docs/SDT_UML.uxf))
 
 
 ## Content
 
 You can find further Information here:
 
-- [Introduction to the SDT](SDT/schema3.0/docs/Introduction.md)
-- [SDT Components](SDT/schema3.0/docs/SDT_Components.md)
-- [SDT Build System](SDT/schema3.0/docs/SDT%20Build%20System.md)
-- [Examples](SDT/schema3.0/docs/Examples.md) 
-- [Links & References](SDT/schema3.0/docs/Links.md)
-- [Changelog](SDT/schema3.0/docs/Changelog.md)
+- [Introduction to the SDT](SDT/schema4.0/docs/Introduction.md)
+- [SDT Components](SDT/schema4.0/docs/SDT_Components.md)
+- [SDT Build System](SDT/schema4.0/docs/SDT%20Build%20System.md)
+- [Examples](SDT/schema4.0/docs/Examples.md) 
+- [Links & References](SDT/schema4.0/docs/Links.md)
+- [Changelog](SDT/schema4.0/docs/Changelog.md)
 - [LICENSE](LICENSE)
 
 

SDT/schema4.0/build.xml

+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- - HGI Device Abstraction Layer  - - - - - - - - - - - - - - - - - - - - -->
+<!--                                                                         -->
+<!--   Extends the standard build with targets for: 			     -->
+<!--    - generate XML schema the from Relax NG (xml) description	     -->
+<!--    - validate DAL documents against the XML Schema			     -->
+<!--    - generate HTML documentation from DAL documents 		     -->
+
+<project name="importing" basedir="." default="schemas">
+  <import file="etc/common.xml"/>
+
+  <!-- Read the namespace declarations from a file (to get linebreaks) - - - -->
+
+  <loadfile property="schema.xmlns" srcFile="${basedir}/etc/schema.xmlns"/>
+
+  <!-- The RNG file the XML and RNC schemas are generaed from  - - - - - - - -->
+
+  <property name="schema.name" value="domain"/>
+  <property name="schema.rng" value="${path.src}/${schema.name}.rng"/>
+
+  <!-- HTML  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+  <!--                                                                       -->
+  <!-- Generate HTML documentation from domain definitions in the test       -->
+  <!-- directory. The module classes included via the extends tagged are     -->
+  <!-- included in the documentation - so an xinclude capable XSL engine is  -->
+  <!-- needed.                                                               -->
+  <!-- This needs Ant version 1.8+ and it must be augmented with an current  -->
+  <!-- version of Xerces. Download the binray distribution and place the put -->
+  <!-- xml-apis.jar and xercesImpl.jar in the Ant lib directory.             -->
+
+  <target name="html">
+	<mkdir dir="${path.genbase}" />
+    <xslt basedir="${basedir}/test" destdir="${basedir}/gen/html"
+	  style="${basedir}/style/html.xsl">
+      <param name="destdir" expression="${basedir}/gen/html"/>
+      <sysproperty
+	  key="org.apache.xerces.xni.parser.XMLParserConfiguration"
+	  value="org.apache.xerces.parsers.XIncludeParserConfiguration"/>
+    </xslt>
+  </target>
+
+  <!-- Schemas - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+  <!--                                                                       -->
+  <!-- The schema is specified using Relax NG (xml) and trang is used to     -->
+  <!-- generate the XML schema. The schema is also generated in Relay NG     -->
+  <!-- compact syntax, which is used by some validating editors (e.g. emacs) -->
+  <!-- The resulting schemas need some additional patching before thy are    -->
+  <!-- usable                                                                -->
+
+  <target name="schemas">
+    <java jar="${basedir}/lib/trang.jar" fork="true">
+      <arg value="${schema.rng}"/>
+      <arg value="${basedir}/etc/${schema.name}.rnc"/>
+    </java>
+
+    <!-- So that the editor does not complain about include directives, the -->
+    <!-- resulting schema is included in another schema, which includes the -->
+    <!-- necessary element definitions. To be able to do this the           -->
+    <!-- definition for Imports must be deleted from this generated schema. -->
+
+    <replace file="${basedir}/etc/${schema.name}.rnc"
+	     token="Imports = element Imports { Domain* }?" value=""/>
+
+    <java jar="${basedir}/lib/trang.jar" fork="true">
+      <arg value="${schema.rng}"/>
+      <arg value="${path.src}/${schema.name}.xsd"/>
+    </java>
+
+    <!-- Can't validate against the generated schema unless we add the      -->
+    <!-- target and default namespaces ...                                  -->
+
+    <replace file='${path.src}/domain.xsd'
+	     token='xmlns:xs="http://www.w3.org/2001/XMLSchema"'
+	     value='${schema.xmlns}'/>
+
+    <!-- In addition the xml:base tag, which is added automatically when    -->
+    <!-- including a document, must also be permitted by out schema.        -->
+    <!-- The schema generated from RNG is almost correct schema ... but     -->
+    <!-- the schemaLocation is wrong.                                       -->
+
+    <replace file='${path.src}/domain.xsd'
+	     token="xml.xsd" value="http://www.w3.org/2001/03/xml.xsd"/>
+  </target>
+
+  <!-- Validate  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+  <!--                                                                       -->
+  <!-- Check the Device Description conforms to the Device Abstraction       -->
+  <!-- Schema. Note that we need to activate support for XML includes        -->
+
+  <target name="validate" depends="">
+    <schemavalidate warn="true">
+      <fileset dir="${basedir}/test" includes="*.xml"/>
+      <attribute name="http://apache.org/xml/features/xinclude" value="true"/>
+      <schema namespace="http://homegatewayinitiative.org/xml/dal/3.0"
+	      file="${path.src}/domain.xsd" />
+      <schema namespace="http://www.w3.org/2001/XInclude"
+	      file="${basedir}/etc/XInclude.xsd" />
+      <schema namespace="http://www.w3.org/2001/XMLSchema"
+	      file="${basedir}/etc/XMLSchema.xsd" />
+    </schemavalidate>
+  </target>
+
+</project>
+

SDT/schema4.0/docs/Changelog.md

+# Changelog
+
+## Changes in 4.0
+
+
+## Changes in 3.0
+- Renamed ``<RootDevice>``to ``<Device>`` and ``<Device>`` to ``<SubDevice>``,
+- Added complex data types: *Struct* and *Arrays*.
+- Simplified the UML diagram. Split the UML diagram into two parts, one for the base elements and one for the data types.
+- In the UML diagram: Moved ``<extends>`` into the UML ``<ModuleClass>`` element (easier to read).
+- Added support to specify *Units of Measurement* to data types,
+- Added ``<Doc>`` to ``<Domain>`` and other elements.
+- ``<Doc>`` is now always the first part of an element.
+- Changed ``<DeviceInfo>`` element to a list of ``<Characteristic>``.
+- Added ``<Characteristic>`` list to ``<Modules>`` and ``<ModuleClasses>``.
+- The ``<data>`` element in ``<Event>`` is now optional to support events without attached or associated data.
+- In Actions: Added ``<Args>`` as a surrounding list around a list of ``<Arg>``.
+- Added *Constraints* to ``<DataType>``.
+- Added optional *name* attribute to ``<DataType>``. This mandatory for elements of a *struct*.
+- Restructured the [RNG](SDT/schema3.0/src/domain.rng) file for better readability and maintainability.
+- In the [RNG](SDT/schema3.0/src/domain.rng)/[XSD](SDT/schema3.0/src/domain.xsd): Changed cardinality of the occurrence of elements that are part of a list of elements (e.g. ``<SubDevices><SubDevice>…</SubDevice></SubDevices>`` from „zero or more“ to „one or more“ when the surrounding list element itself is optional (to avoid empty lists).
+
+
+
+## Changes in 2.0.1
+- Added missing "uri" data type.
+
+## Changes in 2.0
+- Introduced RootDevice to support hierarchical embedded devices.
+- Added new data types (byte, float, array, enum, date, time, datetime, blob, uri)
+- Added ``readable`` and ``eventable`` to data points.
+- Added optional ``<SerialNumber>``, ``<VendorURL>`` and ``<FirmwareVersion>`` elements to DeviceInfo
+- Added optional ``<Doc>`` element to Event
+- Changed the optionality of the ``<DataPoint>``'s ``type`` attribute to "required".
+- Added [UML diagram](SDT/schema2.0/docs/SDT_Components.md)
+- Changed the namespace for the XSD from "hgi.org" to "homegatewayinitiative.org".
\ No newline at end of file

SDT/schema4.0/docs/Examples.md

+# Examples and Contributions
+[A simple example](#simpleExample)  
+[Multi Socket Electrical-Extension-Block](#mseeb)
+
+<a name="simpleExample"></a>
+## A very simple SDT example
+In the ideal case, a large organization or SDO would define a widely-applicable set of [ModuleClasses](SDT_Components.md#ModuleClass), each of which could be used as needed to compose the description of a complex device. In order to show the appoach, this section will create a few example ModuleClasses based on - or inspired by - featues in the Echonet Lite protocol. Please note that the examples shown in this document are very "cut down" and by no means represent a true representation of Echonet Lite.
+
+The Echonet Consortium has standardized their specifications within IEC/ISO (IEC62394, ISO/IEC24767-1, ISO/IEC24767-2, IEC62480, ISO/IEC14543-4-1, ISO/IEC14543-4-2, IEC62457) and they provide a comprehensive collection of various types of home appliances relevant to SmartGrid applications as ECHONET Device objects (see [https://echonet.jp/spec_object_rf_en/](https://echonet.jp/spec_object_rf_en/) ).
+
+For the example in this document, to show re-use of ModuleClass definitions, two complex devices are chosen which have some common features and hence could be expected to both use some of the same ModuleClasses: an air conditioner and a washing machine.
+
+<table>
+<tr><th>Funtionality</th><th>Air Conditioner</th><th>Washing Machine</th></tr>
+<tr><td>operationStatus</td><td>operates on/off</td><td>operates on/off</td></tr>
+<tr><td>measuredCumulativePowerConsumption</td><td>the cumulative power consumption</td><td>the cumulative power consumption</td></tr>
+<tr><td>installationLocation</td><td>this sets/reads a string text describing the location (room) of the air-conditioner.</td><td>this sets/reads a string text describing the location (room) of the washing machine.</td></tr>
+<tr><td>setTimer</td><td>(not applicable. there is no preset start for an air-conditioner)</td><td>This sets/reads use the on/off timer</td></tr>
+</table>
+
+Based on the simplified example above, the two appliances will need the ModuleClasses below:
+
+- *air-conditioner*: operationStatus, measuredCumulativePowerConsumption, installationLocation;
+- *washing-machine*: operationStatus, measuredCumulativePowerConsumption, and setTimer. 
+
+		<ModuleClass name="operationStatus">
+			<Data>
+				<DataPoint name="operationStatus" writable="true">
+					<Doc>This property sets/reads the ON/OFF status.</Doc>
+						<DataType>
+							<SimpleType type="boolean"/> 
+						</DataType>
+				</DataPoint>
+			</Data>
+			<Events>
+				<Event name="operationStatus">
+				</Event>
+			</Events>
+		</ModuleClass>
+
+		<ModuleClass name="measuredCumulativePowerConsumption">
+			<Data>
+				<DataPoint name="measuredCumulativePowerConsumption" writable="false">
+					<Doc>This indicates cumulative power consumption of the device in increments of 0.001kWh.</Doc>
+					<DataType>
+						<SimpleType type="integer"/>
+					</DataType>
+				</DataPoint>
+			</Data>
+		</ModuleClass>
+
+		<ModuleClass name="installationLocation">
+			<Data>
+				<DataPoint name="installationLocation" writable="true">
+					<Doc>This property indicates the installation location</Doc>
+					<DataType>
+						<SimpleType type="string"/>
+					</DataType>
+				</DataPoint>
+			</Data>
+			<Events>
+				<Event name="installationLocation"> </Event>
+			</Events>
+		</ModuleClass>
+
+		<ModuleClass name="onTimerSetting">
+			<DataPoint name="onTimer" writable="true">
+				<Doc>Timer value (HH:MM)</Doc>
+				<DataType>
+					<SimpleType type="time"/>
+				</DataType>
+			</DataPoint>
+		</ModuleClass>
+
+The structure and the according SDT now looks like this:
+
+<table>
+<tr><td colspan="2" width="50%"><b>Example1.SDT</b></td></tr>
+<tr><td> </td><td>Namespace information</td></tr>
+<tr><td> </td><td>Modules (contains ModuleClasses)</td></tr>
+<tr><td> </td><td>operationStatus<ul>
+	<li>measuredCumulativePowerConsumption</li>
+	<li>installationLocation</li>
+	<li>onTimerSetting</li></ul></td></tr>
+</table>
+
+		<?xml version="1.0" encoding="iso-8859-1"?>
+		<!-- Example1 SDT inspired by some Echonet Lite examples -->
+		<Domain xmlns="http://homegatewayinitiative.org/xml/dal/3.0"
+			xmlns:xi="http://www.w3.org/2001/XInclude"
+			id="example1.SDT">
+		
+		<Modules>
+		<!-- Various examples for module classes -->
+		<ModuleClass name="operationStatus">
+			<Data>
+				<DataPoint name="operationStatus" writable="true">
+					<Doc>This property sets the ON/OFF status.</Doc>
+						<DataType>
+							<SimpleType type="boolean"/> 
+						</DataType>
+				</DataPoint>
+			</Data>
+			<Events>
+				<Event name="operationStatus">
+				</Event>
+			</Events>
+		</ModuleClass>
+
+		<ModuleClass name="installationLocation">
+			<Data>
+				<DataPoint name="installationLocation" writable="true">
+					<Doc>This property indicates the installation location</Doc>
+					<DataType>
+						<SimpleType type="string"/>
+					</DataType>
+				</DataPoint>
+			</Data>
+			<Events>
+				<Event name="installationLocation"> </Event>
+			</Events>
+		</ModuleClass>
+
+		<ModuleClass name="measuredCumulativePowerConsumption">
+			<Data>
+				<DataPoint name="measuredCumulativePowerConsumption" writable="false">
+					<Doc>This indicates cumulative power consumption of the device in increments of 0.001kWh.</Doc>
+					<DataType>
+						<SimpleType type="integer"/>
+					</DataType>
+				</DataPoint>
+			</Data>
+		</ModuleClass>
+
+		<ModuleClass name="onTimerSetting">
+			<DataPoint name="onTimer" writable="true">
+				<Doc>Timer value (HH:MM)</Doc>
+				<DataType>
+					<SimpleType type="time"/>
+				</DataType>
+			</DataPoint>
+		</ModuleClass>
+			</Modules>
+		</Domain>
+
+
+---
+
+<a name="mseeb"></a>
+### Multi Socket Electrical-Extension-Block
+
+This example is a specification for an imaginged device, a connected extension block with multiple power socket where each of the sockets are modeled as a 
+separate *SubDevice*.
+
+[mseeb.xml](../test/mseeb.xml)
+
+
+---
+

SDT/schema4.0/docs/FAQ.md

+# Frequently Asked Questions
+
+## What is the HGI?
+tbd
+
+## What is the SDT?
+tbd

SDT/schema4.0/docs/Links.md

+# Links & References
+- **HGI** : [http://www.homegatewayinitiative.org](http://www.homegatewayinitiative.org)
+
+## XML
+- **RELAX NG** : [http://relaxng.org](http://relaxng.org)
+	- **RELAX NG Tutorial** : [http://relaxng.org/tutorial-20011203.html](http://relaxng.org/tutorial-20011203.html)
+
+## Tools
+- **UMLet**	: [http://www.umlet.com](http://www.umlet.com)  
+The free UML drawing tool used to draw the UML file.
+- **Apache Ant** : [http://ant.apache.org](http://ant.apache.org)  
+Build tool
+
+

SDT/schema4.0/docs/SDT Build System Components and Licenses.md

+# Build System Libraries and Licenses
+The following libraries are used in the build system for the SDT.
+
+## trang.jar
+
+[http://www.thaiopensource.com/relaxng/trang-manual.html](http://www.thaiopensource.com/relaxng/trang-manual.html)
+
+*Trang* takes as input a schema written in any of the following formats:
+
+- RELAX NG (XML syntax)
+- RELAX NG (compact syntax)
+- XML 1.0 DTD
+
+and produces as output a schema written in any of the following formats:
+
+- RELAX NG (XML syntax)
+- RELAX NG (compact syntax)
+- XML 1.0 DTD
+- W3C XML Schema
+
+*Trang* can also infer a schema from one or more example XML documents.
+
+
+### License
+Copyright (c) 2002, 2003, 2008 Thai Open Source Software Center Ltd
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+- Neither the name of the Thai Open Source Software Center Ltd nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## Ant-Contrib Tasks
+
+[http://ant-contrib.sourceforge.net](http://ant-contrib.sourceforge.net)
+
+The *Ant-Contrib* project is a collection of tasks (and at one point maybe types and other tools) for Apache Ant.
+
+### License 
+
+This Software is distributed under the Apache Software License.
+
+## antSetLogLevel.jar
+
+GUI dialog for Ant tasks.
+
+Source: Deutsche Telekom
+
+
+

SDT/schema4.0/docs/SDT Build System.md

+# SDT Build System
+This document describes the SDT build system and how to build the SDT and validate new contributions.
+
+The files referenced in this document point to version **4.0** of the SDT.
+
+## Directory Structure and Important Files
+- [SDT/schema4.0/](../..) : Base directory
+- [SDT/schema4.0/src/](../src/) : Source files of the SDT.
+	- [domain.rng](../src/domain.rng) : RELAX NG file with the SDT schema definition. This is the source file that is converted to the actual schema definition *domain.xsd* during the build. See also [http://en.wikipedia.org/wiki/RELAX_NG](http://en.wikipedia.org/wiki/RELAX_NG).  
+	**Only edit this file when one wants to make changes to the SDT!**
+	- [domain.xsd](../src/domain.xsd) : The SDT schema definition that is generated from *domain.rng*.
+	- [xml.xsd](../src/xml.xsd) : General schema definitions for the SDT
+- [SDT/schema4.0/test/](../test/) : This directory contains all XML files with SDT definitions that should be validated whether they conform to the SDT schema. This could be example definitions or contributions.
+- [SDT/schema4.0/build.xml](../build.xml) : This is the definition file for the ant build system.
+- [SDT/schema4.0/etc/](../etc/), [SDT/schema4.0/style/](../style/) : internal directories for the build system. Please, don't make unnecessary changes to these files.
+- [SDT/schema4.0/etc/](../etc), [SDT/schema4.0/style/](../style/) : internal directories for the build system. Please, don't make unnecessary changes to these files.
+	- [SDT/schema4.0/etc/dal.rnc](../etc/dal.rnc) : This file contains various configuration parameter to convert the file [domain.rng](../src/domain.rng) to schema file. **The important parameter to change when changing the namespace or the version number is**:
+
+			default namespace xsl = "http://homegatewayinitiative.org/xml/dal/3.0"
+
+	- [SDT/schema4.0/etc/schemas.xml](../etc/schemas.xml) : This file contains the header for the schema file. **This must be changed when changing the namespace or the version number.**
+- [SDT/schema4.0/lib/](../lib/) : Tasks for the ant-based build system. See also [SDT Build System Components and Licenses](SDT%20Build%20System%20Components%20and%20Licenses.md).
+
+## Installation
+- Install Java on your computer
+- Download and install Apache ant from [http://ant.apache.org](http://ant.apache.org)
+- Clone the SDT repository from GitHub:
+
+		$ git clone https://github.com/Homegateway/SmartDeviceTemplate.git
+	
+## How to Use the Build System
+After cloning the repository go to the directory *SDT/schema* and run commands depending on what you want to achieve.
+
+### Build the Schema
+Running *ant* without any parameter builds the schema definition from the rng-definition [SDT/schema4.0/src/domain.rng](../src/domain.rng) and writes it to [SDT/schema4.0/src/domain.xsd](../src/domain.xsd)
+
+	$ cd SDT/schema
+	$ ant
+
+### Validate SDT Definitions
+You can use the build system to validate new SDT definitions or changes made to existing ones by running the following command:
+
+	$ cd SDT/schema
+	$ ant validate
+
+The output after a successful validation should look like this:
+
+>[schemavalidate] 2 file(s) have been successfully validated.  
+>BUILD SUCCESSFUL  
+>Total time: 1 second
+
+Otherwise you most likely receive a stack trace or some other error messages. Search the output for the line *BUILD FAILED*. Above this line you will find some helpful hints for the filename and line number on which the error occurred (here: file *mseeb.xml* on line 66) and a reason:	
+
+>[schemavalidate] /Users/someone/Sources/git/SmartDeviceTemplate/SDT/schema/test/mseeb.xml:66:18: cvc-elt.1: Cannot find the declaration of element 'Domain'.    
+>BUILD FAILED
+
+---
+
+##  Editing
+As mentioned above, the actual schema definition is defined in the file [domain.rng](../src/domain.rng) and converted to the XML schema definition [domain.xsd](../src/domain.xsd) during the build process. 
+
+**All changes to the schema must therefore be made in [domain.rng](../src/domain.rng), NOT [domain.xsd](../src/domain.xsd) !**
+
+You may need to make additional changes in the following files, e.g. when the name space or the version number need to be adjusted.
+
+PLEASE ONLY EDIT THESE FILES IF NECESSARY. 
+
+- [SDT/schema4.0/build.xml](../build.xml)  
+e.g. in the *ant* target "validate"
+- [SDT/schema4.0/etc/dal.rnc](../etc/dal.rnc)  
+e.g. the entry "default namespace xsl"
+- [SDT/schema4.0/etc/schema.xmlns](../etc/schema.xmlns)
+- [SDT/schema4.0/etc/schemas.xml](../etc/schemas.xml)

SDT/schema4.0/docs/UML Diagram.md

+# UML Diagram of the SDT 4.0
+
+The source for the diagrams below is [here](SDT_UML.uxf).
+## Basic Elements
+
+![](images/SDT_UML_Basic_Elements.png)
+
+## Data Types
+
+![](images/SDT_UML_DataType.png)
+
+## Key
+
+![](images/SDT_UML_Key.png)

SDT/schema4.0/etc/XInclude.xsd

+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+           xmlns:xi="http://www.w3.org/2001/XInclude"
+           targetNamespace="http://www.w3.org/2001/XInclude"
+           finalDefault="extension">
+  <xs:annotation>
+   <xs:documentation>
+    Not normative, but may be useful.
+    See the REC http://www.w3.org/TR/XInclude for definitive
+    information about this namespace.
+   </xs:documentation>
+  </xs:annotation>
+
+  <xs:element name="include" type="xi:includeType" />
+
+  <xs:complexType name="includeType" mixed="true">
+    <xs:choice minOccurs='0' maxOccurs='unbounded' >
+      <xs:element ref='xi:fallback' />
+      <xs:any namespace='##other' processContents='lax' />
+      <xs:any namespace='##local' processContents='lax' />
+    </xs:choice>
+    <xs:attribute name="href" use="optional" type="xs:anyURI"/>
+    <xs:attribute name="parse" use="optional" default="xml"
+                  type="xi:parseType" />
+    <xs:attribute name="xpointer" use="optional" type="xs:string"/>
+    <xs:attribute name="encoding" use="optional" type="xs:string"/>
+    <xs:attribute name="accept" use="optional" type="xs:string"/>
+    <xs:attribute name="accept-language" use="optional" type="xs:string"/>
+    <xs:anyAttribute namespace="##other" processContents="lax"/>
+  </xs:complexType>
+
+  <xs:simpleType name="parseType">
+    <xs:restriction base="xs:token">
+      <xs:enumeration value="xml"/>
+      <xs:enumeration value="text"/>
+    </xs:restriction>
+  </xs:simpleType>
+  
+  <xs:element name="fallback" type="xi:fallbackType" />
+
+  <xs:complexType name="fallbackType" mixed="true">
+    <xs:choice minOccurs="0" maxOccurs="unbounded">
+      <xs:element ref="xi:include"/>
+      <xs:any namespace="##other" processContents="lax"/>
+      <xs:any namespace="##local" processContents="lax"/>
+    </xs:choice>
+    <xs:anyAttribute namespace="##other" processContents="lax" />
+  </xs:complexType>
+
+</xs:schema>

SDT/schema4.0/etc/XMLSchema-datatypes.xsd

+<?xml version='1.0'?>
+<!-- XML Schema schema for XML Schemas: Part 2: Datatypes -->
+<!DOCTYPE schema PUBLIC "-//W3C//DTD XMLSCHEMA 200102//EN" "XMLSchema.dtd" [
+<!ENTITY % s ''>
+<!ENTITY % p ''>
+]>
+<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.w3.org/2001/XMLSchema-datatypes"
+	version="$Id: XMLSchema-datatypes.xsd,v 1.5 2001/03/16 20:53:32 ht Exp $">
+  <annotation>
+   <documentation>Note this schema is NOT a normative schema - -
+     It contains types derived from all the builtin simple type definitions
+     with the same local name but in a distinct namespace, for use
+     by applications which do no wish to import the full XMLSchema
+     schema.  Since derivation is not symmetric, unexpected results may
+     follow from mixing references to these definitions with references
+     to the definitions in the XMLSchema namespace.  For example,
+     although dt:positiveInteger is derived from xs:integer, the converse
+     does not hold.</documentation>
+  </annotation>
+
+  <simpleType name="string">
+   <restriction base="string"/>
+  </simpleType>
+  <simpleType name="boolean">
+   <restriction base="boolean"/>
+  </simpleType>
+  <simpleType name="float">
+   <restriction base="float"/>
+  </simpleType>
+  <simpleType name="double">
+   <restriction base="double"/>
+  </simpleType>
+  <simpleType name="decimal">
+   <restriction base="decimal"/>
+  </simpleType>
+  <simpleType name="dateTime">
+   <restriction base="dateTime"/>
+  </simpleType>
+  <simpleType name="duration">
+   <restriction base="duration"/>
+  </simpleType>
+  <simpleType name="hexBinary">
+   <restriction base="hexBinary"/>
+  </simpleType>
+  <simpleType name="base64Binary">
+   <restriction base="base64Binary"/>
+  </simpleType>
+  <simpleType name="anyURI">
+   <restriction base="anyURI"/>
+  </simpleType>
+  <simpleType name="ID">
+   <restriction base="ID"/>
+  </simpleType>
+  <simpleType name="IDREF">
+   <restriction base="IDREF"/>
+  </simpleType>
+  <simpleType name="ENTITY">
+   <restriction base="ENTITY"/>
+  </simpleType>
+  <simpleType name="NOTATION">
+   <restriction base="NOTATION"/>
+  </simpleType>
+  <simpleType name="normalizedString">
+   <restriction base="normalizedString"/>
+  </simpleType>
+  <simpleType name="token">
+   <restriction base="token"/>
+  </simpleType>
+  <simpleType name="language">
+   <restriction base="language"/>
+  </simpleType>