====== Journée de "familiarisation" avec les nouvelles API de HAL V3 .======

Dans le cadre du réseau ARAMIS, Françoise CONIL et Laurence BESSON  vous proposent, le **mercredi 25 février**,  une journée de "familiarisation" avec les **nouvelles API de HAL V3**.

L'archive ouverte pluridisciplinaire [[https://hal.archives-ouvertes.fr/|HAL]], est destinée au dépôt et à la diffusion d'articles scientifiques de niveau recherche, publiés ou non, et de thèses.


===== But =====

Cette journée a pour but d'aider les **informaticiens** à prendre en main ces nouvelles API en complément de la [[http://api.archives-ouvertes.fr/docs|documentation existante]] pour vous permettre de gérer votre production scientifique.

===== Intervenants =====

Raphaël Tournoy, Laurent Capelli, Hélène Gaboriaud et Yannick Barborini de l'équipe développement du [[http://www.ccsd.cnrs.fr/|CCSD]].

===== Supports =====

  * {{:ateliers:aramis-hal-v3-api-solr_25_02_2015.pdf|API Solr}}
  * {{:ateliers:aramis-hal-v3-les-referentiels-hal_25_02_2015.pdf|Les référentiels de HAL}}
  * {{:ateliers:aramis-hal-v3-le-format-tei_25_02_2015.pdf|Le format TEI}}
  * {{:ateliers:aramis-hal-v3-import-sword_25_02_2015.pdf|L'import Sword}}
  * {{:ateliers:aramis-hal-v3-construire-extraction-hal-pour-hceres.pdf|Construire son extraction HAL pour HCERES}}

===== Ressources =====

  * le [[http://blog.ccsd.cnrs.fr/|blog du CCSD]]
  * la mailing-list [[https://listes.services.cnrs.fr/wws/info/halinfo|halinfo]] (//Échanges entre les responsables de portail, responsables labo de la base d'archives ouvertes HAL//)
  * la mailing-list [[https://listes.services.cnrs.fr/wws/info/si-labo_echanges|si-labo_echanges]] issue du groupe de travail DEVLOG [[http://devlog.cnrs.fr/groupe-de-travail/architecture-si-labo/start|Architecture du SI dans les laboratoires de recherche]]

et bien sûr :

  * la [[https://hal.archives-ouvertes.fr/folder/list10|documentation générale de HAL]]
  * la [[http://api.archives-ouvertes.fr/docs|documentation des API de HAL]]
  * le [[https://halv3-preprod.archives-ouvertes.fr/|site de test de HAL]]

===== Photo =====

{{ :ateliers:atelier_aramis_hal_v3.jpg?nolink&600 |}}

===== Inscriptions =====

<note important>L'accès à l'atelier est **limité à 40 personnes**, merci de vous **inscrire** via https://groupes.renater.fr/reunion/foodle/https-groupes-renater-fr-reunion-foodle-Atelier-Halv3-54b39
</note>
<note warning>Les frais de mission et demandes d'ordre de mission seront à la charge des participants</note>

**Date** : Mercredi 25 février de 9h00 à 16h30

**Lieu** : à Villeurbanne, [[http://oscar.univ-lyon1.fr/appli-externe/plan/plans/fiches_ucbl/nautibus.html|bâtiment Nautibus]], salle C4 au rez-de-chaussée du bâtiment. 

**Pour accéder au bâtiment Nautibus** : Vous pouvez utiliser les indications suivantes pour venir : http://liris.cnrs.fr/acces/localisation-UCBL.htm

**Équipement** : La salle est équipée de nombreuses prises électriques. Pour la connexion réseau, ce sera en wifi obligatoirement (eduroam ou compte invité).

**Repas** : Une pause sandwich / boisson / dessert est prévue

**Pas de visioconférence** : la salle n'est malheureusement pas équipée

===== Pré-requis =====

Avoir consulté la documentation des API et éventuellement commencé à les tester.

Un simple client HTTP REST, comme **curl**, est nécessaire pour expérimenter les API HAL. 

Voici une [[http://liris.cnrs.fr/francoise.conil/atelier-hal-v3/|documentation]] sur quelques requêtes faites avec curl / chrome et l'application "[[https://chrome.google.com/webstore/detail/advanced-rest-client/hgmloofddffdnphfgcellkdfbfbjeloo|Advanced REST Client]]" et [[http://sourceforge.net/projects/soapui/files/|SoapUI]].

Portail de test pour sword : http://api-preprod.archives-ouvertes.fr/sword/hal/

Un compte de test dont le login / mot de passe vous sera donné pendant l'atelier sera utilisé.

===== Programme =====

Voici le programme détaillé de la journée :

==== Matin ====

0) **Tour de table** des participants (**1 à 2 minutes** par personne) : vos besoins, vos projets, votre attente vis à vis de HAL

1) Présentation de l’outil recherche et de l’API search (45 min) syntaxe de recherche Solr, format des réponses, filtres, etc. \\
remarque : //durant la présentation les participants expérimenteront les requêtes dans leur navigateur (ou avec leur outil préféré curl, wget).//

2) API des référentiels HAL et AURéHAL (30 min)
même remarque

**Ateliers** :

a) Exporter sa publication selon les types
//Comment construire son extraction HAL pour répondre aux demandes de l'AERES pour le rapport d'activité.//

b) Publication des chercheurs de mon labo : construire des pages web présentant les auteurs de mon labo puis sur chaque auteur la liste des publications
remarque : //Chaque participant utilise ses outils, l'équipe du CCSD nous aidera à élaborer / corriger les requêtes d'extraction de HAL//

==== Pause repas ====

Nous avons prévu sandwich / eau / café pour les participants afin de pouvoir discuter entre nous pendant cette pause.

==== Après-midi ====

3) Format TEI (30 min)

4) import SWORD (30 min)

**Ateliers** :

a) Importer un lot de publications

b) endnoteXML / WOS vers TEI