search

CredentialEngine / CatalogingGuidance

This repository is for recording issues around cataloging credentials including discretionary decision. The focus is on the cataloger--the person creating descriptions.
0 stars 0 forks source link

Handling codedNotation in CredentialAlignmentObject #1

Open stuartasutton opened 7 years ago

stuartasutton commented 7 years ago

The ceterm:codedNotation property of the CredentialAlignmentObject is used to include a formal code identifying a competency that was created by the authors of the competency framework. An example of such a formal code are those assigned to competencies in the U.S. Common Core State Standards; e.g., "CCSS.ELA-Literacy.RI.2.1". Many competency frameworks do not include such formal codes. If there is no explicit formal code, no data should be entered.

The following encoding has an incorrect ceterm:codedNotation value of "1". It appears that the value is some kind of list identifier indicating that this competency is in the first position of an ordered list of competencies. Such list identifiers are not considered ceterms:codedNotation; however, see the asn:listID property in the ASN schema defining competency frameworks that is used to identify such competency positioning in the metadata describing a competency framework.

"ceterms:targetCompetency": [
    {
      "@type": "ceterms:CredentialAlignmentObject",
      "ceterms:alignmentType": "Teaches",
      "ceterms:codedNotation": [
        "1"
      ],
      "ceterms:frameworkName": "Program Learning Outcomes",
      "ceterms:targetNodeName": "Health Assessment: Conduct comprehensive and focused assessments of health and illness parameters in individuals, groups, and vulnerable populations"
    },

NOTE: It would be useful for the record to have an image here of the CE editor input screen where cetermscodedNotation is used.

stuartasutton commented 7 years ago

Below is another example of an inappropriate use of the ceterms:codedNotaiton property. The data appears to be some form of versioning information and not from a formal notation scheme.

"@type": "ceterms:AssessmentProfile",
  "@id": "http://credentialEngineRegistry.org/resources/a81e3b16-f583-40da-a186-c568559ad7e5",
  "ceterms:codedNotation": [
    "Test Code: 1337 / Version: 01"
  ]