Requêtes sur les ressources de HAL : Différence entre versions

De HAL
Sauter à la navigation Sauter à la recherche
Ligne 5 : Ligne 5 :
 
! Objectif de la requête !!  Requête et exemple !!  Champs à remplacer  
 
! Objectif de la requête !!  Requête et exemple !!  Champs à remplacer  
 
|-  
 
|-  
 +
|'''Liste de tous les dépôts d'une COMUE''' || Texte de la cellule || Texte de la cellule
 +
|-
 +
|'''Liste des x dernières publications déposées pour une structure donnée'''
 +
Format de réponse :
 +
|| Requête : api.archives-ouvertes.fr/search/AAA/?q=*:*&rows=BBB&sort=producedDate_tdate desc
 +
[https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=30&wt=csv&sort=producedDate_tdate desc Exemple]
 +
|| AAA : code de la collection
 +
BBB : nombre de lignes de résultats voulues
 +
|-
 +
|'''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é''' || Texte de la cellule || Texte de la cellule
 +
|-
 +
|'''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é''' || Texte de la cellule || Texte de la cellule
 +
|-
 
| style="width: 35%;" | '''Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD''' <br /> Format : export CSV
 
| style="width: 35%;" | '''Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD''' <br /> Format : export CSV
 
| style="width: 35%;" |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] <br />
 
| style="width: 35%;" |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] <br />
 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:413106&fq=labStructValid_s:OLD&fq=producedDateY_i:1995TO2016 Exemple]
 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:413106&fq=labStructValid_s:OLD&fq=producedDateY_i:1995TO2016 Exemple]
 
| style="width: 30%;" | AAA = instStructId_i <br /> BBB = année de départ <br /> CCC = année de fin
 
| style="width: 30%;" | AAA = instStructId_i <br /> BBB = année de départ <br /> CCC = année de fin
 
 
|-
 
|-
 
| '''Liste des labos affiliés à une université (ancienne par exemple) et pas à une autre (nouvelle par exemple)''' <br>  
 
| '''Liste des labos affiliés à une université (ancienne par exemple) et pas à une autre (nouvelle par exemple)''' <br>  
Ligne 69 : Ligne 81 :
 
|-
 
|-
 
| Des exemples pour repérer certains types de publications (ceux demandés lors des évaluations HCERES en particulier)|| [http://carnetist.hypotheses.org/240 http://carnetist.hypotheses.org/240] || Texte de la cellule
 
| Des exemples pour repérer certains types de publications (ceux demandés lors des évaluations HCERES en particulier)|| [http://carnetist.hypotheses.org/240 http://carnetist.hypotheses.org/240] || Texte de la cellule
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
|-
 
| Texte de la cellule || Texte de la cellule || Texte de la cellule
 
 
|}
 
|}

Version du 2 mai 2016 à 15:44

Dictionnaire commenté de requêtes API HAL et AUREHAL (29/04/2016 En construction)

Objectif de la requête Requête et exemple Champs à remplacer
Liste de tous les dépôts d'une COMUE Texte de la cellule Texte de la cellule
Liste des x dernières publications déposées pour une structure donnée

Format de réponse :

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

desc Exemple

AAA : code de la collection

BBB : nombre de lignes de résultats voulues

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é Texte de la cellule Texte de la cellule
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é Texte de la cellule Texte de la cellule
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 pour tous les labos dépendant d'une institution pour une année donné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 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 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
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

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

AAA : le corpus de documents (*:* pour tout)

BBB : structHasAuthIdHal_fs : identifiant HAL de la structure)

Liste de toutes les thèses de doctorat d'une université Requête : api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22AAA%22&wt=xml&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
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 [http://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
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 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
Des 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