View source for Link educational occupational credentials to courses

{{navigation}}
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  [https://lists.w3.org/Archives/Public/public-eocred-schema/2018Feb/thread.html thread from February 2018].

==Proposal==
An [http://pending.schema.org/educationalCredentialAwarded educationalCredentialAwarded] property has already been proposed for [http://schema.org/Course 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:
# 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
# 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 [https://github.com/philbarker/schemaorg/blob/eocred/data/ext/pending/issue-1779.rdfa file on github]
 <nowiki> 
<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>
</nowiki>
[http://pending.eocred-1779.appspot.com/educationalCredentialAwarded Test output on appspot] (may be slow to load).

===Examples===
Based on Santa Rosa Junior College [https://portal.santarosa.edu/srweb/SR_GainfulEmployment.aspx?MCID=1462 certificate in Culinary Arts] and associated [https://portal.santarosa.edu/srweb/SR_ProgramOfStudy.aspx?ProgramType=1&Program=003202&Version=3 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:
 <nowiki>
{  
  "@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"
  }
}
</nowiki>
And elsewhere on the web:
 <nowiki>
{  
  "@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"      
  }
}
</nowiki>

'''''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: 
 <nowiki>
{  
  "@context": "http://schema.org/",
  "@graph": [
     {...},  //the credential
     {...},  //Course with alignment
     {...}   //Rest of course information from elsewhere.
  ]
}
</nowiki> 

====2. Description of EducationalOccupationalCredential with reversed educationalCredentialAwarded====
 <nowiki>
{  
  "@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"      
      }
    }
  }
}
</nowiki>

[[Category:Proposals to meet requirements]]