Sharable Content Object Reference Model
Content Aggregation Model
NOVEMBER 16 , 2006
VERSION 1 . 0
®
©2006 Advanced Distributed Learning. All Rights Reserved.
This page intentionally left blank.
2006 Advanced Distributed Learning. All Rights Reserved.
This page intentionally left blank.
Chief Technical Architect Philip Dodds
Technical Editor Schawn E. Thropp
Acknowledgements
ADL would like to thank the following organizations and their members for their continued commitment to building interoperable e-learning standards and specifications:
Aviation Industry CBT Committee (AICC) (http://www.aicc.org/)
Institute of Electrical and Electronics Engineers (IEEE) Learning Technology Standards Committee (LTSC) (http://ltsc.ieee.org/)
IMS Global Learning Consortium, Inc. (http://www.imsglobal.org/)
ADL would also like to thank the ADL Community for their commitment and contribution to the evolution of SCORM.
SCORM® 2004 3rd Edition documentation suite reprinted with permission from IEEE Std. 1484.11.1-2004 IEEE Standard for Learning Technology – Data Model for Content to Learning Management System Communication, Copyright 2004, by IEEE; IEEE Std. 1484.11.2-2003 IEEE Standard for Learning Technology – ECMAScript Application Programming Interface for Content to Runtime Services Communication, Copyright 2003, by IEEE; IEEE Std. 1484.12.1-2002 IEEE Standard for Learning Object Metadata, Copyright 2002, by IEEE; and IEEE Std.
1484.12.3-2005 IEEE Standard for Learning Technology – Extensible Markup Language (XML) Schema Definition Language Binding for Learning Object Metadata, Copyright 2005, by IEEE. The IEEE disclaims any responsibility or liability resulting from the placement and use in the described manner.
SCORM® 2004 3rd Edition documentation suite reprinted with permission from IMS Content Packaging v1.1.4 Copyright 2004, by IMS Global Learning Consortium Inc. and IMS Simple Sequencing v1.0 Copyright 2003, by IMS Global Learning Consortium Inc. IMS Global Learning Consortium has made no inquiry into whether or not the implementation of third party material included in this document would infringe upon the intellectual property rights of any party. 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 document set forth in this document, and to provide supporting documentation to IMS. This material is being offered without any warranty whatsoever, and in particular, any warranty of non-infringement is expressly disclaimed. Any use of this material shall be made entirely at the implementer’s own risk, and neither the IMS Global Learning 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 material.
COPYRIGHT
Copyright 2006 Advanced Distributed Learning Initiative (ADL). All rights reserved.
DISTRIBUTION
Permission to distribute this document is granted under the following stipulations:
The use of this document, its images and examples is for non-commercial, educational or informational purposes only.
The document, its images and examples are intact, complete and unmodified. The complete cover page, as well as the COPYRIGHT, DISTRIBUTION and REPRODUCTION sections, are consequently included.
REPRODUCTION
Permission to reproduce this document completely or in part is granted under the following stipulations:
The reproduction is for non-commercial, educational or informational purposes only.
Appropriate citation of the source document is used as follows:
Source: Advanced Distributed Learning (ADL), Sharable Content Object Reference Model (SCORM®) 2004 3rd Edition Content Aggregation Model Version 1.0, 2006.
For additional information or questions regarding copyright, distribution and reproduction, contact:
ADL Co-Laboratory Hub
1901 North Beauregard Street, Suite 600
Alexandria, Virginia 22311 USA
703-575-2000
SECTION 1 SCORM® CONTENT AGGREGATION MODEL (CAM) OVERVIEW 1-1
SECTION 3 SCORM® CONTENT PACKAGING 3-1
SECTION 5 SCORM® SEQUENCING AND PRESENTATION 5-1
APPENDIX A ACRONYM LISTING................................................................................................... A-1
APPENDIX B REFERENCES............................................................................................................... B-1
REFERENCES ........................................................................................................................................... B-3 APPENDIX C DOCUMENT REVISON HISTORY ............................................................................. C-1
Figure 1.1a: The SCORM Content Aggregation Model Book as Part of the SCORM Bookshelf 1-3
Figure 2.1.1a: Examples of Assets 2-3
Figure 2.1.2a: Conceptual Makeup of a SCO 2-4
Figure 2.1.3a: Conceptual Representation of Activities 2-5
Figure 2.1.4a: Conceptual Illustration of a Content Organization 2-6
Figure 2.1.5a: Conceptual Illustration of a Content Aggregation 2-8
Figure 3.2a: Content Package Conceptual Diagram 3-4
Figure 3.3a: Components of a Manifest 3-7
Figure 3.3.2.3.1a: IMS Content Hierarchy Terminology 3-12
Figure 3.3.3a: Conceptual Illustration of Manifest Resources 3-15
Figure3.5.1a: Example of an Asset Represented as a <file> Element 3-53
Figure 3.5.1b: Example of an Asset Represented as a <resource> Element 3-54
Figure 3.5.1c: Example of a SCO Represented as a <resource> Element 3-55
Figure 3.5.2a: Example of a Content Aggregation Content Package and its Components 3-56
Figure 4.5.1a: Application of Metadata Describing a Content Aggregation 4-87
Figure 4.5.2a: Application of Metadata Describing a Content Organization 4-88
Figure 4.5.13a: Application of Metadata Describing an Activity 4-89
Figure 4.5.4a: Application of Metadata Describing a SCO 4-90
Figure 4.5.5a: Application of Metadata Describing Assets 4-91
Figure 5.3a: Sequencing Rules and Content Packaging Structure Relationship 5-47
Table 3.3.2.3a: Example of Curricular Taxonomy Models 3-11
Table 3.4.1a: SCORM Content Packaging Application Profile Table Format 3-18
Table 3.4.1b: Explanation of Content Packaging Application Profile Multiplicity Requirements 3-18
Table 3.5.3a: SCORM Content Package Application Profile Manifest Element Requirements 3-57
Table 4.2a: Explanation of Multiplicity Requirements 4-5
This page intentionally left blank.
SCORM® Content Aggregation Model (CAM) Overview
From IEEE Std. 1484.11.1-2004 IEEE Standard for Learning Technology – Data Model for Content to Learning Management System Communication, Copyright 2004 IEEE; IEEE Std. 1484.11.2-2003 IEEE Standard for Learning Technology – ECMAScript Application Programming Interface for Content to Runtime Services Communication, Copyright 2003 IEEE; IEEE Std. 1484.12.1- 2002 IEEE Standard for Learning Object Metadata, Copyright 2002 IEEE; and IEEE Std. 1484.12.3-2005 IEEE Standard for Learning Technology – Extensible Markup Language (XML) Schema Definition Language Binding for Learning Object Metadata, Copyright 2005 IEEE. All rights reserved.
From IMS Content Packaging v1.1.4 Copyright 2004, by IMS Global Learning Consortium Inc. and IMS Simple Sequencing v1.0 Copyright 2003, by IMS Global Learning Consortium Inc. All rights reserved.
This page intentionally left blank.
Introduction to the SCORM Content Aggregation Model (CAM) Book
The Sharable Content Object Reference Model (SCORM) is often described as a set of books on a bookshelf. The Content Aggregation Model (CAM) book is one of a set of books (refer to Figure 1.1a: The Content Aggregation Model Book as Part of the SCORM Bookshelf). More information on the other SCORM books and their relationships to one another can be found in the SCORM 2004 3rd Edition Overview book. The SCORM CAM book describes the components used in a learning experience, how to package those components for exchange from system to system, how to describe those components to enable search and discovery and how to define sequencing information for the components. The SCORM CAM promotes the consistent storage, labeling, packaging, exchange and discovery of learning content.
Figure 1.1a: The SCORM Content Aggregation Model Book as Part of the SCORM Bookshelf
What is Covered in the SCORM Content Aggregation Model (CAM) Book?
There are several key concepts that are introduced in the SCORM CAM book. The book describes responsibilities and requirements for building content and content organizations (e.g., course, lessons, modules, etc.). The book contains information on creating content packages, applying metadata to the components in the content package and applying sequencing and navigation details in the context of a content package. SCORM Content Packaging, as described in this book, provides a consistent form for describing content structures, learning content, the metadata that describes the various components of the content structures and sequencing and navigation rules. This consistency facilitates
search and discovery of content packages and their resources (helping facilitate reuse of SCORM conformant content), building of content organizations that will behave in a similar manner from system to system and standard understanding of the contents of the content package. General subjects discussed include:
Content Model: Definition of common terminology used throughout the CAM book.
Content Packaging: Descriptions and requirements for aggregating and bundling learning content.
Metadata: Descriptions and requirements for describing SCORM components.
Sequencing and Navigation: Descriptions and requirements for defining sequencing and navigation information.
Using the SCORM CAM Book
This book will assist authoring tool vendors, content developers and anyone else wishing to create, edit or use:
SCORM Content Model Components (Assets, Sharable Content Objects (SCOs), Activities, Content Organizations and Content Aggregations),
SCORM Content Packages (with or without sequencing and navigation information), or
Metadata
Various requirements are defined throughout the book that describes how to create, edit or use content packages, metadata and content model components.
Early portions of this book, Section 1: The SCORM® Content Aggregation Model (CAM) Overview through Section 2: The SCORM® Content Model, cover general SCORM CAM-related concepts. These sections are recommended reading for those seeking an introduction to the concepts behind the SCORM CAM and who may not wish to delve into its technical details. Others who may find these sections useful include those wishing to learn about updates to the SCORM CAM. Section 2.1.3: Content Organization, for instance, discusses how Activities affect the SCORM CAM.
Section 3: SCORM® Content Packaging is the first section of this book providing technical details specific to the CAM. It describes Manifests, Content Packages, SCORM Content Aggregation Content Package Application Profile, SCORM Resource Content Package Application Profile and Best Practices and Practical Guidelines. This section covers not only the technical details about the various individual components of SCORM Content Packages, but it also covers how to assemble content packages, showing code illustrations of manifests with explanations.
Section 4: Metadata covers all aspects of creating metadata for labeling purposes, to include Learning Object Metadata (LOM) Extensible Markup Language (XML) validation approaches and metadata extensions. The section also describes how to associate metadata to SCORM Content Model Components in a content package.
Section 5: SCORM® Sequencing and Navigation covers ways in which the introduction of sequencing and navigation information affects the SCORM CAM. The section also outlines how to build sequencing and navigation information in XML and how to place those rules in a content package manifest. The section describes the requirements for building XML that represents the desired sequencing strategies.
Relationship with Other SCORM Books
While the various SCORM books are intended to stand alone, there are areas of overlap or mutual coverage. For instance, while this book focuses primarily on elements of SCORM content such as SCOs and Assets, those objects are launched by SCORM conformant Learning Management Systems (LMSs), and so the SCORM Run-Time Environment (RTE) book [2], covering content launch is mentioned numerous times.
Similarly, while the Sequencing and Navigation (SN) book covers the details of SCORM sequencing and navigation processes, including detailed coverage of how an LMS evaluates navigation requests and related activities, this book deals with manifests which contain the sequencing information described by the SCORM SN book, and so some of the basics of sequencing and navigation are touched on.
To help clarify areas of overlap, Section 1.1.3.1: The SCORM Run-Time Environment Book and Section 1.1.3.2: The SCORM Sequencing and Navigation Book provides brief descriptions of the contents of these SCORM books.
The SCORM Run-Time Environment Book
The purpose of the SCORM RTE book is to provide a means for interoperability between SCOs and LMSs. SCORM provides a means for learning content to be interoperable across multiple LMSs regardless of the tools used to create the content. For this to be possible, there must be a common way to launch content, a common way for content to communicate with an LMS and predefined data elements that are exchanged between an LMS and content during its execution. The three components of the SCORM RTE are defined in this document as Launch, Application Program Interface (API) and Data Model. The technical details of these elements are described in the SCORM RTE book, but a brief overview of each of these elements of the RTE follows.
Launch includes defining the relationship between LMSs and SCORM content such that all SCORM conformant content is dependant upon a SCORM conformant LMS to be delivered and displayed to the learner. In addition, LMSs have the responsibility to determine which SCORM content is to be delivered next. These new responsibilities, described in the SCORM SN book, are also touched on in the SCORM RTE book.
The SCORM API, as described in the SCORM RTE book, provides a set of predefined methods that are agreed upon by both LMS vendors and content authoring tool vendors to be made available for purposes of communication between an LMS and the SCOs it launches. These functions complete the launch process by providing a means to establish a “handshake” between the SCO and the LMS that launched it, and to break that
handshake when the learning session with the SCO is terminated. In addition, they provide the means for SCORM content to “set” and “get” data on the LMS, such as assessment results, and to check for and warn the user about any errors that may occur during these processes.
The SCORM RTE Data Model, as described in the SCORM RTE book, provides the data elements that can be used to “get” and “set” data from and to an LMS. For instance, when passing a test score from a learner, a SCO would use the SCORM RTE Data Model element known as cmi.score.scaled to inform the LMS how a user performed in the test. This and all other SCORM Run-Time Environment Data Model elements are described in detail in the SCORM RTE book.
Various concepts described in the SCORM CAM book have impacts on the SCORM RTE. Data defined in a content package manifest impact some initial values for some of the SCORM Run-Time Environment Data Model elements. Data from the manifest is used in the process of delivering and launching content to the learner and impacts the run-time environment. These and other relationships are described throughout the CAM.
The SCORM Sequencing and Navigation Book
The SCORM SN book is based on the IMS Simple Sequencing (SS) Specification Version 1.0, which defines a method for representing the intended behavior of an authored learning experience such that any SCORM conformant LMS will sequence discrete learning activities in a consistent way.
The SCORM SN Model defines how IMS SS applies and is extended in a SCORM environment. It defines the required behaviors and functionality that SCORM conformant LMSs must implement to process sequencing information at run-time. More specifically, it describes the branching and flow of learning activities in terms of an Activity Tree, based on the results of a learner’s interactions with launched content objects and an authored sequencing strategy. An Activity Tree is a conceptual structure of learning activities managed by the LMS for each learner.
The SCORM SN book describes how learner-initiated and system-initiated navigation events can be triggered and processed, resulting in the identification of learning activities for delivery. Each learning activity identified for delivery will have an associated content object. The SCORM RTE book describes how identified content objects are launched.
The sequence of launched content objects, for a given learner and content structure, provides a learning experience (learner interaction with content objects); the SCORM RTE model describes how the LMS manages the resulting learning experience and how that learning experience may affect the Activity Tree.
Various concepts described in the SCORM CAM book have relationships to the SCORM SN book. The SCORM CAM describes how to build sequencing information and represent that information in Extensible Markup Language (XML). The SCORM CAM then describes how to build onto the existing manifest to apply the sequencing information. The SCORM SN book contains more details on the relationship between
the XML binding of the sequencing information and the processes and behaviors of that information.
The SCORM Content Aggregation Model
The SCORM CAM represents a learning taxonomy neutral means for designers and implementers of instruction to aggregate learning resources for the purpose of delivering a desired learning experience. A learning resource is any representation of information that is used in a learning experience. Learning experiences consist of activities that are supported by electronic or non-electronic learning resources.
One activity in the process of creating and delivering learning experiences involves the creation, discovery and gathering together, or aggregation, of simple assets into more complex learning resources and then organizing the resources into a predefined sequence of delivery. The SCORM CAM supports this process and is made up of the following:
Content Model: Nomenclature defining the content components of a learning experience.
Content Packaging: Defines how to represent the intended behavior of a learning experience (Content Structure) and how to aggregate activities of learning resources for movement between different environments (Content Packaging).
Metadata: A mechanism for describing specific instances of the components of the content model.
Sequencing and Navigation: A rule-based model for defining a set of rules that describes the intended sequence and ordering of activities. The activities may or may not reference learning resources to be delivered to the learner.
The SCORM® Content Model
From IEEE Std. 1484.11.1-2004 IEEE Standard for Learning Technology – Data Model for Content to Learning Management System Communication, Copyright 2004 IEEE; IEEE Std. 1484.11.2-2003 IEEE Standard for Learning Technology – ECMAScript Application Programming Interface for Content to Runtime Services Communication, Copyright 2003 IEEE; IEEE Std. 1484.12.1- 2002 IEEE Standard for Learning Object Metadata, Copyright 2002 IEEE; and IEEE Std. 1484.12.3-2005 IEEE Standard for Learning Technology – Extensible Markup Language (XML) Schema Definition Language Binding for Learning Object Metadata, Copyright 2005 IEEE. All rights reserved.
From IMS Content Packaging v1.1.4 Copyright 2004, by IMS Global Learning Consortium Inc. and IMS Simple Sequencing v1.0 Copyright 2003, by IMS Global Learning Consortium Inc. All rights reserved.
This page intentionally left blank.
SCORM Content Model Components
The SCORM Content Model describes the SCORM components used to build a learning experience from learning resources. The Content Model also defines how these lower- level sharable, learning resources are aggregated and organized into higher-level units of instruction. The SCORM Content Model is made up of Assets, Sharable Content Objects (SCOs), Activities, Content Organization and Content Aggregations.
Asset
The Asset is the basic building block of a learning resource. Assets are an electronic representation of media, such as text, images, sound, assessment objects or any other piece of data that can be rendered by a Web client and presented to a learner (refer to Figure 2.1.1a). More than one asset can be collected together to build other assets. In some cases, Assets may be launched as part of the learning experience.
Figure 2.1.1a: Examples of Assets
An Asset can be described with metadata (Refer to the Asset Metadata definition below) to allow for search and discovery within repositories, thereby enabling opportunities for reuse and facilitating maintenance.
Sharable Content Object (SCO)
A SCO is a collection of one or more Assets that represent a single launchable learning resource that uses the SCORM RTE to communicate with an LMS. A SCO represents the lowest level of granularity of a learning resource that is tracked by an LMS using the SCORM Run-Time Environment Data Model. The only difference between a SCO and an Asset is that the SCO communicates with an LMS using the Institute for Electrical and Electronics Engineers (IEEE) ECMAScript Application Programming Interface for Content to Runtime Services Communication standard [1]. Figure 2.1.2a below shows an example of a SCO composed of several Assets.
To improve reusability, a SCO should be independent of its learning context. For example, a SCO could be reused in different learning experiences to fulfill different learning objectives. In addition, an Activity may aggregate more than one SCO resource (and/or Asset resource) to form a higher-level unit of instruction or training that fulfills higher level learning objectives.
SCOs are intended to be subjectively small units, such that potential reuse across multiple learning contexts is feasible. SCORM does not impose any particular constraints on the exact size of a SCO. During content design and authoring activities, when determining the size of a SCO, thought should be given to the smallest logical size of content to be tracked by an LMS at run-time. Reuse requirements for an organization will impact decisions about the size of SCOs. Other factors that may impact the decisions about the size of SCOs include how much information is required to achieve a learning outcome and the point where a branching decision is required for sequencing.
A SCO can be described with metadata (refer to the SCO Metadata definition below) to allow for search and discovery within repositories, thereby enabling opportunities for reuse.
Figure 2.1.2a: Conceptual Makeup of a SCO
A SCO is required to adhere to the requirements defined in the SCORM RTE book [2]. This implies that it must have a means to locate an LMS provided API Instance and must invoke the minimum API methods (Initialize(“”) and Terminate(“”) ). There is no obligation to invoke any of the other API methods as those are optional and depend upon the nature of the content.
The requirement that a SCO must utilize the SCORM RTE yields the following benefits:
Any LMS that supports the SCORM RTE can launch SCOs and track them, regardless of who generated them.
Any LMS that supports the SCORM RTE can track any SCO and know when it has been started and when it has ended.
Any LMS that supports the SCORM RTE can launch any SCO in the same way.
Activities
A learning activity may be loosely described as a meaningful unit of instruction; it is conceptually something the learner does while progressing through instruction. A learning activity may provide a learning resource (SCO or Asset) to the learner or it may be composed of several sub-activities.
Figure 2.1.3a: Conceptual Representation of Activities
The Activities represented in a Content Organization may consist of other Activities (sub- Activities), which may themselves consist of other activities. There is no set limit to the number of levels of nesting for Activities. While a specific learning taxonomy may be associated with hierarchical levels of Activities, (e.g., course, chapter, module, etc.), this is not a requirement. Activities that do not consist of other Activities (leaf activities) will have an associated learning resource (SCO or Asset) that is used to perform the activity.
Activities that consist of other Activities are also called Clusters. Refer to the SCORM SN book for more details on how behaviors can be defined for Activities and Clusters.
Each Activity in a Content Organization can reference metadata to allow for search and discovery within repositories, thereby enabling opportunities for reuse and facilitating maintenance.
Content Organization
A Content Organization is a representation or map that defines the intended use of the content through structured units of instruction (Activities). The map shows how Activities relate to one another. Figure 2.1.4a below shows an example of a Content Organization.
Figure 2.1.4a: Conceptual Illustration of a Content Organization
Content Organization can be described with metadata, thereby enabling opportunities for reuse and facilitating maintenance.
Sequencing only applies to Activities. The intended sequencing of Activities is defined as part of the Content Organization, by structuring Activities in relation to one another and by associating sequencing information with each Activity. The LMS is responsible for interpreting the sequencing information described in the Content Organization and applying sequencing behaviors to control the actual sequence of the learning resources at run-time.
This development strategy represents a departure from the way courseware has been developed using stand-alone computer-based training (CBT) authoring tools. In the past, these tools typically embedded all of the sequencing and navigation information that
governs what part of the course the student will view next in proprietary data formats. In nearly all cases, authoring tools or systems defined and implemented proprietary and sometimes unique sequencing methods for content. Before the arrival of SCORM and the shift toward an interoperable development strategy, it was extremely difficult to share content between different authoring environments and equally difficult to reuse content in other contexts that involved different sequencing requirements.
Within SCORM, sequencing information is defined on the Activities represented in the Content Organization and is external to the learning resources associated with those Activities. It is the responsibility of the LMS to launch learning resources associated with the activities in response to applying the defined sequencing behaviors. This is conceptually important because learning resource reuse is limited if a learning resource has embedded sequencing information that is context-specific to the course. For example, if a learning resource contained a “hardwired” branching to another learning resource under specific conditions, it could not be used in a different course in which the second learning resource might not be applicable or available. The reusability of a learning resource depends on it being independent and self-contained.
SCORM recognizes, however, that some learning resources may contain internal logic to accomplish a particular learning task. Such a learning resource might branch within itself depending on user interactions. These branches are all self-contained, relevant to a stand- alone learning resource and are not usually visible to the LMS. Importantly, internal branching must not reference external learning resources that may or may not be present in other content organizations. This is an important area that content developers should pay attention to when determining what learning resources should be used and how they are to be aggregated.
Content Aggregation
Content Aggregation can be used as both an action and as a way of describing a conceptual entity. Content Aggregation can be used to describe the action or process of composing a set of functionally related content objects so that the set can be applied in a learning experience. In terms of the SCORM Content Model, a Content Aggregation is also used to describe the entity created as part of this process or action. Sometimes the term is loosely used to describe the content package. The Content Aggregation can then be used to deliver the content and prescribed content structure, transferred between systems or even stored in a repository.
Figure 2.1.5a: Conceptual Illustration of a Content Aggregation
SCORM® Content Packaging
From IEEE Std. 1484.11.1-2004 IEEE Standard for Learning Technology – Data Model for Content to Learning Management System Communication, Copyright 2004 IEEE; IEEE Std. 1484.11.2-2003 IEEE Standard for Learning Technology – ECMAScript Application Programming Interface for Content to Runtime Services Communication, Copyright 2003 IEEE; IEEE Std. 1484.12.1- 2002 IEEE Standard for Learning Object Metadata, Copyright 2002 IEEE; and IEEE Std. 1484.12.3-2005 IEEE Standard for Learning Technology – Extensible Markup Language (XML) Schema Definition Language Binding for Learning Object Metadata, Copyright 2005 IEEE. All rights reserved.
From IMS Content Packaging v1.1.4 Copyright 2004, by IMS Global Learning Consortium Inc. and IMS Simple Sequencing v1.0 Copyright 2003, by IMS Global Learning Consortium Inc. All rights reserved.
This page intentionally left blank.
3.1. Content Packaging Overview
Once learning content is designed and built, there is a need to make the content available to learners, authoring tools, repositories or LMSs. The IMS Content Packaging Specification was designed to provide a standard way to structure and exchange learning content.
The purpose of the Content Package is to provide a standardized way to exchange learning content between different systems or tools. The Content Package also provides a place for describing the structure (or organization) and the intended behavior of a collection of learning content.
Content packages are expected to be used to move learning content or collections of learning content between LMSs, development tools and content repositories. The IMS Content Packaging Specification [3] provides a common “input/output” format that any system can support.
SCORM Content Packaging is a set of specific requirements and guidance, or application profiles, of the IMS Content Packaging Specification. SCORM Content Packages adheres strictly to the IMS Content Packaging Specification and provides additional explicit requirements and implementation guidance for packaging Assets, SCOs and Content Organization.
This section is organized as follows:
Section 3.2: Content Package Components defines the key concepts that deal with a content package. These key concepts are useful for getting a base understanding of a content package before describing the specific requirements.
Section 3.3: Components of a Manifest defines the makeup of a Content Package manifest. The manifest acts as the “packaging slip” for the content package. It describes the components of the content package.
Section 3.4: Building Content Packages defines the process of building a content package. The section focuses on the creation of the content package and the manifest file. The section describes the XML components of the manifest and the requirements for using those XML components.
Section 3.5: SCORM Content Package Application Profiles defines specifically how to create SCORM conformant packages that contain Assets, SCOs and Content Organizations. This section describes the two types of application profiles and the requirements associated with those profiles.
Section 3.6: Best Practices and Practical Guidelines defines a collection of best practices and guidelines when building or processing content packages.
Content Package Components
This section contains an overview of content packages, the nomenclature used to describe content packages and the makeup of content packages. The IMS Content Packaging Specification describes data structures that are used to provide interoperability of
Internet-based content with authoring tools, LMSs and run-time environments. The objective of the IMS Content Packaging Specification is to define a standardized set of structures that can be used to exchange content. The scope of the IMS Content Packaging Specification is focused on defining interoperability between systems that wish to import, export, aggregate and disaggregate content packages.
A Content Package contains two major components:
A special XML document describing the content structure and associated resources of the package called the manifest file (imsmanifest.xml). Refer to Section 3.3: Components of a Manifest for more details on manifests. A manifest is required to be present at the root of the content package.
The content (i.e., physical files) making up the content package.
Figure 3.2a is a conceptual diagram that illustrates the components of a Content Package.
Figure 3.2a: Content Package Conceptual Diagram
Package
A package represents a unit of learning. The unit of learning may be part of a course that has instructional relevance outside of a course organization and can be delivered independently, as a portion of a course, an entire course or as a collection of courses.
Once a package arrives at its destination, the package must allow itself to be disaggregated or aggregated. A package must be able to stand alone; that is, it must contain all the information needed to use the packaged contents for learning when it has been unpacked.
Manifest
A manifest is an XML document that contains a structured inventory of the content of a package. If the content package is intended for delivery to an end user, the manifest also contains information about how the content is organized.
The scope of a manifest is elastic. A manifest can describe part of a course that can stand by itself outside of the context of a course (an “instructional object”), an entire course, a collection of courses, or just a collection of content that is to be shipped from one system to another. When packaging a collection of courses, such a content package would typically have to be disaggregated in order to be delivered to learners in a practical LMS run-time system. How to do this disaggregation is out of scope with this version of SCORM. At this point there is no consensus or standard on how to publish a very large or very complex package in a practical LMS, because different LMS systems and repositories use different methods to represent or store the learning content to deliver to learners.
The general rule is that a package always contains a single top-level manifest that may contain one or more (sub)manifests. The top-level manifest always describes the package. Any nested (sub)manifests describe the content at the level at which the (sub)manifest is scoped, such as course, instructional object or other.
ADL Note: The IMS Global Consortium, Inc., is working on a new version of the IMS Content Packaging Specification. One of the major issues that IMS is resolving deals with (sub)manifests, their use, requirements of use and XML syntax requirements. At this time, ADL recommends not to use (sub)manifests until completion of the IMS work. Any questions, concerns or further recommendations on (sub)manifests should be sent to ADL.
The manifest shall adhere to the following requirements (as defined by the IMS Content Packaging Specification):
The manifest file shall be named imsmanifest.xml.
The imsmanifest.xml and any of its supporting control files (e.g., DTD, XSD) shall be at the root of the content package. If extensions are used to describe organizational defined features and those features are represented in XML, then any and all control files also are required to be at the root of the package. This
includes any and all control files needed to validate XML instances including those referenced by the <adlcp:location> element.
All requirements defined in the IMS Content Packaging XML Binding Specification, any restrictions and additional requirements to the IMS binding as
defined in Section 3.4: Building Content Packages.
Package Interchange File (PIF)
The Package Interchange File (PIF) is a binding of the content package components in the form of a compressed archive file. The PIF contains the imsmanifest.xml, all control files and the resources referenced in the content package (those that are local to the PIF, i.e., contained in the content package). SCORM recommends that content packages be created as PIFs. The PIF provides a concise Web delivery format that can be used to transport content packages between systems. If a PIF is used for representing the content package, SCORM requires that the PIF be conformant with RFC 1951 [12]. In addition to this requirement, SCORM mandates that the archive format be PKZip v2.04g (.zip). This .zip file is conformant to RFC1951.
Components of a Manifest
The manifest file represents the information needed to describe the contents of the package. Figure 3.3a describes the makeup of a manifest file.
Figure 3.3a: Components of a Manifest
The manifest is composed of four major sections:
Metadata: Data describing the content package as a whole.
Organizations: Contains the content structure or organization of the learning resources making up a stand-alone unit or units of instruction..
Resources: Defines the learning resources bundled in the content package.
(sub)Manifest(s): Describes any logically nested units of instruction (which can be treated as stand-alone units).
Metadata
Metadata is defined as “data about data”. The metadata depicted in Figure 3.3a is used to describe the content package (i.e., Content Aggregation) as a whole. This metadata enables the search and discoverability of the content package itself. It also enables a mechanism for describing the characteristics of the content package.
ADL Note: Metadata can also be used at various locations within the manifest to describe the different aspects of the content package (refer to Section 4.5.1: Associating Metadata with SCORM Components for more information).
Organizations
The Organizations component is used to describe how the content is organized in the content package. It may contain one or more Organization components, each of which describes a particular structure for the content of the package. The current version of the IMS Content Packaging Specification only defines one form of content organization, which is in the shape of a tree or hierarchy. Neither the IMS Content Packaging Specification, nor SCORM, specifies whether this hierarchy should represent a particular learning taxonomy or nomenclature. In other words, SCORM does not specify terms such as “module,” “lesson” and so on to describe the levels of hierarchy in a content organization. Such terms tend to be resolved in a particular way. Therefore, the choice of nomenclature is left to the content developer.
Multiple Content Organizations
The IMS Content Packaging Specification separates learning resources from the way those resources are organized, allowing for a single content package to have one or more organizations using the same learning resources within different contexts or uses.
In order to deliver the content package to a learner in an LMS, there must be at least one content organization. In some cases, it is useful to define different ways to use the content in a package. Each of these ways is represented in a different content organization. When a content package has several content organizations, at least one organization must be designated as the default organization, in order to avoid having the system processing the content package decide which content organization to use.
Content Organization
The content organization describes how the content of the content package is organized for use. In SCORM Version 1.2, the only defined use for a content organization was as a kind of table of contents for the resources in the content package. In SCORM 2004, the content organization is also used as a way to describe a hierarchy of learning activities that exploit the learning resources. These resources are described in another part of the manifest.
The content organization should not be confused with the physical structure of the content package, or with the structure of the manifest itself. For example, the files in a content package are often organized in a hierarchy of folders, but that structure in itself cannot tell the user of a content package how to use the content of the package.
The purpose of the content organization is to provide the content developer with the means to specify cohesive units of instruction that use collections of learning resources. Such a unit of instruction is a hierarchy of learning activities, for which specific behaviors and rules may be prescribed in such a way that this activity structure and the associated behaviors can be reproduced in any SCORM conformant LMS environment.
For any activity defined in a content organization, the content developer may or may not define specific behaviors and rules. In the absence of specific rules, the content
organization is just a map that can be used to navigate at will through the learning resources defined in the content package. By adding specific rules and behaviors, the content organization becomes a guide that prescribes how an LMS must manage the learner’s experience and use of the learning resources.
A content organization can be seen as a structured map of learning resources, or a structured activity map to guide the learner through a hierarchy of learning activities that use the learning resources. One content developer may choose to structure the content organization as a table of contents for the learning resources, while another content developer may choose to structure the content organization as an adaptive guided path through a learning experience, invoking learning resources only if and when they are needed. A third content developer may create a content organization where some discovery activities include a free form use of some of the learning resources, while other activities are more formally managed.
An LMS may create its own internal representation for a content package and its contents. The specification of a content organization in SCORM does not imply that LMS systems are required to adopt the content organization model or to store the package components using the same structural organization.
The Organization component defined in the IMS Content Packaging Specification provides the framework for the information that is required to represent the content structure. By design, the Organization component also contains the ability to add, for every item in the organization, additional information such as metadata or behavior rules and prescriptions. SCORM refers to such an Organizations component, and to what it can represent as the “Content Organization.”
The Content Organization is not an inventory of the actual learning resources, and it does not describe those resources. The IMS Content Packaging model also provides a clean way to inventory and bundle all of the content (i.e., physical files) required to deliver the learning resources, as well as to identify relationships between files that belong to one or more learning resources, including externally referenced resources that are not contained as physical files within a package.
Authoring Content and Content Collections
Content organizations provide the means to represent the structure of collections of learning resources. This is a relatively new approach to designing learning content. In the past, Computer Based Training (CBT) authoring tools provided the means to create parts of a course as well as how and when those parts were to be presented to the learner. The learning resources and the content organization were usually inseparable, and developed using the same tools and proprietary data formats. The shift to Internet-based technologies and the notion of building reusable content objects changed the authoring process considerably.
Within SCORM, it is the LMS that is responsible for delivering the content according to the prescriptions embodied in the content organization. That means that the LMS must know how and when a designer intended the learning resources included in a content package to be presented to the learner. The content organization, which is located in the
organizations section of the package manifest, allows the designer to provide the LMS with this information. This means that authoring a unit of instruction consists of authoring or collecting learning resources, and also authoring a content organization that uses those learning resources – perhaps using completely different authoring tools.
In SCORM, there are two distinct products of authoring: Authored content organization information, which is used as a prescription by the LMS and processed during run-time, and authored learning resources, which are launched in a browser environment as prescribed by the content organization. Unlike many older CBT models, here the structure is separate from the content. The structure is now fully exposed and can be represented in a standardized form. Content packages can now be delivered in a predictable way, to produce comparable learning experiences in different LMS environments.
Representing Content Structure
A SCORM content organization includes components that are intended to define different aspects of a content structure:
Content Hierarchy: This is a tree-shaped representation, much like a table of contents that represents a logical organization for the learning resources or activities that use the learning resources. In many cases, but not all, this hierarchical tree can be traversed in a specific order that represents the default order in which an author intends for the learner to progress through the material.
Metadata: This is optional, context-specific descriptive data about the content structure or organization. Such metadata can be used to describe how a particular learning resource is to be used in a particular content organization (e.g., competency or objectives that may be met by a learner when the learning resource is used in a particular activity).
Sequencing, Adaptive Sequencing and Navigation: Optional prescriptions may be embedded in the content organization if the content developer wants to control which learning resources are to be presented to the learner as the learner navigates through the content. By default, if no sequencing and navigation prescription is defined, a learner may choose any content item at will. Adding specific prescriptions can alter this default behavior. For example, adding a flow prescription to the items in the content organization will direct the LMS to guide the navigation in the order defined by the organization tree. More complex adaptive sequencing can be based on the completion status of certain learning resources or on more complex computation of user preferences or assessment results.
Content Organizations are intended to represent a wide variety of approaches to the aggregation of content. A content organization can represent a content aggregation ranging from very, very small learning resources – as simple as a few lines of Hypertext Markup Language (HTML) or a short media clip – to highly interactive learning resources that are tracked by an LMS. The SCORM CAM is neutral about the
complexity of content, the number of hierarchical levels of a particular unit of instruction (i.e., taxonomy) and the instructional methodology employed.
Table 3.3.2.3a depicts examples of several possible curricular taxonomy models as used by the Armed Forces of the United States and Canada, which can be represented in a SCORM content organization.
Table 3.3.2.3a: Example of Curricular Taxonomy Models
U.S. Army | U.S. Air Force | U.S. Marine Corps | Canadian Armed Forces |
Course | Course | Course | Course |
Module | Block | Phase | Performance Objective |
Lesson | Module | SubCourse (Annex) | Enabling Objective |
Learning Objective | Lesson | Lesson | Teaching Point |
Learning Step | Learning Objective | Task | |
Learning Objective | |||
Learning Step |
Content Hierarchy
A collection of learning resources can usually be organized into a hierarchy, which can be represented as a content organization. Another approach to organizing learning resources is to define a hierarchy of activities that rely on the resources to provide a specific learning experience. In this case the top-level of the hierarchy is the main activity, which can consist of sub-activities, which can themselves consist of sub- activities. Depending on the design methodology, this hierarchical grouping might be used to represent concepts like Course, Chapter, Topic or similar terms that represent how the content is organized for delivery to a learner.
The IMS Content Packaging Specification defines a set of terms that are used in representing the content hierarchy. Figure 3.3.2.3.1a depicts how a content organization forms a hierarchical structure that maps to a collection of learning resources (as defined by the IMS Content Packaging Specification). The hierarchical structure is a tree of nested Item elements. The root of the tree is the Organization element. An Item element may reference a Resource element, which describes a specific learning resource to be launched when the Item is used as an activity. The same Resource element may be referenced by more than one Item element.
SCORM and the IMS SS Specification [5] are application profiles of the IMS Content Packaging Specification, and as such they add a couple of restrictions. One is that only leaf Items (Items that do not have children) may reference a learning resource. Another is that an Organization must contain at least one Item.
In addition, SCORM requires that a learning resource be either a SCO or an Asset. These will be described in more detail in the section on Resources.
Figure 3.3.2.3.1a: IMS Content Hierarchy Terminology
Metadata
When a learning resource is created it may be useful to describe the learning resource with metadata. It is important to keep in mind that not all learning resources may need metadata, because the learning resource may not have been built for reuse. Sometimes learning resources are developed and intended to be used in a specific context. Metadata allows the learning resource to be found when it is stored in a repository. It also makes the learning resource more reusable since one can, by inspecting the metadata, decide to reuse it without having to actually open and inspect the resource itself. Such metadata is considered context-independent, since it describes the learning resource regardless of where it can be found, independently of any particular use in the context of a specific learning strategy. For example, imagine a simple SCO that teaches how to thread a needle. Metadata describing the SCO might describe the skill to be acquired – inserting a thread through the eye of a needle – and might further describe that a simulation is part of the learning experience. This metadata does not, however, describe how the needle might be used. When the use of a learning resource is defined as part of a learning strategy, additional metadata may be used to describe the activity that uses the resource.
Metadata that is specific to a particular learning strategy is called context-specific metadata and is incorporated in the content organization. For example, the metadata may include an explanation of why that particular activity is inserted at that particular place in an instructional sequence.
Context-independent metadata usually refers to immutable metadata that describes digital assets, content objects or collections of objects. Context-dependent metadata, on the other hand, usually refers to metadata that makes sense only in the context of a particular content organization.
Developing and applying metadata to learning resources and collections of learning resources is a new concept to many. Best practices for doing this have yet to be developed. In some cases, the principal purpose for metadata is discovery and reuse of content. In other cases, it is strictly informational and provides authors with information about the design and intent of the described learning object or item in a content organization. Some have theorized that metadata could be provided to learners to help them navigate through content. No consensus on common usage of metadata has so far emerged, but provisions have been made in these specifications for a variety of potentially valuable uses of metadata.
If a content package is intended only for delivery to learners, and there is no intent to ever reorganize it or disaggregate it to reuse its components in another organization, adding detailed metadata for each element in the content package may be counter-productive, since such metadata only makes the content package and its manifest more expensive to store, transmit and manage. On the other hand, if there is any chance that the content package may have to be modified, reorganized or disaggregated for reuse at some time in the future, then it makes sense to provide metadata for every element that might be reused or need to be interpreted. In case of doubt, past experience with content seems to indicate that it is probably best to add metadata, even though they may be stripped when a streamline delivery package is required.
Sequencing, Adaptive Sequencing and Navigation
Sequencing and Navigation refers to the behaviors that an LMS must follow in order to present a specific learning experience as intended by an author or content developer.
This learning experience may be free play, in which the learner can choose any item in the content organization in any order, or it may be guided by a flow through the structure of the content organization. The learning experience can be adaptive, with different behaviors that depend on the learner’s performance or other variables that can be tracked by the LMS.
SCORM defines a default set of sequencing information that governs sequencing and navigation for a specific content organization. However, the default sequencing information only provides for free play. Many content developers and instructional designers prefer to use specific learning or instructional strategies. In those cases, the content developer can define specific sequencing information that prescribes how an LMS will manage the learning experience.
The sequencing information is associated with the elements in the content organization tree and each of these elements represents an activity that the learner may engage in under control of the sequencing information. Application of sequencing information typically results in either the launching of a learning resource, or a choice the learner must make within the constraints defined by the content developer. Because the sequencing and navigation information is part of the content organization, which is itself part of the package manifest, the intended behaviors can be embedded in a content package in such a form that the package can be used to deliver the same learning experience on any SCORM conformant LMS.
SCORM Sequencing and Navigation provides, among other things, the ability to define highly adaptive activity sequencing. For example, it allows for conditional branching to another activity depending on whether the learner has completed some task, attained an acceptable score or achieved a certain objective. Sequencing and Navigation information embedded in a content organization can prescribe whether and how an LMS may allow the learner to use learning resources in the content package, based on how other learning resources of the same package have been used in past activities.
In the past, CBT authoring tools typically provided custom sequencing and navigation features that were encoded in proprietary data formats. However, new requirements emerged, such as the ability to publish and deploy browser-based content through different LMS systems. Another requirement was to be able to separate structure and instructional strategy logic from the learning resource used in implementing the strategy. This led to the need to standardize some means to define and encode adaptive sequencing and navigation behaviors, so that content organizations can be moved, used and reused across different LMS environments.
The standardization process for sequencing and navigation has proved difficult due to the variety of complex design approaches required in order to effectively train certain tasks or prepare learners for complex roles or responsibilities. Past versions of SCORM provided no specific sequencing capabilities, effectively allowing only pure free play, because it is a difficult and complex subject that required more time to come up with workable solutions. There are many, and often divergent, requirements in the learning design community. No approach has been found to solve all possible use cases.
However, the approach used in SCORM, which is based on the IMS SS Specification [5], is flexible enough to allow a wide variety of learning and instructional design approaches.
Section 5: SCORM® Sequencing and Navigation describes how the sequencing and navigation rules are embedded into the XML representation of content organizations in a package manifest, in compliance with the IMS SS Specification and SCORM. This specification enables robust sequencing and navigation information to be associated with content packages extending the content organization schema with sequencing prescriptions. These prescriptions are based on a common model for expressing rules, events and conditions as well as run-time behaviors associated with various sequencing and navigation methods.
The IMS SS Specification enables systems to deliver learning resources in a predictable manner, while reacting consistently to learners’ interactions with learning resources. The intended approach fosters reusability of learning resources by allowing content developers to define sequencing and navigation behavior or instructional strategies independently of the actual learning resources. The adaptive sequencing information is encoded in the content organization, allowing learning resources to be reused in multiple contexts (i.e., multiple different manifests or organizations, each having their own set of sequencing and navigation information).
Resources
The resources component of a manifest can describe external resources, as well as the content located in the content package. These files may be media files, text files, assessment objects or other pieces of data in electronic form. Conceptual groupings and relationships between files can be represented within the resources component. The combination of resources is generally categorized as “content.” The resources are referred to at various points within the organizations component, which provides the structure for the resources.
In Figure 3.3.3a, a single Resource is made up of multiple components. In SCORM, these components are simple assets. If the Resource was built to communicate with an LMS (refer to the SCORM RTE book [2]) then the Resource is a SCO. If the Resource was not built to communicate with an LMS the Resource is considered an Asset. The collection of Resource components makes up the Resources that an Organization can refer to. This collection of Resources and the Organization defines the Content Organization.
Figure 3.3.3a: Conceptual Illustration of Manifest Resources
The Resource describes the physical makeup (inventory of components) of the resource as a whole. The components of the resource are listed as Files within the Resource.
3.3.4. Content
The content (i.e., physical files) component represents the actual files referenced in the resources component. These files may be local files that are actually contained within the content package, or they can be external files that are referenced by a Universal Resource Indicator (URI). All of the physical files included in the content package should be declared and referenced in the manifest when interchanging content packages. Including files in a content package that are not referenced in the manifest can lead to a wide range of problems when the content package is imported into, run or exported from a system.
During one of these processes the physical files may be needed to complete the content package. Systems will use the manifest to determine the makeup of the content package. If physical files are not listed in the manifest then there is the chance of corrupting the content package at a later time.
Building Content Packages
This section presents the requirements for building SCORM Content Packages. The section describes the XML binding for the IMS Content Packaging Specification as applied to SCORM. There are some specific rules that have guided the creation of this XML binding:
The XML binding will adhere to the XML 1.0 specification [6] of the W3C.
The XML binding must maintain the definitional structure of the IMS Content Packaging Information Model.
Some of the requirements are also drawn from other various specifications and standards. The majority of the requirements are inherited by the requirements defined in IMS Content Packaging Specification. Some other specifications and standards are implicitly inherited based on the nature of the XML and other Internet technologies.
This section also defines the requirements for each of the SCORM Content Package Application Profiles:
Resource Content Package Application Profile: A content package that only contains resources (i.e., no organization). This type of content package can be used for bundling a set of learning resources with no defined organization or content structure. These learning resources may or may not have relationships between each other.
Content Aggregation Content Package Application Profile: A content package for bundling a set of learning resources and their intended static structure and sequencing requirements (i.e., the manifest contains 1 or more organizations of the learning resources).
Refer to Section 3.5: The SCORM Content Package Application Profiles for more information on SCORM Content Package Application Profiles.
Manifest File
The following section defines the requirements for building an imsmanifest.xml file. The manifest is a structured inventory of the content of the package. If the package is intended for delivery to an end user, then the manifest also contains information about how the content is organized. The imsmanifest.xml is, as the name implies, an XML file. This section defines the requirements for each element defined by the IMS Content Packaging Specification.
Some elements use the term smallest permitted maximum (SPM) in describing the multiplicity and/or data types. The SPM indicates that applications that process content
packages shall process at least that number of elements or number of characters, but are free to support and exceed the limit.
The data types and the formats for the elements are defined by the data types prescribed by the XML Schema Part 2: Datatypes W3C Recommendation [13]. The ordering of the XML elements is as defined by the IMS Content Packaging XML Binding for the manifest.
The following table is used to describe the SCORM Content Packaging Application Profile (refer to Section 3.5: The SCORM Content Package Application Profiles for more details) requirements: |
Table 3.4.1a: SCORM Content Packaging Application Profile Table Format |
SCORM Content Packaging Manifest Multiplicity Application Profile Requirements |
Content Aggregation <requirement> Resource <requirement> |
The SCORM Content Packaging Application Profile column describes the types of application profiles defined by SCORM. The Manifest Multiplicity Requirements column defines the multiplicity requirement for the XML elements in the imsmanifest.xml file.
Table 3.4.1b: Explanation of Content Packaging Application Profile Multiplicity Requirements
Multiplicity Requirement | Explanation |
1 and only 1 | The element must exist 1 and only 1 time within the parent element |
0 or More | The element can exist 0 or More times within the parent element. |
1 or More | The element must exist 1 or More times within the parent element. |
0 | The element is not permitted. |
0 or 1 | The element can exist 0 or 1 time within the parent element. |
Table 3.4.1b defines the types of multiplicities that are used in this section. Each type is accompanied by a brief explanation.
<manifest> Element
The <manifest> element represents a reusable unit of instruction that encapsulates metadata, organizations and resource references [3]. The <manifest> element is the root element node in the imsmanifest.xml file. Subsequent occurrences of the <manifest> elements inside the root <manifest> are used to compartmentalize files, metadata and organization structure for aggregation, disaggregation and reuse. These child
<manifest> elements are referred to as (sub)manifests.
ADL Note: The IMS Global Consortium, Inc., is working on a new version of the IMS Content Packaging Specification. One of the major issues that IMS is resolving deals with (sub)manifests, their use, requirements of use and XML syntax requirements. At this time, ADL recommends not to use (sub)manifests until completion of the IMS work. Any questions, concerns or further recommendations on (sub)manifests should be sent to ADL.
All namespace declarations should be declared inside the <manifest> element. This includes any namespaces that are considered extensions to IMS and ADL. Although this is not considered a requirement, based on the XML specifications, ADL considers this to be a “best practice” and urges vendors and tools to provide this information.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <manifest>
SCORM Requirements: The manifest element is the root element node for an IMS Manifest. The root <manifest> element shall exist 1 and only 1 time.
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 1 and only 1 |
Data Type: The <manifest> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <manifest> element contains the following elements/attributes.
Attributes:
identifier (mandatory): The attribute identifies the manifest. The identifier is unique within the Manifest [3]. The identifier attribute is typically provided by an author or authoring tool during the development of the manifest. XML Data Type: xs:ID.
version (optional): The version attribute identifies the version of the Manifest [3]. It is used to distinguish between manifests with the same identifier. The value has an SPM of 20 characters. XML Data Type: xs:string.
xml:base (optional): The xml:base attribute provides a relative path offset for the content file(s) contained in the manifest [3]. The usage of this element is defined in the XML Base [7] specification developed by the World Wide Web Consortium (W3C). The value has an SPM of 2000 characters. XML Data Type: xs:anyURI.
Elements:
<metadata>
<organizations>
<resources>
<manifest>
<imsss:sequencingCollection>
Example:
<manifest identifier="SAMPLE1" version="1.3" xml:base="mycontent" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:adlcp="http://www.adlnet.org/xsd/adlcp_v1p3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.imsglobal.org/xsd/imscp_v1p1
imscp_v1p1.xsd http://www.adlnet.org/xsd/adlcp_v1p3 adlcp_v1p3.xsd">
<!-- imsmanifest contents -->
</manifest>
Code Illustration 3-1: <manifest> Element
<metadata> Element
The <metadata> element contains metadata describing the manifest [3]. It contains relevant information that describes the content package (i.e., Content Aggregation) as a whole. The <metadata> element is considered the root node for metadata defined in a content package. This means that all metadata for a content package is defined as a child of the <metadata> element.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <metadata>
SCORM Requirements: SCORM places a requirement that all <manifest> elements shall contain the following multiplicity requirements for the <metadata> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 1 and only 1 |
Data Type: The <metadata> element is a parent element. Parent elements have no values associated with them. Parent element acts as “containers” for other elements/attributes. The <metadata> element contains the following elements/attributes:
Attributes:
None
Elements:
<schema>
<schemaversion>
{Metadata}
Example:
<manifest identifier="SAMPLE1" version="1.3" xml:base="mycontent/" xmlns="http://www.imsglobal.org/xsd/imscp_v1p1" xmlns:adlcp="http://www.adlnet.org/xsd/adlcp_v1p3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.imsglobal.org/xsd/imscp_v1p1
imscp_v1p1.xsd http://www.adlnet.org/xsd/adlcp_v1p3 adlcp_v1p3.xsd">
<metadata>
<schema>ADL SCORM</schema>
<schemaversion>2004 3rd Edition</schemaversion>
<adlcp:location>packageMetadata.xml</adlcp:location>
</metadata>
</manifest>
Code Illustration 3-2: <metadata> Element
<schema> Element
The <schema> element describes the schema that defines and controls the Manifest [3]. Since this element is a child of the metadata describing the package, the element is used to describe the schema that controls the requirements of the manifest.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <schema>
SCORM Requirements: SCORM places a requirement that the <schema> element shall adhere to the following multiplicity requirements:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 1 and only 1 |
Data Type: The <schema> element is represented as a characterstring. XML Data Type:
xs:string.
SCORM requires that the <schema> element contain the following restricted vocabulary token:
ADL SCORM: This restricted token indicates that the Content Package is built in accordance with the requirements defined by SCORM.
Example:
<manifest>
<metadata>
<schema>ADL SCORM</schema>
<schemaversion>2004 3rd Edition</schemaversion>
</metadata>
</manifest>
Code Illustration 3-3: <schema> Element
<schemaversion> Element
The <schemaversion> element describes the version of the above schema (<schema>) [3].
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <schemaversion>
SCORM Requirements: SCORM places a requirement that the <schemaversion>
element shall adhere to the following multiplicity requirements:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 1 and only 1 |
Data Type: The <schemaversion> element is represented as a characterstring. XML Data Type: xs:string.
SCORM requires that the <schemaversion> element contain the following restricted vocabulary token:
2004 3rd Edition: This restricted token indicates that the Content Package is built in accordance with SCORM 2004 3rd Edition Content Aggregation Model.
Example:
<manifest>
<metadata>
<schema>ADL SCORM</schema>
<schemaversion>2004 3rd Edition</schemaversion>
</metadata>
</manifest>
Code Illustration 3-4: <schemaversion> Element
3.4.1.5. {Metadata} |
Metadata can be inserted into a manifest using an appropriate metadata scheme [3]. If using metadata to describe SCORM Content Model Components, ADL highly recommends, at a minimum, the use of the IEEE LOM metadata scheme. Organizations may use various other metadata schemes if necessary (e.g., work being performed by Dublin Core). This metadata describes the package as a whole. There are several mechanisms for inserting metadata in a manifest. Metadata can be inserted into a manifest by extensions to the XML (inline metadata). ADL also provides a namespaced element (refer to Section 3.4.1.5.2: <location> Element) to permit a reference to a stand- alone XML file. The {Metadata}, found as a child of the <metadata>, is optional (can appear 0 or More times using one of the mechanisms described). The example below illustrates the use of inline XML extensions of the LOM elements. |
SCORM Content Packaging Manifest Multiplicity Application Profile Requirements |
Content Aggregation 0 or More Resource 0 or More |
Metadata using XML extensions
By definition, XML can be extended by introducing elements and attributes from other defined namespaces. Metadata can be inserted into the Content Package manifest by using this type of XML extension mechanism. There are several ways to add extension elements into an XML document:
Defining a namespace in an XML element with a specific prefix. In this method, the specific namespace must be defined using the xmlns:<prefix> syntax in the element. Typically, these prefixes are defined in the root node of an XML element. However, this is not a requirement. The prefix and namespace can be defined in any element, as long as the extended elements are not used prior to the declaration of the namespace (refer to Code Illustration 3-5: Inline Metadata Example – Use of XML Prefix for an example).
Example:
<manifest xmlns:lom = "http://ltsc.ieee.org/xsd/LOM">
<metadata>
<schema>ADL SCORM</schema>
<schemaversion>2004 3rd Edition</schemaversion>
<lom:lom>
<lom:general>
<lom:title>
<lom:string language="en-US">Title for the Package</lom:string>
</lom:title>
</lom:general>
<lom:metaMetadata>
<lom:metadataSchema>LOMv1.0</lom:metadataSchema>
<lom:metadataSchema>ADLv1.0</lom:metadataSchema>
</lom:metaMetadata>
</lom:lom>
</metadata>
</manifest>
Code Illustration 3-5: Inline Metadata Example - Use of XML Prefix
Defining a namespace in an XML element without a prefix. In this method, the namespace is defined at the point of use. By using this method, the syntax is stating that the element is from a particular namespace and every child element of this element is also from the namespace (refer to Code Illustration 3-6: Inline Metadata Example – Use of XML Namespace for an example).
Example:
<manifest>
<metadata>
<schema>ADL SCORM</schema>
<schemaversion>2004 3rd Edition</schemaversion>
<lom xmlns="http://ltsc.ieee.org/xsd/LOM">
<general>
<title>
<string language="en-US">Title for the Package</string>
</title>
</general>
<metaMetadata>
<metadataSchema>LOMv1.0</metadataSchema>
<metadataSchema>ADLv1.0</metadataSchema>
</metaMetadata>
</lom>
</metadata>
</manifest>
Code Illustration 3-6: Inline Metadata Example – Use of XML Namespace
<location> Element
The <location> element provides a means to describe the location where the metadata describing the SCORM Content Model Component may be found. This may be a URI. This is an ADL namespaced element extension to the IMS Content Packaging Specification. The metadata creator has two options for expressing metadata in a Content Package. The creator can either use the <location> element to express the location of
the metadata record or place the metadata inline within the Manifest file, as described previously. This value is affected by the use of xml:base values. Refer to Section
3.4.4.1: Handling the XML Base Attribute for more information on xml:base usage requirements and guidance.
XML Namespace: http://www.adlnet.org/xsd/adlcp_v1p3
XML Namespace Prefix: adlcp
XML Binding Representation: <location>
SCORM Requirements: SCORM places a requirement that the <adlcp:location>
element shall adhere to the following multiplicity requirements:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or More |
Resource | 0 or More |
Data Type: The <adlcp:location> element is represented as a characterstring. The characterstring has an SPM of 2000 characters. XML Data Type: xs:string.
Attributes:
None
Elements:
None
Example:
<manifest>
<metadata>
<schema>ADL SCORM</schema>
<schemaversion>2004 3rd Edition</schemaversion>
<adlcp:location>course/metadata/course.xml</adlcp:location>
</metadata>
</manifest>
Code Illustration 3-7: <adlcp:location> Element
<organizations> Element
The <organizations> element describes one or more structures or organizations for the content package [3].
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <organizations>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <organizations> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 1 and only 1 |
SCORM places a requirement that when building a Resource Content Package, this element is required to be represented in the manifest as an empty element (i.e.,
<organizations/>). When building a Content Aggregation Content Package, this element is required to contain at least one <organization> sub-element.
Data Type: The <organizations> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <organizations> element contains the following elements/attributes:
Attributes:
default (mandatory – for a Content Aggregation Content Package): The default attribute identifies the default organization to use. The value of this element must reference an identifier attribute of an <organization> element that is a direct descendent of the <organizations> element. XML Data Type: xs:IDREF.
Elements:
<organization>
Example:
<organizations default="TOC1">
<organization identifier="TOC1">
<title>Introduction to SCORM for LMS Vendors</title>
<!--organizations structure placed here -->
</organization>
<organization identifier="TOC2">
<title>Introduction to SCORM for Content Vendors</title>
<!--organizations structure placed here -->
</organization>
</organizations>
Code Illustration 3-8: <organizations> Element
<organization> Element
The <organization> element describes a particular hierarchical organization [3]. The content organization is defined by the <organization> element. The content organization is a conceptual term. The content organization can be a lesson, module, course, chapter, etc. What a content organization defines is dependent on an organization’s curricular taxonomy. The <organization> element represents an Activity in the terms of IMS SS.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <organization>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <organization> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 or More |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element (its parent) is required to be empty.
Data Type: The <organization> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <organization> element contains the following elements/attributes:
Attributes:
identifier (mandatory): An identifier for the organization that is unique within the manifest file [3]. Typically this value is provided by an author or authoring tool. XML Data Type: xs:ID.
structure (optional): Describes the shape of the organization [3]. The default value of the structure attribute, if not provided, shall be hierarchical. The value has an SPM of 200 characters. XML Data Type: xs:string.
adlseq:objectivesGlobalToSystem (optional, default = true): This attribute indicates that any mapped global shared objectives defined in sequencing information (refer to Section 5.1.1: <sequencing> Element) are either global to the learner and one experience of a content organization (false) or global for the lifetime of the learner within the LMS (true) across all content organizations. XML Data Type: xs:boolean.
Elements:
<title>
<item>
<metadata>
<imsss:sequencing>
Example:
<organizations>
<organization identifier="TOC1">
<title> Introduction to SCORM for LMS Vendors </title>
<item identifier="ITEM1" identifierref="RESOURCE1" isvisible="true">
<title>SCORM Run-Time Environment Requirements</title>
</item>
<item identifier="ITEM2" identifierref="RESOURCE2" isvisible="true">
<title>LMS Conformance Requirements</title>
</item>
</organization>
</organizations>
Code Illustration 3-9: <organization> Element
<title> Element
The <title> element describes the title of the organization [3]. This element could be used to help a learner decide which organization to choose. Depending on what the organization is describing, this title could be for a course, module, lesson, etc.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <title>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <title> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <title> element is represented as a characterstring element. The characterstring has an SPM of 200 characters. XML Data Type: xs:string.
Example:
<organization identifier="TOC1">
<title>Introduction to the SCORM</title>
</organization>
Code Illustration 3-10: Organization <title> Element
<item> Element
The <item> element is a node that describes the hierarchical structure of the organization [3]. The <item> element represents an Activity in the content organization. The <item> element describes a node within the organization’s structure. The <item> element can be nested and repeated within other <item> elements to any number of levels. This structuring of <item> elements shapes the content organization and describes the relationships between parts of the learning content.
The <item> element can act as a container of other <item> elements or as a leaf node. If an <item> is a leaf node, then the <item> shall reference a <resource> element. If an
<item> element is a parent element, the <item> itself is not permitted to reference a
<resource> element (only leaf <item> elements are permitted to reference resources).
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <item>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <item> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 or More |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <item> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <item> element contains the following elements/attributes:
Attributes:
identifier (mandatory): An identifier attribute is an identifier, for the item, that is unique within the Manifest. XML Data Type: xs:ID.
identifierref (optional): The identifierref attribute is a reference to an
identifier in the resources section or a (sub)manifest [3].
ADL Note: The IMS Global Consortium, Inc., is working on a new version of the IMS Content Packaging Specification. One of the major issues that IMS is resolving deals with (sub)manifests, their use, requirements of use and XML syntax requirements. At this time, ADL recommends not to use (sub)manifests until completion of the IMS work. Any questions, concerns or further recommendations on (sub)manifests should be sent to ADL.
If no identifierref is supplied, it is assumed that there is no content associated with this entry in the organization. The value has an SPM of 2000 characters.
XML Data Type: xs:string.
isvisible (optional): The isvisible attribute indicates whether or not this item is displayed when the structure of the package is displayed or rendered. If not present, value is defaulted to be true [3]. The value only affects the item for which it is defined and not the children of the item or a resource associated with an item. XML Data Type: xs:boolean.
parameters (optional): The parameters attribute contains the static parameters to be passed to the resource at launch time. The parameters attribute should only be used for <item> elements that reference <resource> elements. The value has an SPM of 1000 characters. XML Data Type: xs:string.
The accepted syntax for the parameters attribute value shall be:
#<parameter>
<name>=<value>(&<name>=<value>)*(#<parameter>)
?<name>=<value>(&<name>=<value>)*(#<parameter>)
Where:
<parameter>, <name> and <value> is some implementation defined characterstring value
= is required to separate the <name> and <value> pair
& is required to separate multiple sets of <name> and <value> pairs
(&<name>=<value>)* indicates that 0 or more <name> and <value> pairs can be concatenated together
The characters used in the parameters value may need to be URL encoded. RFC 3986 defines the requirements for encoding URLs.
Elements:
<title>
<item>
<metadata>
<adlcp:timeLimitAction>
<adlcp:dataFromLMS>
<adlcp:completionThreshold>
<imsss:sequencing>
<adlnav:presentation>
Example:
<organization>
<item identifier="ITEM3" identifierref="RESOURCE3" isvisible="true" parameters="?width=500&length=300">
<title>Content 1</title>
</item>
</organization>
Code Illustration 3-11: <item> Element
<title> Element
The <title> element describes the title of the item [3].
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <title>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <title> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty. Consequently, no <item> or <title> will be provided.
Data Type: The <title> element is represented as a characterstring element. The characterstring has an SPM of 200 characters. XML Data Type: xs:string.
Example:
<organization>
<item identifier="ITEM3" identifierref="RESOURCE3" isvisible="true">
<title>Content 1</title>
</item>
</organization>
Code Illustration 3-12: Item <title> Element
<item> Element
The <item> element can be nested an arbitrarily number of levels. This is typically based on the content structure of the aggregation. The <item> element can appear 0 or More times as a child of an <item> element (refer to Section 3.4.1.9: <item> Element for more details on the <item> element.)
<metadata> Element
The <metadata> element contains metadata describing the item [3]. It contains relevant information that describes the <item> element (i.e., Activity) as a whole. The
<metadata> element is considered the root node for metadata describing the activity. This means that all metadata for the activity is defined as a child of the <metadata> element.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <metadata>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <metadata> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <metadata> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <metadata> element contains the following elements/attributes:
Attributes:
None
Elements:
{Metadata} – Refer to Section 3.4.1.5: {Metadata} for information on the inclusion of metadata.
ADL Note: This is different from the <metadata> element defined in Section 3.4.1.2:
<metadata> Element. The IMS Content Packaging Specification only permits the
<schema> and <schemaversion> elements on the <metadata> element defined as a child of the <manifest> element.
Example:
<organization>
<item>
<title>The organization title</title>
<metadata>
<adlcp:location>lesson1/lesson1MD.xml</adlcp:location>
</metadata>
</item>
</organization>
Code Illustration 3-13: Item <metadata> Element
<timeLimitAction> Element
The <timeLimitAction> element defines the action that should be taken when the maximum time allowed in the current attempt of the activity is exceeded. All time tracking and time limit actions are controlled by the SCO.
This element is an ADL defined extension to the IMS Content Packaging Specification. The element shall only appear, if needed, as a child of a leaf <item> element that references a SCO. Only those <item> elements that reference a SCO resource can contain the <timeLimitAction> element.
The LMS shall use the value of the <timeLimitAction> element, if provided, to initialize the cmi.time_limit_action data model element (refer to the SCORM RTE book [2]). If the content developer defines a time limit action, then the SCO is responsible for all behaviors based on the time out (if the time out occurs).
XML Namespace: http://www.adlnet.org/xsd/adlcp_v1p3
XML Namespace Prefix: adlcp
XML Binding Representation: <timeLimitAction>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <timeLimitAction> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <timeLimitAction> element is represented as a characterstring. The characterstring is required to be one of following set of restricted characterstring tokens:
exit,message: The learner should be forced to exit the SCO. The SCO should provide a message to the learner indicating that the maximum time allowed for the learner attempt was exceeded.
exit,no message: The learner should be forced to exit the SCO with no message.
continue,message: The learner should be allowed to continue in the SCO. The SCO should provide a message to the learner indicating that the maximum time allowed for the learner attempt was exceeded.
continue,no message: Although the learner has exceeded the maximum time allowed for the learner attempt, the learner should be given no message and should not be forced to exit the SCO.
If this feature is used within the SCO, the SCO shall keep track of the time affecting this timeout period and provide the informative message indicating the timeout (if appropriate).
Example:
<organization>
<item identifier="ITEM3" identifierref="RESOURCE3" isvisible="true">
<title>Content 1</title>
<adlcp:timeLimitAction>exit,no message</adlcp:timeLimitAction>
</item>
</organization>
Code Illustration 3-14: <timeLimitAction> Element
<dataFromLMS> Element
The <dataFromLMS> element provides initialization data expected by the resource (i.e., SCO) represented by the <item> after launch. This data is opaque to the LMS and only has functional meaning to the SCO. This element shall not be used for parameters that the SCO may need during the launch (query string parameters). If this type of functionality is required, then the developer should use the parameters attribute of the item referencing the SCO resource.
This element is an ADL defined extension to the IMS Content Packaging Specification. The element shall only appear, if needed, as a child of a leaf <item> element. Only those
<item> elements that reference a SCO resource can contain the <dataFromLMS>
element).
The LMS shall use the value of the <dataFromLMS> element, if provided, to initialize the cmi.launch_data data model element (refer to SCORM Run-Time Environment book [2]).
XML Namespace: http://www.adlnet.org/xsd/adlcp_v1p3
XML Namespace Prefix: adlcp
XML Binding Representation: <dataFromLMS>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <dataFromLMS> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <dataFromLMS> element is represented as a characterstring element. The characterstring has an SPM of 4000 characters.
Example:
<organization>
<item identifier="ITEM3" identifierref="RESOURCE3" isvisible="true">
<title>Content 1</title>
<adlcp:dataFromLMS>Some SCO Information</adlcp:dataFromLMS>
</item>
</organization>
Code Illustration 3-15: <dataFromLMS> Element
<completionThreshold> Element
The <completionThreshold> element defines a threshold value that can be used by the SCO resource referenced by the <item> for which the <completionThreshold> is defined. This element is an ADL defined extension to the IMS Content Packaging Specification. The element shall only appear, if needed, as a child of a leaf <item> element. Only those <item> elements that reference a SCO resource can contain the
<completionThreshold> element).
The LMS shall use the value of the <completionThreshold> element, if provided, to initialize the cmi.completion_threshold data model element (refer to the SCORM RTE book [2]). This value can be used by the SCO to determine completion.
XML Namespace: http://www.adlnet.org/xsd/adlcp_v1p3
XML Namespace Prefix: adlcp
XML Binding Representation: <completionThreshold>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <completionThreshold> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <completionThreshold> element is represented as a decimal value between the range of 0.0 and 1.0 element.
Example:
<organization>
<item identifier="ITEM3" identifierref="RESOURCE3" isvisible="true">
<title>Content 1</title>
<adlcp:completionThreshold>0.75</adlcp:completionThreshold>
</item>
</organization>
Code Illustration 3-16: <completionThreshold> Element
<sequencing> Element
Refer to Section 5.1.1: <sequencing> Element.
<presentation> Element
Refer to Section 5.2.1: <presentation> Element.
<metadata> Element
The <metadata> element is metadata describing the organization [3]. It contains relevant information that describes the <organization> element (i.e., Content Organization) as a whole. The <metadata> element is considered the root node for metadata describing the content organization. This means that all metadata for the content organization is defined as a child of the <metadata> element.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <metadata>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for this <metadata> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 |
For Resource Content Packages, this element shall not appear. The <organizations>
element is required to be empty.
Data Type: The <metadata> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <metadata> element contains the following elements/attributes:
Attributes:
None
Elements:
{Metadata} – Refer to Section 3.4.1.5: {Metadata} for information on the inclusion of metadata.
ADL Note: This is different from the <metadata> element defined in Section 3.4.1.2:
<metadata> Element. The IMS Content Packaging Specification only permits the
<schema> and <schemaversion> elements on the <metadata> element defined as a child of the <manifest> element.
Example:
<organization>
<title>Introduction to SCORM</title>
<item identifier="ITEM1" identifierref="RESOURCE1" isvisible="true">
<title>SCORM Run-Time Environment Requirements</title>
</item>
<metadata>
<adlcp:location>activities/activity1MD.xml</adlcp:location>
</metadata>
</organization>
Code Illustration 3-17: Organization <metadata> Element
<sequencing> Element
Refer to Section 5.1.1: <sequencing> Element.
<resources> Element
The <resources> element is a collection of references to resources. There is no assumption of order or hierarchy of the individual <resource> elements that the
<resources> element contains [3].
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <resources>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <resources> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 1 and only 1 |
Resource | 1 and only 1 |
Data Type: The <resources> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other
elements/attributes. The <resources> element contains the following elements/attributes:
Attributes:
xml:base (optional): The xml:base attribute provides a relative path offset for the content file(s) [3]. The usage of this element is defined in the XML Base [7] Working Draft from the W3C. The value has an SPM of 2000 characters. XML Data Type: xs:anyURI.
Elements:
<resource>
Example:
<manifest>
<metadata/>
<organizations/>
<resources>
<resource identifier="RESOURCE1" adlcp:scormType="sco" type="webcontent" href="lesson1.htm">
<file href="lesson1.htm"/>
</resource>
<resource identifier="RESOURCE2" adlcp:scormType="sco" type="webcontent" href="intro1.htm">
<file href="intro1.htm"/>
</resource>
<resource identifier="RESOURCE3" adlcp:scormType="asset" type="webcontent" href="content1.htm">
<file href="content1.htm"/>
</resource>
<resource identifier="RESOURCE4" adlcp:scormType="sco" type="webcontent" href="summary1.htm">
<file href="summary1.htm"/>
</resource>
</resources>
</manifest>
Code Illustration 3-18: <resources> Element
<resource> Element
The <resource> element is a reference to a resource [3]. There are two primary types of resources defined within SCORM:
SCOs
Assets
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <resource>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <resource> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or More |
Resource | 0 or More |
A leaf <item> element is required to reference a resource (SCO resource or Asset resource). If an <item> references a resource, this resource is subject to being identified for delivery and launch to the learner. If an <item> references a <resource>, then the
<resource> element shall meet the following requirements:
The type attribute should be set to webcontent.
The adlcp:scormType shall be set to sco or asset.
The href attribute shall be required.
Data Type: The <resource> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <resource> element contains the following elements/attributes:
Attributes:
identifier (mandatory): The identifier attribute represents an identifier, of the resource, that is unique within the scope of its containing manifest file [3]. This identifier is typically provided by an author or authoring tool. XML Data Type: xs:ID.
type (mandatory): The type attribute indicates the type of resource [3]. The value has an SPM of 1000 characters. XML Data Type: xs:string.
href (optional): The href attribute is a reference a Uniform Resource Locator (URL) [3]. The href attribute represents the “entry point” or “launching point” of this resource. External fully qualified URLs are also permitted. The URL may also contain additional parameters (refer to Section 3.4.3.3: Handling Additional Parameters as Part of URLs for information regarding the handling of these parameters). This value is affected by the use of xml:base values. Refer to Section 3.4.4.1: Handling the XML Base Attribute for more information on xml:base usage requirements and guidance. The value has an SPM of 2000 characters. The SPM represents the length of the href with the values of any xml:base applied to it. XML Data Type: xs:string.
xml:base (optional): The xml:base attribute provides a relative path offset for the files contained in the manifest. The usage of this element is defined in the XML Base Working Draft from the W3C. The value has an SPM of 2000 characters. XML Data Type: xs:anyURI.
adlcp:scormType (mandatory): The adlcp:scormType attribute defines the type of SCORM resource. This is an ADL extension to the IMS Content Packaging Information Model. XML Data Type: xs:string. The character string is restricted and shall be one of the following characterstring tokens (sco or asset).
Where sco indicates that the resource is a SCO resource and asset indicates that the resource is an Asset resource.
Elements:
<metadata>
<file>
<dependency>
Example:
<resources>
<resource identifier="R_A2" type="webcontent" adlcp:scormType="sco" href="sco1.html">
<file href="sco1.html"/>
</resource>
<resource identifier="R_A3" type="webcontent" adlcp:scormType="sco" href="sco3.html">
<file href="sco3.html"/>
</resource>
<resource identifier="R_A5" type="webcontent" adlcp:scormType="asset" href="pics\distress_sigs_add.jpg">
<file href="pics\distress_sigs_add.jpg"/>
</resource>
</resources>
Code Illustration 3-19: <resource> Element
<metadata> Element
The <metadata> element is metadata describing the resource [3]. It contains relevant information that describes the <resource> element as a whole. The <resource> element may represent a SCO or an Asset. This depends on the value of the adlcp:scormType attribute. The <metadata> element is considered the root node for metadata describing the resource. This means that all metadata for the resource is defined as a child of the <metadata> element.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <metadata>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <metadata> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 or 1 |
Data Type: The <metadata> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <metadata> element contains the following elements/attributes:
Attributes:
None
Elements:
{Metadata}: Refer to Section 3.4.1.5: {Metadata} for information on the inclusion of metadata.
ADL Note: This is different from the <metadata> element defined in Section 3.4.1.2:
<metadata> Element. The IMS Content Packaging Specification only permits the
<schema> and <schemaversion> elements on the <metadata> element defined as a child of the <manifest> element.
Example:
<resources>
<resource identifier="R_A2" type="webcontent" adlcp:scormType="sco" href="sco1.html">
<file href="sco1.html"/>
<metadata>
<adlcp:location>resources/resource1MD.xml</adlcp:location>
</metadata>
</resource>
</resources>
Code Illustration 3-20: Resource <metadata> Element
<file> Element
The <file> element is a listing of files that a resource described by a <resource> element requires for delivery. This element is repeated as necessary for each file for a given resource. The element acts as an inventory system detailing the set of files used to build the resource. The <file> element represents files that are local to the content package. For all files that are required for delivery of the content package in a SCORM run-time environment and are local to the content package (physically located in the content package), a <file> element shall be used to represent the file relative to the resource in which it is used. If the resource identified by a <resource> element is local to the package, then the resource itself shall be identified as a <file> element. The launch location of the <resource> (<resource>’s href value) shall be used as the href of the file. The value of the <file> element’s href attribute should not contain any parameters that may have been defined on the <resource> element’s href attribute.
All of the physical files that are included in the content package should be referenced by a file element. Leaving these references to the physical files out of the manifest may cause a wide range of problems.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <file>
the following multiplicity requirements for the <file> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or More |
Resource | 0 or More |
Data Type: The <file> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <file> element contains the following elements/attributes:
Attributes:
href (mandatory): The href attribute identifies the location of the file [3]. This value is affected by the use of xml:base values. Some systems may treat this value as case sensitive, developers should be aware of this and ensure that values used match the resources being referenced. Refer to Section 3.4.4.1: Handling the XML Base Attribute for more information on xml:base usage requirements and guidance. The value has an SPM of 2000 characters. The SPM represents the length of the href with the values of any xml:base applied to it. XML Data Type: xs:string.
Elements:
<metadata>
Example:
<resource identifier="R_A2" type="webcontent" adlcp:scormType="sco" href="sco1.html">
<file href="assets/image1.gif"/>
<file href="sco1.html"/>
<file href="assets/common/APIWrapper.js"/>
</resource>
Code Illustration 3-21: <file> Element
<metadata> Element
The <metadata> element is metadata describing the file [3]. It contains relevant information that describes the <file> element (i.e., Asset) as a whole. The <metadata> element is considered the root node for metadata describing the Asset. This means that all metadata for the Asset is defined as a child of the <metadata> element.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <metadata>
SCORM Requirements: SCORM places a requirement that all manifests shall adhere to the following multiplicity requirements for the <metadata> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or 1 |
Resource | 0 or 1 |
Data Type: The <metadata> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements/attributes. The <metadata> element contains the following elements/attributes:
Attributes:
None
Elements:
{Metadata} – Refer to Section 3.4.1.5: {Metadata} for information on the inclusion of metadata.
ADL Note: This is different from the <metadata> element defined in Section 3.4.1.2:
<metadata> Element. The IMS Content Packaging Specification only permits the
<schema> and <schemaversion> elements on the <metadata> element defined as a child of the <manifest> element.
Example:
<resource identifier="R_A2" type="webcontent" adlcp:scormType="sco" href="sco1.html">
<file href="assets/image1.gif">
<metadata>
<adlcp:location>assets/asset1.xml</adlcp:location>
</metadata>
</file>
<file href="sco1.html"/>
<file href="assets/common/APIWrapper.js"/>
</resource>
Code Illustration 3-22: File <metadata> Element
<dependency> Element
The <dependency> element identifies a resource whose files this resource (the resource in which the dependency is declared in) depends on [3]. The resource that the
<dependency> references can act as a container for multiple files that the resource containing the <dependency> is reliant on.
XML Namespace: http://www.imsglobal.org/xsd/imscp_v1p1
XML Namespace Prefix: imscp
XML Binding Representation: <dependency>
the following multiplicity requirements for the <dependency> element:
SCORM Content Packaging Application Profile | Manifest Multiplicity Requirements |
Content Aggregation | 0 or More |
Resource | 0 or More |
Data Type: This element is represented as an empty element. The <dependency>
element only contains attributes.
Attributes:
identifierref (mandatory): The identifierref attribute references an identifier attribute of a <resource> (within the scope of the <manifest> element for which it is defined) and is used to resolve the ultimate location of the dependent resource. The identifierref is not permitted to reference a resource defined in a (sub)manifest. The value has an SPM of 2000 characters. XML Data Type: xs:string.
Elements:
None
Example:
<resources>
<resource identifier="R_A2" type="webcontent" adlcp:scormType="sco" href="sco1.html">
<file href="sco1.html"/>
<dependency identifierref="R_A5"/>
</resource>
<resource identifier="R_A5" type="webcontent" adlcp:scormType="asset" href="pics\distress_sigs_add.jpg">
<file href="pics\distress_sigs_add.jpg"/>
</resource>
</resources>
Code Illustration 3-23: <dependency> Element
<manifest> Element
Refer to Section 3.4.1.1: <manifest> Element.
ADL Note: The IMS Global Consortium Inc., is working on a new version of the IMS Content Packaging Specification. One of the major revisions that IMS is resolving deals with (sub)manifests, their use, requirements of use and XML syntax requirements. At this time, ADL recommends not to use (sub)manifests until completion of the IMS work. Any questions, concerns or further recommendations on (sub)manifests should be sent to ADL.
<sequencingCollection> Element
Refer to Section 5.1.12: <sequencingCollection> Element.
Content Package Manifest Extensions
The IMS Content Packaging Specification allows for communities to place their own namespaced elements throughout the manifest. SCORM carries this practice with a set of extensions. These sets of extensions are required to meet various requirements and to help in the application profiling of the various specifications and standards described in SCORM. The extensions are defined in three separate XML Schema Definition (XSD) files. These files are:
adlcp_v1p3.xsd: Describes SCORM Content Packaging extensions. These extension elements and attributes are defined within the http://www.adlnet.org/xsd/adlcp_v1p3 namespace. ADL reserves the namespace and the adlcp: prefix to indicate elements of that namespace. These extension elements are described in detail in Section 3.4.1: Manifest File.
adlseq_v1p3.xsd: Describes SCORM Sequencing extensions. These extension elements and attributes are defined within the http://www.adlnet.org/xsd/adlseq_v1p3 namespace. ADL reserves the namespace and the adlseq: prefix to indicate elements of that namespace. These extension elements are described in detail in Section 3.4.1: Manifest File.
adlnav_v1p3.xsd: Describes SCORM Navigation extensions. These extension elements and attributes are defined within the http://www.adlnet.org/xsd/adlnav_v1p3 namespace. ADL reserves the namespace and the adlnav: prefix to indicate elements of that namespace. These extension elements are described in detail in Section 3.4.1: Manifest File.
Extending the manifest with an organization-defined extension could cause a low degree of semantic interoperability. Organizations that do not recognize the extension may not know how to deal with the extension properly and may ignore the extensions. To keep a high degree of semantic interoperability and, if the need arises, to extend the manifest, ADL recommends that vertical communities work to a consensus on building a set of interoperable extensions.
Content Package Manifest Href Handling
An “href” is used to describe the location of a <file> or <resource> identified in the content package manifest. This location can either be an internal URL or an external URL. According to the IMS Content Packaging Version 1.1.3 Final Specification, the value of an href is to be constructed according to the rules expressed in RFC 3986 [8].
Handling the XML Base Attribute
The XML Base [7] is a construct used to explicitly specify the base URL of a document in resolving relative URLs in links to files in a Content Package. The URLs can be prefixed by an XML Base attribute. This allows an author or authoring tool to specify and/or offset the base directory so that it is not necessary to repeat the base directory in every use of that URL.
The default base directory is the location of the package. This concept is known as “relative to the package.” The only way to explicitly override this default base directory is to reference a file with an absolute path that is external to the package. If the file is not external to the package, any XML Base value will simply offset the default base directory. The XML Base attribute can be either:
A relative URL (describing the offset from the root of the package, e.g., Course/Lesson/), or
External URL (external from the package, e.g., http://www.adlnet.gov/content/).
Trailing slashes are required to be at the end of any XML Base value. When referencing local files in the content package, the URL, including XML Base, shall not begin with a leading forward slash (“/”). As defined in RFC 3986, a path with a leading forward slash indicates the absolute path of that file. Using a leading slash denotes the root of the local host. With this in mind, the use of a leading forward slash is not permitted to minimize misinterpretation and increase portability.
The IMS Content Packaging XML Binding Specification allows for the use of the XML Base attribute in the <manifest>, <resources> and <resource> elements.
If the XML Base attribute is present in the <manifest> element, all URLs found within the child elements of the <manifest> element shall use the XML Base value to construct the actual href value. This includes the href values for the <resource> and <file> elements and the value held in the <adlcp:location> element.
<manifest xml:base="Course/">
<organizations>
<organization>
<item identifier="ID1" identifierref="R_ID1"></item>
</organization>
</organizations>
<resources>
<resource identifier="R_ID1"
href="Lesson01/Topics/index.htm"></resource>
</resources>
</manifest>
Code Illustration 3-24: XML Base Defined on <manifest> Element
Because of the use of the XML Base attribute in the <manifest> element and an href exists within the child hierarchy of the <manifest> element, the actual href for the resource, shown in Code Illustration 3-24: XML Base Defined on <manifest> Element, is: Course/Lesson01/Topics/index.htm.
If the XML Base attribute is present in the <resources> element, all URLs found within the child elements of the <resources> element shall use the XML Base value to construct the actual href value.
<manifest>
<organizations>
<organization>
<item identifier="ID1" identifierref="R_ID1"></item>
</organization>
</organizations>
<resources xml:base="Course/Lesson01/">
<resource identifier="R_ID1" href="Topics/index.htm"></resource>
</resources>
</manifest>
Code Illustration 3-25: XML Base Defined on <resources> Element
Because of the use of the XML Base attribute in the <resources> element and an href exists within the child hierarchy of the <resources> element, the actual href for the resource, shown in Code Illustration 3-25: XML Base Defined on <resources> Element, is: Course/Lesson01/Topics/index.htm
If the XML Base attribute is present in the <resource> element, all URLs found within the child elements of the <resource> element shall use the XML Base value to construct the actual href value.
<manifest>
<organizations>
<organization>
<item identifier="ID1" identifierref="R_ID1">
</item>
</organization>
</organizations>
<resources>
<resource identifier="R_ID1" xml:base="Course/Lesson01/Topics/"
href="index.htm">
</resource>
</resources>
</manifest>
Code Illustration 3-26: XML Base Defined on <resource> Element
Because of the use of the XML Base attribute in the <resource> element and an href exists within the child hierarchy of the <resource> element, the actual href for the resource, shown in Code Illustration 3-26: XML Base Defined on <resource> Element, is: Course/Lesson01/Topics/index.htm.
If a combination of XML Base attributes is used throughout the Manifest, the value of the XML Base attribute shall be appended in the order of the hierarchy of these elements to form the actual URL. The <manifest> element’s XML Base value comes first, followed by the <resources> elements XML Base value, followed by the <resource> elements XML Base value, followed by the href attribute’s value.
<manifest xml:base="Course/">
<organizations>
<organization>
<item identifier="ID1" identifierref="R_ID1"></item>
</organization>
</organizations>
<resources xml:base="Lesson01/">
<resource identifier="R_ID1"
href="index.htm" xml:base="Topics/">
</resource>
</resources>
</manifest>
Code Illustration 3-27: XML Base Defined on All Permitted Elements
Because of the use of the XML Base attributes in the <manifest>, <resources> and
<resource> elements and an href exists as an attribute of the <resource> element, the actual href for the resource, shown in Code Illustration 3-27: XML Base Defined on All Permitted Elements, is: Course/Lesson01/Topics/index.htm.
When using the xml:base attribute, care should be taken in regards to the SPM defined for the xml:base and href attribute values. The xml:base attribute has an SPM of 2000 characters. This SPM applies not only to the actual value held by the xml:base attribute, but also impacts the overall SPM for the href attribute. The SPM of 2000 characters defined for the href attribute represents the SPM for the length of the href after all of the xml:base attributes have been applied to the href to form the absolute URL. So developers should keep this SPM in mind when using the xml:base attribute in conjunction with the href attribute. Violating the SPM may cause interoperability issues between different systems.
URL Encoding and Decoding
In some situations the URLs used in defining the location of the files or resource may need to be encoded. RFC 3986 defines the rules and requirements for encoding URLs. Sections 2.2 through 2.4 of RFC 3986 describe how and when to encode or decode URLs. Some characters have a "structural" purpose as delimiters in a URL and may not be escaped when they serve that purpose. Those characters are:
"/" in the schema part of the URL, or as a separator in the path part of a URL
":" in the schema part of the URL
"#" as the lead character for an anchor value
"&" as the separator between parameters
"?" as the separator between the path part of a URL and the parameters
"=" as the separator between a parameter value and the parameter name
"%" as an escape indicator.
If one of those characters exists in the URL, but not for that purpose, it must be encoded (or escaped). With this in mind, it would be incorrect to take a complete URL such as "Course/Lesson/Module/Resources/bar.html" and just escape it using an ECMAScript escape function, since that would change the path separator slashes that are
required for interpretation of the URL into escaped characters. On the other hand, if the value of a parameter that is included as part of the URL contains a slash character, that character must be escaped. So escaping must be done before assembling the parts of the URL, by escaping the segments that need to be escaped and then assembling those parts with delimiters that should not be escaped.
Additionally, double encoding shall not be used when the URL is included in a manifest. Thus the value of an href attribute for a resource shall be a string that contains a valid URL in the exact format required to launch the resource in a Web browser.
Furthermore, if parameters are specified for an <item>, they shall be properly escaped for use in a URL. For example, suppose that the following parameters are needed for a particular SCO:
"?ratio=3/4&scale=100&label=Gilbert & Sullivan"
The example above is not a valid parameter value because it contains illegal characters. The “/” in “3/4” needs to be escaped because it is not part of the URL and it is not used as a separator in the path. Also, the “&” in “Gilbert & Sullivan” needs to be escaped because it is not used as a separator between parameters. The correctly escaped equivalent to these parameters is:
"ratio=3%2F4&scale=100&label=Gilbert %26 Sullivan"
However, the following is not correctly escaped because characters are double-escaped:
"ratio=3%252F4&scale=100&label=Gilbert %2526 Sullivan"
Since manifests are implemented in XML, the XML rules for escaping must also be followed. For example, the “&” may appear in its literal form only when used within a comment, processing instruction or a CDATA section according to the XML 1.0 standard. If they are needed elsewhere, as in the above example, it must be escaped using either numeric character references or strings (“%26” or “&”). The following would be the correct value to use in the parameters attribute of the item element:
"ratio=3%2F4%26scale=100%26label=Gilbert %26 Sullivan"
It is permitted to escape other characters such as the “=” or the “ “ such as:
"ratio%3D3%2F4%26scale%3D100%26label%3DGilbert%20%26%20Sullivan"
Handling Additional Parameters as Part of URLs
There may be situations where content objects require information at launch time in order for the content object to operate properly. This information is sometimes referred to as launch parameters (or query strings). There are currently two mechanisms for representing query strings in a Manifest.
Option 1: As part of the <resource> or <file> href attribute. The content developer can place the query string as part of the href. An example of this is:
<resource href="foo.html?Topic=1">
<!-- resource information -->
</resource>
Code Illustration 3-28: Parameters defined on Href Attribute
Option 2: Using the parameters attribute of the <item>. The content developer also has the option of placing the query string or launch parameters in the parameters attribute of the <item> that references a <resource>. The href attribute in the <resource> element is the URL used to launch the resource, which may or may not resolve to a file in the package. The href in the <file> element specifies a file name and, if, required, the installation path relative to the package installation "root" directory. These are not redundant, because they are not necessarily the same. For example, the href in the
<resource> element might very well be something like "scos/foo.html#xyz", while the corresponding <file> href is "scos/foo.html".
Also, note that the manifest is also an inventory of every file included in the package, including the launch file for a resource. In other words, the <file> element is an inventory entry. The <resource> element specifies how to use a particular set of files (or how to access an external resource), and the <item> element in an <organization> specifies how to use a resource in one or more places in a content organization.
If an <item> references a <resource>, it is required that the <resource> contains an href entry for launching the resource. The parameters attribute is defined as the static parameters to be passed to the resource at launch time. This allows for the ability to reference the same <resource> from different items for different purposes.
For example:
<manifest>
<!-- For brevity, elements not in question or part of the -->
<!-- example were kept simple and incomplete -->
<organizations>
<organization>
<item identifier="I01" identifierref="R_I01" parameters="?Topic=1">
</item>
</organization>
</organizations>
<resources>
<resource identifier="R_I01" href="foo.htm">
</resource>
</resources>
</manifest>
Code Illustration 3-29: Parameters defined with parameters Attribute
In option 1, each Resource would have to be repeated in the Manifest, with parameters
defined in the href attribute.
Due to the number of ways to syntactically represent the launch parameters within the Manifest, the IMS Content Packaging Specification details an algorithm for constructing the href attribute of the resource element and the parameters consistently.
While first char of parameters is in “?&”
Clear first char of parameters If first char of parameters is “#”
If URI contains “#”
Discard parameters Else
Append parameters to the URI Done processing URI
If the URI contains a “?”
Append “&” to the URI Else
Append “?” to the URI Append parameters to URI Done processing the URI
Code Illustration 3-30: Pseudo Code for Defining Href
SCORM Content Package Application Profiles
SCORM Content Package Application Profiles describe how the IMS Content Packaging Specification will be applied within the overall context of SCORM. The application profiles provide practical guidance for implementers and define additional requirements imposed by SCORM to integrate other standards and specifications and ensure interoperability. The IMS Content Packaging Specification will be used as the basis for a SCORM Content Package. However, SCORM will impose additional requirements, above those defined by the IMS Content Packaging Specification, to ensure sufficient information is included in each package. This will enable SCORM conformant systems to import and export packages that can be used by other SCORM conformant systems.
SCORM introduces the Content Aggregation Model (Section 2.1: The SCORM Content Model Components) that defines a generalized framework for object based learning content. The components are Assets, SCOs and Content Organizations. There are currently two SCORM Content Package Application Profiles, which describe how to package Content Aggregation Model components, identified:
Resource Content Packages
Content Aggregation Content Packages.
The following sections describe the application profiles, the constraints imposed by SCORM and a set of recommended best practices.
Resource Content Package
The SCORM Resource Content Package Application Profile defines a mechanism for packaging Assets and SCOs without having to provide any organization, learning context or curricular taxonomy. Packaging learning resources provides a common medium for exchange. The Resource Content Package Application Profile should be used for moving SCOs and Assets from system to system. Since there is no organization defined in a Resource Content Package, no logical content structure is defined. Since no structure is defined, this type of package cannot be delivered by an LMS to the learner. The SCORM Resource Content Package is merely a collection of learning resources that can be transferred between learning systems.
In many cases an Asset resource or a SCO resource will be comprised of a single file. However, there are cases where Assets and SCOs could be comprised of multiple files. The SCORM Resource Content Package Application Profile allows for packaging Assets and SCOs comprised of single or multiple files. Also, Assets and SCOs may be included locally in the package or may be referenced externally. Locally packaged files will be included as physical files within the overall package. When externally referenced, the Assets and SCOs will not be included as physical files within the package, but will instead be referenced by an URL.
The following figures depict several resource content packages. The examples show a sample imsmanifest.xml instance and how Assets and SCOs could be represented.
Figure 3.5.1a shows an example of an Asset being represented as a <file> element in an
imsmanifest.xml instance.
Figure3.5.1a: Example of an Asset Represented as a <file> Element
Figure 3.5.1b shows an example of an Asset being represented as a <resource> element (i.e., Asset resource) in an imsmanifest.xml instance.
Figure 3.5.1b: Example of an Asset Represented as a <resource> Element
Figure 3.5.1c shows an example of a SCO being represented as a <resource> element in an imsmanifest.xml instance.
Figure 3.5.1c: Example of a SCO Represented as a <resource> Element
Content Aggregation Content Package
SCORM does not impose any requirements on the structure for content organizations. Individual content developers are free to aggregate content into any structure that provides value to them. The IMS Content Packaging Specification [3] provides a framework that includes most of the information that is needed by ADL, as well as logical places in which ADL extensions can be added to capture the rest of the information. Additionally, the IMS packaging model also provides a clean way to inventory and bundle all of the physical files required to deliver the learning resource, as well as to identify relationships between files that belong to one or more learning resources, including externally referenced resources that are not contained as physical files within a content package. The Content Aggregation Content Package Application Profile should be used to bundle learning resources and the content structure. This is the application profile that should be used to bundle complete courses, modules, lessons, etc. The Content Aggregation Content Package’s main purpose is to be used to deliver content to an end user (i.e., typically through an LMS).
The IMS Content Packaging Specification also enables a separation of learning resources from the way those resources can be organized, allowing for one or more uses of the
same learning resources within different contexts. SCORM defines a mechanism for packaging the files and providing the structure.
Figure 3.5.2a shows an example of a Content Organization being represented in an
imsmanifest.xml instance.
Figure 3.5.2a: Example of a Content Aggregation Content Package and its Components
SCORM Content Package Application Profile Requirements
Table 3.5.3a defines the requirements for each of the aforementioned Content Package Application Profiles. Each of the profiles is listed with the corresponding requirements for each of the content packaging manifest elements/attributes.
“M” indicates that the element/attribute is Mandatory.
“O” indicates that the element/attribute is Optional.
“NP” indicates that the element/attribute is Not Permitted.
Elements are indicated as they would in the XML Binding (i.e., using XML notation
<element_name>). Attributes are indicated without any notation (e.g., 1.1 identifier is an attribute of the <manifest> element). The numbering system is based off of the IMS Content Packaging Specification.
Table 3.5.3a: SCORM Content Package Application Profile Manifest Element Requirements
No. | Elements | Resource Content Package | Content Aggregation Content Package |
1 | <manifest> | M | M |
1.1 | identifier | M | M |
1.2 | version | O | O |
1.3 | xml:base | O | O |
1.4 | <metadata> | M | M |
1.4.1 | <schema> | M | M |
1.4.2 | <schemaversion> | M | M |
1.4.3 | {Metadata} | O | O |
1.5 | <organizations> | M | M |
1.5.1 | default | NP | M |
1.5.2 | <organization> | NP | M |
1.5.2.1 | identifier | NP | M |
1.5.2.2 | structure | NP | O |
1.5.2.3 | adlseq:objectivesGlobalToSystem | NP | O |
1.5.2.4 | <title> | NP | M |
1.5.2.5 | <item> | NP | M |
1.5.2.5.1 | identifier | NP | M |
1.5.2.5.2 | identifierref | NP | O |
1.5.2.5.3 | <title> | NP | M |
1.5.2.5.4 | isvisible | NP | O |
1.5.2.5.5 | parameters | NP | O |
1.5.2.5.6 | <item> | NP | O |
1.5.2.5.7 | <metadata> | NP | O |
1.5.2.5.7.1 | {Metadata} | NP | O |
1.5.2.5.8 | <adlcp:timeLimitAction> | NP | O |
1.5.2.5.9 | <adlcp:dataFromLMS> | NP | O |
1.5.2.5.10 | <adlcp:completionThreshold> | NP | O |
1.5.2.5.11 | <imsss:sequencing> | NP | O |
1.5.2.5.12 | <adlnav:presentation> | NP | O |
No. | Elements | Resource Content Package | Content Aggregation Content Package |
1.5.2.6 | <metadata> | NP | O |
1.5.2.6.1 | {Metadata} | NP | O |
1.5.2.7 | <imsss:sequencing> | NP | O |
1.6 | <resources> | M | M |
1.6.1 | xml:base | O | O |
1.6.2 | <resource> | O | O |
1.6.2.1 | identifier | M | M |
1.6.2.2 | type | M | M |
1.6.2.3 | href | O | O |
1.6.2.4 | adlcp:scormType | M | M |
1.6.2.5 | xml:base | O | O |
1.6.2.6 | <metadata> | O | O |
1.6.2.6.1 | {Metadata} | O | O |
1.6.2.7 | <file> | O | O |
1.6.2.7.1 | href | M | M |
1.6.2.7.2 | <metadata> | O | O |
1.6.2.7.2.1 | {Metadata} | O | O |
1.6.2.8 | <dependency> | O | O |
1.6.2.8.1 | identifierref | M | M |
1.7 | <manifest> | O | O |
1.8 | <imsss:sequencingCollection> | NP | O |
Best Practices and Practical Guidelines
The following section describes a set of recommended best practices and practical guidelines for the development of content packages. These best practices are not considered conformance requirements.
Multiple Organizations for a Single Course
The content package allows for representations of multiple organizations for its resources. The same resources may be used in different content organizations adapted for different audiences. For example, one may find value in forcing novice users to progress through content in a linear manner without the ability to skip any instructional units, while advanced users may want to use the content as a refresher by selecting only the instructional units that they would like to experience. Multiple organizations can be used to structure a set of resources in different ways for different reasons. The utilization of multiple organization elements is ideal for the use case.
Using the <dependency> Element
Several learning resources, defined in a content package, may contain the same set of files. The files are represented as <file> elements in the manifest. The <dependency> element can be used to group these sets of files. The use of the <dependency> element in this scenario will alleviate the duplication of the <file> element for each set of files in each resource. In this scenario, a <resource> element can be used to gather the set of files. Once the <resource> is set up, all of the other resources that depend on the set of files can reference the resource by using the <dependency> element.
<manifest>
<organizations>
<organization>
<item identifier="ID1" identifierref="R_ID1"></item>
<item identifier="ID2" identifierref="R_ID2"></item>
</organization>
</organizations>
<resources>
<resource identifier="R_ID1" adlcp:scormType="sco" href="index_1.htm">
<file href="index_1.htm"/>
<file href="image1.jpg"/>
<file href="image2.jpg"/>
<file href="image3.jpg"/>
<file href="apiWrapper.js"/>
</resource>
<resource identifier="R_ID2" adlcp:scormType="sco" href="index_1.htm">
<file href="index.htm"/>
<file href="image1.jpg"/>
<file href="image2.jpg"/>
<file href="image3.jpg"/>
<file href="image4.gif"/>
<file href="apiWrapper.js"/>
</resource>
</resources>
</manifest>
Code Illustration 3-31: Sharing of Files
In Code Illustration 3-31: Sharing of Files, the two defined resources both share a common set of files:
image1.jpg
image2.jpg
image3.jpg
apiWrapper.js
These sets of files are repeated, as <file> elements, for each resource. The method described above can be used to eliminate the repeating of these <file> elements.
<manifest>
<organizations>
<organization>
<item identifier="ID1" identifierref="R_ID1"></item>
<item identifier="ID2" identifierref="R_ID2"></item>
</organization>
</organizations>
<resources>
<resource identifier="R_ID1" adlcp:scormType="sco" href="index_1.htm">
<file href="index_1.htm"/>
<dependency identifierref="DEP_R_ID1"/>
</resource>
<resource identifier="R_ID2" adlcp:scormType="sco" href="index_1.htm">
<file href="index.htm"/>
<file href="image4.gif"/>
<dependency identifierref="DEP_R_ID1"/>
</resource>
<resource identifier="DEP_R_ID1" adlcp:scormType="asset">
<file href="image1.jpg"/>
<file href="image2.jpg"/>
<file href="image3.jpg"/>
<file href="apiWrapper.js"/>
</resource>
</resources>
</manifest>
Code Illustration 3-32: Dependency Resource Example
In Code Illustration 3-32: Dependency Resource Example, a resource was created to hold the commonly used set of files. The resource was given a unique identifier, as required. The newly created resource is an asset. No href attribute was provided by the resource. The asset will never be launched by an LMS (no <item> identifierref references the resource). The resources that share these sets of files now contain a
<dependency> element that references, using the identifierref attribute, the newly created resource.
This page intentionally left blank.
Metadata
From IEEE Std. 1484.11.1-2004 IEEE Standard for Learning Technology – Data Model for Content to Learning Management System Communication, Copyright 2004 IEEE; IEEE Std. 1484.11.2-2003 IEEE Standard for Learning Technology – ECMAScript Application Programming Interface for Content to Runtime Services Communication, Copyright 2003 IEEE; IEEE Std. 1484.12.1- 2002 IEEE Standard for Learning Object Metadata, Copyright 2002 IEEE; and IEEE Std. 1484.12.3-2005 IEEE Standard for Learning Technology – Extensible Markup Language (XML) Schema Definition Language Binding for Learning Object Metadata, Copyright 2005 IEEE. All rights reserved.
From IMS Content Packaging v1.1.4 Copyright 2004, by IMS Global Learning Consortium Inc. and IMS Simple Sequencing v1.0 Copyright 2003, by IMS Global Learning Consortium Inc. All rights reserved.
This page intentionally left blank.
Metadata Overview
Up to this point, SCORM has described the basic building blocks (SCORM Content Model Components) for content development. SCORM has also described how to bundle the building blocks into Content Aggregations and package those pieces for distribution from system to system. Once the SCORM Content Model Components have been built, it may be useful to describe those components in a consistent manner.
Describing the components with metadata facilitates the search and discovery of the components across systems. An LMS could use the metadata to give the learner information about the content organization (i.e., course, lesson, module, etc.). Metadata can also be used at run-time to help in the decision of what content model component to deliver to the learner.
This section provides specific requirements and guidance for using metadata to describe SCORM Content Model Components. The metadata defined in this section is directly based on the IEEE 1484.12.1-2002 Learning Object Metadata (LOM) [11] standard and the IEEE 1484.12.3 Standard for Extensible Markup Language (XML) Binding for Learning Object Metadata Data Model [14]. The IEEE provides roughly 64 metadata elements that can be used to describe SCORM Content Model Components. SCORM strongly recommends the use of the IEEE LOM for describing SCORM Content Model Components
There are currently no requirements defined in SCORM for the creation of metadata and the association of that metadata to the specific SCORM Content Model Components.
SCORM recognizes that the IEEE LOM is the defacto standard for metadata within the learning community and strongly recommends that LOM be used when describing SCORM Content Model Components. Although the Content Package Manifest provides a means for associating metadata instances to the SCORM Content Model Components, SCORM does not require such use. Organizations should work to define use cases and requirements around the creation of metadata and the association to SCORM Content Model Components. For example, the U.S. Department of Defense (DoD) provides the ADL Registry for registering content objects across the DoD and related organizations to enable search and discovery of registered content. The ADL Registry provides a specific application profile of LOM that defines additional requirements and practices for using IEEE LOM when registering content within the ADL Registry. For more information on the ADL Registry’s use of IEEE LOM refer to https://adlregistry.dtic.mil. ADL encourages communities of practice and organizations to determine the set of elements to be used, additional requirements and practices around their use and any constraints.
The following section is broken up into five basic subsections each describing a different aspect of Metadata and how it relates to SCORM:
Section 4.1: Metadata Overview. This section provides a general overview and background information on LOM and its relationship to SCORM.
Section 4.2: LOM Metadata Creation. This section defines requirements and guidance for creating metadata. The section provides the details on the requirements defined by IEEE and the details on building XML instances adhering to the IEEE LOM requirements.
Section 4.3: LOM XML Schema Validation Approaches. This section describes the validation approaches developed by IEEE and described in the IEEE Standard for XML Binding for LOM Data Model. The validation approaches provide different support for XML validation requirements depending on user needs.
Section 4.4: Metadata Extensions. This section describes the extension capabilities defined by IEEE Standard for XML Binding for Learning Object Metadata Data Model and SCORM. The section also discusses the pros and cons to creating extensions.
Section 4.5: Metadata and SCORM Content Model Components. This section describes one method for how metadata could be associated with the SCORM Content Model Components.
The purpose of metadata is to provide a common nomenclature enabling learning resources to be described in a common way. Metadata can be collected in catalogs, as well as directly packaged with the learning resource it describes. Learning resources that are described with metadata can be systematically searched for and retrieved for use and reuse.
SCORM describes how the IEEE LOM metadata element can be mapped to SCORM Content Model Components described in the Content Aggregation Model. This mapping of standardized elements and definitions from IEEE to the SCORM CAM provides the missing link between general specifications and specific content models.
LOM Metadata Creation
The following sections outline the LOM XML metadata elements. According to the IEEE, every LOM metadata element is optional. This implies that when building an XML metadata instance, the developer can optionally pick and choose which elements to use.
The IEEE LOM Information Model describes the set of data elements that are available to build metadata. The LOM Information Model is broken up into nine categories.
These categories are based on the definitions found in the LOM Information Model. The nine categories of metadata elements are:
The General category can be used to describe general information about the SCORM Content Model Component as a whole.
The Life Cycle category can be used to describe features related to the history and current state of the SCORM Content Model Component and those who have affected the component during its evolution.
The Meta-metadata category can be used to describe information about the metadata record itself (rather than the SCORM Content Model Component that the record describes).
The Technical category can be used to describe technical requirements and characteristics of the SCORM Content Model Components.
The Educational category can be used to describe the educational and pedagogic characteristics of the SCORM Content Model Component.
The Rights category can be used to describe the intellectual property rights and conditions of use for the SCORM Content Model Component.
The Relation category can be used to describe features that define the relationship between this SCORM Content Model Component and other targeted components.
The Annotation category can be used to provide comments on the educational use of the SCORM Content Model Component and information on when and by whom the comments were created.
The Classification category can be used to describe where the SCORM Content Model Component falls within a particular classification system.
Some elements use the term smallest permitted maximum (SPM) in describing the multiplicity and/or data types. The SPM indicates that applications that process metadata shall process at least that number of elements or number of characters, but are free to support and exceed the limit.
Table 4.2a: Explanation of Multiplicity Requirements
Multiplicity Requirement | Explanation |
1 and only 1 | The element must exist 1 and only 1 time within the parent element |
0 or More | The element can exist 0 or More times within the parent element. |
1 or More | The element must exist 1 or More times within the parent element. |
0 or 1 | The element can exist 0 or 1 time within the parent element. |
Table 4.2a defines the types of multiplicities that are used in this section. Each type is accompanied by a brief explanation. The table also has definitions for SPMs for those elements that have a multiplicity of more than 1. The SPM indicates the smallest number of elements that must be supported by a processing system.
<lom> Element
All metadata instances shall have <lom> as the root node. The root node begins to define the metadata used to describe the SCORM Content Model Component. When placed in a content package (refer to Section 4.5.1: Associating Metadata with SCORM Components), all metadata is placed within a <imscp:metadata> element (refer to Section 3.4.1: Manifest File) found in an imsmanifest.xml file. The <lom> root node encapsulates all of the categories described above. There is no implied order of the nine categories. The child elements can appear in any order.
All namespace declarations should be declared inside the <lom> element. This includes any namespaces that are considered extensions to the metadata. Although this is not considered a requirement, based on the XML specifications, ADL considers this to be a “best practice” and urges vendors and tools to provide this information.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Namespace Prefix: lom
XML Binding Representation: <lom>
Multiplicity Requirements: The <lom> element contains important elements that SCORM requires to describe all of the SCORM Content Model Components. If LOM metadata is being used to describe the SCORM Content Model Components then, the
<lom> element shall appear 1 and only 1 time.
ADL Note: The multiplicity requirements for the <lom> element imply that the <lom> element (the root element of a LOM Instance) shall appear 1 and only 1 time for a given LOM Instance. More than one LOM Instance could be used to describe a given SCORM Content Model Component. In these cases, the <lom> element may appear 0 or More times as a direct descendant of the <imscp:metadata> element (refer to Section 3.4.1.2
<metadata> Element for more information).
Data Type: The <lom> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The <lom> element contains the following child elements:
<general>
<lifeCycle>
<metaMetadata>
<technical>
<educational>
<rights>
<relation>
<annotation>
<classification>
The example is used to illustrate the concepts described above. The nine category elements are represented as empty elements for simplicity.
<lom xmlns="http://ltsc.ieee.org/xsd/LOM">
<general/>
<classification/>
<annotation/>
<lifeCycle/>
<technical/>
<metaMetadata/>
<educational/>
<relation/>
<rights/>
</lom>
Code Illustration 4-1: <lom> Element
<general> Element
The General category groups the general information that describes the resource as a whole. The resource in this case is the particular SCORM Content Model Component (Asset, SCO, Activity, Content Organization or Content Aggregation) being described. This general information is sometimes viewed as key information in that it is important for describing the particular component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <general>
Multiplicity Requirements: The <general> element shall appear 0 or 1 time.
Data Type: The <general> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<general> element contains the following child elements:
<identifier>
<title>
<language>
<description>
<keyword>
<coverage>
<structure>
<aggregationLevel>
<lom>
<general>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/content/CO_01</entry>
</identifier>
<title>
<string language="en">Title for the learning object</string>
</title>
<language>en</language>
<description>
<string language="en">Textual description</string>
</description>
<keyword>
<string language="en">learning object</string>
</keyword>
<coverage>
<string language="en">Circa, 16th century France</string>
</coverage>
<structure>
<source>LOMv1.0</source>
<value>atomic</value>
</structure>
<aggregationLevel>
<source>LOMv1.0</source>
<value>2</value>
</aggregationLevel>
</general>
</lom>
Code Illustration 4-2: <general> Element
<identifier> Element
The <identifier> element represents a mechanism for assigning a globally unique label that identifies the SCORM Content Model Component. The notion of assigning a globally unique identifier to a component is important when dealing with multiple facets of learning content development (e.g., versioning, maintenance, etc.).
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <identifier>
Multiplicity Requirements: The <identifier> element shall appear 0 or More times. The <identifier> element has an SPM of 10.
Data Type: The <identifier> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<identifier> element contains the following child elements:
<catalog>
<entry>
Example:
<lom>
<general>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/content/CO_01</entry>
</identifier>
</general>
</lom>
Code Illustration 4-3: <identifier> Element
<catalog> Element
The <catalog> element represents the name or designator of the identification or cataloging scheme for the entry. There are a variety of cataloging systems available. SCORM does not require the use of any one particular cataloging system. Organizations are free to choose any cataloging scheme that meets their organizations practices or policies. Some types of cataloging systems are:
Universal Resource Identifier (URI)
Universal Resource Name (URN)
Digital Object Identifier (DOI)
International Standard Book Numbers (ISBN)
International Standard Serial Numbers (ISSN).
The <catalog> element represents the scheme used to create and manage the entry.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <catalog>
Multiplicity Requirements: The <catalog> element shall appear 0 or 1 time.
Data Type: The <catalog> element is represented as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<general>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/content/CO_01</entry>
</identifier>
</general>
</lom>
Code Illustration 4-4: <catalog> Element
<entry> Element
The <entry> element represents the value of the identifier within the identification or cataloging scheme (refer to the <catalog> element) that designates or identifies the learning object.
Identifiers can take on various formats. The IEEE requires that the actual identifier value be represented as a CharacterString. Organizations are free to choose any mechanism to create unique identifiers that meets their organizations practices or policies.
The following listing is a sampling of identifier values (entry):
Scheme (<catalog>) | Value (<entry>) |
Universal Resource Name | urn:ADL: 1345-GFGC-23ED-3321 |
Universal Resource Identifier | |
Handle Syntax | 100.100/2345342256349543 |
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <entry>
Multiplicity Requirements: The <entry> element shall appear 0 or 1 time.
Data Type: The <entry> element’s value is represented as a CharacterString. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<general>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/content/CO_01</entry>
</identifier>
</general>
</lom>
Code Illustration 4-5: <entry> Element
<title> Element
The <title> element represents the name given to the learning object.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <title>
Multiplicity Requirements: The <title> element shall appear 0 or 1 time.
Data Type: The <title> element is represented as a LangString element. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<general>
<title>
<string language="en">Sharable Content Object Reference Model</string>
</title>
</general>
</lom>
Code Illustration 4-6: <title> Element
<language> Element
The <language> element represents the primary human language or languages used within the SCORM Content Model Component to communicate to the intended user. The Language element can be repeated. This allows for the ability to describe components that are built to support multiple languages.
The value held by the <language> element shall be represented according to the following:
Language = Langcode(“-“Subcode)*
Langcode – Represents a language code as defined by ISO 639:1988. This value is mandatory.
Subcode – Represents a country code from the code set defined by ISO 3166-1997. This value can be repeated and is optional.
The <language> element may also have a value of none, if the SCORM Content Model Component has no lingual content.
Examples:
“en”
“en-GB”
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <language>
Multiplicity Requirements: The <language> element shall appear 0 or More times. The <language> element has an SPM of 10.
Data Type: The <language> element is represented as a CharacterString element. The CharacterString has an SPM of 100 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<general>
<language>en</language>
<language>fr</language>
</general>
</lom>
Code Illustration 4-7: <language> Element
<description> Element
The <description> element represents a textual description of the SCORM Content Model Component being described by the metadata. The Description element allows for a narrative description of the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <description>
Multiplicity Requirements: The <description> element shall appear 0 or More times. The <description> element has an SPM of 10.
Data Type: The <description> element is represented as a LangString element. The LangString has an SPM of 2000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<general>
<description>
<string language="en">Textual description of the learning object</string>
</description>
</general>
</lom>
Code Illustration 4-8: <description> Element
<keyword> Element
The <keyword> element shall be used to define common keywords or phrases that describe the learning object. When creating keyword(s), the creator should pick words or phrases that are very succinct and specific to the SCORM component. The Keyword element consists of one word or phrase. If more than one Keyword is desired, the creator should use multiple instances of the Keyword element.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <keyword>
Multiplicity Requirements: The <keyword> element shall appear 0 or More times. The
<keyword> element has an SPM of 10.
Data Type: The <keyword> element is represented as a LangString element. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<general>
<keyword>
<string language="en">learning object</string>
<string language="nl">leerobject</string>
<string language="fr">objet d’apprentissage</string>
</keyword>
<keyword>
<string language="en">metadata</string>
<string language="nl">metadata</string>
<string language="fr">métadonnées</string>
</keyword>
</general>
</lom>
Code Illustration 4-9: <keyword> Element
<coverage> Element
The <coverage> element shall be used to describe the time, culture, geography or region to which the SCORM Content Model Component applies.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <coverage>
Multiplicity Requirements: The <coverage> element shall appear 0 or More times. The <coverage> element has an SPM of 10.
Data Type: The <coverage> element is represented as a LangString element. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<general>
<coverage>
<string language="en">Circa, 16th century France</string>
</coverage>
</general>
</lom>
Code Illustration 4-10: <coverage> Element
<structure> Element
The <structure> element shall describe the underlying organizational structure of the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <structure>
Multiplicity Requirements: The <structure> element shall appear 0 or 1 time.
Data Type: The <structure> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
atomic: An object that is indivisible.
collection: A set of objects with no specified relationship between them.
networked: A set of objects with relationships that are unspecified.
hierarchical: A set of objects whose relationships can be represented by a tree structure.
linear: A set of objects that are fully ordered. Example: A set of objects that are connected by “previous” and “next” relationships.
Example:
<lom>
<general>
<structure>
<source>LOMv1.0</source>
<value>atomic</value>
</structure>
</general>
</lom>
Code Illustration 4-11: <structure> Element
<aggregationLevel> Element
The <aggregationLevel> element shall describe the functional granularity of the learning object.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <aggregationLevel>
Multiplicity Requirements: The <aggregationLevel> element shall appear 0 or 1 time.
Data Type: The <aggregationLevel> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
1: The smallest level of aggregation, e.g., raw media data or fragments.
2: A collection of level 1 learning objects, e.g., a lesson.
3: A collection of level 2 learning objects, e.g., a course.
4: The largest level of granularity, e.g., a set of courses that lead to a certificate.
Example:
<lom>
<general>
<aggregationLevel>
<source>LOMv1.0</source>
<value>2</value>
</aggregationLevel>
</general>
</lom>
Code Illustration 4-12: <aggregationLevel> Element
<lifeCycle> Element
The Life Cycle category groups the features related to the history and current state of the SCORM Content Model Component and those who have affected the component during its evolution. The typical types of information collected in this category include the status of the component (e.g., is the component in its final state or is it still in a draft format), a version identifier indicating the version of the component and a list of individuals/organizations that have affected the component in one manner or another.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <lifeCycle>
Multiplicity Requirements: The <lifeCycle> element shall appear 0 or 1 time.
Data Type: The <lifeCycle> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<lifeCycle> element contains the following child elements:
<version>
<status>
<contribute>
Example:
<lom>
<lifeCycle>
<version>
<string language="en">1.0 alpha</string>
</version>
<status>
<source>LOMv1.0</source>
<value>final</value>
</status>
<contribute>
<role>
<source>LOMv1.0</source>
<value>author</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Friday END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">A description for the date</string>
</description>
</date>
</contribute>
</lifeCycle>
</lom>
Code Illustration 4-13: <lifeCycle> Element
<version> Element
The <version> element shall describe the edition of the SCORM Content Model Component. A component may have several versions or editions during its lifetime. The
<version> element allows for the description of the version of the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <version>
Multiplicity Requirements: The <version> element shall appear 0 or 1 time.
Data Type: The <version> element is represented as a LangString element. The LangString has an SPM of 50 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<lifeCycle>
<version>
<string language="en">1.0 alpha</string>
</version>
</lifeCycle>
</lom>
Code Illustration 4-14: <version> Element
<status> Element
The <status> element shall describe the completion status or condition of the SCORM Content Model Component. A component’s status may change during its lifetime (draft, final, etc.). The <status> element allows for the description of the status of the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <status>
Multiplicity Requirements: The <status> element shall appear 0 or 1 time.
Data Type: The <status> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
draft: The component is in a draft state (as determined by the developer).
final: The component is in a final state (as determined by the developer).
revised: The component has been revised since the last version.
unavailable: The status information is unavailable.
<lom>
<lifeCycle>
<status>
<source>LOMv1.0</source>
<value>final</value>
</status>
</lifeCycle>
</lom>
Code Illustration 4-15: <status> Element
<contribute> Element
The <contribute> element shall be used to describe those entities (i.e., people, organizations) that have contributed to the state of the SCORM Content Model Component during its lifecycle (e.g., creation, edits, reviews, publications, etc.). The Contribute element enables capturing of all those individuals or organizations involved.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <contribute>
Multiplicity Requirements: The <contribute> element shall appear 0 or More times. The <contribute> element has an SPM of 30.
Data Type: The <contribute> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<contribute> element contains the following child elements:
<role>
<entity>
<date>
<lom>
<lifeCycle>
<contribute>
<role>
<source>LOMv1.0</source>
<value>author</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Friday END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">A description for the date</string>
</description>
</date>
</contribute>
</lifeCycle>
</lom>
Code Illustration 4-16: <contribute> Element
<role> Element
The <role> element defines the kind or type of contribution made by the contributor (identified by the Entity element). The IEEE has defined a set of typical roles that are involved with the lifecycle of the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <role>
Multiplicity Requirements: The <role> element shall appear 0 or 1 time.
Data Type: The <role> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
author
publisher
unknown
initiator
terminator
validator
editor
graphical designer
technical implementer
content provider
technical validator
educational validator
script writer
instructional designer
subject matter expert
<lom>
<lifeCycle>
<contribute>
<role>
<source>LOMv1.0</source>
<value>author</value>
</role>
</contribute>
</lifeCycle>
</lom>
Code Illustration 4-17: <role> Element
<entity> Element
The <entity> element identifies the entity or entities that may have contributed during the development lifecycle of the SCORM Content Model Component. An entity can be an individual person, organization, etc. If more than one entity is listed, the entities shall be ordered as most relevant first.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <entity>
Multiplicity Requirements: The <entity> element shall appear 0 or More times. The
<entity> element has an SPM 40.
Data Type: The <entity> element is a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information). All entity values shall be represented in vCard [9] format. This allows systems to take the CharacterString represented by the <entity> element and process this CharacterString as a valid vCard.
<lom>
<lifeCycle>
<contribute>
<role>
<source>LOMv1.0</source>
<value>author</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Author END:VCARD</entity>
<entity>BEGIN:VCARD VERSION:2.1 FN:Mary
Author END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">A description for the date</string>
</description>
</date>
</contribute>
</lifeCycle>
</lom>
Code Illustration 4-18: <entity> Element
<date> Element
The <date> element identifies the date of the contribution made by the entity.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <date>
Multiplicity Requirements: The <date> element shall appear 0 or 1 time.
Data Type: The Date element is represented as a DateTime data type (refer to Section 4.2.11.4: DateTime Data Type for more information). The <date> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The <date> element contains two elements, one that represents the actual date of the contribution (<dateTime>) and one that represents a textual description of the date (<description>):
<dateTime>
<description>
<lom>
<lifeCycle>
<contribute>
<role>
<source>LOMv1.0</source>
<value>author</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Author END:VCARD</entity>
<entity>BEGIN:VCARD VERSION:2.1 FN:Mary
Author END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">This date represents the date the author finished authoring the component.</string>
</description>
</date>
</contribute>
</lifeCycle>
</lom>
Code Illustration 4-19: LifeCycle Contribute <date> Element
<metaMetadata> Element
The Meta-Metadata category provides elements that describe the metadata record itself and not the SCORM Content Model Component the record is describing. This category describes how the metadata instance itself can be identified, who created the metadata instance, how, when and with what references.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <metaMetadata>
Multiplicity Requirements: The <metaMetadata> element shall appear 0 or 1 time.
Data Type: The <metaMetadata> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<metaMetadata> element contains the following child elements:
<identifier>
<contribute>
<metadataSchema>
<language>
Example:
<lom>
<metaMetadata>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/metadata/MDO_01</entry>
</identifier>
<contribute>
<role>
<source>LOMv1.0</source>
<value>creator</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe Metadata
Creator END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">This date represents the date the creator finished authoring the metadata.</string>
</description>
</date>
</contribute>
<metadataSchema>LOMv1.0</metadataSchema>
<metadataSchema>ADLv1.0</metadataSchema>
<language>en</language>
</metaMetadata>
</lom>
Code Illustration 4-20: <metaMetadata> Element
<identifier> Element
The <identifier> element represents a mechanism for assigning a globally unique label that identifies the metadata record that describes the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <identifier>
Multiplicity Requirements: The <identifier> element shall appear 0 or More times. The <identifier> element has an SPM of 10.
Data Type: The <identifier> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<identifier> element contains the following child elements:
<catalog>
<entry>
Example:
<lom>
<metaMetadata>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/metadata/MDO_01</entry>
</identifier>
</metaMetadata>
</lom>
Code Illustration 4-21: Meta-Metadata <identifier> Element
<catalog> Element
The <catalog> element represents the name or designator of the identification or cataloging scheme for the entry. There are a variety of cataloging systems available. SCORM does not require the use of any one particular cataloging system. Organizations are free to choose any cataloging scheme that meets their organizations practices or policies. Some types of cataloging systems are:
Universal Resource Identifier (URI)
Universal Resource Name (URN)
Digital Object Identifier (DOI)
International Standard Book Numbers (ISBN)
International Standard Serial Numbers (ISSN).
The <catalog> element represents the scheme used to create and manage the entry.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <catalog>
Multiplicity Requirements: The <catalog> element shall appear 0 or 1 time.
Data Type: The <catalog> element is represented as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<metaMetadata>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/metadata/MDO_01</entry>
</identifier>
</metaMetadata>
</lom>
Code Illustration 4-22: Meta-Metadata Identifier <catalog> Element
<entry> Element
The <entry> element represents the value of the identifier within the identification or cataloging scheme (refer to the <catalog> element) that designates or identifies the metadata.
Identifiers can take on various formats. The IEEE requires that the actual identifier value be represented as a CharacterString. Organizations are free to choose any mechanism to create unique identifiers that meets their organizations practices or policies. It is recommended that a common scheme be chosen.
The following listing is a sampling of identifier values (entry):
Scheme (<catalog>) | Value (<entry>) |
Universal Resource Name | urn:ADL: 1345-GFGC-23ED-3321 |
Universal Resource Identifier | |
Handle Syntax | 100.100/2345342256349543 |
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <entry>
Multiplicity Requirements: The <entry> element shall appear 0 or 1 time.
Data Type: The <entry> element is represented as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
<lom>
<metaMetadata>
<identifier>
<catalog>URI</catalog>
<entry>http://www.adlnet.gov/metadata/MDO_01</entry>
</identifier>
</metaMetadata>
</lom>
Code Illustration 4-23: Meta-Metadata Identifier <entry> Element
<contribute> Element
The <contribute> element shall be used to describe those entities (i.e., people, organizations) that have affected the state of the metadata (not the SCORM Content Model Component being described) instance during its development lifecycle. The
<contribute> element enables capturing of all those individuals or organizations involved.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <contribute>
Multiplicity Requirements: The <contribute> element shall appear 0 or More times. The <contribute> element has an SPM of 10.
Data Type: The <contribute> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<contribute> element contains the following child elements:
<role>
<entity>
<date>
<lom>
<metaMetadata>
<contribute>
<role>
<source>LOMv1.0</source>
<value>creator</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe Metadata
Creator END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">This date represents the date the creator finished authoring the metadata.</string>
</description>
</date>
</contribute>
</metaMetadata>
</lom>
Code Illustration 4-24: Meta-Metadata <contribute> Element
<role> Element
The <role> element defines the kind or type of contribution made by the contributor (identified by the Entity element). The IEEE has defined a set of typical roles that are involved with the development lifecycle of the metadata instance.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <role>
Multiplicity Requirements: The <role> element shall appear 0 or 1 time.
Data Type: The <role> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
creator
validator
<lom>
<metaMetadata>
<contribute>
<role>
<source>LOMv1.0</source>
<value>creator</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe Metadata
Creator END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">This date represents the date the creator finished authoring the metadata.</string>
</description>
</date>
</contribute>
</metaMetadata>
</lom>
Code Illustration 4-25: Meta-Metadata Contribute <role> Element
<entity> Element
The <entity> element identifies the entity or entities that may have contributed during the development lifecycle of the metadata instance. An entity can be an individual person, organization, etc. If more than one entity is listed, the entities shall be ordered as most relevant first.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <entity>
Multiplicity Requirements: The <entity> element shall appear 0 or More times. The
<entity> element has an SPM of 10.
Data Type: The <entity> element as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information). All entity values shall be represented in vCard [9] format. This allows systems to take the CharacterString represented by the <entity> element and process this CharacterString as a valid vCard.
<lom>
<metaMetadata>
<contribute>
<role>
<source>LOMv1.0</source>
<value>creator</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe Metadata
Creator END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">This date represents the date the creator finished authoring the metadata.</string>
</description>
</date>
</contribute>
</metaMetadata>
</lom>
Code Illustration 4-26: Meta-Metadata Contribute <entity> Element
<date> Element
The <date> element identifies the date of the contribution made by the entity.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <date>
Multiplicity Requirements: The <date> element shall appear 0 or 1 time.
Data Type: The Date element is represented as a DateTime data type (refer to Section 4.2.11.4: DateTime Data Type for more information). The <date> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The <date> element contains two elements, one that represents the actual date of the contribution (<dateTime>) and one that represents a textual description of the date (<description>):
<dateTime>
<description>
<lom>
<metaMetadata>
<contribute>
<role>
<source>LOMv1.0</source>
<value>creator</value>
</role>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe Metadata
Creator END:VCARD</entity>
<date>
<dateTime>2002-12-12</dateTime>
<description>
<string language="en">This date represents the date the creator finished authoring the metadata.</string>
</description>
</date>
</contribute>
</metaMetadata>
</lom>
Code Illustration 4-27: Meta-Metadata Contribute <date> Element
<metadataSchema> Element
The <metadataSchema> element represents the name and version of the authoritative specification used to create the metadata instance. If multiple values are provided, then the metadata instance shall conform to multiple metadata schemas.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <metadataSchema>
Multiplicity Requirements: The <metadataSchema> element shall appear 0 or More times. The <metadataSchema> element has an SPM of 10.
If metadata instances are created that conform to the IEEE LOM XML Binding and the
<metadataSchema> element is present, the IEEE standard requires you to identify that it is conforming to the standard. This requires the <metadataSchema> element to contain the value of LOMv1.0.
Data Type: The <metadataSchema> element is represented as a CharacterString element. The CharacterString has an SPM of 30 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<metaMetadata>
<metadataSchema>LOMv1.0</metadataSchema>
</metaMetadata>
</lom>
Code Illustration 4-28: <metadataSchema> Element
4.2.4.4. <language> Element
The <language> element represents the language of the metadata instance (i.e., the language of all values found in LangStrings). This value represents the default language for all LangStrings. If a value for this data element is not present in a metadata instance, then there is no default language for LangString values. If this value is provided, it is not necessary to indicate a language value for LangString elements.
The value held by the <language> element shall be represented according to the following:
Language = Langcode(“-“Subcode)*
Langcode – Represents a language code as defined by ISO 639:1988. This value is mandatory.
Subcode – Represents a country code from the code set defined by ISO 3166-1997. This value can be repeated and is optional.
Examples:
“en”
“en-GB”
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <language>
Multiplicity Requirements: The <language> element shall appear 0 or 1 time.
Data Type: The <language> element is represented as a CharacterString element. The CharacterString has an SPM of 100 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<metaMetadata>
<language>en</language>
</metaMetadata>
</lom>
Code Illustration 4-29: Meta-Metadata <language> Element
<technical> Element
The Technical category describes all of the technical characteristics and requirements of the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <technical>
Multiplicity Requirements: The <technical> element shall appear 0 or 1 time.
Data Type: The <technical> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<technical> element contains the following child elements:
<format>
<size>
<location>
<requirement>
<installationRemarks>
<otherPlatformRequirements>
<duration>
Example:
<lom>
<technical>
<format>text/html</format>
<size>1024</size>
<location>Lesson01/Module01/Resources/SCO01.htm</location>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
</requirement>
<installationRemarks>
<string language="en">This activity requires the client browser to have a Macromedia Flash plugin installed.</string>
</installationRemarks>
<otherPlatformRequirements>
<string language="en">Sound card, Min. RAM: 16Mb, Video card and display: at least 800 X 600 pixels x 256 colors</string>
</otherPlatformRequirements>
<duration>
<duration>P5Y</duration>
<description>
<string language="en">Length of time to play simulation</string>
</description>
</duration>
</technical>
</lom>
Code Illustration 4-30: <technical> Element
<format> Element
The <format> element represents the technical datatype(s) of all of the components used in the makeup of the SCORM Content Model Component. This element is used to identify any potential software needs to access and use the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <format>
Multiplicity Requirements: The <format> element shall appear 0 or More times. The
<format> element has an SPM of 40.
Data Type: The <format> element is represented as a CharacterString element. The CharacterString has an SPM of 500 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information). The CharacterString shall be a MIME type based on IANA registration (refer to RFC 2048:1996) or the string literal, “non-digital”.
<lom>
<technical>
<format>video/mpeg</format>
<format>text/html</format>
</technical>
</lom>
Code Illustration 4-31: <format> Element
<size> Element
The <size> element represents the size of the digital SCORM Content Model Component in bytes. The size is represented as a decimal value (radix 10). Only the digits “0” through “9” should be used. This data element shall refer to the actual size of the SCORM Component. If the component is compressed, then this data element shall refer to the uncompressed size.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <size>
Multiplicity Requirements: The <size> element shall appear 0 or 1 time.
Data Type: The <size> element is represented as a CharacterString element. The CharacterString has an SPM of 30 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<technical>
<size>345</size>
</technical>
</lom>
Code Illustration 4-32: <size> Element
<location> Element
The <location> element is a string that specifies the location of the SCORM Content Model Component described by the metadata.
This element could be used to describe one or more alternate locations where the SCORM Content Model Component can also be found, in addition to the content package itself (e.g., a known fixed location).
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <location>
Multiplicity Requirements: The <location> element shall appear 0 or More times. The <location> element has an SPM of 10.
Data Type: The <location> element is represented as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
Code Illustration 4-33: <location> Element
<requirement> Element
The <requirement> element expresses the technical capabilities necessary for using the SCORM Content Model Component. The <requirement> element is repeatable. If multiple requirements are needed, then all of the requirements are required (logical connector is an AND).
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <requirement>
Multiplicity Requirements: The <requirement> element shall appear 0 or More times. The <requirement> element has an SPM of 40.
Data Type: The <requirement> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<requirement> element contains the following child elements:
<orComposite>
<lom>
<technical>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
</requirement>
</technical>
</lom>
Code Illustration 4-34: <requirement> Element
<orComposite> Element
The <orComposite> element represents a single requirement. Multiple <orComposite>
elements are connected with a logical connecter of “or”. XML Namespace: http://ltsc.ieee.org/xsd/LOM XML Binding Representation: <orComposite>
Multiplicity Requirements: The <orComposite> element shall appear 0 or More times. The <orComposite> element has an SPM of 40.
Data Type: The <orComposite> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<orComposite> element contains the following child elements:
<type>
<name>
<minimumVersion>
<maximumVersion>
Example: The following metadata indicates that the component being described will execute in either of the following Web browsers:
Microsoft Internet Explorer
Minimum Version: 5.0
Maximum Version 6.0
or
Netscape Communicator
Minimum Version: 4.7.9
Maximum Version 5.0
<lom>
<technical>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>netscape communicator</value>
</name>
<minimumVersion>4.7.9</minimumVersion>
<maximumVersion>5.0</maximumVersion>
</orComposite>
</requirement>
</technical>
</lom>
Code Illustration 4-35: <orComposite> Element
<type> Element
The <type> element represents the technology required to use the SCORM Content Model Component (e.g., hardware, software, network, etc.).
If the metadata instance contains a <type> element then a corresponding <name> element shall exist to describe more details about the type.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <type>
Multiplicity Requirements: The <type> element shall appear 0 or 1 time.
Data Type: The <type> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
operating system
browser
<lom>
<technical>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
</requirement>
</technical>
</lom>
Code Illustration 4-36: <type> Element
<name> Element
The <name> element represents the required technology to use the SCORM Content Model Component. The value used for the Name element depends on the value identified by the Value element.
If the metadata instance contains a <name> element then a corresponding <type> element shall exist to describe more details about the required technology.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <name>
Multiplicity Requirements: The <name> element shall appear 0 or 1 time.
Data Type: The <name> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens: If Requirement.OrComposite.Type = “operating system”:
pc-dos
ms-windows
macos
unix
multi-os
none
If Requirement.OrComposite.Type = “browser”:
any
netscape communicator
ms-internet explorer
opera
amaya
Example:
<lom>
<technical>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
</requirement>
</technical>
</lom>
Code Illustration 4-37: <name> Element
<minimumVersion> Element
The <minimumVersion> element represents the lowest possible version of the required technology to use the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <minimumVersion>
Multiplicity Requirements: The <minimumVersion> element shall appear 0 or 1 time.
Data Type: The <minimumVersion> element is represented as a CharacterString. The CharacterString has an SPM of 30 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
<lom>
<technical>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
</requirement>
</technical>
</lom>
Code Illustration 4-38: <minimumVersion> Element
<maximumVersion> Element
The <maximumVersion> element represents the highest possible version of the required technology to use the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <maximumVersion>
Multiplicity Requirements: The <maximumVersion> element shall appear 0 or 1 time.
Data Type: The <maximumVersion> element is represented as a CharacterString. The CharacterString has an SPM of 30 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
<lom>
<technical>
<requirement>
<orComposite>
<type>
<source>LOMv1.0</source>
<value>browser</value>
</type>
<name>
<source>LOMv1.0</source>
<value>ms-internet explorer</value>
</name>
<minimumVersion>5.0</minimumVersion>
<maximumVersion>6.0</maximumVersion>
</orComposite>
</requirement>
</technical>
</lom>
Code Illustration 4-39: <maximumVersion> Element
<installationRemarks> Element
The <installationRemarks> element is used to represent any specific instructions on how to install the SCORM Content Model Component. This element could be used to describe to the user (e.g., LMS, Content Developer, Authoring Tool) of the component any particular instructions for use. It may be used to describe, in more detail, the technical requirements for the SCORM component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <installationRemarks>
Multiplicity Requirements: The <installationRemarks> element shall appear 0 or 1 time.
Data Type: The <installationRemarks> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<technical>
<installationRemarks>
<string language="en">This activity requires the client browser to have a Macromedia Flash plugin installed.</string>
</installationRemarks>
</technical>
</lom>
Code Illustration 4-40: <installationRemarks> Element
<otherPlatformRequirements> Element
The <otherPlatformRequirements> element is used to represent information about other software and hardware requirements of the SCORM Content Model Component. This element should be used to describe requirements that cannot be represented or expressed with the other Technical elements.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <otherPlatformRequirements>
Multiplicity Requirements: The <otherPlatformRequirements> element shall appear 0 or 1 time.
Data Type: The <otherPlatformRequirements> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<technical>
<otherPlatformRequirements>
<string language="en">Sound card, Min. RAM: 16Mb, Video card and display: at least 800 X 600 pixels x 256 colors</string>
</otherPlatformRequirements>
</technical>
</lom>
Code Illustration 4-41: <otherPlatformRequirements> Element
<duration> Element
The <duration> element represents the time a continuous SCORM Content Model Component takes when played at intended speed. This element is useful for sounds, movies, simulations and the like.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <duration>
Multiplicity Requirements: The <duration> element shall appear 0 or 1 time.
Data Type: The <duration> element is represented as a Duration data type (refer to Section 4.2.11.5: Duration Data Type for more information).
<lom>
<technical>
<duration>
<!-- Movie will play for 1 hour and 30 minutes -->
<duration>PT1H30M</duration>
<description>
<string language="en">Length of time to play movie</string>
</description>
</duration>
</technical>
</lom>
Code Illustration 4-42: <duration> Element
<educational> Element
The Educational category describes the key educational or pedagogic characteristics of the SCORM Content Model Component. This category allows for the description of the educational characteristics and is typically used by teachers, managers, authors and learners.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <educational>
Multiplicity Requirements: The <educational> element shall appear 0 or More times. The <educational> element has an SPM of 100.
Data Type: The <educational> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<educational> element contains the following child elements:
<interactivityType>
<learningResourceType>
<interactivityLevel>
<semanticDensity>
<intendedEndUserRole>
<context>
<typicalAgeRange>
<difficulty>
<typicalLearningTime>
<description>
<language>
<lom>
<educational>
<interactivityType>
<source>LOMv1.0</source>
<value>mixed</value>
</interactivityType>
<learningResourceType>
<source>LOMv1.0</source>
<value>figure</value>
</learningResourceType>
<learningResourceType>
<source>LOMv1.0</source>
<value>narrative text</value>
</learningResourceType>
<interactivityLevel>
<source>LOMv1.0</source>
<value>very low</value>
</interactivityLevel>
<semanticDensity>
<source>LOMv1.0</source>
<value>very low</value>
</semanticDensity>
<intendedEndUserRole>
<source>LOMv1.0</source>
<value>learner</value>
</intendedEndUserRole>
<context>
<source>LOMv1.0</source>
<value>training</value>
</context>
<typicalAgeRange>
<string language="en">18-</string>
</typicalAgeRange>
<difficulty>
<source>LOMv1.0</source>
<value>easy</value>
</difficulty>
<typicalLearningTime>
<duration>PT1H30M</duration>
<description>
<string language="en">Average length of time to experience the activity.</string>
</description>
</typicalLearningTime>
<language>en-US</language>
</educational>
</lom>
Code Illustration 4-43: <educational> Element
<interactivityType> Element
The <interactivityType> element represents the dominant mode of learning supported by the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <interactivityType>
Multiplicity Requirements: The <interactivityType> element shall appear 0 or 1 time.
Data Type: The <interactivityType> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
active: Active learning (e.g., learning by doing) is supported by content that directly induces productive action by the learner.
expositive: Expositive learning (e.g., passive learning) occurs when the learner’s job mainly consists of absorbing the content exposed to them.
mixed: A blend of active and expositive interactivity types.
Example:
<lom>
<educational>
<interactivityType>
<source>LOMv1.0</source>
<value>mixed</value>
</interactivityType>
</educational>
</lom>
Code Illustration 4-44: <interactivityType> Element
<learningResourceType> Element
The <learningResourceType> element represents the specific kind of the SCORM Content Model Component. This element is repeatable in order to fully describe the types of resources used in the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <learningResourceType>
Multiplicity Requirements: The <learningResourceType> element shall appear 0 or More times. The <learningResourceType> element has an SPM of 10.
Data Type: The <learningResourceType> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
exercise
simulation
questionnaire
diagram
figure
graph
index
slide
table
narrative text
exam
experiment
problem statement
self assessment
lecture
Example:
<lom>
<educational>
<learningResourceType>
<source>LOMv1.0</source>
<value>narrative text</value>
</learningResourceType>
<learningResourceType>
<source>LOMv1.0</source>
<value>simulation</value>
</learningResourceType>
</educational>
</lom>
Code Illustration 4-45: <learningResourceType> Element
<interactivityLevel> Element
The <interactivityLevel> represents the degree of interactivity characterizing the SCORM Content Model Component. Interactivity in this context refers to the degree to which the learner can influence the aspect or behavior of the component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <interactivityLevel>
Multiplicity Requirements: The <interactivityLevel> element shall appear 0 or 1 time.
Data Type: The <interactivityLevel> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
very low
low
medium
high
very high
These values, inherently, are meaningful only in a context of a community practice. At this time, this scale is left to organizations to define.
Example:
<lom>
<educational>
<interactivityLevel>
<source>LOMv1.0</source>
<value>very low</value>
</interactivityLevel>
</educational>
</lom>
Code Illustration 4-46: <interactivityLevel> Element
<semanticDensity> Element
The <semanticDensity> represents the degree of conciseness of the SCORM Content Model Component. The semantic density of a SCORM component may be estimated in terms of its size, span or, in the case of self-timed resources such as audio or video, duration.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <semanticDensity>
Multiplicity Requirements: The <semanticDensity> element shall appear 0 or 1 time.
Data Type: The <semanticDensity> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
very low
low
medium
high
very high
These values, inherently, are meaningful only in a context of a community practice At this time, this scale is left to organizations to define.
Example:
<lom>
<educational>
<semanticDensity>
<source>LOMv1.0</source>
<value>very low</value>
</semanticDensity>
</educational>
</lom>
Code Illustration 4-47: <semanticDensity> Element
<intendedEndUserRole> Element
The <intendedEndUserRole> element represents the principal user(s) for which the SCORM Content Model Component was designed. If multiple elements are used, the most dominant role should be first.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <intendedEndUserRole>
Multiplicity Requirements: The <intendedEndUserRole> element shall appear 0 or More times. The <intendedEndUserRole> element has an SPM of 10.
Data Type: The <intendedEndUserRole> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
teacher
author
learner
manager
Example:
<lom>
<educational>
<intendedEndUserRole>
<source>LOMv1.0</source>
<value>learner</value>
</intendedEndUserRole>
</educational>
</lom>
Code Illustration 4-48: <intendedEndUserRole> Element
<context> Element
The <context> element represents the principal environment within which the learning and use of the SCORM Content Model Component is intended to take place.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <context>
Multiplicity Requirements: The <context> element shall appear 0 or More times. The
<context> element has an SPM of 10.
Data Type: The <context> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
school
higher education
training
other
Example:
<lom>
<educational>
<context>
<source>LOMv1.0</source>
<value>training</value>
</context>
</educational>
</lom>
Code Illustration 4-49: <context> Element
<typicalAgeRange> Element
The <typicalAgeRange> element represents the age of the typical end user. This element shall refer to the developmental age, if that would be different from the chronological age. The IEEE Standard recommends that, when applicable, the value should be formatted as minimum age – maximum age or minimum age – (e.g., 18 – 25, or 18-). The values of this element do not necessarily have to be represented numerically (e.g., adults only, suitable for children over 7).
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <typicalAgeRange>
Multiplicity Requirements: The <typicalAgeRange> element shall appear 0 or More times. The <typicalAgeRange> element has an SPM of 5.
Data Type: The <typicalAgeRange> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<educational>
<typicalAgeRange>
<string language="en">18-</string>
</typicalAgeRange>
</educational>
</lom>
Code Illustration 4-50: <typicalAgeRange> Element
<difficulty> Element
The <difficulty> element represents how hard it is to work with or through the SCORM Content Model Component for the typical intended target audience. The typical
target audience can be characterized by the <context> and <typicalAgeRange>
elements.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <difficulty>
Multiplicity Requirements: The <difficulty> element shall appear 0 or 1 time.
Data Type: The <difficulty> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
very easy
easy
medium
difficult
very difficult
These values, inherently, are meaningful only in a context of a community practice. At this time, this scale is left to organizations to define.
Example:
<lom>
<educational>
<difficulty>
<source>LOMv1.0</source>
<value>easy</value>
</difficulty>
</educational>
</lom>
Code Illustration 4-51: <difficulty> Element
<typicalLearningTime> Element
The <typicalLearningTime> element represents the approximate of typical time it takes to work with or through the SCORM Content Model Component for the typical intended target audience. The typical target audience can be characterized by the elements
<context> and <typicalAgeRange>.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <typicalLearningTime>
Multiplicity Requirements: The <typicalLearningTime> element shall appear 0 or 1 time.
Data Type: The <typicalLearningTime> element is represented as a Duration data type (refer to Section 4.2.11.5: Duration Data Type for more information).
Example:
<lom>
<educational>
<typicalLearningTime>
<duration>PT1H30M</duration>
<description>
<string language="en">Average length of time to experience the activity.</string>
</description>
</typicalLearningTime>
</educational>
</lom>
Code Illustration 4-52: <typicalLearningTime> Element
<description> Element
The <description> element shall be used to comment on how the SCORM Content Model Component is to be used.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <description>
Multiplicity Requirements: The <description> element shall appear 0 or More times. The <description> element has an SPM of 10.
Data Type: The <description> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<educational>
<description>
<string language="en">This course is designed for IT professionals responsible for implementing Java</string>
</description>
</educational>
</lom>
Code Illustration 4-53: Educational <description> Element
<language> Element
The <language> element represents the human language used by the typical intended user of the SCORM Content Model Component. The typical target intended user can be characterized by the elements <context> and <typicalAgeRange>.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <language>
Multiplicity Requirements: The <language> element shall appear 0 or More times. The <language> element has an SPM of 10.
Data Type: The <language> element is represented as a CharacterString. The CharacterString has an SPM of 100 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<educational>
<language>en-US</language>
</educational>
</lom>
Code Illustration 4-54: Educational <language> Element
<rights> Element
The Rights category describes the intellectual property rights and conditions of use for the SCORM Content Model Component. This element shall be used to describe any and all digital rights of the SCORM Component (cost for use, copyright, etc.).
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <rights>
Multiplicity Requirements: The <rights> element shall appear 0 or 1 time.
Data Type: The <rights> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<rights> element contains the following child elements:
<cost>
<copyrightAndOtherRestrictions>
<description>
Example:
<lom>
<rights>
<cost>
<source>LOMv1.0</source>
<value>yes</value>
</cost>
<copyrightAndOtherRestrictions>
<source>LOMv1.0</source>
<value>yes</value>
</copyrightAndOtherRestrictions>
<description>
</description>
</rights>
</lom>
Code Illustration 4-55: <rights> Element
<cost> Element
The <cost> element represents whether the SCORM Content Model Component requires some sort of payment.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <cost>
Multiplicity Requirements: The <cost> element shall appear 0 or 1 time.
Data Type: The <cost> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
yes
no
If the <cost> element is set to yes, the <description> element can be used to describe addition details dealing with the cost.
Example:
<lom>
<rights>
<cost>
<source>LOMv1.0</source>
<value>yes</value>
</cost>
<description>
<string language="en">Contact joe_developer@someorg.org for cost information.</string>
</description>
</rights>
</lom>
Code Illustration 4-56: <cost> Element
<copyrightAndOtherRestrictions> Element
The <copyrightAndOtherRestrictions> element describes whether copyright or other restrictions apply to the use of the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <copyrightAndOtherRestrictions>
Multiplicity Requirements: The <copyrightAndOtherRestrictions> element shall appear 0 or 1 time.
Data Type: The <copyrightAndOtherRestrictions> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
yes
no
If the <copyrightAndOtherRestrictions> element is set to yes, the <description> element can be used to describe addition details dealing with the copyright and other restrictions.
Example:
<lom>
<rights>
<copyrightAndOtherRestrictions>
<source>LOMv1.0</source>
<value>yes</value>
</copyrightAndOtherRestrictions>
<description>
<string language="en">Contact joe_developer@someorg.org for copyright information.</string>
</description>
</rights>
</lom>
Code Illustration 4-57: <copyrightAndOtherRestrictions> Element
<description> Element
The <description> element allows for comments on the conditions of use of the SCORM Content Model Component. This element can be used to describe any cost, copyright or other restrictions about the SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <description>
Multiplicity Requirements: The <description> element shall appear 0 or 1 time.
Data Type: The <description> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<rights>
<copyrightAndOtherRestrictions>
<source>LOMv1.0</source>
<value>yes</value>
</copyrightAndOtherRestrictions>
<description>
</description>
</rights>
</lom>
Code Illustration 4-58: Rights <description> Element
<relation> Element
The Relation category defines the relationship between the SCORM Content Model Component and other components, if any. The Relation element is allowed to be repeated. To define multiple relationships, one could create several instances of this category. If there is more than one target component, then each target shall have a new relationship instance.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <relation>
Multiplicity Requirements: The <relation> element shall appear 0 or More times. The <relation> element has an SPM of 100.
Data Type: The <relation> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<relation> element contains the following child elements:
<kind>
<resource>
Example:
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>isbasedon</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD</entry>
</identifier>
<description>
<string language="en">Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-59: <relation> Element
<kind> Element
The <kind> element describes the nature of the relationship between the SCORM Content Model Component and the target component identified by the Resource.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <kind>
Multiplicity Requirements: The <kind> element shall appear 0 or 1 time.
Data Type: The <kind> element is represented as a Vocabulary element (refer to Section 4.2.11.3: Vocabulary Data Type for more information).
Vocabulary Tokens: The IEEE LOM defines the following set of vocabulary tokens:
ispartof
haspart
isversionof
hasversion
isformatof
hasformat
references
isreferencedby
isbasedon
isbasisfor
requires
isrequiredby
Example:
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>ispartof</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD-3324</entry>
</identifier>
<description>
<string language="en">ADL Course: Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-60: <kind> Element
<resource> Element
The <resource> element describes the target SCORM Content Model Component that this relationship references.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <resource>
Multiplicity Requirements: The <resource> element shall appear 0 or 1 time.
Data Type: The <resource> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<resource> element contains the following child elements:
<identifier>
<description>
Example:
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>isbasedon</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD</entry>
</identifier>
<description>
<string language="en">ADL Course: Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-61: <resource> Element
<identifier> Element
The <identifier> element represents a mechanism for assigning a globally unique label that identifies the target SCORM Content Model Component
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <identifier>
Multiplicity Requirements: The <identifier> element shall appear 0 or More times. The <identifier> element has an SPM of 10.
Data Type: The <identifier> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<identifier> element contains the following child elements:
<catalog>
<entry>
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>isbasedon</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD</entry>
</identifier>
<description>
<string language="en">ADL Course: Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-62: Relation Resource <identifier> Element
<catalog> Element
The <catalog> element represents the name or designator of the identification or cataloging scheme for the entry. There are a variety of cataloging systems available. SCORM does not require the use of any one particular cataloging system. Organizations are free to choose any cataloging scheme that meets their organizations practices or policies. Some types of cataloging systems are:
Universal Resource Identifier (URI)
Universal Resource Name (URN)
Digital Object Identifier (DOI)
International Standard Book Numbers (ISBN)
International Standard Serial Numbers (ISSN).
The <catalog> element represents the scheme used to create and manage the entry.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <catalog>
Multiplicity Requirements: The <catalog> element shall appear 0 or 1 time.
Data Type: The <catalog> element is represented as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
Example:
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>isbasedon</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD</entry>
</identifier>
<description>
<string language="en">ADL Course: Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-63: Relation Resource Identifier <catalog> Element
<entry> Element
The <entry> element represents the value of the identifier within the identification or cataloging scheme (refer to the <catalog> element) that designates or identifies the target SCORM Content Model Component.
Identifiers can take on various formats. The IEEE requires that the actual identifier value be represented as a CharacterString. Organizations are free to choose any mechanism to create unique identifiers that meets their organizations practices or policies. It is recommended that a common scheme be chosen.
The following listing is a sampling of identifier values (entry):
Scheme (<catalog>) | Value (<entry>) |
Universal Resource Name | urn:ADL: 1345-GFGC-23ED-3321 |
Universal Resource Identifier | |
Handle Syntax | 100.100/2345342256349543 |
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <entry>
Multiplicity Requirements: The <entry> element shall appear 0 or 1 time.
Data Type: The <entry> element is represented as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information).
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>isbasedon</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD</entry>
</identifier>
<description>
<string language="en">ADL Course: Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-64: Relation Resource Identifier <entry> Element
<description> Element
The <description> element describes the target SCORM Content Model Component.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <description>
Multiplicity Requirements: The <description> element shall appear 0 or More times. The <description> element has an SPM of 10.
Data Type: The <description> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example:
<lom>
<relation>
<kind>
<source>LOMv1.0</source>
<value>isbasedon</value>
</kind>
<resource>
<identifier>
<catalog>URN</catalog>
<entry>urn:ADL:1234-45FD</entry>
</identifier>
<description>
<string language="en">ADL Course: Microsoft MSCE</string>
</description>
</resource>
</relation>
</lom>
Code Illustration 4-65: Relation Resource <description> Element
<annotation> Element
The Annotation category provides comments on the educational use of the SCORM Content Model Component and information on when and by whom the comments were created. This category enables educators to share their assessments of SCORM Content Model Components, suggestions for use, etc.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <annotation>
Multiplicity Requirements: The <annotation> element shall appear 0 or More times. The <annotation> element has an SPM of 30.
Data Type: The <annotation> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The
<annotation> element contains the following child elements:
<entity>
<date>
<description>
Example:
<lom>
<annotation>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Author END:VCARD</entity>
<date>
<dateTime>2001-07-30T10:14:35.5+01:00</dateTime>
<description>
<string language="en">Date and time annotation was created</string>
</description>
</date>
<description>Learners will need to understand the fundamentals of Windows programming in order to grasp the concepts described in this learning.</description>
</annotation>
</lom>
Code Illustration 4-66: <annotation> Element
<entity> Element
The <entity> element identifies the entity or entities that that have created the annotation.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <entity>
Multiplicity Requirements: The <entity> element shall appear 0 or 1 time.
Data Type: The <entity> element as a CharacterString element. The CharacterString has an SPM of 1000 characters (refer to Section 4.2.11.1: CharacterString Data Type for more information). All entity values shall be represented in vCard [9] format. This allows systems to take the CharacterString represented by the <entity> element and process this CharacterString as a valid vCard.
Example:
<lom>
<annotation>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Author END:VCARD</entity>
<date>
<dateTime>2001-07-30T10:14:35.5+01:00</dateTime>
<description>
<string language="en">Date and time annotation was created</string>
</description>
</date>
<description>Learners will need to understand the fundamentals of Windows programming in order to grasp the concepts described in this learning.</description>
</annotation>
</lom>
Code Illustration 4-67: Annotation <entity> Element
<date> Element
The <date> element identifies the date the annotation was created.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <date>
Multiplicity Requirements: The <date> element shall appear 0 or 1 time.
Data Type: The Date element is represented as a DateTime data type (refer to Section 4.2.11.4: DateTime Data Type for more information). The <date> element is a parent element. Parent elements have no values associated with them. Parent elements act as “containers” for other elements. The <date> element contains two elements, one that represents the actual date of the contribution (<dateTime>) and one that represents a textual description of the date (<description>):
<dateTime>
<description>
<lom>
<annotation>
<entity>BEGIN:VCARD VERSION:2.1 FN:Joe
Author END:VCARD</entity>
<date>
<dateTime>2001-07-30T10:14:35.5+01:00</dateTime>
<description>
<string language="en">Date and time annotation was created</string>
</description>
</date>
<description>Learners will need to understand the fundamentals of Windows programming in order to grasp the concepts described in this learning.</description>
</annotation>
</lom>
Code Illustration 4-68: Annotation <date> Element
4.2.9.3. <description> Element
The <description> element shall be used to represent the contents of the annotation.
XML Namespace: http://ltsc.ieee.org/xsd/LOM
XML Binding Representation: <description>
Multiplicity Requirements: The <description> element shall appear 0 or 1 time.
Data Type: The <description> element is represented as a LangString. The LangString has an SPM of 1000 characters (refer to Section 4.2.11.2: LangString Data Type for more information).
Example: