IMS logo

IMS Global Access for All (AfA) Digital Resource Description (DRD)

Version 3.0 Specification

Public Draft 1.0


Date Issued: 13 September 2012
Latest version: http://www.imsglobal.org/accessibility/

IPR and Distribution Notices

Recipients of this document are requested to submit, with their comments, notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the specification set forth in this document, and to provide supporting documentation.

IMS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on IMS's procedures with respect to rights in IMS specifications can be found at the IMS Intellectual Property Rights web page: http://www.imsglobal.org/ipr/imsipr_policyFinal.pdf .

Copyright © 2012 IMS Global Learning Consortium. All Rights Reserved.

Use of this specification to develop products or services is governed by the license with IMS found on the IMS website: http://www.imsglobal.org/speclicense.html .

Permission is granted to all parties to use excerpts from this document as needed in producing requests for proposals.

The limited permissions granted above are perpetual and will not be revoked by IMS or its successors or assigns.

THIS SPECIFICATION IS BEING OFFERED WITHOUT ANY WARRANTY WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NONINFRINGEMENT IS EXPRESSLY DISCLAIMED. ANY USE OF THIS SPECIFICATION SHALL BE MADE ENTIRELY AT THE IMPLEMENTER'S OWN RISK, AND NEITHER THE CONSORTIUM, NOR ANY OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER, DIRECTLY OR INDIRECTLY, ARISING FROM THE USE OF THIS SPECIFICATION.

Public contributions, comments and questions can be posted here: http://www.imsglobal.org/community/forum//categories.cfm?catid=88

top

Table of Contents

  1. Introduction
    1. Scope and Context
    2. Structure of this Document
    3. Nomenclature
    4. References

  2. Platform Specific Model of the Binding
    1. Full Data Model Description
    2. Core Profile Data Model Description

  3. Application of the Binding Guidelines
    1. Full Specification
    2. Core Profile

  4. XSD File Documentation
    1. Full Data Model XSD Documentation
    2. Core Profile Data Model XSD Documentation

  5. Vocabularies
  6. Appendix A - Listing of the XSDs
  7. About This Document
  8. List of Contributors
  9. Revision History
top

1. Introduction

This document is a part of the IMS Global Access for All Digital Resource Description (AfA DRD) v3.0 specification. The binding details how the AfA DRD Information Model is realised as an XML binding: using and XSD description. The AfA DRD binding is contained in two XSD files: for the full and core profile versions. The IMS Global AfA Best Practice and Implementation Guide [AfA, 12b] provides non-normative guidance on how to use the Binding and Information Model. For a conceptual overview of the AfA Specification, please see the overview description [AfA, 12a]. For a discussion of potential applications, see the Best Practice & Implementation Guide.

1.1 Scope and Context

The IMS Global AfA DRD v3.0 XSD Binding v1.0 is used in conjunction with the following documents:

  1. IMS Global Access for All Digital Resource Description Information Model v3.0 [AfADRD, 12] – the data model definition of the AfA DRD;
  2. IMS Global Access for All Data Element Specification v3.0 [AfADES, 12] – the set of data elements used for the AfA DRD;
  3. IMS Global Access for All Personal Needs & Preferences Information Model v3.0 [AfAPNP, 12] – the data model definition of the AfA PNP;
  4. IMS Global Access for All Best Practice and Implementation Guide v1.0 – key information on how to adopt and implement the specification.[AfA, 12b]

As such the Access for All Digital Resource Description specification supersedes the specifications:

  1. IMS Global Access for All Digital Resource Description Information Model Final Specification v2.0 [AfADRD, 10].

This XSD binding takes the Access for All Digital Resource Description Information Model and produces an encoding of that description in XSD. The XSD is created using the IMS Global Binding Auto-generation Tool-kit (I-BAT) [I-BAT, 06].

1.2 Structure of this Document

The structure of this document is:

2. Platform Specific Model of the Binding
The description of the platform specific models in the form of the IMS Global UML-Profile data model representation of the IMS Global AfA DRD specification information model. This representation is used by the IMS Global I-BAT tool to auto-generate the corresponding XSDs;
3. Application of the Binding Guidelines
Explanation of how the platform specific model is realised as the XSD binding. This addresses how the information model is realised as the binding;
4. XSD File Documentation
The description of the elements used within the data model components of the full AfA DRD and core profile bindings. This part of the binding document was created using the schema documentation tool provided as part of the Oxygen 14.0 product;
Appendix A - Listing of the XSD Files This is the full listing of the AfA DRD full and core profile XSD files;

1.3 Nomenclature

AfA DES Access for All Data Element Specification
AfA DRD Access for All Digital Resource Description
AfA PNP Access for All Personal Needs & Preferences
I-BAT IMS Global Binding Auto-generation Tool-kit
IMS Global IMS Global Learning Consortium
PIM Platform Independent Model
PSM Platform Specific Model
UML Unified Modelling Language
W3C World Wide Web Consortium
XMI XML Meta-data Interchange
XML Extensible Mark-up Language
XSD XML Schema Definition
XSL Extensible Stylesheet Language
XSLT XSL Transformations

1.4 References

[AfA, 12a]
IAccess For All Specification Overview v1.0, R.Schwerdtfeger, M.Rothberg and C.Smythe, Public Draft, IMS Global Learning Consortium, September 2012.
[AfA, 12b]
Access For All Best Practices & Implementation Guide v1.0, R.Schwerdtfeger, M.Rothberg and C.Smythe, Public Draft, IMS Global Learning Consortium, September 2012.
[AfADES, 12]
Access For All v3.0 Data Element Specification v1.0, R.Schwerdtfeger, M.Rothberg and C.Smythe, Public Draft, IMS Global Learning Consortium, September 2012.
[AfADRD, 10]
Access For All Digital Resource Description (DRD) v2.0 Information Model v1.0, R.Schwerdtfeger, M.Rothberg and C.Smythe, Final Release, IMS Global Learning Consortium, April 2010.
[AfADRD, 12]
IAccess For All Digital Resource Description (DRD) v3.0 Information Model v1.0, R.Schwerdtfeger, M.Rothberg and C.Smythe, Public Draft, IMS Global Learning Consortium, September 2012.
[AfAPNP, 12]
Access For All Personal Needs & Preferences (PNP) v3.0 Information Model v1.0, R.Schwerdtfeger, M.Rothberg and C.Smythe, Public Draft, IMS Global Learning Consortium, September 2012.
[I-BAT, 06] IMS Global Binding Auto-generation Toolkit Manual v1.0, C.Smythe, IMS Global Learning Consortium, July 2006.
[SDN11, 06]
IMS Global Specification Note 11: Vocabulary Definition, Registration & Maintenance Procedures, C.Smythe, IMS Global Learning Consortium, October 2006.
top | toc

2. Platform Specific Model of the Binding

2.1 Full Data Model Description

The data model for the AfA DRD is shown in Figures 2.1, 2.2, 2.3, 2.4, 2.5 and 2.6.

Figure 2.1 The PSM representation of the root structure in the AFA DRD data model.

Figure 2.2 The PSM representation of the 'AccessModeValue' and 'APIInteroperableValue' structures in the AFA DRD data model.

Figure 2.3 The PSM representation of the 'AdaptationTypeValue' structure in the AFA DRD data model.

Figure 2.4 The PSM representation of the 'AdaptationDetailValue' and 'AdaptationMediaTypeValue' structures in the AFA DRD data model.

Figure 2.5 The PSM representation of the 'ControlFlexibilityValue' and 'DisplayTransformablityValue' structures in the AFA DRD data model.

Figure 2.6 The PSM representation of the 'EducationalComplexityValue' and 'HazardValue' structures in the AFA DRD data model.

2.2 Core Profile Data Model Description

The data model for the AfA DRD Core Profile is shown in Figure 2.7.

Figure 2.7 The PSM representation of the data model description for the Core Profile for the AfA DRD.

top | toc

3. Application of the Binding Guidelines

The Key for Tables 3.1 and 3.2 is:

  1. The 'PSM Reference' field refers to information in the PSM description (Section 2 in this document). The sub-fields are:
    1. Name – the name of the data structure in the PSM and PIM
    2. UML Type – the type of UML construct i.e. either Class or Attribute
    3. Figure – the reference Figure number in this document;
  2. The 'PIM Reference' field refers to infomation in the AfA DRD Information Model [AfADRD, 12]. The sub-fields are:
    1. Type – the type of the data structure in the Information Model
    2. Table – the reference number of Tabular description in the corresponding Information Model document;
  3. The 'XSD Reference' field refers to infrmation in the XSD descriptions (Section 4 in this document). The sub-fields are:
    1. Name – the name of the field in the XSD(s)
    2. Type – the type of XSD construct i.e. either a ComplexType or Element.

3.1 Full Specification

The mapping between the PIM and PSM descriptions is detailed in Table 3.1.

Table 3.1 Mapping between the PIM, PSM and XSD descriptions for the full specification data model.

PSM Reference PIM Reference XSD Reference
Name UML Type Figure Type Table Name Type

AccessForAllResource

Class 2.1
AccessForAllResource
3.2 AccessForAllResource.Type ComplexType
  • accessMode
Attribute 2.1 AccessModeValue* 3.3 accessMode Element
  • accessModeAdapted
Attribute 2.1 AccessModeValue* 3.4 accessMode Element
  • adaptationType
Attribute 2.1 AdaptationTypeValue* 3.8 adaptationType Element
  • atInteroperable
Attribute 2.1 Boolean 3.10 atInteroperable Element
  • controlFlexibility
Attribute 2.1 ControlFlexibilityValue* 3.11 controlFlexibility Element
  • displayTransformability
Attribute 2.1 DisplayTransformabilityValue* 3.12 displayTransformability Element
  • educationalComplexityOfAdaptation
Attribute 2.1 EducationalComplexityValue* 3.13 educationalComplexityOfAdaptation Element
  • hasAdaptation
Attribute 2.1 URI 3.15 hasAdaptation Element
  • hazard
Attribute 2.1 HazardValue 3.16 hazard Element
  • isAdaptationOf
Attribute 2.1 URI 3.17 isAdaptationOf Element
  • languageOfAdaptation
Attribute 2.1 NormalizedString 3.20 languageOfAdaptation Element
  • adaptationDetail
Attribute 2.1 AdaptationDetailValue* 3.6 adaptationDetail Element
  • adaptationMediaType
Attribute 2.1 AdaptationMediaTypeValue* 3.7 adaptationMediaType Element
  • apiInteroperable
Attribute 2.1 APIInteroperableValue* 3.9 apiInteroperable Element
  • educationalLevelOfAdaptation
Attribute 2.1 NormalizedString 3.14 educationalLevelOfAdaptation Element
  • isFullAdaptationOf
Attribute 2.1 URI 3.18 isFullAdaptationOf Element
  • isPartialAdaptationOf
Attribute 2.1 URI 3.19 isPartialAdaptationOf Element
  • extension
Attribute 2.1 Namespace Extension 3.21 extension Element

* denotes that the associated vocabulary is defined in the AfA DES document [AfADES, 12].

3.2 Core Profile

The mapping between the PIM and PSM descriptions is detailed in Table 3.2.

Table 3.2 Mapping between the PIM, PSM and XSD descriptions for the core profile data model.

PSM Reference PIM Reference XSD Reference
Name UML Type Figure Type Table Name Type

AccessForAllResource

Class 2.1 and 2.7
AccessForAllResource
3.2 AccessForAllResource.Type ComplexType
  • accessMode
Attribute 2.1 and 2.7 AccessModeValue* 3.3 accessMode Element
  • accessModeAdapted
Attribute 2.1 and 2.7 AccessModeValue* 3.4 accessMode Element
  • adaptationType
Attribute 2.1 and 2.7 AdaptationTypeValue* 3.8 adaptationType Element
  • atInteroperable
Attribute 2.1 and 2.7 Boolean 3.10 atInteroperable Element
  • controlFlexibility
Attribute 2.1 and 2.7 ControlFlexibilityValue* 3.11 controlFlexibility Element
  • displayTransformability
Attribute 2.1 and 2.7 DisplayTransformabilityValue* 3.12 displayTransformability Element
  • educationalComplexityOfAdaptation
Attribute 2.1 and 2.7 EducationalComplexityValue* 3.13 educationalComplexityOfAdaptation Element
  • hasAdaptation
Attribute 2.1 and 2.7 URI 3.15 hasAdaptation Element
  • hazard
Attribute 2.1 and 2.7 HazardValue* 3.16 hazard Element
  • isAdaptationOf
Attribute 2.1 and 2.7 URI 3.17 isAdaptationOf Element
  • languageOfAdaptation
Attribute 2.1 and 2.7 NormalizedString 3.20 languageOfAdaptation Element

* denotes that the associated vocabulary is defined in the AfA DES document [AfADES, 12].

top | toc


4. XSD File Documentation

The XSD file documentation has been produced by the Oxygen XML Editing tool.

4.1 Full Data Model XSD Documentation

Click on the Section header to access this documentation for the Full data model description.

4.2 Core Profile Data Model XSD Documentation

Click on the Section header to access this documentation for the Core Profile data model description.

top | toc


5. Vocabularies

The vocabulary terms in the XSD binding are as defined in the information model [AfADES, 12]. When proprietary vocabulary terms are required, these must have the prefix 'ext:'. For example a new vocabualry term 'myAudio' would have the value 'ext:myAudio'. The use of the 'ext:' prefix is required by the full model XSD.

top | toc

Appendix A - Listing of the XSDs

The XSD files are:

This file was generated by the I-BATv1.0 tool using the PSM representation described in Section 2. Documentation of the XSDs is supplied in Section 4.

top | toc

About This Document

Title
IMS Global Access for All (AfA) Digital Resource Description (DRD) XSD Binding
Editor
Colin Smythe (IMS Global)
Co-Chairs
Madeleine Rothberg (WGBH), Richard Schwerdtfeger (IBM)
Version
3.0
Version Date
13 September 2012
Release
Final 1.0
Status
Public Draft
Summary
This document contains the IMS Global Access For All Digital Resource Description Specification XML Schema Definition (XSD) Binding v3.0.   This part of the Access For All specification provides a common language to describe digital learning resources to facilitate matching of those resources to learners’ accessibility needs and preferences.
Revision Information
This version supersedes the IMS Access for All (AfA) Digital Resource Description v2.0 specification.
Purpose
This document is made available for adoption by the public community at large.
Document Location
http://www.imsglobal.org/lafa/afav3p0/imsafadrdv3p0_BindPDv1.0.html

top | toc

List of Contributors

The following individuals contributed to the development of this document:

Name
Organization
Anastasia Cheetham
OCAD University (Canada)
Andy Heath
Axelrod Access for All (UK)
JoAnna Hunt
Blackboard (USA)
Madeleine Rothberg
WGBH (USA)
Richard Schwerdtfeger
IBM (USA)
Colin Smythe
IMS Global Learning Consortium, Inc.

top | toc

Revision History

Version No.
Release Date
Comments
Pubic Draft 1.0
13 September 2012
The first formal release of the Public Draft version of this document.






top | toc

IMS Global Learning Consortium, Inc. (“IMS Global”) is publishing the information contained in this document (“Specification”) for purposes of scientific, experimental, and scholarly collaboration only.
IMS Global makes no warranty or representation regarding the accuracy or completeness of the Specification.
This material is provided on an “As Is” and “As Available” basis.
The Specification is at all times subject to change and revision without notice.
It is your sole responsibility to evaluate the usefulness, accuracy, and completeness of the Specification as it relates to you.
IMS Global would appreciate receiving your comments and suggestions.
Please contact IMS Global through our website at http://www.imsglobal.org
Please refer to Document Name: IMS Global AfA DRD v3.0 XSD Binding Public Draft v1.0
Date: 13 September 2012.