Catagorize credential by type

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

It should be possible to search or review results of a search by specific credential type, e.g. “degree”, “certificate”, “badge”. This requires the ability to categorize credentials by type, and to indicate that an educational occupational credential is a member of an official set, group, category or type of credential.

Discussion: EOCred: Identifying subtypes of credential thread from Jan 2018.

Proposal

Create a new property of EducationalOccupationalCredential called credentialCategory, in which the subtype of an EducationalOccupationalCredential can be provided as text, url or (preferably) a DefinedTerm.

Name: credentialCategory

Definition: The category or type of credential being described, for example "degree”, “certificate”, “badge”, or more specific term.

Expected Range: DefinedTerm

Note 0: a (hopefully short term) complication with this proposal is that DefinedTerm is not yet a part of schema.org. [Track discussion on github.]

Note 1: the number of different categories / types of credential in use globally is huge. Trying to produce a single classification scheme of manageable size to categorize these is problematic and would result in the loss of useful information about the specific credential type. Therefore we do not propose a single classification scheme as part of schema.org. We do encourage that local and widely used classification schemes for credential subtypes are described using suitable RDF languages in such a way as to be compatible with schema.org DefinedTermSets.

Note 2: where semantic descriptions of categories, classes or subtypes of Credentials are available from vocabularies other than schema.org, the URIs for these can be used with the schema:additionalType property, the RDFa:typeOf attribute or the JSON-LD @type key (in addition to the credentialType property).

Note 3.: text and url values are allowed by default for schema.org properties, so not declared in the expected range.

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/credentialType">
      <span>Category: <span property="schema:category">issue-1779</span></span>
      <span class="h" property="rdfs:label">credentialCategory</span>
      <span property="rdfs:comment">The category or type of credential being described, for example "degree”, “certificate”, “badge”, or more specific term.</span>
      <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
      <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/DefinedTerm">DefinedTerm</a></span>
      <link property="http://schema.org/isPartOf" href="http://pending.schema.org" />
      <span>Source:  <a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/1779">#1779</a></span>
   </div>

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

Examples

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

1. Based on SQA HNC Facilities Management

This copy is for ease of reference only. The definitive version is in file issue-1779-examples.txt on github, which may be more extensive. 

PRE-MARKUP:
<h1>HNC Facilities Management</h1>
<p>Higher National qualifications provide practical skills and theoretical
  knowledge that meet the needs of employers. The HNC in Facilities Management
  (SCQF level 7) develops knowledge and skills of the modern Facilities
  Management industry including both ‘hard’ and ‘soft’ services, and is aimed
  at those in supervisory and management roles or aspiring managers within the
  wider realm of Facilities Services.</p>

MICRODATA:
<div itemscope itemtype="http://schema.org/EducationalOccupationalCredential">
  <h1 itemprop="name">HNC Facilities Management</h1>
  <p itemprop="description">Higher National qualifications provide practical
    skills and theoretical knowledge that meet the needs of employers. The HNC
    in Facilities Management (SCQF level 7) develops knowledge and skills of the
    modern Facilities Management industry including both ‘hard’ and ‘soft’
    services, and is aimed at those in supervisory and management roles or
    aspiring managers within the wider realm of Facilities Services.</p>
  <div itemprop="credentialCategory"
       itemscope itemtype="http://schema.org/DefinedTerm">
    <meta itemprop="name" content="Higher National Certificate" />
    <meta itemprop="termCode" content="HNC" />
  </div>
</div>

RDFA:
<div  vocab="http://schema.org/" typeof="EducationalOccupationalCredential">
  <h1 property="name">HNC Facilities Management</h1>
  <p property="description">Higher National qualifications provide practical
    skills and theoretical knowledge that meet the needs of employers. The HNC
    in Facilities Management (SCQF level 7) develops knowledge and skills of
    the modern Facilities Management industry including both ‘hard’ and ‘soft’
    services, and is aimed at those in supervisory and management roles or
    aspiring managers within the wider realm of Facilities Services.</p>
  <div property="credentialCategory" typeof="http://schema.org/DefinedTerm">
    <meta property="name" content="Higher National Certificate" />
    <meta property="termCode" content="HNC" />
  </div>
</div>

JSON:
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EducationalOccupationalCredential",
  "name" : "HNC Facilities Management",
  "description" : "Higher National qualifications provide practical
  skills and theoretical knowledge that meet the needs of employers. The HNC
  in Facilities Management (SCQF level 7) develops knowledge and skills of
  the modern Facilities Management industry including both ‘hard’ and ‘soft’
  services, and is aimed at those in supervisory and management roles or
  aspiring managers within the wider realm of Facilities Services.",
  "credentialCategory" : {
    "@type": "DefinedTerm",
    "name": "Higher National Certificate",
    "termCode": "HNC"
  }
}
</script>

2. Based on BCSP Certified Safety Professional

This copy is for ease of reference only. The definitive version is in file issue-1779-examples.txt on github, which may be more extensive. 

PRE-MARKUP:
<h1>Certified Safety Professional</h1>
<p>Certified Safety Professionals (CSP) are persons
  who perform at least 50% of professional level safety duties, including
  making worksite assessments to determine risks, assessing potential hazards
  and controls, evaluating risks and hazard control measures, investigating
  incidents, maintaining and evaluating incident and loss records, and
  preparing emergency response plans.</p>

MICRODATA:
<div itemscope itemtype="http://schema.org/EducationalOccupationalCredential">
<h1 itemprop="name">Certified Safety Professional</h1>
<link itemprop="url" href="https://www.bcsp.org/CSP" />
<p itemprop="description">Certified Safety Professionals (CSP) are persons
  who perform at least 50% of professional level safety duties, including
  making worksite assessments to determine risks, assessing potential hazards
  and controls, evaluating risks and hazard control measures, investigating
  incidents, maintaining and evaluating incident and loss records, and
  preparing emergency response plans.</p>
  <div itemprop="credentialCategory"
       itemscope itemtype="http://schema.org/DefinedTerm">
    <meta itemprop="name" content="Certification" />
    <link itemprop="url" href="http://purl.org/ctdl/terms/Certification" />
    <div itemprop="inDefinedTermSet" itemscope
         itemtype="http://schema.org/DefinedTermSet">
      <meta itemprop="name" content="Credential Transparency Description Language"/>
      <link itemprop="url" content="http://purl.org/ctdl/terms/" />
    </div>
  </div>
  <link itemprop="additionalType" href="http://purl.org/ctdl/terms/Certification">
</div>

RDFA:
<div vocab="http://schema.org/"
     typeof="EducationalOccupationalCredential http://purl.org/ctdl/terms/Certification">
<h1 property="name">Certified Safety Professional</h1>
<link property="url" href="https://www.bcsp.org/CSP" />
<p property="description">Certified Safety Professionals (CSP) are persons
  who perform at least 50% of professional level safety duties, including
  making worksite assessments to determine risks, assessing potential hazards
  and controls, evaluating risks and hazard control measures, investigating
  incidents, maintaining and evaluating incident and loss records, and
  preparing emergency response plans.</p>
  <div property="credentialCategory" typeof="DefinedTerm"
       resource="http://purl.org/ctdl/terms/Certification" />
    <meta property="name" content="Certification" />
    <div property="inDefinedTermSet" typeof="http://schema.org/DefinedTermSet"
         resource="http://purl.org/ctdl/terms/">
      <meta property="name" content="Credential Transparency Description Language"/>
    </div>
  </div>
</div>

JSON:
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": ["EducationalOccupationalCredential","http://purl.org/ctdl/terms/Certification"],
  "name": "Certified Safety Professional",
  "url": "https://www.bcsp.org/CSP",
  "description": "Certified Safety Professionals (CSP) are persons
  who perform at least 50% of professional level safety duties, including
  making worksite assessments to determine risks, assessing potential hazards
  and controls, evaluating risks and hazard control measures, investigating
  incidents, maintaining and evaluating incident and loss records, and
  preparing emergency response plans.",
  "credentialCategory" : {
    "@type": "DefinedTerm",
    "@id": "http://purl.org/ctdl/terms/Certification",
    "name": "Certification",
    "inDefinedTermSet" : {
       "@type": "DefinedTermSet",
       "@id": "http://purl.org/ctdl/terms/",
       "name": "Credential Transparency Description Language"
    }
  }
}
</script>
Retrieved from "https://www.w3.org/community/eocred-schema/wiki/index.php?title=Catagorize_credential_by_type&oldid=142"