Données ouvertes de CorpusUL
Les données sur les publications des chercheurs déposées dans CorpusUL peuvent être échangées avec d'autres systèmes. Vous trouverez ci-dessous de l'information sur l'utilisation possible de ces données.
Service Web de CorpusUL
À partir des données de CorpusUL, le service Web permet l'intégration automatisée d'une liste de publications qui ont été déposées dans la plateforme. Grâce à ce service, une telle liste peut, par exemple, être intégrée dans un site Web pour l'un des chercheurs d'une faculté ou d'un département, ou pour l'ensemble de ceux-ci.
Les listes de publications générées par le service Web sont regroupées par chercheur, puis par collections, qui correspondent à des types de documents: article, livre, chapitre de livre et rapport de recherche. Pour voir toutes les collections disponibles dans la plateforme et leur description, consultez la page Communautés et collections dans CorpusUL.
Exemple d'intégration dans un site Web
L'image ci-dessous montre une partie des publications récentes de la professeure Chantal Guillemette intégrées dans le site Web de la Faculté de pharmacie. Pour voir l'exemple en contexte, consultez la page Répertoire du personnel, section «Publications récentes».
Modalités d'intégration dans un site Web
L'intégration des données exige certaines compétences techniques. Vous pouvez demander l'assistance du Bureau des services Web de l'Université Laval par courriel à l'adresse web@bsw.ulaval.ca ou par téléphone au poste 7881. Notez que la Bibliothèque n'offre pas le service d'intégration des données.
Si vous disposez d'un personnel qualifié, vous pouvez intégrer vous-même les données en suivant les instructions ci-dessous.
- Consultez la documentation technique du service Web de CorpusUL sur le site Swagger.
- Consultez les tableaux ci-dessous, dans les sections Réponse documentée et Éléments indispensables pour créer une liste de publications.
- Inscrivez-vous au registre d'utilisation de l'API REST sur le site de CorpusUL pour recevoir les nouveautés sur l'API REST et être informé des périodes de maintenance.
Syntaxe des requêtes
La requête doit se faire avec des chaînes de caractères exactes incluant les majuscules, les minuscules et les accents. Trop approximative, elle risque de ne pas aboutir ou d'être longue à s'exécuter.
À partir du nom d'un chercheur, la recherche doit être faite sous la forme «Nom, Prénom». Notez qu'il n'est pas possible de chercher plus d'un chercheur à la fois dans une requête.
Exemples de requêtes
Pour lister toutes les publications d'un chercheur disponibles dans CorpusUL
- Requête avec le nom du chercheur Frédéric Lasserre
- Requête avec l'identifiant du chercheur Frédéric Lasserre
Pour lister tous les chercheurs d'une faculté qui ont déposé des documents dans CorpusUL
Les informations contenues dans la réponse à une requête dépendent du paramètre «authorsOnly (true/false)».
- Avec le paramètre «authorsOnly (true)», le service Web renvoie uniquement les informations sur les auteurs (nom, prénom, etc.)
- Avec le paramètre «authorsOnly (false)», le service Web renvoie les informations sur les auteurs et la liste des publications de chacun.
Lorsque le paramètre «authorsOnly (false)» est utilisé pour chaque auteur, les publications sont regroupées par ordre alphabétique de collection et triées par date de publication, de la plus récente à la moins récente.
Le tableau ci-dessous présente les éléments à connaitre pour interpréter la réponse du service Web de CorpusUL.
|
|
JSON |
Description |
Valeur |
|---|---|---|---|
|
Auteurs |
|
|
|
|
|
id |
Id de solr |
UUID |
|
|
prenom |
Prénom de l'auteur |
Texte |
|
|
nom |
Nom de l'auteur |
Texte |
|
|
idUlaval |
Id de l'auteur dans le fichier d'autorité de la Bibliothèque |
Texte |
|
|
appartenanceUlaval |
Faculté d'appartenance |
Texte |
|
|
isni |
|
Texte |
|
|
orcid |
|
Texte |
|
Collections |
|
|
|
|
|
nom |
Nom de la collection |
Texte |
|
|
Id |
Identifiant interne de la collection (UUID) |
UUID |
|
|
handle |
Identifiant permanent de la collection (ex : 20.500.11794/3) |
Texte |
|
Items |
|
|
|
|
|
archived |
Identifie si l'article a été archivé dans CorpusUL |
True/false |
|
|
withdrawn |
Identifie si la référence a été retiré de CorpusUL |
True/false |
|
|
metadata |
Contient toutes les métadonnées descriptifs du document |
Tous les éléments de métadonnées sont accompagnés d'un paramètre langage (mais nous ne l'exploitons pas, majoritairement valeur « null ») |
|
|
dc.contributor.author |
Auteur du document déposé |
Texte (Nom, Prénom) |
|
|
dc.date.issued |
Date de publication |
Date au format AAAA-MM-JJ |
|
|
dc.identifier.uri |
URL permanent dans CorpusUL |
URL de type Handle |
|
|
dc.relation.ispartof |
Titre du livre dans lequel un chapitre a été publié |
Uniquement pour les chapitres de livre |
|
|
dc.title |
Titre principal du document |
Texte |
|
|
dcterms.bibliographicCitation |
Référence à la revue dans laquelle l'article a été publié |
Texte |
Pour consulter la liste complète des éléments de métadonnées descriptives, téléchargez le tableau Excel.
Éléments indispensables pour créer une liste de publications
|
Articles publiés dans une revue avec comité de lecture / Autres articles publiés |
Chapitres de livre |
Livres |
Rapports de recherche |
|---|---|---|---|
|
dc.contributor.author |
dc.contributor.author |
dc.contributor.author |
dc.contributor.author |
|
dc.date.issued |
dc.date.issued |
dc.contributor.editor |
dc.date.issued |
|
dc.title |
dc.title |
dc.date.issued |
dc.title |
|
dc.identifier.uri |
dc.identifier.uri |
dc.title |
dc.identifier.uri |
|
dcterms.bibliographicCitation |
dc.relation.ispartof |
dc.identifier.uri |
|