Skip to content

Commit

Permalink
Educational and Occupational Credentials (#1978)
Browse files Browse the repository at this point in the history
* correcting format of durations, fixes #1470

* correcting examples in timeRequired. Fixes #1469

* Adding template for Educational and Occupational Credentials, and defining class EducationalOccupationalCredential

* adding examples for EducationalOccupationalCredential class with name and description proerties

* forgot closing tags for examples

* adding defintion for credentialType property, with examples. Minor tidying of example formatting

* Starting second example. Getting confused over TermDefinitions, DefinedTerms, termCodes

* pointing to EOCredential test site

* fixed TermDefinition to DefinedTerm; added JSON-LD example for Safety Certification; removed strat div

* credentialType -> credentialCategory 'disarming to presumptuous software folk'-Fritz Ray

* tidying up types, ids and urls for typeof and credentialCategory

* missed a credentialType -> credentialCategory

* adding definition and example for educationalLevel

* Changing range to Course educationalCredentialAwarded to include EducationalOccupationalCredential

* change to defn and range of educationalLevel

* Adding definition for competencyrequired and example of it.

* extend scope of defn of conpetencyRequired to match scope of e.o.credential

* adding area and duration of validity

* better wording of definition for validFor

* Added recognizedBy

* Adding template for Educational and Occupational Credentials, and defining class EducationalOccupationalCredential

* adding examples for EducationalOccupationalCredential class with name and description proerties

* forgot closing tags for examples

* adding defintion for credentialType property, with examples. Minor tidying of example formatting

* Starting second example. Getting confused over TermDefinitions, DefinedTerms, termCodes

* fixed TermDefinition to DefinedTerm; added JSON-LD example for Safety Certification; removed strat div

* credentialType -> credentialCategory 'disarming to presumptuous software folk'-Fritz Ray

* tidying up types, ids and urls for typeof and credentialCategory

* missed a credentialType -> credentialCategory

* adding definition and example for educationalLevel

* Changing range to Course educationalCredentialAwarded to include EducationalOccupationalCredential

* change to defn and range of educationalLevel

* Adding definition for competencyrequired and example of it.

* extend scope of defn of conpetencyRequired to match scope of e.o.credential

* adding area and duration of validity

* better wording of definition for validFor

* Added recognizedBy

* parking recognizedBy proposal

* reversing withdrawal of recognizedBy

* education requirements

* restoring schema.org app.yaml

* Revert "correcting format of durations, fixes #1470"

This reverts commit 1afaec7.

* Revert "correcting examples in timeRequired. Fixes #1469"

This reverts commit 2457783.

* changing definition of validIn and validFor to something more generic; done in schema.rdfa since changes in pending file did not show.

* Fixing (simplifying) and adding examples

* explicitly adding text and url to range of credentialCategory

* putting text and url back into range of Course-> educationalCredentialAwarded
  • Loading branch information
philbarker authored and danbri committed Oct 23, 2018
1 parent 6649c41 commit 5f99c67
Show file tree
Hide file tree
Showing 4 changed files with 313 additions and 5 deletions.
230 changes: 230 additions & 0 deletions data/ext/pending/issue-1779-examples.txt
@@ -0,0 +1,230 @@
TYPES: EducationalOccupationalCredential, credentialCategory, educationalLevel, competencyRequired

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>
<h2>Mapping to National Occupational Standards</h2>
<ul>
<li>ASTFM401 Understand facilities management and its place in the organisation</li>
<li>[etc]</li>
</ul>


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="educationalLevel"
itemscope itemtype="http://schema.org/DefinedTerm">
<meta itemprop="name" content="SCQF Level 7" />
<link itemprop="inDefinedTermSet" href="https://www.sqa.org.uk/sqa/71377.html" />
</div>
<div itemprop="credentialCategory"
itemscope itemtype="http://schema.org/DefinedTerm">
<meta itemprop="name" content="Higher National Certificate" />
<meta itemprop="termCode" content="HNC" />
</div>
<h2>Mapping to National Occupational Standards</h2>
<ul>
<li itemprop="competencyRequired"
itemscope itemtype="http://schema.org/DefinedTerm">
<span itemprop="termCode">ASTFM401</span>
<span itemprop="name">Understand facilities management and its place in the organisation</span>
<link itemprop="url" href="https://www.ukstandards.org.uk/PublishedNos/ASTFM401.pdf" />
<link itemprop="inDefinedTermSet" href="https://www.ukstandards.org.uk/" />
</li>
<li>[etc]</li>
</ul>
</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="educationalLevel" typeof="DefinedTerm">
<meta property="name" content="SCQF Level 7" />
<link property="inDefinedTermSet" href="https://www.sqa.org.uk/sqa/71377.html" />
</div>
<div property="credentialCategory" typeof="DefinedTerm">
<meta property="name" content="Higher National Certificate" />
<meta property="termCode" content="HNC" />
</div>
<h2>Mapping to National Occupational Standards</h2>
<ul>
<li property="competencyRequired" typeof="DefinedTerm">
<span property="termCode">ASTFM401</span>
<span property="name">Understand facilities management and its place in the organisation</span>
<link property="url" href="https://www.ukstandards.org.uk/PublishedNos/ASTFM401.pdf" />
<link property="inDefinedTermSet" href="https://www.ukstandards.org.uk/" />
</li>
<li>[etc]</li>
</ul>
</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.",
"educationalLevel" : {
"@type": "DefinedTerm",
"name": "SCQF Level 7",
"inDefinedTermSet": "https://www.sqa.org.uk/sqa/71377.html"
},
"credentialCategory" : {
"@type": "DefinedTerm",
"name": "Higher National Certificate",
"termCode": "HNC"
},
"competencyRequired" : {
"@type": "DefinedTerm",
"termCode": "ASTFM401",
"name": "Understand facilities management and its place in the organisation",
"url": "https://www.ukstandards.org.uk/PublishedNos/ASTFM401.pdf",
"inDefinedTermSet": "https://www.ukstandards.org.uk/"
}
}
</script>

TYPES: EducationalOccupationalCredential, credentialCategory
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">
<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"],
"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>

TYPES: EducationalOccupationalCredential, Occupation, educationRequirements

PRE-MARKUP:
<h1>Occupation: Research Scientist</h1>
<h2>educationRequirements"</h2>
<p>PhD or equivalent<p>

MICRODATA:
<div itemscope itemtype="http://schema.org/Occupation">
<h1>Occupation: <span itemprop="name"> Research Scientist</span></h1>
<h2>qualifications</h2>
<p itemprop="educationRequirements" itemscope
itemtype="http://schema.org/EducationalOccupationalCredential">
<span itemprop="educationalLevel">PhD or equivalent</span>
</p>
</div>


RDFA:
<div vocab="http://schema.org/" typeof="http://schema.org/Occupation">
<h1>Occupation: <span property="name"> Research Scientist</span></h1>
<h2>qualifications</h2>
<p property="educationRequirements"
typeof="http://schema.org/EducationalOccupationalCredential">
<span property="educationalLevel">PhD or equivalent</span>
</p>
</div>

JSON:
<script type="application/ld+json">
{
"@context": "http://schema.org/",
"@type": "Occupation",
"name": "Research Scientist",
"qualifications": {
"@type": "EducationalOccupationalCredential",
"educationalLevel": "PhD or equivalent"
}
}
</script>
79 changes: 79 additions & 0 deletions data/ext/pending/issue-1779.rdfa
@@ -0,0 +1,79 @@
<div>
<!-- Educational and Occupational Credentials should be in schema.org, issue 1779 -->

<div typeof="rdfs:Class" resource="http://schema.org/EducationalOccupationalCredential">
<span class="h" property="rdfs:label">EducationalOccupationalCredential</span>
<span property="rdfs:comment">An educational or occupational credential. A diploma, academic degree, certification, qualification, badge, etc., that may be awarded to a person or other entity that meets the requirements defined by the credentialer.</span>
<span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/CreativeWork">CreativeWork</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>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/credentialCategory">
<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>
<span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>
<span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/URL">URL</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>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/educationalLevel">
<span class="h" property="rdfs:label">educationalLevel</span>
<span property="rdfs:comment">The level in terms of progression through an educational or training context. Examples of educational levels include 'beginner', 'intermediate' or 'advanced', and formal sets of level indicators.</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/Text">Text</a></span>
<span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/URL">URL</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>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/competencyRequired">
<span class="h" property="rdfs:label">competencyRequired</span>
<span property="rdfs:comment">Knowledge, skill, ability or personal attribute that must be demonstrated by a person or other entity.</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/Text">Text</a></span>
<span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/URL">URL</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>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/validIn">
<span class="h" property="rdfs:label">validIn</span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
<span>Source: <a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/1779">#1779</a></span>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/validFor">
<span class="h" property="rdfs:label">validFor</span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
<span>Source: <a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/1779">#1779</a></span>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/recognizedBy">
<span class="h" property="rdfs:label">recognizedBy</span>
<span property="rdfs:comment">An organization that acknowledges the validity, value or utility of a credential. Note: recognition may include a process of quality assurance or accreditation.</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/Organization">Organization</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>
<span>Category: <span property="schema:category">issue-1779</span></span>
</div>
<div typeof="rdf:Property" resource="http://schema.org/educationRequirements">
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
<link property="http://schema.org/isPartOf" href="http://pending.schema.org" />
<span property="schema:category">issue-1779</span>
<a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/1779"></a>
</div>
<div typeof="rdf:Property" resource="http://schema.org/qualifications">
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
<link property="http://schema.org/isPartOf" href="http://pending.schema.org" />
<span property="schema:category">issue-1779</span>
<a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/1779"></a>
</div>

</div>
5 changes: 2 additions & 3 deletions data/ext/pending/issue-195.rdfa
Expand Up @@ -39,13 +39,12 @@ We show /educationalCredentialAwarded in the examples but it is still under disc
(more so than the above which are relatively stable). -->

<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/URL">URL</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>

- <span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
</div>

</div>
4 changes: 2 additions & 2 deletions data/schema.rdfa
Expand Up @@ -7416,7 +7416,7 @@ Open-ended date ranges can be written with ".." in place of the end date. For ex

<div typeof="rdf:Property" resource="http://schema.org/validFor">
<span class="h" property="rdfs:label">validFor</span>
<span property="rdfs:comment">The time validity of the permit.</span>
<span property="rdfs:comment">The duration of validity of a permit or similar thing.</span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/Permit">Permit</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Duration">Duration</a></span>
</div>
Expand All @@ -7434,7 +7434,7 @@ Open-ended date ranges can be written with ".." in place of the end date. For ex
</div>
<div typeof="rdf:Property" resource="http://schema.org/validIn">
<span class="h" property="rdfs:label">validIn</span>
<span property="rdfs:comment">The geographic area where the permit is valid.</span>
<span property="rdfs:comment">The geographic area where a permit or similar thing is valid.</span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/Permit">Permit</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/AdministrativeArea">AdministrativeArea</a></span>
</div>
Expand Down

0 comments on commit 5f99c67

Please sign in to comment.