Link educational occupational credentials to courses

From Educational and Occupational Credentials in schema.org Community Group
Educational and occupational
credentials in schema.org
Wiki Navigation
Main Page
Outline use cases
Proposals to meet requirements
Example sites
Other useful links
Community group home page
email list for group
schema.org Git hub issue

So that having found an educational or occupational credential, and possibly identified the competencies required to obtain that credential, an individual may find courses (and hence perhaps learning materials or other things) that will help them acquire those competencies it is necessary to be able to link these educational and occupational credentials to courses.

Discussion: EOCred: link to course thread from February 2018.

Proposal

An educationalCredentialAwarded property has already been proposed for Course, it is sufficient to extend the expectedRange of this property to include EducationalOccupationalCredentials in order to meet this requirement. Search engines can then search for Courses that link to the Credential using this property.

Note: When providing descriptions of Educational Occupational Credentials rather than Courses there are two options for using this property:

  1. Provide a short separate description of the Course, which need be no more than the URI identifier and educationalCredentialAwarded property if further information about the course is already available from elsewhere
  2. Use the mechanism provided in JSON-LD (@reverse) or RDFa (rev) for reversing the sense of educationalCredentialAwarded.

Draft code for schema.org

This copy on the wiki is for ease of reference only, the definitive version is the file on github

 
<div typeof="rdf:Property" resource="http://schema.org/educationalCredentialAwarded">
  <span class="h" property="rdfs:label">educationalCredentialAwarded</span>
  <span property="rdfs:comment">A description of the qualification, award, certificate, diploma or other educational credential awarded as a consequence of successful completion of this course.</span>
  <span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/Course">Course</a></span>
  <span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
</div>

Test output on appspot (may be slow to load).

Examples

Based on Santa Rosa Junior College certificate in Culinary Arts and associated program of study.

Note: These examples should not be taken as being authoritative or accurate descriptions of the resources on which they are based.

1. Separate descriptions of EducationalOccupationalCredential and Course

On the site describing the Educational Occupational Credential, as separate objects in a @graph array, or each in its own <script type="application/ld+json"> tag:

{  
  "@context": "http://schema.org/",
  "@type": "EducationalOccupationalCredential",
  "@id": "http://example.org/SRJCCACert",
  "name": "Undergraduate certificate in Culinary Arts"
}
{
  "@context": "http://schema.org/",
  "@type": "Course",
  "@id": "https://portal.santarosa.edu/srweb/SR_ProgramOfStudy.aspx?ProgramType=1&Program=003202&Version=3",
  "educationalCredentialAwarded": {
    "@type": "EducationalOccupationalCredential",
    "@id": "http://example.org/SRJCCACert"
  }
}

And elsewhere on the web:

{  
  "@context": "http://schema.org/",
  "@type": "Course",
  "@id": "https://portal.santarosa.edu/srweb/SR_ProgramOfStudy.aspx?ProgramType=1&Program=003202&Version=3",
  "name": "Programme of study for Culinary Arts Certificate",
  "description": "Programme of study designed to train individuals in all aspects of the culinary arts field.",
  "provider": {
    "@type": "EducationalOrganization",
    "@id": "https://www.santarosa.edu/",
    "name": "Santa Rosa Junior College"      
  }
}

Hint: To see how this example would validate using, for example, Google's Structured data testing tool, when the information is aggregated in one place, wrap each of the three JSON objects into an array:

{  
  "@context": "http://schema.org/",
  "@graph": [
     {...},  //the credential
     {...},  //Course with alignment
     {...}   //Rest of course information from elsewhere.
  ]
}
 

2. Description of EducationalOccupationalCredential with reversed educationalCredentialAwarded

{  
  "@context": "http://schema.org/",
  "@type": "EducationalOccupationalCredential",
  "@id": "http://example.org/SRJCCACert",
  "name": "Undergraduate certificate in Culinary Arts",
  "@reverse": {
    "educationalCredentialAwarded": {
      "@context": "http://schema.org/",
      "@type": "Course",
      "@id": "https://portal.santarosa.edu/srweb/SR_ProgramOfStudy.aspx?ProgramType=1&Program=003202&Version=3",
      "name": "Programme of study for Culinary Arts Certificate",
      "description": "Programme of study designed to train individuals in all aspects of the culinary arts field.",
      "provider": {
        "@type": "EducationalOrganization",
        "@id": "https://www.santarosa.edu/",
        "name": "Santa Rosa Junior College"      
      }
    }
  }
}