CourseInstance DRAFT Profile
Version: 0.9-DRAFT (16 August 2022)
Specification describing the instance of a course.
If you spot any errors or omissions with this type, please file an issue in our GitHub.
You can read the release version of this specification here.
Key to specification table
- Green properties/types are proposed by Bioschemas, or indicate proposed changes by Bioschemas to Schema.org
- Red properties/types exist in the core of Schema.org
- Blue properties/types exist in the pending area of Schema.org
- Black properties/types are reused from external vocabularies/ontologies
CD = Cardinality
| Property | Expected Type | Description | CD | Controlled Vocabulary | Example |
|---|---|---|---|---|---|
| Marginality: Minimum. | |||||
| @context | URL | Used to provide the context (namespaces) for the JSON-LD file. Not needed in other serialisations. |
ONE | ||
| @type | Text | Schema.org/Bioschemas class for the resource declared using JSON-LD syntax. For other serialisations please use the appropriate mechanism. While it is permissible to provide multiple types, it is preferred to use a single type. |
MANY | Schema.org, Bioschemas | |
| @id | IRI | Used to distinguish the resource being described in JSON-LD. For other serialisations use the appropriate approach. | ONE | ||
| dct:conformsTo | IRI | Used to state the Bioschemas profile that the markup relates to. The versioned URL of the profile must be used. Note that we use a CURIE in the table here but the full URL for Dublin Core terms must be used in the markup (http://purl.org/dc/terms/conformsTo), see example. |
ONE | Bioschemas profile versioned URL | |
| courseMode |
Text URL |
Schema: The medium or means of delivery of the course instance or the mode of study, either as a text label (e.g. “online”, “onsite” or “blended”; “synchronous” or “asynchronous”; “full-time” or “part-time”) or as a URL reference to a term from a controlled vocabulary (e.g. https://ceds.ed.gov/element/001311#Asynchronous ). Bioschemas: The medium, means or pace of delivery of the course instance or the mode of study, either as a text label (e.g. “online”, “onsite”, “hybrid” or “blended”; “synchronous” or “asynchronous”; “full-time” or “part-time”) or as a URL reference to a term from a controlled vocabulary (e.g. https://ceds.ed.gov/element/001311#Asynchronous ). Another example of a Glossary of terms as defined by the Bioschemas Training community and published in Zenodo in 2016: https://zenodo.org/record/166378#.YrHnEi8iu-o |
MANY | ||
| location |
Place PostalAddress Text VirtualLocation |
Schema: The location of for example where the event is happening, an organization is located, or where an action takes place. Bioschemas: Location of the Course Instance. If the Course Instance is online, add the connection details as text |
ONE | ||
| Marginality: Recommended. | |||||
| endDate |
Date DateTime |
Schema: The end date and time of the item (in ISO 8601 date format). |
ONE | ISO 8601 |
|
| inLanguage |
Language Text |
Schema: The language of the content or performance or used in an action. Please use one of the language codes from the IETF BCP 47 standard. See also availableLanguage. Supersedes language. |
ONE | ||
| instructor |
Person |
Schema: A person assigned to instruct or provide instructional assistance for the CourseInstance. Bioschemas: An instructor can be the main teacher or trainer, as well as a training assistant, or a helper. |
MANY | ||
| offers |
Demand Offer |
Schema: An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event. Use businessFunction to indicate the kind of transaction offered, i.e. sell, lease, etc. This property can also be used to describe a Demand. While this property is listed as expected on a number of common types, it can be used in others. In that case, using a second type, such as Product or a subtype of Product, can clarify the nature of the offer. Inverse property: itemOffered. Bioschemas: The price an attendee would pay to attend this CourseInstance. The price currency can be for instance in “GBP” (pound sterling) or “CHF” (Swiss francs). |
MANY | Price currency ISO 4217 Date specified price ISO 8601 |
|
| startDate |
Date DateTime |
Schema: The start date and time of the item (in ISO 8601 date format). |
ONE | ISO 8601 |
|
| url |
URL |
Schema: URL of the item. Bioschemas: The preferred URL of this course instance. You must provide this value if it is known |
ONE | ||
| Marginality: Optional. | |||||
| alternateName |
Text |
Schema: An alias for the item. |
MANY | ||
| contributor |
Organization Person |
Schema: A secondary contributor to the CreativeWork or Event. Bioschemas: Contributors are those who made non-authorship contributions: e.g., critical review, commentary or revision. |
MANY | ||
| description |
Text |
Schema: A description of the item. Bioschemas: A description of the Course Instance. (courseInstance) description can be used to override (course) description for specific course instances. |
ONE | ||
| duration |
Duration |
Schema: The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format. Bioschemas: (CourseInstance) duration can be used to override (Course) duration for specific course instances. |
ONE | ||
| eventStatus |
EventStatusType |
Schema: An eventStatus of an event represents its status; particularly useful when an event is cancelled or rescheduled. Bioschemas: An eventStatus of an event represents its status; particularly useful when an event is cancelled or rescheduled. Used as text label (e.g. “postponed”, “cancelled”, “date TBC”, “application open” or “registration closed”). |
ONE | ||
| funder |
Organization Person |
Schema: A person or organization that supports (sponsors) something through some kind of financial contribution. |
MANY | ||
| image |
ImageObject URL |
Schema: An image of the item. This can be a URL or a fully described ImageObject. |
ONE | ||
| maximumAttendeeCapacity |
Integer |
Schema: The total number of individuals that may attend an event or venue. |
ONE | ||
| name |
Text |
Schema: The name of the item. Bioschemas: The name of the course. Course instance name can be used to override Course name for variations in specific Course instances. Use name from Course unless the Course instance has a different name from the course. |
ONE | ||
| organizer |
Organization Person |
Schema: An organizer of an Event. |
MANY | ||
| subEvent |
Event |
Schema: An Event that is part of this event. For example, a conference event includes many presentations, each of which is a subEvent of the conference. Supersedes subEvents. Inverse property: superEvent. Bioschemas: For events within events e.g. guest lecture within a workshop event |
MANY | ||
| superEvent |
Event |
Schema: An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent. Inverse property: subEvent. Bioschemas: Use to describe the event a course instance takes place within. e.g. Galaxy Workshop during the ISMB Conference. |
MANY | ||
| workFeatured |
CreativeWork |
Schema: A work featured in some event, e.g. exhibited in an ExhibitionEvent. Specific subproperties are available for workPerformed (e.g. a play), or a workPresented (a Movie at a ScreeningEvent). Bioschemas: The training material used in this specific course instance, or produced for this course instance. If this is the same for all Course Instances, use hasPart and/or mentions in Course instead |
MANY | ||