CredentialEngine / Schema-Development

Development of the vocabularies for the CTI models
13 stars 8 forks source link

New property: targetAction #920

Closed jeannekitchens closed 4 months ago

jeannekitchens commented 6 months ago

Major Use Case: As a QA Organization, I need to publish my QA Actions with a reference to ceterms:object. I am not going to publish the (object) courses or learning programs on behalf of my customers. I need my customers to publish their courses and learning programs and link those to the related QA action. This enables more people and applications to find direct links between resources and related QA actions.

See Action data from Quality Matters in the sandbox.

https://sandbox.credentialengine.org/finder/search?searchType=credentialingaction&filteritemtext=Quality%20Matters:%20Offers%2010%20Quality%20Assurance%20Action(s)&filterparameters={%22n%22:%22organizationroles%22,%22aid%22:3344,%22rid%22:[3,6,7]}

image

ceterms:objectOf Definition: Action carried out upon this resource. Domain: Credential, Learning Opportunity Profile, Learning Program, Course, Competency, Competency Framework, Assessment Profile, Credential Organization, QA Credential Organization, and Organization. Inverse of ceterms:object. Range: Action classes.

siuc-nate commented 5 months ago

Proposal: Create:

URI: ceterms:targetAction Label: Target Action Definition: Action carried out upon this resource. Domain: ceterms:Credential (and subclasses), ceterms:LearningOpportunityProfile (and subclasses), ceasn:Competency, ceasn:CompetencyFramework, ceterms:AssessmentProfile, ceterms:Organization (and subclasses) Range: ceterms:CredentialingAction (and subclasses)

siuc-nate commented 4 months ago

Not to split hairs, but would a more proper URL/name for that definition be something closer to "Object Of Action" or maybe just "Object Of"?

Since the definition is not just a broad/generic "action related to this resource" style definition (which might be needed/useful later on) that we usually use with the "target" properties, I think having a more specific property name/label would make sense. That would also make it safe to declare the properties as being inverse of each other (I think we'd use owl:inverseOf for that?)

I would propose: Create:

URI: ceterms:objectOfAction Label: Object Of Action Definition: Action carried out upon this resource. Domain: ceterms:Credential (and subclasses), ceterms:LearningOpportunityProfile (and subclasses), ceasn:Competency, ceasn:CompetencyFramework, ceterms:AssessmentProfile, ceterms:Organization (and subclasses) Range: ceterms:CredentialingAction (and subclasses) Inverse Of: ceterms:object

Update:

URI: ceterms:object Add owl:inverseOf ceterms:objectOf

philbarker commented 4 months ago

I prefer Nate's latest suggestion. I would tend towards objectOfAction, because objects are all over the place in RDF / JSON-LD.

BTW: for the "broad generic action related to the resource" schema.org has https://schema.org/potentialAction "Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role." (if we ever need it)

siuc-nate commented 4 months ago

I updated the proposal to use "object of action". @jeannekitchens @philbarker Are both of you on board with the proposal in my previous post?

jeannekitchens commented 4 months ago

@siuc-nate I'm good with this.

philbarker commented 4 months ago

@siuc-nate yep, looks good to me.

siuc-nate commented 4 months ago

These changes have been made in pending CTDL and noted in the history tracking