Skip to main content

A New Way of Working with the 1EdTech Specifications

1EdTech TECH TALK

Contributed by Dr. Colin Smythe, 1EdTech Chief Architect

The Student Learning Data Model: A New Way of Working with the 1EdTech Specifications

Having published edtech interoperability specifications for over 20 years, we’ve learned a few things. As is the standard (pun intended) by all specification development organizations, these specs are published as sets of HTML documents. In most cases, these documents are long, and it is difficult for a reader to find the information of specific interest. New tools are needed to simplify reading specification documentation, and so 1EdTech has been developing such tools over the past 12 months. In November 2020, we announced the availability of the Student Learning Data Model or SLDM for short. The SLDM provides a new way to access, explore and visualize all of the information within the set of 1EdTech specifications relevant to a student’s engagement and progress.

In many cases, an edtech system will make use of more than one 1EdTech specification. An essential part of our development process is the integration between 1EdTech spec, for example, LTI® links being a resource type in Common Cartridge®. The reference now has to be made to several specs. A reader needs to easily access, explore, and visualize information across several sets of documentation. As the number of published specifications increases (over 100 in our history), as the complexity of each specification increases (an unavoidable reality as a specification evolves), and as the integrations become more comprehensive, the availability and use of tools such as the SLDM is essential.

The SLDM provides three tiers of information. The first two tiers are available to any registered user of the 1EdTech website. Access to the third tier is only available to users from 1EdTech member organizations.

The first tier collects the information into an eight-cell honeycomb of:

  • User and Organization
  • Enrollment & Attendance
  • Pathways to Competency
  • Instructional Resources
  • Assignment and Assessment
  • Learning Activities

 

The second tier—accessed through the honeycomb—provides the list and details of the relevant data models from the 1EdTech specifications. A user of the SLDM can now get all of the information on the data models in just two clicks, avoiding having to dive into the thousands of pages of specification documentation. The third tier—accessed either through the second-tier links or directly—gives even richer details for the data models and related information.

The SLDM is a curation of the relevant specification information. It is a focus or “lens” on the 1EdTech specifications.

Applying the lens to the complete set of 1EdTech specifications provides a way to bring the relevant information into one focus from the mass of spec material. And we plan to make other lenses. As part of realizing the SLDM, the 1EdTech technical team created a new data dictionary or Common Data Model (CDM). We generated the CDM from the source models made in the 1EdTech model-driven specification development process (I will reveal more about this process in later blogs), which guarantees consistency between the published 1EdTech spec documentation and the Common Data Model. The information presented through the SLDM is drawn directly from the CDM.

The first release of the SLDM and CDM draws on data model definitions only. Many 1EdTech specs like OneRoster®, REST API, and others include a service definition. A service definition describes how the data must be exchanged; the data model describes the syntax, semantics, and format of the data to be exchanged but not how the data is exchanged. Future releases of the CDM and SLDM will include the service definitions and the binding technology artifacts, e.g., OpenAPI files, etc.  The long-term aim is to make tools such as the SLDM and CDM the primary way of working with 1EdTech specifications.

Access to the SLDM and CDM is through the 1EdTech website. We used GraphQL as the delivery technology when creating the CDM. A GraphQL server contains all of the Common Data Model and responds to queries from the 1EdTech website. GraphQL provides a powerful combination for defining a flexible API with common semantics for the data being exchanged and stored. This is a great learning opportunity for us, so if in the future, 1EdTech members request GraphQL based binding of an 1EdTech specification, we can produce them from a strong understanding of its strengths and weaknesses.

So, what now?

The first step is to get 1EdTech members and non-members using the Student Learning Data Model and 1EdTech members using the Common Data Model.

Next, we need your feedback on what to improve and what new features we need to add. The early response has been encouraging, but we want more from you. Some of the specific feedback we need includes:

  • How can the user experience for the SLDM and Common Data Model be improved?

  • What type of synthesized information across the specifications is useful?

  • What type of information and visualization would be useful for our service-based specifications?

  • The SLDM is the first lens. What are other lenses of interest?

 

 

Published on 2021-06-10
Help us improve the accessibility of this site by emailing recommendations to web@imsglobal.org