pesc-org / json-ld-transcript

Creating a machine readable, semantic PESC transcript
https://www.pesc.org/college-transcript.html
1 stars 0 forks source link

Mapping Organization to CEDS #21

Closed philbarker closed 7 months ago

philbarker commented 10 months ago

CEDS has several subclasses for Organization, we currently have just one top-level organization.

Most of the properties of Organization are identifiers or related to contact details.

Contact we have pretty much solved for Person using CTDL in such a way that we can use the same object type for Organization.

For identifiers we can try the same CEDS-based approach as we did for person identifiers: instead of separate properties for each type of identifier, we use the ceds:hasOrganizationIdentification property with an object of relevant the type.

That leaves just a handful of properties: accreditation, noteMessage/elm:additionalNote, organizationName, schoolLevel, schoolOverrideCode.

List of most relevant CEDS Organization subclasses

AdultEducationProvider CredentiallingOrganization EarlyCollege EducationInstitution K12School PostsecondaryInstitution PostsecondarySystem (and several other more specialized types).

Contact Point

We found CEDS addresses to be problematic for Students (they were too US-centric) and so used CTDL ContactPoint + PostalAddress instead.

Identifier mapping

If we use CEDS for identifiers as we did with Person, here are the relevant types of identifier.

PESC Identifier CEDS Identifier Type CEDS Description
pesc:actID OrganizationIdentification_ACT College Board/ACT program code set of PK-grade 12 institutions
pesc:atpID
pesc:ccdID
pesc:ceebactID
pesc:csisID [Canadian, old, not in CEDS]
pesc:dunsID OrganizationIdentification_DUNS Dun and Bradstreet number
pesc:esisID [Canadian, old, not in CEDS]
pesc:ipedsID
pesc:ficeID
pesc:nchelpID
pesc:opeID
pesc:psisID [Canadian, not in CEDS]
pesc:pssID
pesc:usisID [Canadian, old, not in CEDS]
pesc:localOrganizationID
pesc:mutuallyDefinedID OrganizationIdentification_Other Not yet defined in CEDS.

CEDS has others, see element/000827, element/001072.

Any others that we don't match would likely be handled using the CEDS _Other or _OtherFederal + a type from the pesc: namespace.

Remaining properties

Pesc property Mapping
accreditation ceds:AccreditingOrganization
noteMessage elm:additionalNote or drop
organizationName ceds:NameOfInstitution
schoolLevel ? Maybe Organization subtype?
schoolOverrideCode
philbarker commented 9 months ago

model identifiers as was done for PersonIdentification rm: schoolOverrideCode Keep with Organization rather more specific types Keep current school levels

philbarker commented 8 months ago

On 28 Feb, decided that OpeID and PSIS were suggested as the most important organization id schemes for US and Canada respectively. OpeID is in CEDS Domain Entity Schema but under "Directory" and not as an identification scheme, and is not in the draft ontology. CTDL, incidently, has a property for opeID.

PSIS, being non-US is not in CEDS.

I suggest, for now, creating identifier types in the pesc: namespace for OPEID and PSIS.

4pins commented 8 months ago

"I suggest, for now, creating identifier types in the pesc: namespace for OPEID and PSIS." Seems right to me!