View on GitHub

artsdata-data-model

Overview of how data is modelled in Artsdata.ca.

< Back | Home | Edit page | 🙋 Check for open issues |

Structured Data Templates

Structured data templates in JSON-LD format based on the Schema.org vocabulary.

Inspired by the Structured Data Templates project of La danse sur les routes du Québec

Conventions

Identification of values to modify in the template

Templates are made available as a file containing data in JSON-LD format.

To facilitate understanding and use, explanatory notes have been included about the expected values and the format in which they should be entered. These notes have been placed between double dashes in French and in English. For example:

"url": "--URL complète vers la page Web concernée : Full URL to the relevant webpage--"

Once the template is used and filled with data, it should no longer contain double dashes. For instance:

"url": "https://placedesarts.com"

Template

The Event template is intended to represent information about single events, ie a show having a single representation. If your event has a series of performances of the same show, please add the Event Series template to the Event template to describe each individual performance as a nested entity1 within the ‘subEvent’ property’s array. Then change the top Event type to ‘EventSeries’.

Details on key properties

@id

Enter a URI constituting a unique identifier of the event within the website domain. The event’s URI should be different from the web page’s URI, because a “real-world object” and the web page describing it are two distinct things (or entities) in Schema structured data.

For series of performances, in addition to the URI of the EventSeries entity, a distinct URI should be assigned to each performance using the Add-on for Event Series. Make sure that no individual performance is assigned the same URI as the first-level EventSeries entity.

If you are unable to assign a distinct URI to each event, including each performance of a series of performances, then it is preferable not to use the @id property.2

additionalType

Enter additional types corresponding to the particular type of event. Refer to the Artsdata controlled vocabulary to identify the most appropriate type(s) of all performing arts event types. You can add as many additionalType properties as needed to properly describe the event. As a default, we recommend the type PerformingArtsEvent, which denotes « a performing arts work performed for an audience ».

name

Enter the title of the event.

url

Enter the canonic URL of the event web page on the organizer’s website. For series of performances, if each peformance has its own web page, enter each performance’s unique URL. Otherwise, enter the URL of the event series’ web page. Sinon saisissez, l’URL de la page web de la série de représentation.

eventStatus

Indicate whether an event is scheduled (with date), postponed (date to be confirmed), rescheduled (with new date) or cancelled.

eventAttendanceMode

Indicate if an event occurs in person, online, or is hybrid, meaning both on and offline.

organizer

Enter information identifying and describing the organization that is responsible for presenting the show. It can be a presenter or a self-presenting company. You can add multiple organizer(s). Entities nested1 under this property are typically of @type Organization.

performer

Enter information identifying and describing the company, group or person(s) who is(are) responsible for performing the performance. It is possible to add several performer(s). The entities nested under this property can be of @type Organization, PerformingGroup or Person.

location

Enter the information identifying and describing the place where the event is presented (is happening). The entity nested under the location property can be @type Place (a physical space) or @type VirtualLocation (a virtural space).

offers

Enter information about ticket availability and the webpage where tickets can be purchased.

sameAs (for embeded entities)

Enter the URIs of bridge identifiers3 that identify without any ambiguity the entities nested within the Event type entity. When there are multiple values, list them within square brackets, one URI per line.

Always enter bridge identifiers in full URI format (rather than entering just the identifier’s string). For example, for the Wikidata ID Q596774, the matching URI is http://www.wikidata.org/entity/Q596774 (note that the URI format is different from the web page URL format). ISNI, Wikidata and Artsdata all have their own user interface with their respective processes for searching an entity and retrieving its URI. Wikidata is particularly intricate in this regard: in order to retrieve an item’s URI, the user must right click on “Concept URI” in the left menu (within the “Tools” section), and then select “Copy link address”. For more information, consult these Recommendations Regarding Unique Persistent Identifiers in the Performing Arts.

The sameAs property can also be used to list social media and streaming platform accounts associated with an entity.

Here is a JSON-LD example of a nested @type PersonPerson entity described with the sameAs property. Please note that, for consision’s sake, several relevant properties were excluded from this example.

{
   "@context":"http://schema.org/",
   "@type":"Event",
   "@id":"https://somesite.ca/events/elisapie-isaac#2023-06-16T20:00:00",
   "name":"The Ballad of the Runaway Girl",
   "startDate":"2023-06-16T20:00:00-04:00",
   <!-- ... -->
   "performer":{
      "@type":"Person",
      "name":"Elisapie",
      "url":"https://www.elisapie.com",
      "sameAs":[
         "http://kg.artsdata.ca/resource/K12-438",
         "https://isni.org/isni/0000000002492038",
         "http://www.wikidata.org/entity/Q596774",
         "https://music.apple.com/artist/440813872"]
      },
   <!-- ... -->
}

  1. The term “nested entities” refers to entities linked to the Event entity through properties such as organizer, performer, location ou subEvent. These entities are things in their own right in the Schema.org context. They can have a different @type from the first-level entity. They can be described with attribute-value pairs in the same fashion as the first-level entity. The “nesting” of entities within the first-level entity serves many purposes: it indicates that the first-level entity is the main entity of the web page; it explicitly and semantically describes the relationship between the first-level entity and the second-level entities; it removes any confusion as to which attribute-value pair relates to which entity. Nested entities are embedded as values within an attribute-value pair using curly brackets { }. Nested entities are usually indented in the code and in JSON-LD viewers, in order to help human readability. ↩ ↩2

  2. It is possible to generate a fonctional URI by appending a hash (#) at the end of the web page URL, followed by a string of characters that acts as a unique identifier for an event entity on the page (this string is called a fragment identifier. Let’s take this fictional example: https://mypresentingorg.ca/events/eventname/#e1324. In this exemple, the web page’s URL (and URI) is https://mypresentingorg.ca/events/eventname/, while the string e1324 is an identifier that uniquely identifies an event in the websites events listing. Any character string is fine, as long as it is unique within the website’s domain. For example, it could be a local identifier in the website’s database. It could also be the date and time of the performance. It is not necessary for the fragment identifier to point to a tail anchor within the page’s body (for example, an id or name attribute): as long as the character string that follows the hash is unique, this satisfies the requirement of a canonical URL in the context of Schema.org. More information. ↩

  3. A bridge identifier is a globally unique persistent identifier (i.e., an identifier expressed as a permanent and dereferenceable URI) that is used by several information systems and can thus help reconcile entities across systems. Bridge identifier therefore play a crucial role in enabling data sharing across systems. The ISNI, the Wikidata ID and the Artsdata ID are relevant bridge identifiers in the performing arts domain. The URIs of these bridge identifiers can resolve to either a web page (readable by humans) or RDF data (readable by machines) that provide descriptive information about the entity. For more information, consult these Recommendations Regarding Unique Persistent Identifiers in the Performing Arts. ↩