Insérer des concepts de Nomenclature à votre site Web

S’ils le souhaitent, les utilisateurs de Nomenclature (musées, producteurs de logiciels de gestion des collections) peuvent insérer une représentation visuelle des concepts de Nomenclature à leurs outils en ligne afin d’intégrer de manière harmonieuse les données de Nomenclature à leur propre contenu (grâce à leurs feuilles CSS respectives). Pour ce faire, les développeurs Web doivent suivre la procédure suivante :

• Ajouter un élément « div » doté de l’attribut « class='nomenclature' » tous deux sont obligatoires.
• Indiquer l’identifiant numérique (ID) du terme à afficher (« data-id ») qui se trouve dans l’adresse URL sous le paramètre ID. Par exemple, l’identifiant de « Chaise » est « 1090 » : https://page.nomenclature.info/parcourir-browse.app?lang=fr&id=1090&wo=I&ws=CA. Ce paramètre est obligatoire dans l’élément « div ».
• Préciser la langue : data-ui_lang (en, fr).
  • La langue affichée par défaut est l’anglais (valeur « en »).
• Préciser le type de données : data-type (data, ref, all).
  • Le type de données « data » récupère les données telles qu’elles apparaissent sous l’onglet Nomenclature de la page https://page.nomenclature.info/parcourir-browse.app?lang=fr&id=1090&wo=I&ws=CA
  • Le type de données « ref » récupère les autres références qui se trouvent dans l’onglet « Autres références à ce concept » de la page https://page.nomenclature.info/parcourir-browse.app?lang=fr&id=1090&wo=I&ws=CA
  • Le type de données « all » récupère toutes les données « data » et « ref » à l’aide d’une seule requête. Il s’agit du type de données par défaut.
• Indiquer la variante linguistique : data-ling_var (CA, INT),
  • La variante linguistique « CA » récupère les données dans la variante linguistique canadienne.
  • La variante linguistique « INT » récupère les données dans la variante linguistique internationale. Il s’agit de la variante par défaut.
• Indiquer l’identifiant du client (« data-client_id ») – il s’agit de l'adresse courriel de l’organisme ou de la personne qui utilise le service, adresse qu’utilisera le RCIP pour informer le client dans l’éventualité où des changements substantiels au service, susceptibles de perturber son utilisation, sont prévus).
• Appeler la fonction JavaScript du site Nomenclature.
  • <script async src='https://page.nomenclature.info/js/inc-nomenclature-term.js?v=1.0'></script>
  • Il est à noter que le RCIP maintiendra actives deux versions de cette fonction JavaScript (maintien de la version précédente). .
    • Actuelle : inc-nomenclature-term.js?v=1.0 (premier choix)
    • Actuelle (avec numéro de version) : inc-nomenclature-term.js?v=1.0
    • Version précédente : inc-nomenclature-term-0.1.js
    • Le RCIP invite les utilisateurs à utiliser systématiquement la version la plus récente (sans numéro de version), puisque les versions avec numéro pourraient cesser de fonctionner au fur et à mesure qu’elles cesseront d’être maintenues.

Il est possible de combiner plusieurs appels sur une même page HTML.
Par exemple :

• <div class='nomenclature' data-client_id='test_client' data-id="1080" data-type="data" data-ui_lang="fr"><p>Veuillez patienter pendant le téléchargement du contenu...</p></div>
• <div class='nomenclature' data-client_id='test_client' data-id="1080" data-type="ref" data-ui_lang="fr"><p>Veuillez patienter pendant le téléchargement du contenu...</p></div>
• <div class='nomenclature' data-client_id='test_client' data-id="1080" data-type="all" data-ui_lang="en"><p>Veuillez patienter pendant le téléchargement du contenu...</p></div>
• <script async src='https://page.nomenclature.info/js/inc-nomenclature-term.js?v=1.0'></script>

La phrase « Veuillez patienter pendant le téléchargement du contenu... » permet d’informer les utilisateurs que les données externes provenant de Nomenclature sont en cours de téléchargement sur la page. Cette phrase peut être personnalisée.

Nota : Le rendu de la page nécessitera vos feuilles CSS personnalisées afin de maintenir l’apparence de votre site.