Requêtes sur les ressources de HAL

Les requêtes ci-dessous sont toutes appliquées à une collection (ou un portail), on peut donc changer cet identifiant pour appliquer la requête à son contexte

Nombre d'articles par revues

Requête à facette affichant pour une collection donnée, le nombre d'articles par revue.

https://api.archives-ouvertes.fr/search/?q=%2A&fq=collCode_s%3AUNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&wt=phps&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count

Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

Modifier le champ "collCode" pour changer le portail ou la collection interrogée.

Répartition des dépôts par type de publication

Requête à facette affichant une collection, le nombre d’occurrence par type de publication

https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s%3AUNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&wt=phps&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count

Les cumuls sont caclulés depuis 2011.

Modifier le champ "collCode" pour changer le portail ou la collection interrogée.

Voici la liste des types de documents dans HAL : https://api.archives-ouvertes.fr/ref/doctype

Nombre de dépôts par année type de dépôt et type de document dans sa collection

Requête affichant le nombre de dépôt par année de publication

https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s

Pour chaque année l'arbre xml affiche le nombre total de dépôt, puis l’élément pivot détaille le contenu annuel type de document par type de document.

Nombre de dépôts par domaine dans sa collection

Requête affichane le nombre d'occurence par domaine pour sa collection

https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=%2A&fq=NOT+status_i%3A111&start=0&rows=0&wt=phps&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=level0_domain_s&facet.sort=count

Référentiel des domaines de HAL : https://api.archives-ouvertes.fr/ref/domain

Liste des dépôts d'un regroupement d'institutions

Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)

https://api.archives-ouvertes.fr/search/?q=structId_i:303512

Listes des 50 derniers dépôts faits dans une collection par date de publication descendante

le filtre de tri est producedDate_tdate = date de publication

https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc

changer rows=chiffre pour le nombre de ligne à exporter

changer wt=format (pour xml par exemple)

Listes des 50 derniers dépôts faits dans une collection par date de dépôt descendante

le filtre de tri est submittedDate_s = date de dépôt

https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc

changer SIC pour changer la collection ou le portail

changer rows=chiffre pour le nombre de ligne à exporter

changer wt=format (pour xml par exemple)

Flux rss des dépôts faits dans une collection depuis 1 mois

https://api.archives-ouvertes.fr/search/hal/?q=collCode_s:(UNIV-ORLEANS)&fq=releasedDate_tdate:[NOW%2FDAY-1MONTH+TO+NOW%2FDAY%2B1DAY]&fq=&rows=30&sort=submittedDate_tdate+desc&wt=rss

le champ rows indique le nombre de résultat qu'on souhaite récupérer (30 ici)

Flux rss des 3 derniers dépôts avec texte intégral

https://api.archives-ouvertes.fr/search/pasteur/?wt=rss&q=*&sort=submittedDate_tdate+desc&fq=producedDate_tdate:[NOW-1YEARS%20TO%20NOW]&fq=submitType_s:file&fq=collCode_s%3APASTEUR&fq=NOT+status_i%3A111&rows=3

dans le champ date, on récupère les 12 derniers mois et on limite à 3 résultats

Objectif de la requête	Requête et exemple	Champs à remplacer
Liste des dépôts par labo d'une université (et uniquement des labos affiliés à l'université), par année de dépôt et par type de document déposé	Il s'agit de l'intitulé de la requête tel que formulé par le GT5 : à mon avis il n'est pas possible d'avoir tous ces résultats dans un seul export, je remplace par (voir ligne suivante) : nombre de dépôts pour un laboratoire ou une collection pour une année par type de document Si on veut une liste : quels champs on veut ? (titre/auteur de chaque publi ?)
Nombre des dépôts présents dans une collection/portail trié par type de document Format de réponse : XML	Requête : api.archives-ouvertes.fr/search/AAA/?q=*:*&rows=0&facet=true&facet.field=docType_s&wt=xml Exemple (portail/collection ens-lyon] liste des types de documents	AAA : code de la collection ou du portail BBB : année de dépôt
Nombre des dépôts présents dans une collection/portail trié par type de document par date de dépôt ou de publication Format de réponse : XML	Requête pour une année de dépôt : api.archives-ouvertes.fr/search/AAA/?q=*:*&rows=0&fq=submittedDateY_i:BBB&facet=true&facet.field=docType_s&wt=xml Exemple (portail/collection ens-lyon, année de dépôt 2015) Requête pour les dépôts publiés une année précise (O réponses / pb requête) : api.archives-ouvertes.fr/search/AAA/?q=*:*&rows=0&fq=producedDateY_i=CCC&facet=true&facet.field=docType_s&wt=xml Exemple (portail/collection ens-lyon, année de publication 2015)	AAA : code de la collection ou du portail BBB : année de dépôt (submittedDateY_i) CCC : année de publication (producedDateY_i)
Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD Format : export CSV	Requête : api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:AAA&fq=labStructValid_s:OLD&fq=producedDateY_i:[BBB TO CCC] Exemple	AAA = instStructId_i BBB = année de départ CCC = année de fin
Liste des labos affiliés à une université (ancienne par exemple) et pas à une autre (nouvelle par exemple) Format : export CSV Champs du fichier : docid, name_s	Requête : api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:AAA%20AND%20NOT(parentDocid_i:BBB))&fl=docid,name_s&wt=csv Exemple (Ancienne = Nancy2, Nouvelle = Lorraine)	AAA = parentDocid_i de l'université voulue BBB = parentDocid_i de l'université non voulue
Liste des dépôts de texte intégral d'une institution pour une année Format : sortie XML limitation du résultat à 10000 lignes	Requête : api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:AAA&fq=submittedDateY_i:BBB&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0 Exemple	AAA = instStructId_i BBB = Année voulue

Liste des thèses d'une institution

http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%Université%20d'Orléans%22&wt=csv&sort=producedDate_s%20desc&rows=2000&fl=halId_s,defenseDate_s,authFullName_s,thesisSchool_s,labStructAcronym_s,instStructAcronym_s,title_s,label_s

Format : export csv

champs exportés : halId_s,defenseDate_s,authFullName_s,thesisSchool_s,labStructAcronym_s,instStructAcronym_s,title_s,label_s

changer rows=2000 pour le nombre de réponses

Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX

Objectif de la requête	Requête et exemple	Champs à remplacer
Liste des thèses d'une institution Format : export csv champs exportés : halId_s,defenseDate_s,authFullName_s,thesisSchool_s,labStructAcronym_s,instStructAcronym_s,title_s,label_s Export porté à 2000 réponses	Requête : api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22AAA%22&wt=csv&sort=producedDate_s%20desc&rows=2000&fl=halId_s,defenseDate_s,authFullName_s,thesisSchool_s,labStructAcronym_s,instStructAcronym_s,title_s,label_s Exemple	AAA : authorityInstitution_s copier/coller la chaîne de caractère dans la liste ci-jointe
Exemples pour repérer certains types de publications (ceux demandés lors des évaluations HCERES en particulier)	http://carnetist.hypotheses.org/240	Texte de la cellule
Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX Format de réponse : XML	Requête : https://api.archives-ouvertes.fr/search/X/?q=structure_t:*%20NOT%20(XX)&wt=xml&fl=uri_s Exemple	X : code du portail XX : tous les éléments de la collection
Nombre de dépôt par contributeur dans un portail, par année de dépôt (ex 10 ccsd) Le résultat est rangé du plus grand au plus petit nombre de dépôt pour chaque année	Requête api.archives-ouvertes.fr/search/AAA/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000 Exemple (univ-lille3)	AAA : code collection

Requêtes avec l'API Auréhal

Recherches et extractions de revues

Objectif de la requête	Requête et exemple	Champs à remplacer
Liste des identifiants des revues des notices non valides d'une collection Format : sortie XML	Requête : api.archives-ouvertes.fr/search/AAA/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i Exemple	AAA = l'identifiant de la collection
Liste, triée par ordre de dépôt décroissante des dépôts, des articles publiées en revue, tamponnés par une collection, avec pour chacun la liste des auteurs, l'année de publication, le nom de la revue, ainsi que toutes les informations de RoMEO/SHERPA à propos de la politique éditoriale de la revue Format : sortie XML limitation du résultat à 2000 lignes	Requête : api.archives-ouvertes.fr/search/?q=collCode_s:AAA%20AND%20docType_s:ART&wt=xml&sort=producedDate_s%20desc&rows=2000&fl=authFullName_s,journalTitle_s,submitType_s,journalSherpaColor_s,journalSherpaCondition_s,journalSherpaDate_s,journalSherpaPostPrint_s,journalSherpaPostRest_s, journalSherpaPrePrint_s,journalSherpaPreRest_s,producedDateY_i [https://api.archives-ouvertes.fr/search/?q=collCode_s:3774%20AND%20docType_s:ART&wt=xml&sort=producedDate_s%20desc&rows=2000&fl=authFullName_s,journalTitle_s,submitType_s,journalSherpaColor_s,journalSherpaCondition_s,journalSherpaDate_s,journalSherpaPostPrint_s,journalSherpaPostRest_s, journalSherpaPrePrint_s,journalSherpaPreRest_s,producedDateY_i Exemple]	AAA : collCode_s : identifiant de la collection

Recherches et extractions d'auteurs

Objectif de la requête	Requête et exemple	Champs à remplacer
Liste des chercheurs d'une structure avec indication de leur idhal ou non dans les balises xml Format : sortie XML limitation du résultat à 10000 lignes	Requête : api.archives-ouvertes.fr/search/?q=AAA&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=BBB_FacetSep_&facet.mincount=1&facet.limit=1000 Exemple Lecture des résultats Pour les auteurs qui ont un idhal la chaine le représentant est entre _JoinSep_ et _FacetSep_ Exemple avec Idhal : 226306_FacetSep_Maison des Sciences de l'Homme de Dijon_JoinSep_lsaligny_FacetSep_Saligny Laure Exemple sans Idhal : 226306_FacetSep_Maison des Sciences de l'Homme de Dijon_JoinSep__FacetSep_Alazard Céline	AAA : le corpus de documents (*:* pour tout) BBB : structHasAuthIdHal_fs : identifiant HAL de la structure)
Liste de tous les chercheurs ayant créé leur CV HAL Format : sortie XML limitation du résultat à 10000 lignes	Requête : api.archives-ouvertes.fr/ref/author/?q=hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml Exemple	Pas d'options dans la requête
Liste des publications d'un auteur à partir de son idhal	Entrer dans la recherche avancée de HAL la chaîne de caractère de l'idhal de l'auteur / champ IDHAL Exporter le résultat (exporte l'ensemble des résultats) : formats d'exports = ceux proposés par HAL	Pas d'options

Recherches et extractions de structures

Objectif de la requête	Requête et exemple	Champs à remplacer
Liste de toutes les structures qui dépendent d'une structure dont l'identifiant HAL est XXX	Requête : api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22AAA%22&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s%20asc Exemple	AAA : parentDocid_i
Liste des dépôts par labo d'une université (et uniquement des labos affiliés à l'université), par année de publication et par type de document déposé	Il s'agit de l'intitulé de la requête tel que formulé par le GT5 : à mon avis il n'est pas possible d'avoir tous ces résultats dans un seul export, je remplace par (voir ligne suivante) :