View on GitHub

artsdata-data-model

Overview of how data is modelled in Artsdata.ca.

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

Link to English Version

Version française - Gabarits de données structurées

Gabarits de données structurées au format JSON-LD s’appuyant sur le vocabulaire Schema.org.

Inspiré par le projet Gabarits de données structurées de La danse sur les routes du Québec

Conventions

Identification des valeurs à modifier dans le gabarit

Les gabarits sont rendus disponibles sous forme de fichier contenant des données au format JSON-LD.

Afin de faciliter la compréhension et l’utilisation, des notes explicatives ont été incluses à propos des valeurs attendues et du format dans lequel elles devraient être saisie. Ces notes ont été placées entre de doubles tirets en français et anglais. Par exemple:

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

Une fois le gabarit utilisé et rempli avec des données, il ne devrait plus contenir de doubles tirets. Par exemple:

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

Gabarit

Le gabarit Événement est destiné à représenter les informations à propos d’événements uniques, c’est-à-dire un spectacle ayant une seule représentation. Si votre événement comporte une série de représentations d’un même spectacle, veuillez ajouter l’extension Série d’événements au gabarit Événement afin de décrire chaque représentation comme un ‘subEvent’, puis changez le type de l’événement principal pour ‘EventSeries’.

Détails sur certaines propriétés clés

additionalType

Saisissez des types supplémentaires correspondant au type particulier de l’événement. Référez-vous au la vocabulaire contrôlé Artsdata pour identifier le ou les types les mieux appropriés parmi tous les types d’événements des arts de la scène. Vous pouvez ajouter autant de propriétés additionalType que nécessaire pour bien décrire l’événement. En guise de valeur par défaut, nous recommandons le type PerformingArtsEvent, qui désigne « une œuvre des arts de la scène exécutée pour un public ».

name

Saisissez le titre de l’événement.

url

Saisissez l’URL de la page web de l’événement sur le site de l’organisateur. Dans le cas de séries de représentations, en plus de l’URL de la page web de la série, une URL distincte devrait être assignée à chaque représentation à l’aide de l’Extension pour les Séries d’événements. Si les différentes représentations ne disposent pas de leurs propres page web (en sus de la page de la série), il est tout de même possible de leur assigner des URL ajoutant des ancres # suivies de la date de chaque représentation.

eventStatus

Indiquez si un événement est programmé (avec date), reporté (date à confirmer), reprogrammé (avec nouvelle date) ou annulé.

eventAttendanceMode

Indiquez si un événement se produit en personne, en ligne, ou format hybride.

organizer

Saisissez les informations identifiant et décrivant l’organisme qui est responsable de la présentation du spectacle. Il peut s’agir d’un organisme diffuseur ou d’une compagnie qui présente sa propre production. On peut ajouter plusieurs organizer(s). Les entités décrites sous cette propriété sont généralement de @type Organization.

performer

Saisissez les informations identifiant et décrivant la compagnie, le groupe ou la (des) personne(s) qui est(sont) responsable de l’exécution de la représentation. Il est possible d’ajouter plusieurs performer(s). Les entités décrites sous cette propriété peuvent être de @type Organization, PerformingGroup ou Person.

location

Saisissez les informations identifiant et décrivant l’endroit où est présenté l’événement. L’entité décrite sous la propriété location peut être de @type Place (un lieu physique) ou de @type VirtualLocation (un lieu virtuel).

offers

Saisissez les informations à propos de la disponibilité des billets et de la page Web où l’on peut se les procurer.

English Version - 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 ‘subEvent’, and then change the top Event type to ‘EventSeries’.

Details on key properties

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 URL of the event webpage on the organizer’s website. For series of performances, in addition to the URL of the series webpage, a distinct URL should be assigned to each performance using the Add-on for Event Series. If individual performances in the series do not have their own stand-alone webpages, unique URLs can be created by appending # anchors followed by the date of each performance.

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 described 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 described 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 described 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.