HAL - Contributions de l’utilisateur [fr]

CasuHAL AtelierAPI

2019-06-25T15:25:33Z

Lnjouguet : /* Atelier API des journées CasuHAL 2019 */

== Atelier API des journées CasuHAL 2019 ==

=== Support de la présentation ===
[[:File:CasuhalAtelierAPI2019.pdf]]
=== Mémos ===

Formats de réponse [[:File:afficheformatréponses.pdf]]

Paramètres groupes [[:File:affichegroupes.pdf]]

Métadonnées [[:File:affichemetadonnees.pdf]]

Opérateurs de recherche [[:File:afficheopérateurs.pdf]]

Récapitulatif des paramètres [[:File:afficheparamètres.pdf]]

Paramètres des facettes [[:File:afficheparamètresfacettes.pdf]]

Types de champs [[:File:affichetypeschamps.pdf]]

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

=== Utiliser l'API d'archives-ouvertes ? démonstrations ===

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

=== Réaliser des requêtes d'interrogation de l'API ===

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

=== Echange avec la salle et/ou démonstrations de requêtes ===

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

CasuHAL AtelierAPI

2019-06-25T15:22:26Z

Lnjouguet :

== Atelier API des journées CasuHAL 2019 ==

=== Support de la présentation ===
[[:File:CasuhalAtelierAPI2019.pdf]]
=== Mémos ===

Formats de réponse : [[:File:afficheformatréponses.pdf]]

Paramètres groupes[[:File:affichegroupes.pdf]]

Métadonnées [[:File:affichemetadonnees.pdf]]

Opérateurs de recherche [[:File:afficheopérateurs.pdf]]

Récapitulatif des paramètres [[:File:afficheparamètres.pdf]]

Paramètres des facettes [[:File:afficheparamètresfacettes.pdf]]

Types de champs [[:File:affichetypeschamps.pdf]]

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

=== Utiliser l'API d'archives-ouvertes ? démonstrations ===

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

=== Réaliser des requêtes d'interrogation de l'API ===

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

=== Echange avec la salle et/ou démonstrations de requêtes ===

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

CasuHAL AtelierAPI

2019-06-25T15:14:59Z

Lnjouguet : /* Atelier API des journées CasuHAL 2019 */

== Atelier API des journées CasuHAL 2019 ==

* Support de la présentation[[:File:CasuhalAtelierAPI2019.pdf]]
* Mémos :

Formats de réponse : [[:File:afficheformatréponses.pdf]]

Paramètres groupes[[:File:affichegroupes.pdf]]

Métadonnées [[:File:affichemetadonnees.pdf]]

Opérateurs de recherche [[:File:afficheopérateurs.pdf]]

Récapitulatif des paramètres [[:File:afficheparamètres.pdf]]

Paramètres des facettes [[:File:afficheparamètresfacettes.pdf]]

Types de champs [[:File:affichetypeschamps.pdf]]

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

== Utiliser l'API d'archives-ouvertes ? démonstrations ==

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

== Réaliser des requêtes d'interrogation de l'API ==

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

== Echange avec la salle et/ou démonstrations de requêtes ==

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

CasuHAL AtelierAPI

2019-06-25T15:12:26Z

Lnjouguet : /* Atelier API des journées CasuHAL 2019 */

== Atelier API des journées CasuHAL 2019 ==

* [[:File:CasuhalAtelierAPI2019.pdf:Support de la présentation]]
* Mémos :
[[:File:afficheformatréponses.pdf]]
[[:File:affichegroupes.pdf]]
[[:File:affichemetadonnees.pdf]]
[[:File:afficheopérateurs.pdf]]
[[:File:afficheparamètres.pdf]]
[[:File:afficheparamètresfacettes.pdf]]
[[:File:affichetypeschamps.pdf]]

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

== Utiliser l'API d'archives-ouvertes ? démonstrations ==

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

== Réaliser des requêtes d'interrogation de l'API ==

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

== Echange avec la salle et/ou démonstrations de requêtes ==

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

CasuHAL AtelierAPI

2019-06-25T15:11:38Z

Lnjouguet : /* Atelier API des journées CasuHAL 2019 */

== Atelier API des journées CasuHAL 2019 ==

* [[:Support de la présentation:CasuhalAtelierAPI2019.pdf]]
* Mémos :
[[:File:afficheformatréponses.pdf]]
[[:File:affichegroupes.pdf]]
[[:File:affichemetadonnees.pdf]]
[[:File:afficheopérateurs.pdf]]
[[:File:afficheparamètres.pdf]]
[[:File:afficheparamètresfacettes.pdf]]
[[:File:affichetypeschamps.pdf]]

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

== Utiliser l'API d'archives-ouvertes ? démonstrations ==

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

== Réaliser des requêtes d'interrogation de l'API ==

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

== Echange avec la salle et/ou démonstrations de requêtes ==

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

Accueil

2019-06-25T14:38:50Z

Lnjouguet :

Ce wiki est a la disposition de la communauté des utilisateurs de HAL, afin de permettre un partage des outils, spécifications et bonnes pratiques dans HAL.

{{cadre2|Titre=Informations générales|Couleur=#14235C|Texte=
* [[CasuHAL : club utilisateur de HAL ]]
** [https://casuhal2018.sciencesconf.org/ Journée CasuHal 2018]
** [[Journée CasuHal 2017]]
* [https://hal.archives-ouvertes.fr/section/documentation Documentation HAL du CCSD]
* [https://doc.archives-ouvertes.fr/wp-content/uploads/2017/12/HAL_admin_portails_doc_janvier2016.pdf Manuel administrateur HAL]
* [[Annuaire des administrateurs HAL]]
* [[Liste des portails HAL]]
* Evénements organisés pour l'[[OpenAccessWeek]]
* [[Loi pour une république numérique]]
* [[Politiques des presses universitaires]]
}}

{{cadre2|Titre=Bonnes pratiques et tutoriels de saisie dans HAL|Couleur=#14235C|Texte=
* [[Recommandations pour la saisie des noms de structure]]
* [[Aide à la saisie par type de document]]
* [[Tutoriels sur le dépôt dans HAL]]
* [[Supports de communication]]
* [[Exemples de sites intégrant un flux provenant de HAL]]
* [[Messages-types]]
}}

{{cadre2|Titre=Outils pour administrer HAL|Couleur=#14235C|Texte=
* [[Administrer HAL au quotidien]]
* [[Outils pour gérer les structures]]
* [[Outils et services développés localement pour améliorer ou faciliter l'utilisation de HAL]]
* [[Retours d'expérience|Retours d'expérience d'imports/exports et d'utilisation des API de HAL]]
* [[Configuration du site web]] d'un portail ou d'une collection d'un portail ou d'une collection
* [[web semantique et HAL]]
}}

{{cadre2|Titre=API|Couleur=#14235C|Texte=Section ayant pour objectif de créer une entraide au sein de CasuHal sur l'utilisation des API de HAL : http://api.archives-ouvertes.fr/docs
* [[Liste des requêtes de base|Introduction, débuter]]
* [[Requêtes_sur_les_ressources_de_HAL|Requêtes sur les ressources de HAL (ressources et référentiels)]]
* [[CasuHAL_AtelierAPI|Journées CasuHAL : Ateliers API]]
* [[API:Recherche:Hal|Formation API HAL du CCSD 2016 : requêtes sur les documents]]
* [[API:Recherche:Référentiels|Formation API HAL du CCSD 2016 : requêtes sur les auteurs et structures]]
* [[SWORD|Utilisation de sword]]
* [[GT Moissonnage]]
}}

{{cadre2|Titre=Statistiques|Couleur=#14235C|Texte=Section décrivant les possibilités offertes par le module statistique des portail HAL, accessibles aux administrateurs. ATTENTION 2019 : le CCSD développe une nouvelle interface avec Kibana, le suivi statistique va être revu
* [[Statistiques de consultation]]
* [[Statistiques de dépôt]]
* [[esgbu]]
}}

CasuHAL AtelierAPI

2019-06-25T14:37:54Z

Lnjouguet : /* Atelier API des journées CasuHAL 2019 */

== Atelier API des journées CasuHAL 2019 ==

* [[Support de la présentation:File:CasuhalAtelierAPI2019.pdf]]
* Mémos :
[[:File:afficheformatréponses.pdf]]
[[:File:affichegroupes.pdf]]
[[:File:affichemetadonnees.pdf]]
[[:File:afficheopérateurs.pdf]]
[[:File:afficheparamètres.pdf]]
[[:File:afficheparamètresfacettes.pdf]]
[[:File:affichetypeschamps.pdf]]

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

== Utiliser l'API d'archives-ouvertes ? démonstrations ==

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

== Réaliser des requêtes d'interrogation de l'API ==

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

== Echange avec la salle et/ou démonstrations de requêtes ==

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

Fichier:Affichetypeschamps.pdf

2019-06-25T14:37:17Z

Lnjouguet : MsUpload

MsUpload

Fichier:Afficheparamètresfacettes.pdf

2019-06-25T14:37:16Z

Lnjouguet : MsUpload

MsUpload

Fichier:Afficheparamètres.pdf

2019-06-25T14:37:14Z

Lnjouguet : MsUpload

MsUpload

Fichier:Afficheopérateurs.pdf

2019-06-25T14:37:12Z

Lnjouguet : MsUpload

MsUpload

Fichier:Affichemetadonnees.pdf

2019-06-25T14:37:11Z

Lnjouguet : MsUpload

MsUpload

Fichier:Affichegroupes.pdf

2019-06-25T14:37:09Z

Lnjouguet : MsUpload

MsUpload

Fichier:Afficheformatréponses.pdf

2019-06-25T14:37:07Z

Lnjouguet : MsUpload

MsUpload

Fichier:CasuhalAtelierAPI2019.pdf

2019-06-25T14:36:00Z

Lnjouguet : MsUpload

MsUpload

CasuHAL AtelierAPI

2019-06-25T08:33:43Z

Lnjouguet :

== Atelier API des journées CasuHAL 2019 ==
Support de la présentation

Mémos :

== Atelier API des journées CasuHAL 2018 ==

'''A l'occasion des journées CasuHAL 2018 et de l'atelier sur l'utilisation des API de HAL, nous avons proposé de commencer par lister des actions à mener pour favoriser l'utilisation des API par le réseau CasuHAL.'''
Ci-dessous la trame de l'atelier

=== Explication de ce qu'est une API===
Les APIs (Application Programming Interface ou interface de programmation) sont des interfaces qui permettent une communication machine à machine. Cela permet à une source de donnée de s'exposer pour un ré-emploi par un autre système informatique.

-> Ce que ça permet

-> Comment ça le permet

-> Présentation des API Recherche et Référentiels de HAL

-> Précisions sur l'API d'import Sword et l'entrepôt OAI

=== Supports de formation sur l'API HAL ===
https://fr.slideshare.net/OAccsd/les-api-de-hal
https://fr.slideshare.net/OAccsd/usage-des-api-de-hal
https://www.slideshare.net/OAccsd/les-api-de-recherche-de-hal
https://fr.slideshare.net/OAccsd/les-api-de-hal-formation-ccsd-mars-2016
https://fr.slideshare.net/OAccsd/tei-hal-import-sword

== Utiliser l'API d'archives-ouvertes ? démonstrations ==

-> Requête -> Que faire du fichier retourné ?

-> Affichage "simple" dans un tableur : démonstration d'un export csv et affichage simple dans libreoffice

-> Utilisation de logiciels de traitement de données (pour enrichissement et/ou traitement et/ou nettoyage) : Démonstration avec OpenRefine d'un import de données récupérées, découpage du contenu d'une colonne etc.

-> Affichage dans un site web : démonstration d'un affichage site web avec une requête dans l'API

-> Autre ? (question à la salle ?)

== Réaliser des requêtes d'interrogation de l'API ==

-> Diaporama de présentation de la syntaxe des requêtes : [[:File:2018-06-01_CASUHAL_Utilisation des API.pdf]]

-> Scan du contenu de la documentation [[Notes Hélène]]

== Echange avec la salle et/ou démonstrations de requêtes ==

=== Développer un réseau d’entraide autour des API de HAL : on objectif pour CasuHal ? ===
Pistes / propositions :
*Utiliser la liste hal.tech pour les questions concernant l’interrogation de l’API
*Reporter sur le wiki les « réponses »
*Compléter la documentation des requêtes déjà présentes sur le wiki
*Constituer un inventaire des requêtes fréquemment demandées
*Autre ?

=== Je n'ai pas d'idées : quelles requêtes peuvent être intéressantes pour moi ? ===

'''1 / La question d'une liste d'auteurs affiliés à un établissement (CF question précise posée sur la liste dans le cadre de la prépa de l'atelier)'''

Essai 1 -> https://api.archives-ouvertes.fr/ref/author/?q=structureId_i:81173&fl=docid,label_s,idHal_i,idHal_s,*_id&rows=10000&wt=xml
Référentiel auteur

Essai 2 -> https://api.archives-ouvertes.fr/search/uvsq/?q=*:*&facet=true&facet.field=structHasAuthIdHal_fs&facet.mincount=0&facet.prefix=81173_&rows=0&wt=xml&facet.limit=10000

Les auteurs ne sont pas affiliés (dans auréhal) comme on pourrait le penser, ce sont dans les notices documents que les affiliations sont appliquées = Donc on cherche dans l'api de recherche de documents et on extrait les affiliations par ce biais là.

Comment obtenir en plus dans cette liste les identifiants accrochés aux auteurs (orcid, idref and cie) = Re requêter 1 à 1 les auteur ?...

'''2 / les affiliations : afficher ttes les structures affiliées à un auteur (https://api.archives-ouvertes.fr/docs/ref/resource/authorstructure)'''

https://api.archives-ouvertes.fr/search/authorstructure/?firstName_t=prenom&lastName_t=nom&i&wt=xml

'''3 / retrouver des doublons potentiels de publication pour une collection donnée pour une année de production donnée'''

http://api.archives-ouvertes.fr/search/?q=collCode_s:%22INRIA%22%20AND%20producedDateY_i:2015&rows=0&wt=xml&indent=true&facet=true&facet.pivot=title_s,docType_s,halId_s&facet.limit=10&facet.mincount=2

'''4 / Liste des structures rattachées à une structure de + haut niveau.'''

https://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:300297&fl=* ou https://api.archives-ouvertes.fr/ref/structure/?wt=csv&q=parentDocid_i:300297&fl=*

On a 165 résultats (Attention la conf par défaut limite à 30)

Requêtes sur les ressources de HAL

2019-05-20T08:44:17Z

Lnjouguet : /* Requêtes sur les collections */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes sur les collections ==

=== Récupérer la liste des collections rattachées à son institution ===
Il s'agit là de récupérer par l'API la même liste que celle possible sur le portail : https://hal-univ-orleans.archives-ouvertes.fr/browse/scollection
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs&facet.prefix=UNIV-ORLEANS</pre>

Cette requête, comme la page du portail, liste les collections pour lesquelles dans leur configuration il a été complété le champ : Identifiant des collections supérieures.

=== Récupérer la liste des collections qui contiennent au moins un dépôt de son institution ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs</pre>

Le champs collIsParentOfCategoryColl_fs contient les données suivantes : Collection parente + _FacetSep_ + type collection parente + _JoinSep_ + Code de la collection + _FacetSep_ + Nom de la collection

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?q=parentDocid_i:"74911"&rows=300&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

* parentDocid = 74911 (université d'Angers)
* rows = 300. Permet d'avoir toutes les réponses, dans le résultat le numFound = 279.
* fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s : liste des champs demandé en réponse
* sort=acronym_s asc : trié par ordre alphabétique de l'acronyme

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-20T08:37:50Z

Lnjouguet : /* Récupérer la liste des collections qui contiennent un dépôt ou plusieurs de son institution */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes sur les collections ==

=== Récupérer la liste des collections rattachées à son institution ===
Il s'agit là de récupérer par l'API la même liste que celle possible sur le portail : https://hal-univ-orleans.archives-ouvertes.fr/browse/scollection
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs&facet.prefix=UNIV-ORLEANS</pre>

Cette requête, comme la page du portail, liste les collections pour lesquelles dans leur configuration il a été complété le champ : Identifiant des collections supérieures.

=== Récupérer la liste des collections qui contiennent un dépôt ou plusieurs de son institution ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs</pre>

Le champs collIsParentOfCategoryColl_fs contient les données suivantes : Collection parente + _FacetSep_ + type collection parente + _JoinSep_ + Code de la collection + _FacetSep_ + Nom de la collection

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?q=parentDocid_i:"74911"&rows=300&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

* parentDocid = 74911 (université d'Angers)
* rows = 300. Permet d'avoir toutes les réponses, dans le résultat le numFound = 279.
* fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s : liste des champs demandé en réponse
* sort=acronym_s asc : trié par ordre alphabétique de l'acronyme

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-20T08:36:43Z

Lnjouguet : /* Récupérer la liste des collections rattachées à son institution */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes sur les collections ==

=== Récupérer la liste des collections rattachées à son institution ===
Il s'agit là de récupérer par l'API la même liste que celle possible sur le portail : https://hal-univ-orleans.archives-ouvertes.fr/browse/scollection
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs&facet.prefix=UNIV-ORLEANS</pre>

Cette requête, comme la page du portail, liste les collections pour lesquelles dans leur configuration il a été complété le champ : Identifiant des collections supérieures.

=== Récupérer la liste des collections qui contiennent un dépôt ou plusieurs de son institution ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs</pre>

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?q=parentDocid_i:"74911"&rows=300&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

* parentDocid = 74911 (université d'Angers)
* rows = 300. Permet d'avoir toutes les réponses, dans le résultat le numFound = 279.
* fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s : liste des champs demandé en réponse
* sort=acronym_s asc : trié par ordre alphabétique de l'acronyme

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-20T08:35:33Z

Lnjouguet :

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes sur les collections ==

=== Récupérer la liste des collections rattachées à son institution ===
Il s'agit là de récupérer par l'API la même liste que celle possible sur le portail : https://hal-univ-orleans.archives-ouvertes.fr/browse/scollection
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs&facet.prefix=UNIV-ORLEANS</pre>

=== Récupérer la liste des collections qui contiennent un dépôt ou plusieurs de son institution ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=collIsParentOfCategoryColl_fs</pre>

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?q=parentDocid_i:"74911"&rows=300&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

* parentDocid = 74911 (université d'Angers)
* rows = 300. Permet d'avoir toutes les réponses, dans le résultat le numFound = 279.
* fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s : liste des champs demandé en réponse
* sort=acronym_s asc : trié par ordre alphabétique de l'acronyme

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-10T08:19:30Z

Lnjouguet : /* Liste de toutes les structures qui dépendent d'une structure */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?q=parentDocid_i:"74911"&rows=300&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

* parentDocid = 74911 (université d'Angers)
* rows = 300. Permet d'avoir toutes les réponses, dans le résultat le numFound = 279.
* fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s : liste des champs demandé en réponse
* sort=acronym_s asc : trié par ordre alphabétique de l'acronyme

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-10T08:16:22Z

Lnjouguet : /* Liste de toutes les structures qui dépendent d'une structure */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-10T08:15:23Z

Lnjouguet : /* Méthode pour repérer les types d'artciles (extractions HCERES) */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'articles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-09T09:46:58Z

Lnjouguet : /* Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-09T09:42:31Z

Lnjouguet : /* Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

<pre>https://api.archives-ouvertes.fr/search/?q=(collCategory_s:REVUE%20NOT%20collCategory_s:(SET%20OR%20COLLOQUE%20OR%20ECOLE%20OR%20PRES%20OR%20UNIV%20OR%20LABO%20OR%20THEME%20OR%20INSTITUTION%20OR%20AUTRE))&rows=0&wt=json&facet=true&facet.field=collCode_s&facet.limit=10000&facet.mincount=1&facet.field=collCategory_s</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-09T08:58:59Z

Lnjouguet : /* Requêtes qui restent à créer ou finaliser */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== Récupérer la lise de tous les "codes de collection" (soit collCode_s) de type "REVUE" (soit collCategory_s:REVUE) ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&fq=collCategory_s:REVUE&facet=true&facet.field=collCode_s&facet.limit=10000</pre>

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Accueil

2019-05-07T15:25:20Z

Lnjouguet :

Ce wiki est a la disposition de la communauté des utilisateurs de HAL, afin de permettre un partage des outils, spécifications et bonnes pratiques dans HAL.

{{cadre2|Titre=Informations générales|Couleur=#14235C|Texte=
* [[CasuHAL : club utilisateur de HAL ]]
** [https://casuhal2018.sciencesconf.org/ Journée CasuHal 2018]
** [[Journée CasuHal 2017]]
* [https://hal.archives-ouvertes.fr/section/documentation Documentation HAL du CCSD]
* [https://doc.archives-ouvertes.fr/wp-content/uploads/2017/12/HAL_admin_portails_doc_janvier2016.pdf Manuel administrateur HAL]
* [[Annuaire des administrateurs HAL]]
* [[Liste des portails HAL]]
* Evénements organisés pour l'[[OpenAccessWeek]]
* [[Loi pour une république numérique]]
* [[Politiques des presses universitaires]]
}}

{{cadre2|Titre=Bonnes pratiques et tutoriels de saisie dans HAL|Couleur=#14235C|Texte=
* [[Recommandations pour la saisie des noms de structure]]
* [[Aide à la saisie par type de document]]
* [[Tutoriels sur le dépôt dans HAL]]
* [[Supports de communication]]
* [[Exemples de sites intégrant un flux provenant de HAL]]
* [[Messages-types]]
}}

{{cadre2|Titre=Outils pour administrer HAL|Couleur=#14235C|Texte=
* [[Administrer HAL au quotidien]]
* [[Outils pour gérer les structures]]
* [[Outils et services développés localement pour améliorer ou faciliter l'utilisation de HAL]]
* [[Retours d'expérience|Retours d'expérience d'imports/exports et d'utilisation des API de HAL]]
* [[Configuration du site web]] d'un portail ou d'une collection d'un portail ou d'une collection
* [[web semantique et HAL]]
}}

{{cadre2|Titre=API|Couleur=#14235C|Texte=Section ayant pour objectif de créer une entraide au sein de CasuHal sur l'utilisation des API de HAL : http://api.archives-ouvertes.fr/docs
* [[Liste des requêtes de base|Introduction, débuter]]
* [[Requêtes_sur_les_ressources_de_HAL|Requêtes sur les ressources de HAL (ressources et référentiels)]]
* [[CasuHAL_AtelierAPI|CasuHAL : Atelier API 2018]]
* [[API:Recherche:Hal|Formation API HAL du CCSD 2016 : requêtes sur les documents]]
* [[API:Recherche:Référentiels|Formation API HAL du CCSD 2016 : requêtes sur les auteurs et structures]]
* [[SWORD|Utilisation de sword]]
}}

{{cadre2|Titre=Statistiques|Couleur=#14235C|Texte=Section décrivant les possibilités offertes par le module statistique des portail HAL, accessibles aux administrateurs. ATTENTION 2019 : le CCSD développe une nouvelle interface avec Kibana, le suivi statistique va être revu
* [[Statistiques de consultation]]
* [[Statistiques de dépôt]]
* [[esgbu]]
}}

Accueil

2019-05-07T15:24:20Z

Lnjouguet :

Ce wiki est a la disposition de la communauté des utilisateurs de HAL, afin de permettre un partage des outils, spécifications et bonnes pratiques dans HAL.

{{cadre2|Titre=Informations générales|Couleur=#14235C|Texte=
* [[CasuHAL : club utilisateur de HAL ]]
** [https://casuhal2018.sciencesconf.org/ Journée CasuHal 2018]
** [[Journée CasuHal 2017]]
* [https://hal.archives-ouvertes.fr/section/documentation Documentation HAL du CCSD]
* [https://doc.archives-ouvertes.fr/wp-content/uploads/2017/12/HAL_admin_portails_doc_janvier2016.pdf Manuel administrateur HAL]
* [[Annuaire des administrateurs HAL]]
* [[Liste des portails HAL]]
* Evénements organisés pour l'[[OpenAccessWeek]]
* [[Loi pour une république numérique]]
* [[Politiques des presses universitaires]]
}}

{{cadre2|Titre=Bonnes pratiques et tutoriels de saisie dans HAL|Couleur=#14235C|Texte=
* [[Recommandations pour la saisie des noms de structure]]
* [[Aide à la saisie par type de document]]
* [[Tutoriels sur le dépôt dans HAL]]
* [[Supports de communication]]
* [[Exemples de sites intégrant un flux provenant de HAL]]
* [[Messages-types]]
}}

{{cadre2|Titre=Outils pour administrer HAL|Couleur=#14235C|Texte=
* [[Administrer HAL au quotidien]]
* [[Outils pour gérer les structures]]
* [[Outils et services développés localement pour améliorer ou faciliter l'utilisation de HAL]]
* [[Retours d'expérience|Retours d'expérience d'imports/exports et d'utilisation des API de HAL]]
* [[Configuration du site web]] d'un portail ou d'une collection d'un portail ou d'une collection
* [[web semantique et HAL]]
}}

{{cadre2|Titre=API|Couleur=#14235C|Texte=Section ayant pour objectif de créer une entraide au sein de CasuHal sur l'utilisation des API de HAL : http://api.archives-ouvertes.fr/docs
* [[Liste des requêtes de base|Introduction, débuter]]
* [[Requêtes_sur_les_ressources_de_HAL|Requêtes sur les ressources de HAL (notices, documents, API de recherche)]]
* [[CasuHAL_AtelierAPI|CasuHAL : Atelier API 2018]]
* [[API:Recherche:Hal|Formation API HAL du CCSD 2016 : requêtes sur les documents]]
* [[API:Recherche:Référentiels|Formation API HAL du CCSD 2016 : requêtes sur les auteurs et structures]]
* [[SWORD|Utilisation de sword]]
}}

{{cadre2|Titre=Statistiques|Couleur=#14235C|Texte=Section décrivant les possibilités offertes par le module statistique des portail HAL, accessibles aux administrateurs. ATTENTION 2019 : le CCSD développe une nouvelle interface avec Kibana, le suivi statistique va être revu
* [[Statistiques de consultation]]
* [[Statistiques de dépôt]]
* [[esgbu]]
}}

Requêtes sur les ressources de HAL

2019-05-07T15:08:41Z

Lnjouguet : /* Requêtes qui restent à créer */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ou finaliser ==

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://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</pre>

=== Liste des identifiants des revues des notices non valides d'une collection ===
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/3774/?q=*&rows=0&wt=xml&fq=journalValid_s:INCOMING&facet=true&facet.field=journalId_i</pre>

=== 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 ===
<pre style="white-space:pre-wrap;">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</pre>

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-07T14:36:09Z

Lnjouguet : /* Requêtes */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes qui restent à créer ==

=== 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é ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/</pre>

=== Liste des dépôts pour une plage entre 2 années d'une structure dont les labos sont en statut OLD ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D</pre>

=== Liste des dépôts de texte intégral d'une institution pour une année ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&facet=true&facet.mincount=1&facet.pivot.mincount=1&facet.limit=10000&facet.pivot=labStructName_s,submittedDateM_i&rows=0</pre>

| '''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
|}

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-07T14:29:04Z

Lnjouguet : /* Requêtes */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes sur le contrôle qualité du contenu ==
=== Liste des dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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
|}

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-07T12:08:16Z

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

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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
|}

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-06T15:17:22Z

Lnjouguet : /* Recherches et extractions de structures */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

Requêtes sur les ressources de HAL

2019-05-06T15:17:11Z

Lnjouguet : /* Recherches et extractions de structures */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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 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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T15:16:41Z

Lnjouguet : /* Liste de toutes les structures qui dépendent d'une structure */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T15:15:21Z

Lnjouguet : /* Requêtes d'analyse de ses structures */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

=== Liste de toutes les structures qui dépendent d'une structure ===
Requête sur le référentiel structure d'Auréhal
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:"74911"&rows=2000&fl=name_s,acronym_s,code_s,docid,address_s,url_s,country_s&sort=acronym_s%20asc </pre>

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:59:32Z

Lnjouguet : /* Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal (https://aurehal.archives-ouvertes.fr/author/index) en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:58:54Z

Lnjouguet : /* Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
Requête effectuée dans le référentiel Auréhal Auteurs
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:57:55Z

Lnjouguet : /* Requêtes d'analyse des auteurs */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s asc&fl=idHal_s,idHal_i,lastName_s,firstName_s</pre>

Il est également possible de faire cette recherche directement sur Auréhal en indiquant dans le champ de recherche les valeurs de la requête : structureId_i:198056 AND hasCV_bool:true

[[File:Hal_requête_CV.png|800px]]

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:54:53Z

Lnjouguet : /* Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:39:14Z

Lnjouguet : /* Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas...

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:38:54Z

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
* Élément de la liste à puces
* Élément de la liste à puces
* Élément de la liste à puces
* q=collection_t:LIM
* fq=authStructId_i:54305
* fq=popularLevel_s:0
* fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
* rows=0
* indent=true
* &sort=producedDate_tdate%20asc
* facet.field=authIdHasPrimaryStructure_f
* facet.contains=_JoinSep_54305_FacetSep
* wt=xml

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:38:18Z

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

Détails des paramètres :
q=collection_t:LIM
fq=authStructId_i:54305
fq=popularLevel_s:0
fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]
rows=0
indent=true
&sort=producedDate_tdate%20asc
facet.field=authIdHasPrimaryStructure_f
facet.contains=_JoinSep_54305_FacetSep
wt=xml

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:25:26Z

Lnjouguet : /* Requêtes d'analyse des auteurs */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z TO 2016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

== Requêtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:24:38Z

Lnjouguet : /* Requêtes */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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êtes ==

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:03:27Z

Lnjouguet : /* Recherches et extractions de structures */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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êtes ==

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T13:00:24Z

Lnjouguet : /* Recherches et extractions de structures */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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êtes ==

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

{{boîte déroulante/début|titre=TITRE}}
Contenu
{{boîte déroulante/fin}}

Requêtes sur les ressources de HAL

2019-05-06T12:59:39Z

Lnjouguet : /* Recherches et extractions de structures */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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êtes ==

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

{{Boîte déroulante/début}}

TEXTE

{{Boîte déroulante/fin}}

Requêtes sur les ressources de HAL

2019-05-06T12:31:17Z

Lnjouguet : /* Requêtes */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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êtes ==

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}

Requêtes sur les ressources de HAL

2019-05-06T12:30:48Z

Lnjouguet : /* Requêtes */

=== Remarques générales ===
Les champs retournés par défaut sont docid, label_s et uri_s

Les résultats sont limités à 30 lignes par défaut

Le format de retour par défaut est JSON (installer un visualiseur json dans son navigateur)

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

== Requêtes simples pour récupérer des listes ==
=== Liste des dépôts d'une institution ou d'un regroupement ===
Dans ce cas on utilise simplement l'identifiant de l'institution. Dans Auréhal le niveau regroupement existe : https://doc.archives-ouvertes.fr/gerer-un-portail/referentiels/structures-de-recherche/.

La configuration du regroupement se fait donc dans Auréhal

Exemple pour le regroupement Comue Paris-Est (https://aurehal.archives-ouvertes.fr/structure/read/id/303512)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=structId_i:303512</pre>

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=50&wt=csv&sort=producedDate_tdate%20desc </pre>

Cette requête rapporte 50 résultats dans un export CSV

Si on fait la requête au format xml on voit le numreponse à 6122 => si on veut tout voir on peut mettre rows=6200.

=== Export 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
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/SIC/?q=*:*&rows=100&wt=csv&fl=submittedDate_s,producedDate_s,label_s&sort=submittedDate_s%20desc</pre>

=== Flux rss des dépôts faits dans une collection depuis 1 mois ===
Pour avoir la sortie sous la forme d'un flux RSS il faut indiquer wt=rss
<pre style="white-space:pre-wrap;">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</pre>

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 ===
<pre style="white-space:pre-wrap;">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</pre>

Dans le champ date, on récupère les 12 derniers mois (de moins 1 an à aujourd'hui) et on limite à 3 résultats (rows=3)

=== Liste des thèses d'une institution ===
<pre style="white-space:pre-wrap;">http://api.archives-ouvertes.fr/search/?q=docType_s:THESE%20AND%20authorityInstitution_s:%22Université%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</pre>

la liste des champs exportés est : 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

Il faut indiquer le champ "authorityInstitution_s" : trouver le bon intitulé dans https://api.archives-ouvertes.fr/search/?q=*%3A*&rows=0&wt=xml&indent=true&facet=true&facet.field=authorityInstitution_s

== Requêtes d'analyse du contenu par type de documents ==

=== Connaître le cumul des dépôts de sa collection répartis par type de document ===
Requête à facette affichant une collection, le nombre d’occurrence par type de document
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=docType_s&facet.sort=count</pre>

Les cumuls sont calculés depuis 2011.

liste des types de documents dans HAL (41 en tout) : https://api.archives-ouvertes.fr/ref/doctype

=== Connaître le nombre total de dépôt année par année dans sa collection. Et pour chaque année la répartition des dépôts par type de document ===
Requête affichant le nombre de dépôt par année de publication
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-ORLEANS/?q=*:*&wt=xml&rows=0&facet=true&facet.pivot=submittedDateY_i,submitType_s,docType_s</pre>

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.

=== Connaître le nombre de dépôt pour une année donnée dans sa collection présenté par type de documents ===

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&rows=0&fq=submittedDateY_i:2019&facet=true&facet.field=docType_s&wt=xml</pre>

=== Méthode pour repérer les types d'artciles (extractions HCERES) ===
Article du blog Carnet'IST. Proposition de requêtes sur le site web HAL pour distinguer, entre autres, les 4 types d’articles suivants : ACL; ACLN, ACSL, AV ou TRANSF
http://carnetist.hypotheses.org/240

== Requêtes d'analyse du contenu par domaine ==

=== Connaître le cumul des dépôts de sa collection répartis par domaines ===
Requête affichant le nombre de notice par domaine pour sa collection
<pre style="white-space:pre-wrap;">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</pre>

Liste des domaines de HAL (393 en mai 2019) : http://api.archives-ouvertes.fr/ref/domain/?q=*:*&rows=400

== Requêtes d'analyse du contenu des revues (journal) ==

=== Connaître le nombre d'articles déposés par titre de revue dans sa collection ===
La requête affiche pour chaque revue le nombre d'articles déposés dans la collection HAL.
<pre style="white-space:pre-wrap;"> https://api.archives-ouvertes.fr/search/?q=*&fq=collCode_s:UNIV-ORLEANS&fq=NOT+status_i%3A111&start=0&rows=0&omitHeader=true&facet.mincount=1&facet.limit=10000&facet=true&facet.field=journalTitle_s&facet.sort=count</pre>
Le cumul est calculé depuis 2011 et ne concerne que le type "articles".

== Requêtes d'analyse de ses structures ==

=== Liste des structures affiliées à une institution et pas à une autre ===
Il s'agit par exemple de récupérer la liste des laboratoires attachés à l'université de Nancy et pas à l'université de Lorraine

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/ref/structure/?fq=(parentDocid_i:300292%20AND%20NOT(parentDocid_i:413289))&fl=docid,name_s&wt=csv</pre>

Pour cette requêtes il faut récupérer dans Auréhal structure les identifiants des 2 structures à analyser

== Requêtes d'analyse des contributions ==

=== Nombre de dépôt par contributeur dans un portail, classés par année de dépôt ===
Requête à facette affichant par année, la liste des contributeurs déposant et le nombre de dépôt associé à chaque contributeur
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/univ-orleans/?q=*:*&facet=true&facet.pivot=submittedDateY_i,contributorFullName_s&rows=0&wt=xml&facet.limit=1000</pre>

== Requêtes d'analyse des auteurs ==

=== Liste des auteurs dont une publication au moins est affiliée à une structure avec indication de leur IDHAL ou de l'absence d'IDHAL ===

Requête à facette listant les auteurs affiliés par un ou plusieurs dépôt à une structure
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&wt=xml&facet=true&facet.query=structHasAuthIdHal_fs&facet.field=structHasAuthIdHal_fs&facet.prefix=129439_FacetSep_&facet.mincount=1&facet.limit=1000</pre>
ou
https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=226306_&wt=xml

Le champ facet.prefix indique l'identifiant de la structure d'affiliation voulue (à trouver dans Aurehal structure)

https://api.archives-ouvertes.fr/search/?q=*:*&rows=0&facet=true&facet.field=structHasAuthIdHal_fs&facet.prefix=245758_&wt=xml&fq=structId_i:245758

Pour ceux 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êtes ==

=== Nombre de publications scientifiques hors vulgarisation des auteurs d'une collection et d'un laboratoire spécifique par année universitaire de publication (2015-2016) en affichant uniquement les auteurs affiliés au laboratoire demandé et non pas tous les auteurs présents dans la collection ===
Requête indiquant le nombre de publications scientifiques par auteurs affiliés à une structure spécifique (&fq=authStructId_i:54305 et &facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep), pour une année universitaire donnée (&fq=producedDate_tdate:), hors vulgarisation (&fq=popularLevel_s:0)

<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/UNIV-REUNION/?q=collection_t:LIM&fq=authStructId_i:54305&fq=popularLevel_s:0&fq=producedDate_tdate:[2015-07-31T00:00:00Z%20TO%202016-07-31T00:00:00Z]&rows=0&indent=true&facet=true&sort=producedDate_tdate%20asc&facet.field=authIdHasPrimaryStructure_fs&facet.contains=_JoinSep_54305_FacetSep&wt=xml</pre>

{{Boîte déroulante/début}}
Contenu

{{Boîte déroulante/fin}}

{| class="wikitable"
|-
! 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 ?)
||
|-
|| '''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] 
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=csv&q=*&fq=instStructId_i:300297&fq=labStructValid_s:OLD&fq=producedDateY_i:%5B2000%20TO%202014%5D Exemple]
|| AAA = instStructId_i BBB = année de départ CCC = année de fin
|-
| '''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
[https://api.archives-ouvertes.fr/search/hal/?omitHeader=true&wt=xml&q=*&fq=instStructId_i:300297&fq=submittedDateY_i:2015&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 dépôts effectués dans un portail X mais non affiliés à une structure de la collection XX ===
L'objectif est d'avoir les dépôts qui sont passés par un portail mais qui ne sont pas affiliés à une structure relevant de ce portail (des erreurs de dépôt)
<pre style="white-space:pre-wrap;">https://api.archives-ouvertes.fr/search/amu/?q=structure_t:*%20NOT%20%28%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%20I%22%20OR%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%20II%22%20OR%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%20III%22%20OR%20%22Universit%C3%A9%20de%20Provence%20-%20Aix-Marseille%201%22%20OR%20%20%22Universit%C3%A9%20de%20la%20M%C3%A9diterran%C3%A9e%20-%20Aix-Marseille%202%22%20OR%20%20%22Universit%C3%A9%20Paul%20C%C3%A9zanne%20-%20Aix-Marseille%203%22%20OR%20%22Aix-Marseille%20Universit%C3%A9%20-%20AMU%22%20OR%20%20%22PRES%20Aix%20Marseille%20Universit%C3%A9%22%20OR%20%22Aix%20Marseille%20Universit%C3%A9%22%29&wt=xml&fl=uri_s</pre>
Changer le nom du portail et la liste des structures

{| class="wikitable"
|-
! 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
[https://api.archives-ouvertes.fr/search/3774/?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
|}

=== Liste des auteurs ayant un dépôt ou plusieurs affilié à une structure ayant créé leur CV HAL ===
http://api.archives-ouvertes.fr/ref/author/?q=structureId_i:198056 AND hasCV_bool:true&rows=10000&sort=lastName_s%20asc&fl=idHal_s,idHal_i,lastName_s,firstName_s&wt=xml

Egalement possible sur le site Auréhal en indiquant dans le champ de recherche les valeurs de la requête :

[[File:Hal_requête_CV.png|800px]]

=== Liste des publications d'un auteur à partir de son idhal ===
Aller sur le site web du portail : 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

=== Recherches et extractions de structures ===
{| class="wikitable"
|-
! 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
[http://api.archives-ouvertes.fr/ref/structure/?wt=xml&q=parentDocid_i:%22XXX%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) :
||
|}