Mode d’emploi - Bibliothèques logicielles diagrams.net

Version : 1.0

Créé le : 2021-04-22

Mis à jour le : 2022-11-23

Résumé : Ce document présente un aperçu des bibliothèques logicielles diagrams.net et explique comment les utiliser.

Des questions? : Veuillez adresser vos questions et commentaires par courriel à l’adresse rcip-chin@pch.gc.ca. Précisez « Bibliothèques diagrams.net » dans l’objet.

Utilisation principale

  • Simplifier la visualisation de modèles de données fondés sur CIDOC CRM et ses extensions lorsque ceux-ci sont réalisés par l’intermédiaire de l’outil diagrams.net.

Contexte

Les bibliothèques diagrams.net constituent un ensemble de fichiers XML d’ontologies qui sert à représenter des patrons conceptuels à l’aide du logiciel diagrams.net. Tenu à jour par le Réseau canadien d’information sur le patrimoine (RCIP), ces bibliothèques logicielles permettent de créer des diagrammes dans le cadre de projets de données ouvertes et liées. Le RCIP a jusqu’à maintenant créé sept bibliothèques destinées aux ontologies du Modèle conceptuel de référence du Comité international pour la Documentation (CIDOC CRM); celles-ci sont diffusées officiellement en format RDFS et répertoriées ci-dessous. Elles seront utiles aux utilisateurs qui créent des diagrammes de modèles de données fondés sur le CIDOC CRM.

  • CIDOC CRM base (version 7.1.1)

  • FRBRoo (version 2.4)

  • PRESSoo (version 1.0)

  • CRMdig (version 3.2.2)

  • CRMpc (version 7.1.1)

  • CRMarchaeo (version 1.4.1)

  • CRMgeo (version 1.2)

Ces travaux ont été inspirés par le travail de Nicola Carboni.

Vocabulaire de base et connaissances préalables

Une bibliothèque consiste en un ensemble de formes qu’on peut simplement glisser et déposer dans un diagramme pour en faciliter la création. Elle se trouve habituellement dans le volet gauche du logiciel diagrams.net.

Chaque bibliothèque contient les formes de toutes les classes et les connecteurs correspondant aux propriétés de chaque ontologie. La palette de couleurs choisie (voir ci-dessous) est fondée sur une proposition de George Bruseker pour le CIDOC CRM .

E1_CRM_Entity et toute sous-classe ne faisant pas partie des classes ci-dessous (#FFFFFF)
E2_Temporal_Entity et ses sous-classes (#82C3EC)
E55_Type et ses sous-classes (#FAB565)
E52_Time-Span et ses sous-classes (#86BCC8)
E41_Appellation et ses sous-classes (#FEF3BA)
E53_Place et ses sous-classes (#94CC7D)
E28_Conceptual_Object et ses sous-classes (#FDDC34)
E18_Physical_Thing et ses sous-classes (#E1BA9C)
E41_Actor et ses sous-classes (#FFBDCA)
Toutes les PC_Classes (#CC80FF)

Auditoire visé et description des sections

Quiconque voulant visualiser des modèles de données fondés sur le CIDOC CRM et ses extensions peut utiliser cet outil. Selon la version de diagrams.net utilisée, deux versions permettent de charger les bibliothèques :

Vous trouverez à la rubrique Utilisation des bibliothèques une description plus approfondie des bibliothèques et des conseils sur leur utilisation.

Instructions

Chargement des bibliothèques

Vous pouvez accéder à l’une ou l’autre des bibliothèques de deux façons :

  • vous ouvrez une bibliothèque XML directement dans le logiciel;

  • vous chargez la bibliothèque voulue par son URL.

Ouverture d’une bibliothèque

Cette option est la plus appropriée à l’usage local du logiciel diagrams.net.

Lancez le logiciel diagrams.net, cliquez dans l’ordre sur Fichier puis Ouvrir une librairie depuis, et :

  1. si le répertoire Github ou les fichiers XML sont déjà téléchargés :

    1. choisissez le service ou l’appareil où se trouvent les fichiers;

    2. localisez le fichier voulu et sélectionnez-le (l’extension est .xml), puis cliquez sur Ouvrir.

OU

  1. entrez directement l’URL Github de chaque bibliothèque, dans le répertoire /cidoc-crm :

    1. CIDOC CRM base (https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/crm_library.xml)

    2. FRBRoo (https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/frbroo_library.xml)

    3. PRESSoo (https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/pressoo_library.xml)

    4. CRMdig (https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/crmdig_library.xml)

    5. CRMpc (https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/crmpc_library.xml)

    6. CRMarchaeo ((https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/crmarchaeo_library.xml)

    7. CRMgeo ((https://raw.githubusercontent.com/chin-rcip/diagrams.net_libraries/main/cidoc-crm/crmgeo_library.xml)

Chargement d’une bibliothèque par son URL

Cette option est la plus appropriée à l’usage en ligne du logiciel diagrams.net.

Cliquez sur l’une des adresses suivantes pour ouvrir diagrams.net et y charger la bibliothèque voulue :

Une fois chargée, la bibliothèque est habituellement gardée dans la mémoire cache du navigateur Web; il est donc inutile de la charger de nouveau à moins d’avoir vidé la mémoire cache.

Utilisation des bibliothèques

Les bibliothèques contiennent deux types de formes :

  • des rectangles arrondis colorés selon la palette de couleurs décrite ci-dessus et qui représentent les classes;

  • des flèches noires qui représentent les propriétés.

Chaque forme est étiquetée selon la nomenclature du CIDOC CRM, c’est-à-dire un caractère de soulignement après le code de l’entité et entre chaque mot, par exemple, « E2_Temporal_Entity ». Pour simplifier les recherches à l’aide du champ Chercher des formes dans la partie supérieure du volet de gauche, ces caractères de soulignement sont remplacés par des espaces dans le titre  : « E2 Temporal Entity ».

Pour trouver une forme en particulier (classes ou propriétés), entrez son code CIDOC CRM ou son titre dans le champ de recherche.

Aide-mémoire

  • Cliquez ici pour charger toutes les bibliothèques dans la version en ligne de diagrams.net.

  • Interrogez l’outil de recherche pour trouver une entité par son code ou son titre.

Pour plus d’information

Pour en savoir plus sur la création, l’échange et le chargement des bibliothèques de formes dans diagrams.net, consultez les ressources documentaires suivantes (en anglais seulement) :

Licence

Les fichiers de ce répertoire sont distribués en vertu de la licence MIT. Pour satisfaire aux exigences relatives à son attribution, vous devez préciser comme suit le détenteur du droit d’auteur :

Copyright (c) 2021-2022 Canadian Heritage Information Network, Canadian Heritage, Government of Canada - Réseau canadien d’information sur le patrimoine, Patrimoine canadien, Gouvernement du Canada

diagrams.net est distribué sous la licence Apache License 2.0. Copyright 2021 diagrams.net (JGraph)

Bibliographie

Benson, David. 2020. « Work with Custom Shape Libraries ». Legacy desk – do not use. 15 septembre 2020. https://drawio.freshdesk.com/support/solutions/articles/16000067790-work-with-custom-shape-libraries. (En anglais seulement)

Carboni, Nicola. (2020) 2021. Shapes_CIDOC-CRM. https://github.com/ncarboni/Shapes_CIDOC-CRM (en anglais seulement)

jgraph. n.d. « Diagrams.Net Libraries ». Drawio-Libs. Consulté le 13 mai 2021. http://jgraph.github.io/drawio-libs/ (en anglais seulement)

Réseau canadien d’information sur le patrimoine (RCIP). 2021a. « classe (nom féminin) ». Dans le Glossaire. Ottawa, ON : Government of Canada / Gouvernement du Canada. https://chin-rcip.github.io/collections-model/fr/ressources/actuel/glossaire#classe-nom-feminin

Réseau canadien d’information sur le patrimoine (RCIP). 2021a. « propriété (nom féminin) ». Dans le Glossaire. Ottawa, ON : Government of Canada / Gouvernement du Canada. https://chin-rcip.github.io/collections-model/fr/ressources/actuel/glossaire#propriete-nom-feminin