IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON-LD Binding

IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON-LD Binding

IMS Candidate Final Public
Version 1.0
IMS Candidate Final Public
Date Issued: June 18, 2020
Status: This document is for review and adoption by the IMS membership.
This version: https://www.imsglobal.org/spec/case/v1p0/
Latest version: https://www.imsglobal.org/spec/case/latest/
Errata: https://www.imsglobal.org/spec/case/v1p0/errata/

IPR and Distribution Notice

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

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

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

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

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

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

Public contributions, comments and questions can be posted here: http://www.imsglobal.org/forums/ims-glc-public-forums-and-resources.

© 2020 IMS Global Learning Consortium, Inc. All Rights Reserved.

Trademark information: http://www.imsglobal.org/copyright.html

Abstract

The Competencies and Academic Standards Exchange (CASE) Service specification is the definition of how systems achieve the exchange of information about learning standards and/or competencies. The key aim is to replace the current ways of documenting a learning standard and competency, typically a PDF or HTML document, by one which is machine readable both syntactically and semantically. Further, using this new specification it will be possible to electronically exchange these definitions so that applications, systems and tools can readily access this data.

1. Introduction

The Competencies and Academic Standards Exchange (CASE) specification defines how systems exchange and manage information about learning standards and/or competencies in a consistent and referenceable way. The key aim is to replace the current ways of documenting and referencing learning standards and competencies, which are typically published as a PDF or HTML document intended to be read by humans, by one which is also machine readable both syntactically and semantically. This allows for "Common Alignments" for content and referenceable unique identifiers for use in certificates and transcripts. Further, using this new specification it will be possible to electronically exchange these definitions so that applications, systems and tools can readily access and manage this data. This includes LMSs, Assessment tools, Curriculum Management applications, certificate and competency based evaluation systems and any other tool, process or content that would need to align to or reference a competency or framework.

This document describes the JSON-LD document formats for CASE 1.0.

1.1 Conformance Statements

As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

The key words "MAY", "MUST", "MUST NOT", "OPTIONAL", "RECOMMENDED", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", and "SHOULD NOT" in this document are to be interpreted as described in [RFC2119].

An implementation of this specification that fails to implement a MUST/REQUIRED/SHALL requirement or fails to abide by a MUST NOT/SHALL NOT prohibition is considered nonconformant. SHOULD/SHOULD NOT/RECOMMENDED statements constitute a best practice. Ignoring a best practice does not violate conformance but a decision to disregard such guidance should be carefully considered. MAY/OPTIONAL statements indicate that implementers are entirely free to choose whether or not to implement the option.

The Conformance and Certification Guide for this specification may introduce greater normative constraints than those defined here for specific service or implementation categories.

1.2 Document Set

The documents that make up this specification are:

2. JSON-LD Binding

Service Providers that support the CASE JSON-LD Binding provide [JSON-LD] documents for each of the data model classes described in this section. Note that the JSON-LD Binding is an alternative, not a replacement for the REST JSON Binding described in [CASE-REST-10]. Conformance testing of this JSON-LD Binding will enforce adherence to the JSON-LD Schema in shown in [CASE-JSON-10].

2.1 Context

This binding uses the @context property to map short-form aliases to the URIs required by CASE documents. The value of the @context property MUST be a URL with the value https://purl.imsglobal.org/spec/case/v1p0/context/imscasev1p0_context_v1p0.jsonld. This URL resolves to the @context described in IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON-LD Context.

2.2 @id

The CASE JSON-LD @context maps the JSON-LD @id property to the alias id. The id property is REQUIRED for all of the documents described below. The id MUST be a URL and, when dereferenced, results in a document containing machine readable information about the id.

2.3 @type

This CASE JSON-LD Context maps the JSON-LD @type property to the alias type. The type property is REQUIRED for all of the documents described below. The type MUST be the name of the class as defined in the specification [CASE-10].

2.4 Associations

Associations between CFDocuments and between CFItems MAY be included in the CFDocument and CFItem. For example, the associations between two CFItems MAY be included in both CFItems. The set of associations is represented by the associationSet property which is a set of AssociationLinks, not by the CFAssociation class defined in [CASE-INFO-10].

2.4.1 associationSet Property

CFDocument and CFItem have a new property associationSet which is an array of AssociationLink objects.

A. Sample JSON-LD

Implementations of the CASE JSON-LD Binding MUST provide a [JSON-LD] document when the id is dereferenced. The [JSON-Schema] of each document is defined in IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON Schema. Sample documents are shown below.

A.1 CFAssociationGrouping

A.2 CFConcept

A.3 CFDocument

A.4 CFItem

A.5 CFItemType

A.6 CFLicense

A.7 CFPackage

A.8 CFRubric

B. Revision History

B.1 Version History

Version No. Release Date Comments
IMS Candidate Final Release 1.0 August 28, 2020 Based on member and invited expert feedback the following changes were made:
  • Removed AssociationSet class and rewrote the Associations section.
  • Defined targetId and uri as @id properties in the @context file [CASE-CONTEXT-10]
    "targetId": {
        "@id": "case:targetId",
        "@type": "@id"
      },
    "uri": {
        "@id": "case:uri",
        "@type": "@id"
    }
  • Added optional type property to all JSON Schema definitions
  • Updated all the examples to include type
IMS Candidate Final Release 1.0 June 18, 2020 First release of the JSON-LD Binding for CASE Version 1.0.

B.2 Changes in the Release

The changes made in this document are:

  • First release of the JSON-LD Binding for CASE Version 1.0.

C. References

C.1 Normative references

[CASE-10]
Competencies and Academic Standards Exchange (CASE) Service Version 1.0. IMS Global Learning Consortium. July 2017. IMS Final Release. URL: https://www.imsglobal.org/activity/case/
[CASE-CERT-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: Conformance and Certification. IMS Global Learning Consortium. July 7, 2017. IMS Final Release. URL: https://www.imsglobal.org/spec/case/v1p0/cert/
[CASE-CONTEXT-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON-LD Context. IMS Global Learning Consortium. June 18, 2020. IMS Candidate Final. URL: https://purl.imsglobal.org/spec/case/v1p0/context/
[CASE-IMPL-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: Best Practices and Implementation Guide. IMS Global Learning Consortium. July 7, 2017. IMS Final Release. URL: https://www.imsglobal.org/spec/case/v1p0/impl/
[CASE-INFO-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: Information Model. IMS Global Learning Consortium. July 7, 2017. IMS Final Release. URL: https://www.imsglobal.org/spec/case/v1p0/caseservicev1p0_infomodelv1p0.html
[CASE-JSON-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON Schema. IMS Global Learning Consortium. June 18, 2020. IMS Candidate Final. URL: https://purl.imsglobal.org/spec/case/v1p0/schema/json/
[CASE-JSONLD-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON-LD Binding. IMS Global Learning Consortium. June 18, 2020. IMS Candidate Final. URL: https://www.imsglobal.org/spec/case/v1p0/jsonld/
[CASE-OPEN-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: OpenAPI Schema. IMS Global Learning Consortium. July 7, 2017. IMS Final Release. URL: https://purl.imsglobal.org/spec/case/v1p0/schema/openapi/
[CASE-REST-10]
IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: REST/JSON Binding. IMS Global Learning Consortium. July 7, 2017. IMS Final Release. URL: https://www.imsglobal.org/spec/case/v1p0/caseservicev1p0_restbindv1p0.html
[JSON-LD]
JSON-LD 1.0. Manu Sporny; Gregg Kellogg; Markus Lanthaler. W3C. 16 January 2014. W3C Recommendation. URL: https://www.w3.org/TR/json-ld/
[JSON-Schema]
JSON Schema: core definitions and terminology. K. Zyp. Internet Engineering Task Force (IETF). 31 January 2013. Internet-Draft. URL: https://tools.ietf.org/html/draft-zyp-json-schema
[RFC2119]
Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://tools.ietf.org/html/rfc2119

D. List of Contributors

The following individuals contributed to the development of this document:

Name Organization
Raymond BaranoskiSAFARI Montage (USA)
Diana BidulescuHouston ISD (USA)
Adam BlumOpenEd (USA)
Jared BoothHMH (USA)
Clyde BoyerTrinity Education Group (USA)
Barry BrahierInfinite Campus (USA)
Christine CaseTrinity Education Group (USA)
Joseph ChapmanD2L (Canada)
Chris ChungIMS Global (USA)
Deb EverhartLearning Objects (USA)
David GappaSAFARI Montage (USA)
Jeremy GatzaFlorida Virtual School (USA)
Jeff GrannCapella University (USA)
Bob GroganeLumen (USA)
Jeroen HamersKennisnet (Netherlands)
Joel HernandezeLumen (USA)
Jill HobsonIMS Global (USA)
Chris HoustonCapella University (USA)
Jamey HyndsKaty ISD (USA)
Brian KubotaPearson (USA)
Andy KuritizkyHMH (USA)
Mark LeubaIMS Global (USA)
Karl LloydInstructure (USA)
Joshua MarksPCG (USA)
Lisa MattsonIMS Global (USA)
David MayesGwinnett County Schools (USA)
Greg NadeauPCG (USA)
Henk NijstadKennisnet (Netherlands)
Hugh NorwoodTrinity Education Group (USA)
Robert PangbornIBM (USA)
Steve PolyakACT (USA)
Brandt ReddSmarter Balance (USA)
Jennifer ReichlinPearson (USA)
William SantoD2L (Canada)
Bob SchlossIBM (USA)
McCall SmithInstructure (USA)
Colin SmythIMS Global (USA)
Davant StewartHouston ISD (USA)
Stewart SuttonDublin Core (USA)
Marcia van OploKennisnet (Netherlands)
Michele WagnerBaltimore County Public Schools (USA)
David WardPCG (USA)
Jennifer WhitingFlorida Virtual School (USA)
Avi YashchinIBM (USA)
Stuart SuttonCredential Engine

IMS Global Learning Consortium, Inc. ("IMS Global") is publishing the information contained in this document ("Specification") for purposes of scientific, experimental, and scholarly collaboration only.

IMS Global makes no warranty or representation regarding the accuracy or completeness of the Specification.

This material is provided on an "As Is" and "As Available" basis.

The Specification is at all times subject to change and revision without notice.

It is your sole responsibility to evaluate the usefulness, accuracy, and completeness of the Specification as it relates to you.

IMS Global would appreciate receiving your comments and suggestions.

Please contact IMS Global through our website at http://www.imsglobal.org.

Please refer to Document Name: IMS Competencies and Academic Standards Exchange (CASE) Service Version 1.0: JSON-LD Binding 1.0

Date: June 18, 2020