Présentation des portails HAL, AureHAL et l'utilisation du protocole SWORD

1. ADMINISTRATION D’UN PORTAIL HAL
UTILISATION DU PROTOCOLE SWORD
Laurent Capelli (CCSD)

2. ADMINISTRATION

3. Met en forme le site Web
Crée des collections
Gère les droits des utilisateurs
Accède aux statistiques de son portail
Gère les dépôts de son portail
Gère les référentiels (AURéHAL)
3
ADMINISTRATION

4. Langue de l’interface
Apparence
Menu
Page personnalisable
Page dynamique
Actualités
Ressource
4
ADMINISTRATION/SITE WEB

5. Création
identifiant unique TAMPID
Critère
requête de recherche
5
ADMINISTRATION/COLLECTION

6. Recherche sur nom, prénom, mail et id
Modification du compte
Gestion des privilèges
référent structures
gestionnaire de collection
administrateur
6
ADMINISTRATION/UTILISATEUR

7. Sélection des ressources
Répartition
Tous les champs indexés
Groupement
Consultation
Date
Géolocalisation
7
ADMINISTRATION/STATISTIQUES

8. Ensemble des ressources déposées sur le site
Informations, visualisation, suppression des
ressources existantes
Ajout de nouveaux fichiers
8
ADMINISTRATION/RESSOURCES

9. http://aurehal.archives-ouvertes.fr/
Auteurs
Structures de recherche
Disciplines
Revues
Projets ANR
Projets Européens
AURÉHAL : ACCÈS UNIFIÉ AUX
RÉFÉRENTIELS HAL

10. Les référentiels peuvent être consultés, même
sans authentification
L’historique de chaque entrée est visible par
toute personne authentifiée : date de création,
de mise à jour
Chaque entrée d’un référentiel permet de lancer
une requête dans HAL pour consulter les dépôts
liés
Une mise à jour dans un référentiel génère
automatiquement une mise à jour dans les
dépôts liés
10
RÉFÉRENTIELS :
CARACTÉRISTIQUES COMMUNES

11. Création d’une forme auteur : champs
Nom
Prénom
Autres prénoms (initiales)
Adresse courriel
URL site personnel
Établissement d’appartenance = institution dont dépend
le chercheur
Statuts : Incoming/ Valid/ Old
Incoming : forme auteur sans IdHAL : rouge
Valid : forme auteur par défaut d’un IdHAL : vert
Old : autre forme auteur d’un IdHAL : jaune
Code couleur lors du dépôt et dans AURéHAL
11
RÉFÉRENTIEL AUTEUR

12. Règles de fusion :
Une forme auteur n’appartenant pas à un IdHAL
peut être remplacée par n’importe quelle autre
forme auteur
Une forme auteur appartenant à un IdHAL ne
peut être remplacée que par une forme auteur
appartenant au même IdHAL
La forme auteur par défaut d’un IdHAL ne peut
pas être remplacée
12
FUSION DES FORMES AUTEUR

13. Création d’une structure : Champs
Nom
Sigle
Adresse
Pays
Type structure (équipe, département, laboratoire,
institution/entreprise)
URL
Statut + code couleur dans AURéHAL:
Valide (vert)/ Fermée (jaune)/ A valider (rouge)
13
RÉFÉRENTIEL STRUCTURES

14. 4 niveaux de structure
Equipe de recherche
Département
Laboratoire
Institution
Chaque type de structure a une structure
parent (sauf l’institution)
14
STRUCTURES DE RECHERCHE

15. 15
STRUCTURES DE RECHERCHE
Institution
Laboratoire
Département
Équipe
Équipe
Laboratoire
Département
Laboratoire

16. Champs :
Nom de la revue *
Nom abrégé
ISSN et E-ISSN
Editeur *
Racine DOI
URL
Etat : Valide / Non valide
Lien avec SHERPA/ ROMEO
16
RÉFÉRENTIEL REVUES

17. Champs
Titre *
Acronyme *
Référence *
Intitulé
Acronyme appel
Année *
Validité : Valide/ Non valide
Convention avec l’ANR (conclue le 1er février
2014)
17
RÉFÉRENTIEL PROJETS ANR

18. Champs
Numéro *
Acronyme *
Titre *
Programme
Date début
Date fin
Identifiant
Validité : Valide/ Non valide
18
RÉFÉRENTIEL PROJETS EUROPÉEN

19. Champs multivalués
Collections / Moissonnage
Compatibilité Openaire
Compatibilité H2020
19
PROJETS ANR ET PROJETS EUROPÉENS

20. IMPORT SWORD

21. API REST HTTP
verbe GET, POST, PUT et DELETE
entête HTTP
On-Behalf-Of
X-Packaging
Content-Type
Content-Disposition
Content-MD5
Export-To-Arxiv, Export-To-PMC, Hide-For-RePEc,
Hide-In-OAI
21
IMPORT SWORD

22. GET
api.archives-ouvertes.fr/sword/identifiant
Statut de la ressource
HTTP/1.1 200 OK
<document>
<status>accept|verify|update|delete</stat
us>
<comment></comment>
</document>
22
IMPORT SWORD

23. DELETE
api.archives-ouvertes.fr/sword/identifiant
Suppression de la ressource
HTTP/1.1 204 No Content
23
IMPORT SWORD

24. POST
api.archives-ouvertes.fr/sword/portail
Dépôt d’une ressource
notice : text/xml
fichier ou annexe : application/zip
Format pivot basée sur la TEI
api.archives-ouvertes.fr/documents/aofr-sword.xsd
HTTP/1.1 202 Accepted
HTTP/1.1 201 Created
24
IMPORT SWORD

25. PUT
api.archives-ouvertes.fr/sword/identifiant
Modification|Nouvelle version d’une
ressource
HTTP/1.1 200 OK
HTTP/1.1 201 Created
25
IMPORT SWORD

26. Gestion des erreurs
HTTP/1.1 4XX
406 Not Acceptable
412 Precondition Failed
403 Forbidden
405 Method Not Allowed
413 Request Entity Too Large
400 Bad Request
Xpath : sword:error/summary
26
IMPORT SWORD

27. exemple dépôt notice
curl -v -u test_ws:test https://api.archives-
ouvertes.fr/sword/hal -H "X-
Packaging:http://purl.org/net/sword-types/AOfr" -X
POST -H "Content-Type:text/xml" --data-binary
@Desktop/tei2.xml
27
IMPORT SWORD

28. exemple nouvelle version
curl -v -u test_ws:test https://api.archives-
ouvertes.fr/sword/hal-00000001 -H "X-
Packaging:http://purl.org/net/sword-types/AOfr" -X PUT
-H "Content-Type:application/zip" –H "Content-
Disposition:inline, filename=aa12.xml" --data-binary
@Desktop/Archive.zip
28
IMPORT SWORD

29. MERCI …