RDF integration: schema.org/Certification and schema.org/BadgeCriteria #9

Open
westurner opened this Issue Nov 7, 2014 · 10 comments

Projects

None yet

4 participants

Contributor

http://schema.org

This site provides a collection of schemas that webmasters can use to markup HTML pages in ways recognized by major search providers, and that can also be used for structured data interoperability (e.g. in JSON).

schema.org defines a number of Classes (types) with Properties (attributes) that can be expressed in HTML with RDFa or Microdata, in JSON-LD (http://json-ld.org), and then in any other RDF format.

Development and discussion regarding schema.org/Course and schema.org/Credential is underway: rvguha/schemaorg#195

How could/should we reference OpenBadges Badge Class(es) offered by a schema.org/OnlineCourse ?
[edit]

  • Thing > Intangible > Credential > schema.org/OpenBadgesBadgeClass
    • SCH: schemaorg/schemaorg/data/ext/course/course.rdfa: RDFa Class and Properties
    • DAT: schemaorg/schemaorg/data/ext/course/course-openbadgesbadgeclass-examples.txt: JSON-LD example
  • Thing > Intangible > Credential > Badge > schema.org/OpenBadgesBadge
    • [OpenBadges] JWS and JSON-LD
    • [OpenBadges] JWSand RDFa

The current proposal google doc https://docs.google.com/document/d/12YWjLzZC8FiTiOwSAETRIEozeqZdn6O8a4fgqK4t5Ss/edit# ( linked in rvguha/schemaorg#195 ) describes schema.org/Course and schema.org/Credential.

Value Proposition:

  • JSON-LD / RDFa / Microdata #LinkedData could be embedded in course description HTML pages and discovered by search engines (supporting queries like "Where can I find a course which offers schema:OpenBadgesBadgeClass XYZ?")
Contributor

See: rvguha/schemaorg#195 "Thing > CreativeWork > Course"

@westurner westurner changed the title from Integration with schema:OnlineCourse (schema:Badge)? to Integration with schema.org/Course / schema.org/Certification Dec 16, 2014
@westurner westurner changed the title from Integration with schema.org/Course / schema.org/Certification to Integration with schema.org > Course, Certification Dec 16, 2014
@westurner westurner changed the title from Integration with schema.org > Course, Certification to Properties for schema.org/Certification Dec 16, 2014
Contributor
westurner commented Dec 16, 2014 edited

OpenBadges BadgeClass to schema:OpenBadgesBadgeClass

[edit]

Property openbadges Expected Type schema.org property Note
name Text name 1:1 -- http://schema.org/name
description Text description 1:1 -- http://schema.org/description
image Data URL or URL image http://schema.org/image
criteria URL criteria "URL of the criteria for earning the achievement. If the badge represents an educational achievement, consider [adding LRMI markup]" ... http://schema.org/URL (a more specific type like badgeUrl or openBadgeUrl could be helpful)
issuer URL issuer http://schema.org/Organization
alignment Array of AlignmentObjects 0 or more CreativeWork. educationalAlignment -> AlignmentObject; schema:ItemList / rdf:List http://schema.org/educationalAlignment > https://schema.org/AlignmentObject
tags Array of Text keywords https://schema.org/keywords
tags Array of Text about https://schema.org/about > https://schema.org/Thing > https://schema.org/url

Schema.org does not solve for JWS (https://tools.ietf.org/html/draft-ietf-jose-json-web-signature-38)

Contributor
ottonomy commented Jan 6, 2015

Hey, @westurner -- Thanks for working on this. I'm not steeped in schema.org's methods, but I'll try to provide a comment or two that might be useful:

Open Badges are made up of three components: Issuer, BadgeClass and Assertion. A BadgeClass describes one type of achievement recognized by one issuer. Many earners can receive Open Badges recognizing them for that achievement.

BadgeClasses themselves (as of OBI v1.0) are hosted independently of the Assertions, and hosted BadgeClasses are plain JSON, not in JWT/JWS form.

It looks like your mappings are pretty good. For image, you may want to use http://schema.org/image instead of http://schema.org/ImageObject , because there isn't any additional metadata in the BadgeClasses specifically about the image.

For criteria if you're going to create anything beyond http://schema.org/url, it should be http://schema.org/CriteriaUrl -- this field as used in an OpenBadge is too specific to use a term only one step narrower than the general URL type, I think.

I'd be fine leaving the issuer mapping -> http://schema.org/Organization unless you had specific terms for credential issuer and recipient (whatever exact words you settled on). If you're creating a Certification type, I believe these would be two essential properties.

The OBI Alignment Object was patterned after http://schema.org/educationalAlignment I believe.

If you have any more questions or want to talk synchronously, let me know -- I could probably find some time late this week or early next.

Contributor

Thank you for your feedback!

Unfortunately I am not able to contribute as much time as I'd like to this
issue.

Anyone that would like to keep pushing forward on this is more than welcome
to do so

On Tue, Jan 6, 2015 at 3:57 PM, Nate Otto [email protected] wrote:

Hey, @westurner https://github.com/westurner -- Thanks for working on
this. I'm not steeped in schema.org's methods, but I'll try to provide a
comment or two that might be useful:

Open Badges are made up of three components: Issuer, BadgeClass and
Assertion. A BadgeClass describes one type of achievement recognized by one
issuer. Many earners can receive Open Badges recognizing them for that
achievement.

BadgeClasses themselves (as of OBI v1.0) are hosted independently of the
Assertions, and hosted BadgeClasses are plain JSON, not in JWT/JWS form.

It looks like your mappings are pretty good. For image, you may want to
use http://schema.org/image instead of http://schema.org/ImageObject ,
because there isn't any additional metadata in the BadgeClasses
specifically about the image.

For criteria if you're going to create anything beyond
http://schema.org/url, it should be http://schema.org/CriteriaUrl -- this
field as used in an OpenBadge is too specific to use a term only one step
narrower than the general URL type, I think.

I'd be fine leaving the issuer mapping -> http://schema.org/Organization
unless you had specific terms for credential issuer and recipient (whatever
exact words you settled on). If you're creating a Certification type, I
believe these would be two essential properties.

The OBI Alignment Object was patterned after
http://schema.org/educationalAlignment I believe.

If you have any more questions or want to talk synchronously, let me know
-- I could probably find some time late this week or early next.


Reply to this email directly or view it on GitHub
#9 (comment)
.

Contributor

I've updated schema:ImageObject -> schema:image in the markdown table.

Contributor

CriteriaUrl / BadgeCriteriaUrl / BadgeCriteria .url

@westurner westurner changed the title from Properties for schema.org/Certification to RDF integration: schema.org/Certification and schema.org/BadgeCriteria Feb 4, 2015
@westurner westurner referenced this issue in schemaorg/schemaorg Jan 28, 2016
Open

Schema.org Course Extension RDFa & Examples #972

2 of 4 tasks complete
@timothyfcook timothyfcook added the backlog label Feb 9, 2017
@westurner westurner referenced this issue in blockchain-certificates/cert-schema Mar 23, 2017
Open

V2: Verification and Signature #25

Contributor
Contributor
westurner commented Mar 23, 2017 edited
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment