Dictionnaire commenté de requêtes

De HAL
Aller à : navigation, rechercher

Requêtes possibles avec le module statistiques de HAL

                                              Ces requêtes sont en cours de test et de correction 

Requêtes pour l'ESGBU

Le module statistiques permet de faire les requêtes pour l'ESGBU

Intitulé ESGBU Action dans le module stats champ/filtre à modifier
Nombre d'unités documentaires référencées dans le système de collecte sous forme de notices uniquement Lancer la requête Evolution des dépôts de notices (4) avec l'année voulue

Voir le chiffre qui se met à jour "Nombre de ressources répondant aux critères : XXX"

submittedDateY_i:[2000 TO 2016] AND submitType_s:notice (2000 en année de départ car les stats HAL ne remontent pas au delà)
Nombre d'unités documentaires référencées dans le système de collecte et déposées en texte intégral Lancer la requête Evolution des dépôts de documents (5) avec l'année voulue

Voir le chiffre qui se met à jour "Nombre de ressources répondant aux critères : XXX"

submittedDateY_i:[2000 TO 2016] AND submitType_s:file
Accroissement annuel des unités documentaires référencées dans le système de collecte sous forme de notices uniquement Lancer la requête Evolution des dépôts de notices (4) avec la plage de dates voulue

Voir le chiffre qui se met à jour "Nombre de ressources répondant aux critères : XXX"

submittedDateY_i:2016 AND submitType_s:notice
Accroissement annuel des unités documentaires référencées dans le système de collecte et déposées en texte intégral Lancer la requête Evolution des dépôts de documents (5) avec la plage de dates voulue

Voir le chiffre qui se met à jour "Nombre de ressources répondant aux critères : XXX"

submittedDateY_i:2016 AND submitType_s:file
Nombre de visites sur le portail d'accès des archives ouvertes Cette donnée n'est pas disponible par le module, demander au support les stats piwik : hal.support@ccsd.cnrs.fr 15/06/2016 : question posée au CCSD : Est-il envisageable d'avoir un compte sur le piwik du ccsd pour chaque administrateur de portail HAL ?

Nous allons voir pour l'intégrer à l'ouverture de chaque portail. Pour les portails existants, cela sera possible pour la plupart des portails. Cette demande étant récente, nous ne pouvons pas vous donner de planning concernant sa mise en place.

Nombre de téléchargements sur le portail d'accès des archives ouvertes

Espace de sélection : dépôts du portail
Entrer le filtre : submitType_s:file
Aller sur l'onglet Consultation des ressources
Sélectionner : type=téléchargement du fichier principal
Période : pour l'année 2016 complète, sélectionner dans le widget du 31/12/2015 au 31/12/2016

Requêtes possibles avec le module statistiques de HAL

Ces requêtes sont à faire sur le portail HAL avec son compte admin (graphiques + export), il s'agit ici des statistiques "PORTAIL" (auteur, déposant, structure, collection, portail)
Liste non exhaustive
https://hal.archives-ouvertes.fr/section/statistiques

Objectif de la requête Requête API champ interrogé
Evolution des dépôts Le module stat donne : le nombre de dépôts de notices, le nombre de dépôts avec texte ou le cumul des 2 (cela corresponds aux widgets qu'on retrouve sur la majorité des portails)
Répartition des articles dans les revues les stats sont caclulées depuis 2011 et concernent bien les types articles uniquement (pas tous les dépôts du portail)

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

champ : journalTitle_s (revue : titre)
Répartition des (articles) / dépôts par type de publications les stats sont caclulées depuis 2011 et concernent tous les types de publications donc tous les dépôts du portail

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

champ : docType_s (Type de document)
Répartition des dépôts par année de publication les stats sont caclulées depuis 2011 et concernent tous les dépôts dur portail

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.pivot.mincount=1&facet.pivot={!key=pivot}producedDateY_i,submitType_s&facet.sort=count ERROR

champ : producedDateY_i (Date de publication : année)
Répartition des dépôts par domaine les stats sont caclulées depuis 2011 et concernent tous les dépôts dur portail ? -> il rapporte même plus dans le cas présent

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=level0_domain_s&facet.sort=count

champ : level0_domain_s (Domaine racine / Code de domaines répartis par niveaux)

Requêtes avec l'API HAL

Listes de dépôts ou publications

Objectif de la requête Requête et exemple Champs à remplacer
Liste de tous les dépôts d'une COMUE Utiliser le formulaire du site web de HAL avec export plutôt ?

Dans auréhal structure le niveau de structure type Comue n'est pas "encore" prévue à ce jour (4 niveaux de prévus : https://hal.archives-ouvertes.fr/page/le-referentiel-des-structures-de-recherche)
Recherche avancée de HAL : sélectionner le champ d'interrogation "Structure : Identifiant HAL de la structure" : entrer par exemple "300297 OR 300298". Exporter le résultat.
PB la requête rapporte 6303 résultat, l'export compte 2000 lignes (export limité en nombre de lignes peut être ?)

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

Format de réponse : xml

Requête : api.archives-ouvertes.fr/search/AAA/?q=*:*&rows=BBB&wt=xml&sort=producedDate_tdate desc

Exemple (collection SIC / 30 lignes)

AAA : code de la collection

BBB : nombre de lignes de résultats voulues Pour une réponse en csv : wt=csv

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

Format de réponse : xml
Champs demandés : le label (notice biblio), la date de dépôt dans HAL, la date de publication

Requête : api.archives-ouvertes.fr/search/AAA/?q=*:*&rows=BBB&wt=xml&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc

Exemple (collection SIC / 100 lignes)

AAA : code de la collection

BBB : nombre de lignes de résultats voulues Pour une réponse en csv : wt=csv

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

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

Format : sortie RSS Réponse limitée à 30 résultats

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

[NOW%2FDAY-1MONTH+TO+NOW%2FDAY%2B1DAY&fq=submitType_s:file&fq=&rows=30&sort=submittedDate_tdate+desc&wt=rss Exemple]

AAA : le code de la collection

Recherche et extraction de dépôts ou publications

Liste des thèses d'une institution

Repérer certains types de publications (ex HCERES)

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

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) :