Recherche des publications dans l'archive ouverte HAL.

Args: query: termes de recherche (titre, résumé, auteur, mots-clés...). year_from: année de début (incluse), ex. 2020. year_to: année de fin (incluse), ex. 2024. doc_type: type de document lisible : article, these, hdr, communication, ouvrage, chapitre, rapport, poster, brevet, image, video. open_access_only: ne garder que les publications en accès ouvert. with_file_only: ne garder que les dépôts avec fichier (pas les notices). sort: 'pertinence' (défaut), 'date' (plus récent d'abord). rows: nombre de résultats (max 100). start: décalage de pagination, à incrémenter pour la page suivante. portal: portail (minuscules) ou collection (majuscules), facultatif.

Récupère la fiche détaillée d'une publication par son identifiant HAL.

Args: hal_id: identifiant HAL, ex. 'hal-00001234' ou 'tel-00987654'.

Exporte des publications au format bibliographique (BibTeX, EndNote, CSV, TEI).

Args: query: termes de recherche identifiant les publications à exporter. fmt: 'bibtex' (défaut), 'endnote', 'csv', 'xml-tei'. rows: nombre de références à exporter (max 100).

Statistiques agrégées sur des publications (comptages par facette).

Utile pour : production d'un labo par année, répartition par type de document, mots-clés dominants, auteurs les plus prolifiques sur un thème.

Args: query: termes de recherche définissant l'ensemble à analyser. group_by: dimension d'agrégation : 'annee', 'type', 'motscles', 'auteur'.

Récupère une page de la production d'un chercheur via son IdHAL.

L'IdHAL (ex. 'jane-dupont') est l'identifiant auteur unique de HAL : il évite les homonymes et regroupe les variantes de nom. Idéal pour dresser la liste des publications d'une personne. Pour paginer au-delà de rows, utiliser search_publications(query='authIdHal_s:"prenom-nom"', start=...).

Args: id_hal: l'IdHAL du chercheur, au format 'prenom-nom' (ex. 'jane-dupont'). year_from: année de début (incluse). year_to: année de fin (incluse). doc_type: filtrer par type : article, these, communication, ouvrage, etc. sort: 'date' (défaut, plus récent d'abord) ou 'pertinence'. rows: nombre de publications à renvoyer (max 100). include_coauthors: si vrai, ajoute la liste des co-auteurs les plus fréquents (comptages).

Recherche un laboratoire ou une structure de recherche dans HAL.

Args: query: nom ou acronyme de la structure (ex. 'LIP6', 'physique quantique'). rows: nombre de résultats (max 50).

Rechercher dans AuréHAL : author, structure, domain, journal, doctype, instance. query accepte la syntaxe Solr. Vérifier valid_s et les dates des affiliations.

Récupérer une proposition de métadonnées Crossref à partir du DOI. Aucun dépôt.

Chercher les notices au titre exact ou au DOI. Aucun résultat ne garantit pas l'absence de doublon.

Créer un brouillon local immuable ART/COMM : métadonnées TEI et PDF optionnel. Résoudre les structure_ids dans AuréHAL avant préparation. Ne pas inventer de licence. Vérifier check_duplicates. Présenter le résultat complet à l'utilisateur avant submit_deposit. create : nouveau dépôt ; new_version : cible sans vN et PDF ; metadata_update : cible avec vN, métadonnées complètes (remplacement, pas patch), sans PDF. Aucun appel réseau.

Relire le brouillon exact, son empreinte, son test et le journal d'envoi.

Tester le paquet auprès de HAL avec X-test: 1 (sans dépôt). Transmet PDF et métadonnées. Nécessite les identifiants de l'environnement choisi. À effectuer avant submit_deposit.

ENVOI RÉEL du brouillon testé. Appeler uniquement sur instruction explicite de l'utilisateur après présentation du fichier, des auteurs/affiliations, de la licence et de l'embargo. Fournir l'empreinte relue et confirm=true. Production exige HAL_ALLOW_PRODUCTION=1. Une tentative est journalisée et ne peut pas être rejouée automatiquement.

Statut SWORD authentifié : accept=en ligne, verify=validation, update=corrections, delete=refus. Les mots de passe retournés par HAL sont filtrés.