Source: http://retrievo.pt/record?id=oai:hal.archives-ouvertes.fr:hal-00264541
Timestamp: 2020-06-02 03:49:55+00:00

Document:
Retrievo - The Determination of alpha_s from Tau Decays Revisited
Zhang, Z.;
Malaescu, B.;
Hoecker, A.;
Descotes-Genon, S.;
We revisit the determination of alpha_s(m_tau) using a fit to inclusive tau hadronic spectral moments in light of (1) the recent calculation of the fourth-order perturbative coefficient K_4 in the expansion of the Adler function, (2) new precision measurements from BABAR of e+e- annihilation cross sections, which decrease the uncertainty in the separation of vector and axial-vector spectral functions, and (3) improved results from BABAR and Belle on tau branching fractions involving kaons. We estimate that the fourth-order perturbative prediction reduces the theoretical uncertainty, introduced by the truncation of the series, by 20% with respect to earlier determinations. We discuss to some detail the perturbative prediction and show that the effect of the incomplete knowledge of the series is reduced by using the so-called contour-improved calculation, as opposed to fixed-order perturbation theory which manifests convergence problems. The corresponding theoretical uncertainties are studied at the tau and Z mass scales. Nonperturbative contributions extracted from the most inclusive fit are small, in agreement with earlier determinations. Systematic effects from quark-hadron duality violation are estimated with simple models and found to be within the quoted systematic errors. The fit gives alpha_s(m_tau) = 0.344 +- 0.005 +- 0.007, where the first error is experimental and the second theoretical. After evolution to M_Z we obtain alpha_s(M_Z) = 0.1212 +- 0.0005 +- 0.0008 +- 0.0005, where the errors are respectively experimental, theoretical and due to the evolution. The result is in agreement with the corresponding NNNLO value derived from essentially the Z width in the global electroweak fit. The alpha_s(M_Z) determination from tau decays is the most precise one to date.
ARXIV: 0803.0979
http://hal.archives-ouvertes.fr/hal-00264541
http://retrievo.pt/record?id=oai:hal.archives-ouvertes.fr:hal-00264541
Rédigé par Estelle THEVENIAUD Septembre 2006 Dernière mise à jour Février 2009
Mode d’emploi de HAL,
la plate-forme d’archives ouvertes
Objet : Développement des archives ouvertes Chère Collègue, Cher Collègue,
Le CNRS soutient le mouvement international en faveur des archives ouvertes. Il a, à cet
égard, exprimé une position de principe lors de la déclaration de Berlin, signée le 22 octobre 2003, en faveur du modèle du libre accès à la connaissance. Et l’établissement a agi concrètement en mettant en œuvre la base pluridisciplinaire « Hal » 1, hébergée au Centre pour la communication scientifique directe (CCSD), unité propre de service (UPS) du CNRS. L’Académie des sciences a exprimé, pour sa part, son fort soutien dans un avis rendu le 5 juillet 2005 et un accord inter-établissements (établissements d’enseignement supérieur et de recherche et organismes de recherche) est en cours de signature pour l’utilisation commune de Hal. Dans ce contexte, je souhaite que vous invitiez tous les chercheurs des unités propres ou associées au CNRS à déposer, chaque fois que c'est possible, les « manuscrits » de leurs travaux sur la base Hal, les rendant ainsi librement consultables par la communauté scientifique internationale. Outre une large visibilité immédiate des travaux de recherche, ce dispositif permettra, dans un cadre académique, une préservation à long terme des documents sous forme électronique. Il permettra également aux laboratoires et institutions une identification facilitée de leur production scientifique via une « collection »2 constituée sur la base « Hal ». Je vous incite donc à prendre des mesures pour que ce dépôt soit effectué régulièrement. Le CNRS veillera, pour sa part, au maintien de ces bases en libre accès, à la conservation à long terme du corpus de connaissances ainsi constitué et à la stabilité des adresses des documents mis en ligne.
Il ne s’agit évidemment pas de renoncer à la publication des travaux de recherche dans des revues à comité de lecture. L’évaluation scientifique par les pairs et l’amélioration des textes soumis aux revues scientifiques, en particulier internationales, sont des composantes essentielles de la recherche. Cependant, comme l'ont déjà montré certaines grandes communautés scientifiques, une publication par les canaux classiques n'est pas incompatible avec la communication des résultats sur une base en accès libre. 1http://hal.ccsd.cnrs.fr/ 2 www.ccsd.cnrs.fr/article.php3?id_article=15
Il existe bien évidemment des cas où il est inopportun ou impossible de diffuser les résultats
de recherche, que ce soit dans le cadre des bases en libre accès ou des publications traditionnelles. C'est aux chercheurs et aux laboratoires d'appliquer le discernement nécessaire.
Il convient en particulier de veiller à ne pas rendre publics des résultats confidentiels, par
exemple s’ils sont destinés à être brevetés, et de vérifier que les droits de diffusion en archives ouvertes n’ont fait pas l’objet d’une cession à un éditeur (cf. le « guide du dépôt et du bon usage de Hal »3 qui rappelle les règles à respecter en matière de droit de propriété intellectuelle4). Les chercheurs des laboratoires propres ou associés au CNRS sont invités à ce titre à favoriser les revues et éditeurs dont les contrats sont compatibles avec le dépôt des documents sur Hal, mais bien évidemment ce sont eux les mieux placés pour décider en dernier ressort si cela est possible, compte tenu des habitudes dans chaque discipline et de la nécessité d’une bonne diffusion.
Dans les cas où il s’avère que le dépôt du texte dans son intégralité n’est pas approprié, il
demeure toujours la possibilité de déposer dans Hal une notice bibliographique ne contenant que les références de publication.
Sachant pouvoir compter sur votre actif concours pour contribuer à développer le modèle du
libre accès à la connaissance, je vous prie de bien vouloir agréer, Chère Collègue, Cher Collègue, l’expression de mes salutations les meilleures,
3 www.ccsd.cnrs.fr/rubrique.php3?id_rubrique=15 4 www.sg.cnrs.fr/daj/propriete/droits/droits.htm
SOMMAIRE 1. Le serveur HAL ................................................................................................................................ 9
1.1. But et usage ............................................................................................................................ 9 1.2. Documents contenus dans Hal ................................................................................................ 9 1.3. Disciplines .............................................................................................................................. 10 1.4. Types des dépôts .................................................................................................................. 10 1.5. Règles de dépôts ................................................................................................................... 11
2. Les différents rôles ......................................................................................................................... 12 2.1. Abonné .................................................................................................................................. 12 2.2. Contributeur ........................................................................................................................... 12 2.3. Remarques ............................................................................................................................ 13
3. Ouvrir l’application .......................................................................................................................... 13 4. Se créer un compte ........................................................................................................................ 14 5. S’authentifier .................................................................................................................................. 15 6. Déposer .......................................................................................................................................... 16
6.1. Déposer un document avec texte intégral ............................................................................. 18 6.2. Déposer une thèse ou une HDR ........................................................................................... 33 6.3. Déposer un document avec lien sur arXiv ............................................................................. 38 6.4. Déposer une référence bibliographique ................................................................................ 40
7. Mon espace .................................................................................................................................... 44 7.1. Mes dépôts ............................................................................................................................ 44 7.2. Mes statistiques ..................................................................................................................... 45 7.3. Mes alertes ............................................................................................................................ 47 7.4. Mon compte ........................................................................................................................... 47
8. Consultation des documents .......................................................................................................... 48 9. Recherche de documents .............................................................................................................. 49 10. Services ..................................................................................................................................... 50
10.1. S’abonner .......................................................................................................................... 50 10.2. Consulter les laboratoires connus de HAL ........................................................................ 52 10.3. Tester la compilation Tex/LaTeX ....................................................................................... 52
11. Extraction des données ............................................................................................................. 53 11.1. Récupération d’url ............................................................................................................. 53 11.2. Exporter une liste de publication ....................................................................................... 53 11.3. Exporter une liste de publication en regroupant les données de HAL et PubliCNRS ....... 54 11.4. Flux RSS ............................................................................................................................ 56
12. Les collections ........................................................................................................................... 57 12.1. Tamponner un article ......................................................................................................... 58 12.2. Consulter les articles en attente d’être validés. ................................................................. 59 12.3. Consulter la liste des tampons d’un article ........................................................................ 59 12.4. « Détamponner » des articles ............................................................................................ 60 12.5. Personnalisation de l’interface web de la collection .......................................................... 60 12.6. Statistiques de la collection ............................................................................................... 67
13. Questions ................................................................................................................................... 71 13.1. A propos des notices de publiCNRS… ............................................................................. 71 13.2. HAL et Labintel .................................................................................................................. 71 13.3. HAL et CRAC ..................................................................................................................... 71 13.4. Import de documents ......................................................................................................... 72 13.5. Import et EndNote ............................................................................................................. 72
Documentation HAL Page 9/72
1. Le serveur HAL
1.1. But et usage Hal est un outil de communication scientifique directe développé par le CCSD (Centre pour la Communication Scientifique Directe) destiné à recueillir les publications scientifiques des chercheurs. C’est une application web accessible avec un navigateur (Internet Explorer, Firefox, Safari, etc.) à l’URL :
http://hal.archives-ouvertes.fr/ Les documents qui sont déposés sur le serveur Hal deviennent immédiatement et gratuitement accessibles aux chercheurs du monde entier. Il s’inscrit dans le cadre du mouvement international Open Archive Initiative (OAI) par une promotion d’un auto-archivage institutionnel et pérenne. Le serveur Hal permet également aux auteurs, laboratoires et institutions de constituer des listes de publications (cf. §11) automatiquement mises à jour en fonction des dépôts. Ces listes peuvent être :
 importées automatiquement dans les rapports individuels des chercheurs CNRS via l’interface CRAC.
 utilisées par les laboratoires pour assurer une meilleure visibilité de leur production, surtout s’ils mettent en jeu la constitution automatique d’un présentoir électronique associé ou non à un tampon (cf. §12). C’est une bonne façon de mieux faire connaître en interne le travail des autres chercheurs de la même unité, mais aussi de présenter la production du laboratoire à l’extérieur, par exemple un comité d’évaluation.
 insérées dans des documents à caractère administratif : contribuer à la constitution d’un rapport du laboratoire par exemple.
Pour compléter ces listes, il est possible de déposer des « notices bibliographiques » mais seulement dans la mesure où il y a difficulté au dépôt du texte intégral pour cause de confidentialité, brevet, etc. Hal reste avant tout un outil de communication scientifique ; sa vocation est donc principalement de recueillir des documents avec texte intégral. Les institutions, fédérations de laboratoires, grandes écoles, départements, etc. peuvent aussi utiliser l’application Hal pour identifier et rendre visible la production scientifique de leurs chercheurs et de leurs laboratoires. Les organisateurs de congrès ou écoles d’été peuvent utiliser Hal pour collecter les contributions des auteurs et de les rendre visible via les « collections » (cf. §12). Hal est un outil configurable en environnements multiples.
1.2. Documents contenus dans Hal Le dépôt d’un document sur Hal est placé sous la responsabilité de la personne qui l’effectue ; il implique l’accord de l’ensemble des auteurs. Ces derniers conservent évidemment l’entière propriété intellectuelle de leur travail. Les documents déposés doivent avoir un contenu susceptible d’intéresser la communauté des chercheurs de leur domaine. Le CCSD effectue une vérification de chaque document avant de les mettre en ligne. Afin de responsabiliser scientifiquement les auteurs, le retrait des documents déposés n’est pas accessible en archives ouvertes. En revanche, il est parfaitement possible de faire évoluer un texte et de lui apporter des corrections ou des précisions en déposant des versions successives (cf. §7.1), qui seront toutes automatiquement datées. Si les auteurs d’un dépôt désirent se rétracter scientifiquement, il est recommandé de déposer une version supplémentaire vide, en précisant dans les commentaires qu’il s’agit d’une rétractation et en précisant éventuellement les raisons. Le serveur Hal permet aussi de déposer des mémoires de thèses et d’habilitation, dans son environnement spécifique TEL (thèses en ligne, http://tel.archives-ouvertes.fr) (cf. §6.2). Dans ce cas la responsabilité scientifique du contenu est celle du jury de l’université qui a délivré la thèse. L’envoi d’un document sur ce serveur est assimilable à la présentation de résultats scientifiques dans une conférence : les travaux sont divulgués publiquement ce qui peut, compte tenu par exemple des réglementations européennes, empêcher dans certains cas le dépôt d’un brevet. Un certain discernement s’impose donc dans le dépôt !
Documentation HAL Page 10/72
Les lois sur le copyright des éditeurs doivent être respectées ; par exemple un fichier fourni par un éditeur commercial, comme celui disponible en ligne par abonnement à une revue, ne peut être déposé sans l’accord explicite de cet éditeur. Sauf dans ce cas particulier, la règle générale est que les fichiers téléchargés doivent être produits par l’auteur ou son laboratoire. De plus, ne pas déposer sur Hal de document pour lequel le (ou les) auteur(s) ont signé avec un éditeur un contrat donnant lieu à contreparties financières au titre de droits d’auteur. Dans un cas comme dans l’autre, le déposant peut utiliser une procédure de dépôt différé (cf. §5.1) pour introduire un certain délai dans la mise en ligne du texte. Les documents qui doivent rester confidentiels (si par exemple une prise de brevets est envisagée) ne doivent en aucun cas être déposés sur Hal. Si toutefois une erreur technique ou autre se produisait lors d’un dépôt, pour la corriger prière de prévenir rapidement le CCSD par courrier électronique hal.support@ccsd.cnrs.fr ou par téléphone au 04 78 93 08 (standard)
1.3. Disciplines Toutes les disciplines scientifiques peuvent être accueillies dans Hal. Les rubriques qui n’existent pas encore seront introduites au fur et à mesure des demandes exprimées par les communautés scientifiques. Celles-ci peuvent être envoyées à l’adresse hal.support@ccsd.cnrs.fr et seront transmises aux comités habilités.
1.4. Types des dépôts Plusieurs types de dépôts peuvent être effectués dans Hal :
 Document en texte intégral dont le (ou les) fichier(s) seront téléchargés sur Hal.  Documents dont le texte intégral est fourni sous la forme d’un lien vers arXiv (base de
données de référence en physique, mathématiques)  Référence bibliographique (notice), qui contient les références de publication d’un article, livre,
etc. publié, mais pas le texte intégral. Il est préférable (mais pas obligatoire) de l’enrichir d’une adresse DOI.
Documentation HAL Page 11/72
1.5. Règles de dépôts Le dépôt sur une archive ouverte d’un document scientifique permet d’en augmenter l’accessibilité et la visibilité. Il obéit toutefois à un certain nombre de règles qui découlent du bon sens, de la déontologie scientifique et du respect des lois. En voici un bref résumé. Hal met à disposition des lecteurs des documents scientifiques dans un contexte académique identique à celui des revues scientifiques spécialisées. Les mêmes règles de bon usage s’appliquent donc : les travaux peuvent être cités et référencés dans d’autres documents scientifiques, mais restent entièrement la propriété intellectuelle de leurs auteurs. Un texte déposé sur Hal doit décrire un travail de recherche solide, conforme aux règles en usage dans la discipline, comparable aux manuscrits que les chercheurs soumettent pour publication aux comités de lecture de revues scientifiques, d’actes de colloque, etc.. 1. Il convient de s’assurer que le ou les auteurs approuvent le dépôt de leur travail sur l’archive ouverte et ses conséquences ; leur responsabilité scientifique est en effet engagée vis-à-vis de la communauté internationale. Hal est une archive ouverte permanente, où la responsabilité scientifique des comités de lecture des journaux habituels est remplacée par la responsabilité individuelle du déposant. Il sera possible ensuite de faire évoluer le document par dépôt de versions successives, sans aucune limitation ; seule la dernière version est proposée par défaut au lecteur. L’interface Hal ne permet cependant pas la simple suppression d’un document. 2. Il convient de s’assurer que le document peut bien être rendu public. S’il est confidentiel (brevet en attente, clause de confidentialité dans contrat de recherche, etc.), il ne doit évidemment pas être envoyé à Hal. Il est déconseillé de déposer sur Hal tout manuscrit dont l’auteur attend rémunération. Dans le cas par exemple d’un ouvrage destiné à être vendu en librairie, une mise en ligne du texte pourrait décourager l’éditeur de signer un contrat. Le dépôt dans un tel cas n’est certes pas impossible, mais demande négociation préalable avec l’éditeur. 3. Il est nécessaire de déposer des « fichiers auteur », c’est-à-dire des fichiers produits par l’auteur ou son laboratoire. Pour respecter la loi, les fichiers produits par les éditeurs commerciaux ne peuvent être chargés sur Hal uniquement si l’autorisation de l’éditeur a été obtenue explicitement ; dans ce cas, mentionner cette autorisation et remercier l’éditeur dans le champ « commentaires ». De même, les images, les fichiers sonores, etc. qui ne sont pas du domaine public ne peuvent être déposés sans autorisation explicite du détenteur de leurs droits. 4. De nombreuses revues scientifiques admettent le dépôt de « fichiers auteur » par leurs auteurs sur des archives ouvertes, avant ou après publication, dans le cadre d’une diffusion purement scientifique et non commerciale. Le nombre de ces revues croît constamment sous la pression des communautés scientifiques. Certaines revues s’y opposent toutefois, souvent en exigeant un délai minimal entre la publication et la mise en ligne du document source ; un dépôt différé avec délai réglable est possible sur Hal pour suivre cette règle. Il est également possible de déposer sur Hal un « document caché » (visible du seul déposant et des administrateurs de la base) ou une notice de publication sans plein texte. Il est cependant demandé aux auteurs de faire un usage limité de ces restrictions ; mieux vaut choisir un journal ou un éditeur qui ne s’oppose pas à la mise en ligne instantanée. La variété des situations est telle que seuls les auteurs sont à même de décider les modalités de communication scientifique de leur travail. Les revues scientifiques et éditeurs commerciaux ne disposent que des droits que les auteurs leur ont cédés explicitement par contrat écrit. En l’absence de document signé, les auteurs restent libres de déposer leurs fichiers source sur Hal. C’est également le cas s’ils n’ont pas cédé leurs droits de reproduction numérique. Les auteurs sont donc invités à ne céder que les droits qui sont strictement nécessaires, à choisir les revues dans cette optique en fonction de leur politique affichée, et à bien lire les formulaires de « transferts de copyright » proposés. Le site SHERPA/RoMEO Publishers' Copyright Listings (http://www.sherpa.ac.uk/) détaille les politiques des éditeurs face à l'auto-archivage.
Documentation HAL Page 12/72
2. Les différents rôles Pour consulter les documents présents sur le serveur, il n’est pas nécessaire de se créer un compte. Un simple internaute peut parcourir le site HAL et consulter tous les documents qui ont été déposés. Par contre, pour avoir d’autres droits que la consultation il est obligatoire d’être inscrit et de posséder le ou les rôle(s) suivant(s) : abonné, contributeur (référent laboratoire, super lecteur, tamponneur) ou valideur.
2.1. Abonné L’abonné est un utilisateur qui s’est inscrit pour recevoir des alertes quotidiennes et/ou mensuelles contenant les dépôts les plus récents. (cf. §10.1). Il peut devenir contributeur s’il le souhaite en modifiant son compte d’abonné.
2.2. Contributeur Le contributeur est un utilisateur qui s’est inscrit sur HAL (voir §4) et qui peut déposer des articles. Le seul droit qu’il possède est de déposer des documents. Il peut obtenir des droits supplémentaires si nécessaire tels que référent de son laboratoire ou tamponneur en en effectuant la demande à l’équipe de responsable du portail, hal.support@ccsd.cnrs.fr.
2.2.1. Référent laboratoire Le droit référent s’acquière pour une entité laboratoire et donne la possibilité de visualiser, modifier les métadonnées, de mettre en ligne les fichiers « texte intégrale » des dépôts attachés au laboratoire de référence et de transférer la propriété d’un dépôt à un des auteurs par exemple. Mais ce droit ne permet pas de modifier la typologie d’un document.
2.2.2. Tamponneur Le tamponneur gère une collection, en mode manuel, pour laquelle il va tamponner des documents qui auront été sélectionnés. Il contrôle ainsi l'entrée de chaque document dans sa collection. Il lui est aussi permis de personnaliser l’interface de la collection (logo, page d’accueil) (cf. §12).
2.2.3. Valideur Le valideur est la personne qui va contrôler les dépôts effectués sur HAL afin de les mettre en ligne. Pour mettre un document en ligne, le valideur effectue une validation technique (vérification des fichiers, ordre des auteurs, etc.)
2.2.4. Utilisateur de l’import HAL Il est possible d’importer automatiquement dans Hal des ensembles de documents sans passer par l’interface web (cf. §13.4), pour pouvoir utiliser cette fonctionnalité il faut demander l’autorisation à l’équipe de responsable du portail, hal.support@ccsd.cnrs.fr. La documentation se trouve à l'URL suivante : http://www.ccsd.cnrs.fr/spip.php?rubrique31.
2.2.5. Utilisateur des WebServices Les WebServices permettent d'accéder en consultation aux référentiels internes de HAL (laboratoires, domaines scientifiques, etc.), de déposer ou modifier des articles scientifiques accessibles via le protocole HTTP à l’URL http://hal.archives-ouvertes.fr/ws/
Documentation HAL Page 13/72
La documentation se trouve à l'URL suivante : http://www.ccsd.cnrs.fr/spip.php?rubrique31. La création d’un compte pour l’utilisation des webServices est soumise à l’autorisation du CCSD. En cas de problème rencontré, le CCSD se réserve le droit de le fermer.
2.3. Remarques Un contributeur peut cumuler plusieurs droits, par exemple il peut être à la fois « référent laboratoire » et « tamponneur ». Un contributeur peut donner l’identifiant et le mot de passe attribué à un dépôt à sa documentaliste pour qu’elle puisse avoir les mêmes droits que lui (modifier la typologie par exemple) sur ce dépôt. Le contributeur n’est pas forcément auteur de l’article.
3. Ouvrir l’application Pour accéder à l’application vous devez ouvrir un navigateur web et taper l’URL suivante : http://hal.archives-ouvertes.fr La page d’accueil s’affiche. Par défaut, l’application s’ouvre en français, mais si vous l’utiliser en anglais en cliquant sur le lien en haut à droite [english version]
Documentation HAL Page 14/72
4. Se créer un compte
Avant tout dépôt sur Hal, il est nécessaire de « s’inscrire », pour cela :
 se rendre dans la rubrique « Déposer > S’inscrire »  renseigner les informations demandées
o l’identifiant : peut être votre nom, un pseudo (mot court facile à mémoriser ou à taper au clavier)
o si vous choisissez de vous associer comme auteur par défaut, le champ auteur sera renseigné avec votre nom, votre prénom, votre courriel et votre URL personnelle lors des dépôts
o les champs précédés de la flèche bleue sont obligatoires (Remarque : cette flèche bleue précède, dans Hal, tout champ de formulaire obligatoire).
 cliquer sur « Créer »
L’identifiant peut contenir une chaine de caractère quelconque (nom, prénom, première lettre du prénom suivie du nom, etc.) C’est le seul champ qui ne sera pas modifiable par la suite. Cet identifiant vous permettra de vous connecter.
Le mot de passe doit être saisi deux fois afin d’éviter les erreurs de frappe.
Tous les messages de confirmation de dépôt, de demande de modification, de mise en ligne seront envoyés à cette adresse. En cas de changement d’adresse, il sera possible de la modifier dans « Mon espace > Mon compte ».
Liste déroulante pour choisir la langue de l’interface.
Ce domaine sera sélectionné par défaut pour chaque dépôt, mais vous aurez la possibilité de le supprimer et/ou d’en ajouter d’autres.
Si vous choisissez de vous associer comme auteur par défaut, le champ auteur sera renseigné avec votre nom et votre prénom lors des dépôts. Cette fonctionnalité est utile que dans le cas des chercheurs.
Documentation HAL Page 15/72
Un mail de confirmation contenant un lien sur lequel il faudra cliquer pour activer votre compte, vous sera ensuite envoyé. Cela permet de vérifier l’exactitude de l’adresse mail que vous avez saisie.
http://hal.archives-ouvertes.fr/index.php?action_todo=register
5. S’authentifier
Pour s’authentifier :
 cliquer sur « S’authentifier », ou aller dans « Déposer > S’authentifier »  saisir votre identifiant  saisir votre mot de passe  cliquer sur « Valider »
http://hal.archives-ouvertes.fr/index.php?action_todo=login
Lien d’activation de votre compte
Documentation HAL Page 16/72
Dans le cas d’oubli de vos paramètres de connexion, vous avez la possibilité de les recevoir par mail en renseignant votre identifiant ou votre courriel après avoir cliqué sur le lien « Vous avez perdu votre mot de passe ».
Oubli des paramètres de connexion
6. Déposer Un dépôt dans Hal est composé de plusieurs éléments distincts :
1. le texte intégral, avec parfois des documents annexes (présentation PowerPoint par ex.). 2. les métadonnées :
a) scientifiques, qui décrivent le contenu du texte intégral (titre, auteurs, résumé, discipline, mots clé, classification PACS ou autre ; on peut considérer que le commentaire optionnel est aussi une métadonnée de ce type)
b) relatives à la publication du document, s’il est publié (nom du journal, DOI, type de publication, etc.)
c) administratives (établissements, contrats, etc.) Les métadonnées 2-a servent pour les recherches scientifiques, les 2-b pour les extractions automatiques de listes de publication, les 2-c pour les constructions automatiques de listes donnant la production des laboratoires et/ou des établissements. Ces éléments ont des rôles bien distincts, qu’il convient de ne pas confondre. Par exemple :
La notion de version est attachée uniquement au premier élément, le texte intégral ; une version comporte une date certifiée par le système qui correspond uniquement à ce texte intégral, et non aux métadonnées. Ainsi, on peut changer les métadonnées d’un article, corriger une erreur, ajouter des mots clé, sans changer ni sa version ni sa date. Certains laboratoires envisagent un dépôt initial d’une version pauvre en métadonnées par les chercheurs, puis un enrichissement par les bibliothécaires ; ceci ne doit pas changer la date et la version du texte intégral. Les métadonnées d’une version donnée d’un document peuvent changer dans le temps. Par exemple un document non publié peut acquérir des références de publication.
Le rôle de la métadonnée "type de publication" n’est pas de qualifier le document déposé ! Il est de permettre l’extraction automatique de listes de publications pour les rapports de chercheurs ou de laboratoires selon la présentation requise par les établissements ou le ministère (contractualisation). Il serait illogique d’ajouter dans la liste des types de publication la notion de "non publié" ou de "soumis à" ; le champ commentaires doit être utilisé par les auteurs qui désirent préciser où ils soumettent leurs manuscrits, comme c’est très courant dans arXiv. Les dépôts possibles dans HAL sont :
 les documents avec texte intégral  les thèses ou HDR sur TEL  les documents avec lien sur d’autres grandes bases (arXiv, pubMed, etc.)  les références bibliographiques
Le dépôt d’un document se fait en plusieurs étapes :
 la saisie des métadonnées (c’est-à-dire les informations structurées sur le document)  la saisie des auteurs et de leur(s) laboratoire(s)  le transfert des fichiers s’il s’agit d’un dépôt avec texte intégral
Documentation HAL Page 17/72
 la récapitulation des données saisies Le dépôt n’est possible qu’après avoir validé toutes ces étapes et une fois le document déposé, il ne vous sera plus possible de le retirer du serveur de HAL Pour chaque document déposé, le serveur renvoie automatiquement un identifiant et un mot de passe dans un message à l’adresse électronique du déposant ; ces paramètres sont utiles aux co-auteurs, par exemple, pour effectuer toute modification ultérieure telle que le remplacement par une nouvelle version. Quelques remarques : Hal ne fonctionne correctement qu’avec une version suffisamment récente du navigateur (Netscape postérieur à 6, Internet Explorer supérieur à 6, Mozilla supérieur à 1.7, Firefox et Safari). De plus, le dépôt d’articles et de notices demande que la fonction de blocage des « popups » soit désactivée. Avant de commencer le premier dépôt, il est recommandé de vérifier que votre laboratoire est dans la liste des laboratoires déjà connus de Hal dans la rubrique « Services > Liste des laboratoires connus de Hal ». Si vous ne trouvez pas votre laboratoire, vous pourrez quand même effectuer votre dépôt, mais vous gagnerez du temps ensuite en le faisant entrer dans la liste de Hal (cf. §10.2). Les champs précédés de la flèche bleue sont obligatoires ; il est nécessaire de les remplir pour pouvoir passer toutes les étapes de dépôt.
http://hal.archives-ouvertes.fr/index.php?action_todo=menu&to_open=deposed
Documentation HAL Page 18/72
6.1. Déposer un document avec texte intégral
Quelques explications Vous avez le choix entre déposer votre texte intégral en :
 « mode visible » (visibilité immédiate du texte intégral pour tous), ce qui correspond à la fonction principale de communication scientifique directe de Hal Les fichiers déposés doivent être :
o de préférence des « fichiers auteur », c’est à dire des fichiers produits au sein du laboratoire par un auteur, un secrétariat, etc.
o si vous n’avez que des fichiers provenant d’un éditeur, obtenus par exemple en les recopiant lors de la consultation en ligne d’un journal commercial, ou des scans d’une revue commerciale, il est indispensable de recueillir l’accord formel de l’éditeur (à préciser dans le champ commentaire).
Le contenu des fichiers doivent être du niveau scientifique requis et ne doivent pas être : o des documents devant rester confidentiels (clause de secret dans un contrat de
recherche, projet de prise de brevet, procédé technique à protéger, etc.) o des documents pour lesquels a été, ou sera signé un contrat/accord de transfert de
copyright interdisant la mise en ligne. o de façon générale il est déconseillé de déposer sur Hal un document dont l’auteur
attend une rémunération de la part d’un éditeur.
 « mode différé » où le texte intégral ne devient visible qu’après un délai ajustable. L’utilisation de ce mode permet de mettre en ligne le texte intégral au bout d’un délai réglable choisi à l’avance. Ce délai peut être utilisé pour donner le temps de déposer un brevet, publier un autre document, ou tout simplement satisfaire les contraintes imposées par les éditeurs qui interdisent la mise en ligne avant un certain temps après la publication.
Le mode visible est, bien entendu, à privilégier, le mode différé ne devant être utilisé que si le premier est exclu !
Documentation HAL Page 19/72
1ère étape : renseigner les métadonnées
Formulaire de saisie des métadonnées
Etape de renseignement des métadonnées
Le résumé peut être saisi en plusieurs langues et vous devez privilégier la langue du document.
Les mots clés sont utiles pour la recherche.
Votre domaine « préféré » renseigné lors de l’inscription est sélectionné par défaut. Il est possible d’en ajouter d’autres ou même de le retirer en cliquant sur le bouton « retirer ».
La classification correspond à des codes prédéfinis dans différents domaines (mathématiques, physique, informatique, etc.)
La référence interne est un identifiant propre au laboratoire.
Il est possible d’ajouter la référence bibliographique dans le cas d’un article publié.
Pour éviter les doublons le système affiche la liste des articles déjà présents dans HAL dont le titre commence par les mêmes mots.
Documentation HAL Page 20/72
Le résumé peut être saisi en plusieurs langues et vous devez privilégier la langue du document. Pour une soumission qui doit être transmise sur arXiv, il est nécessaire de fournir un résumé en anglais, et de ne pas dépasser un total de 1400 caractères (15 lignes) environ. Vous avez la possibilité de déposer votre document dans plusieurs domaines (interdisciplinarité). Vous pouvez aussi indexer votre document avec des mots clés pour faciliter les recherches.
2ème étape : renseigner les auteurs et les laboratoires Une version évoluée (web 2.0) a été intégrée à la fonctionnalité de dépôt afin de faciliter la saisie des auteurs et de leur laboratoire. Cette méthode est proposée par défaut pour les nouveaux inscrits, pour les autres il faut préciser au système le passage à cette version dans la rubrique « Mon espace > Mon compte » et choisir la version évoluée dans la liste « interface auteur/laboratoire ».
Changer l’interface auteur/laboratoire
Version évoluée :
Interface auteur/laboratoire web 2.0
Pour ajouter un auteur, commencez à saisir son nom dans la zone « Ajouter un nouvel auteur », le système recherche alors tous les auteurs présents dans la base de données de HAL et correspondant à votre recherche. Le résultat s’affiche sous la forme d’une liste d’auteurs. Si vous trouvez votre auteur dans la liste sélectionnez le, sinon cliquez sur « nouvel auteur … ».
Etape de renseignement des affiliations auteur(s) – laboratoire(s)
Documentation HAL Page 21/72
Ajouter un nouvel auteur
Rechercher le laboratoire d’un auteur
Les informations sur l’auteur apparaissent dans un formulaire (si vous avez cliqué sur « nouvel auteur … » les informations seront à renseigner). Si l’auteur que vous renseignez est connu dans la base, le système récupère son ou ses laboratoires d’appartenance (associations déjà faites lors de précédents dépôts). Pour ajouter un laboratoire d’appartenance, il faut commencer à saisir le libellé, le sigle ou le code du laboratoire, une liste apparaît et propose les laboratoires valides dans la base et correspondant à la recherche. Si vous trouvez votre laboratoire dans la liste sélectionnez le, sinon cliquez sur « nouveau laboratoire … »
Documentation HAL Page 22/72
Ajouter le laboratoire d’un auteur
Pour ajouter un nouveau laboratoire, il suffit de renseigner les informations demandées dans le formulaire qui apparaît. Il est obligatoire de renseigner au moins une affiliation (Institution, Université, Grande-école, Partenaire privé), cela se fait de la même façon que la saisie d’un auteur ou d’un laboratoire. Une fois les informations sur le laboratoire saisies il faut cliquer sur « Ajouter ce laboratoire ».
Valider les informations d’un auteur
Puis valider en cliquant sur le bouton « Ajouter cet auteur ».
Documentation HAL Page 23/72
Si l’auteur que vous renseignez est connu dans la base, il faut cliquer sur son nom, le système récupère son ou ses laboratoires d’appartenance.
Ajout d’un auteur déjà enregistré
Si les informations sont correctes, vous pouvez valider, sinon il est possible de les modifier et de supprimer le laboratoire en cliquant sur la petite croix rouge à côté du libellé pour changer l’affiliation.
La petite croix permet de supprimer le laboratoire pour cet auteur.
En cliquant sur cette icône le laboratoire sera rattaché à tous les autres auteurs.
Le « i » permet d’afficher les informations d’un laboratoire valide du référentiel.
Documentation HAL Page 24/72
Vous pouvez également ajouter une liste d’auteurs appartenant à un laboratoire du référentiel HAL. Une fois le laboratoire sélectionné, une liste d’auteurs est établie à partir des précédents dépôts dans HAL. Il suffit de sélectionner le ou les auteurs et de cliquer sur le bouton « Ajouter ».
Liste des auteurs d’un laboratoire
Pour faciliter la saisie des auteurs, il est aussi possible de récupérer les affiliations que vous aurez déjà saisies pour des dépôts précédents en cliquant sur le lien « Sélectionner depuis mes auteurs ». Ensuite il suffit de sélectionner les auteurs concernés par le dépôt puis de cliquer sur « Ajouter ».
En cliquant sur cette icône, vous pourrez modifier les informations d’un laboratoire non valide dans le référentiel des laboratoires connus de HAL
Il est possible de déplacer un auteur par un glissé/déposé, pour modifier l’ordre des auteurs.
Pour éditer/modifier les informations de l’auteur il faut cliquer sur le crayon
Cliquer sur la croix rouge pour supprimer l’auteur. Il est aussi possible d’affilier un laboratoire à
un autre auteur par glissé/déposé.
Documentation HAL Page 25/72
Liste de mes auteurs
Une fois tous les auteurs affiliés à leur(s) laboratoire(s) vous pouvez passer à l’étape de transfert des fichiers en cliquant sur le bouton « Etape suivante ».
Documentation HAL Page 26/72
auteur(s) – laboratoire(s)
Cet écran est partagé en deux parties :
 à gauche la partie « auteur »  à droite la partie « laboratoire »
Dans la première partie vous allez renseigner les auteurs du document. Vous pouvez saisir individuellement les auteurs à l'aide du bouton « ajouter » en renseignant le prénom et le nom et éventuellement le courriel et l’URL de sa page perso.
Ajouter un auteur (1)
Documentation HAL Page 27/72
Ajouter un auteur (2)
Vous pouvez aussi importer par copier/coller depuis un document quelconque une liste d'auteurs (séparés par un caractère particulier : virgule, tiret, ...) en respectant l’ordre prénom nom à l’aide du bouton "ajouter une liste d'auteurs".
Documentation HAL Page 28/72
La deuxième partie est prévue pour renseigner les laboratoires des auteurs. Le bouton « sélectionner un laboratoire pré-renseigné » vous permet de rechercher votre laboratoire dans la liste des laboratoires connus de HAL.
Sélection d’un laboratoire
Documentation HAL Page 29/72
Si vous ne le trouvez pas, et uniquement dans ce cas, cliquez sur « ajouter » et renseignez la fiche de votre laboratoire.
Ajout d’un laboratoire En cas de besoin, le CCSD corrigera ou complètera votre saisie afin que cette fiche devienne la référence unique et complète de votre laboratoire. L’entrée libre d’un laboratoire par ce biais n’a aucune action sur la liste des laboratoires connus de Hal, et ne concerne que le document courant. L’utilisation abusive du bouton « ajouter » risquerait donc d’introduire des mauvais référencements de laboratoires ainsi que des doublons. Pour éviter cela il est préférable de faire une demande auprès du CCSD afin que le laboratoire soit enregistré dans la liste des laboratoires connus de HAL. Après être passé par ces deux étapes, il faut ensuite procéder à l’affiliation des auteurs aux laboratoires.
Documentation HAL Page 30/72
Association auteur(s) – laboratoire(s)
Le bouton central vous permet d'associer les auteurs et laboratoires que vous avez sélectionnés. Cette association est matérialisée par le numéro du laboratoire placé en exposant sur le nom de l'auteur. Un simple clic sur cet exposant permet d'annuler une association erronée. Il est possible d’associer plusieurs laboratoires à chaque auteur et tous les auteurs doivent être affiliés à au moins un laboratoire. Le bouton "Sélectionner depuis mes auteurs" vous permet d’avoir accès à la liste de tous les auteurs que vous avez déjà renseignés et de les réutiliser avec leur(s) laboratoire(s). Lorsqu’un auteur a été entré à partir du bouton "ajouter", une petite maison apparaît à côté de son nom ; il suffit de cliquer dessus pour que Hal examine dans l’ensemble des documents et notices déjà déposés s’il n’est pas possible de proposer un laboratoire pour cet auteur. Attention ! Le laboratoire n’est pas pris dans la « liste des laboratoires connus de Hal », mais inféré à partir de ce qui a été indiqué dans tous les dépôts antérieurs ; rien ne garantit donc, ni la correction des informations sur le laboratoire, ni celle de l’association. Si un laboratoire a été renseigné de façon erronée dans un dépôt antérieur, si l’auteur a un homonyme, ou s’il a changé de laboratoire, il peut y avoir des erreurs. Bien utilisée, la petite maison permet de gagner du temps ; mal utilisée, elle peut propager des erreurs ; une vérification rapide s’impose donc. Remarque : En cas de changement de laboratoire d’un auteur, en cas de changement de nom du laboratoire, ou encore en cas de fusion ou de séparation de laboratoires, la règle à appliquer sur Hal est la même que pour une publication dans un journal : c’est l’appartenance au moment de l’écriture et/ou de la publication du document qui doit être indiquée ; les changements ultérieurs de noms et de laboratoires ne sont pas pris en compte.
Recherche si elle existe, l’association de cet auteur dans tous les dépôts antérieurs.
Documentation HAL Page 31/72
3ème étape : déposer le(s) fichier(s)
Transfert de fichiers Pour déposer les fichiers (archives, compressés ou non) de votre article :
 indiquez le type de fichier (tex, .doc, .ps, .pdf, etc.) dans la liste déroulante de gauche  désignez le fichier sur votre disque dur par le bouton « Parcourir... » ou « Browse... »
correspondant  cliquez sur « Transférer » pour l'envoyer vers le serveur HAL, sinon vous ne pourrez pas
passer à l’étape suivante Vous pouvez transférer les fichiers par groupes de 5 au plus, autant de fois que nécessaire pour que l'article soit complet. En cas de fichiers multiples, pensez à un regroupement en un seul fichier compressé.
Etape de transfert des fichiers
Fichier(s) téléchargé(s) sur le serveur
Documentation HAL Page 32/72
Pour un dépôt au format TeX ou LaTeX, il est conseillé de vérifier avant le dépôt que la compilation se déroule sans problème (cf. §10.3) en utilisant "Tester la compilation Tex et Latex" dans l’onglet "Services" de la page d’accueil de Hal. Le compilateur intégré au système Hal permet uniquement l’inclusion d’images au format PostScript. Ces figures sont à transférer dans le même type de fichier que le document tex. Lors du dépôt de nouvelle version, HAL reporte tous les fichiers de la version précédente. S'ils sont devenus inutiles vous devez donc, soit les effacer (en cliquant sur la petite poubelle), soit télécharger des fichiers portant le même nom qui les remplaceront alors automatiquement. Pour les dépôts au format doc, rtf ou ps, HAL se charge automatiquement de créer un fichier PDF. Pour faciliter la lecture des documents déposés, il est parfois utile de déposer des « documents annexes » tels que le fichier de présentation d’un séminaire. Ceci est possible dans Hal une fois que le document principal a été déposé. Les deux types de documents ne doivent pas être confondus : par exemple, pour le dépôt d’une contribution à une conférence scientifique, le fichier principal doit être celui destiné aux actes de la conférence, le fichier annexe celui de la présentation orale. Pour les dépôts de documents annexes, choisissez dans la liste déroulante « Fichiers annexes (ppt, video, ...) » A noter : Si vous souhaitez transférer le(s) fichier(s) sur arXiv, il faut obligatoirement respecter les contraintes suivantes, imposées par arXiv :
 Fichier pdf : font de type 3 interdite, fichier unique avec taille < 1000kB et ne provient pas de TeX ou LaTex
 Fichier TeX ou LaTex : la taille du tar.gz de l'ensemble des fichiers doit être < 1000kB, la somme des tailles des fichiers doit être < 4000kB et individuellement, la taille de chaque fichier est < 2000kB
 Pour plus d'information consulter http://fr.arxiv.org/help/sizes
Après avoir effectué le transfert de tous les fichiers, il faut indiquer l’origine des fichiers déposés (fichiers « auteur » ou fichiers « éditeur ») avant de passer à l’étape suivante.
4ème étape : récapitulation
Ecran de récapitulation
Etape de récapitulation
Documentation HAL Page 33/72
Cette étape récapitule votre dépôt. Vous pouvez visualiser sur une seule page toutes les informations que vous avez saisies. Pour la physique, les mathématiques et une partie de la biologie, chaque fois que la sous discipline correspondante existe sur le serveur américain arXiv, le serveur Hal y envoie automatiquement une copie du document (sauf si le déposant annule ce transfert). Ce transfert peut être demandé seulement si le domaine de dépôt correspond à un domaine présent sur arXiv. Pour le domaine de physique, la soumission automatique aux journaux EPJ et EPL est proposée.
Vous pouvez aussi définir à ce niveau une mise en ligne immédiate ou différée. Attention, la mise en ligne différée annule le transfert sur arXiv.
6.2. Déposer une thèse ou une HDR
Vous êtes directement redirigé sur notre serveur de thèses en ligne (TEL).
Quelques explications Le dépôt des thèses (doctorat, thèses d’état, habilitations) doit se faire uniquement via un « environnement » spécialisé de HAL appelé TEL (thèses en ligne). En consultation dans Hal standard, les thèses apparaissent avec les autres documents, mais seules les thèses sont visibles dans l’interface de consultation de TEL. Un compte de déposant sur HAL est également valide sur TEL, de sorte que les contributeurs n’ont pas à recommencer la procédure d’enregistrement initial. Les métadonnées qui sont à remplir sont légèrement différentes, mais les lignes générales du dépôt sur Hal sont les mêmes. Il est obligatoire de déposer au moins un fichier visualisable de l’ensemble de la thèse, sous forme pdf (de préférence)
Cliquer sur déposer pour terminer le dépôt.
La mise en ligne du dépôt peut être différée.
Documentation HAL Page 34/72
ou ps, y compris la page de couverture. Ce fichier doit être unique et facile à imprimer ; c’est indispensable pour que le lecteur intéressé par le document puisse l’imprimer dans de bonnes conditions pour travailler avec. Pour les dépôts en format doc, rtf ou ps, TEL se charge automatiquement de créer un format pdf. De surcroît, le dépôt de fichiers source en nombre quelconque (images, fichiers tex, etc..) est encouragé. Enfin, il est très utile de déposer des fichiers annexes comme ceux contenant la présentation utilisée lors de la soutenance (fichier Powerpoint, enregistrement audio, etc..). En revanche, ne pas déposer les rapports rédigés par le jury, qui n’ont pas leur place sur TEL. Une particularité de TEL est qu’aucun examen scientifique du document, même rudimentaire, n’est effectué, puisque le contenu a déjà été examiné par le jury. Il est demandé au déposant de télécharger la version qui contient compte de toutes les corrections demandées par le jury ; le cas échéant, si ces corrections sont absentes du premier dépôt, une seconde version doit impérativement être déposée pour remédier au problème.
1ère étape : renseigner les auteurs et les laboratoires
Même fonctionnalité que pour le dépôt avec texte intégral (cf. §6.1)
Etape auteur-laboratoire
Documentation HAL Page 35/72
2ème étape : renseigner les métadonnées
La date de soutenance doit être une date passée.
Le résumé doit être donné en français ou dans la langue du document si ce n'est ni le français ni l'anglais.
Il doit obligatoirement être saisi en anglais.
Documentation HAL Page 36/72
Formulaire de saisie des métadonnées pour une thèse
Vous devez renseigner le titre complet de votre dépôt. Le résumé doit être donné en français ou dans la langue du document si ce n'est ni le français ni l'anglais, il doit obligatoirement être saisi aussi en anglais ensuite.
Choisir le pays auquel appartient l’organisme.
Possibilité de rechercher sur la première lettre du libellé.
Cliquer sur l’organisme pour l’ajouter dans la zone.
Documentation HAL Page 37/72
Vous avez la possibilité de déposer votre document dans plusieurs domaines (crosspostage) et de définir plusieurs organismes de délivrance, plusieurs écoles doctorales (dans le cas d’une thèse) et plusieurs spécialités (dans le cas d’une thèse). Si et seulement si vous ne trouvez pas votre organisme, votre école ou votre spécialité vous avez la possibilité de les saisir dans la zone de saisie en bas de la liste. Les zones « directeur de thèse » pour une thèse ou « président du jury » pour une HDR et « composition du jury » sont à remplir en respectant l’ordre prénom nom. Vous pouvez aussi indexer votre document avec des mots clés pour faciliter les recherches.
Transfert de fichier(s) Cette page vous permet de déposer le ou les fichiers de votre thèse. Il est nécessaire de déposer un fichier visualisable de l'ensemble de la thèse (pdf, ps, html) comprenant la page de couverture de celle-ci, afin que les lecteurs puissent imprimer un document commode à lire et à conserver. S'ils sont disponibles, il est recommandé d'y ajouter des fichiers source (TeX, doc par exemple), mais ce n’est pas obligatoire. En cas de fichiers multiples, pensez à un regroupement en un seul fichier compressé. Pour cela :
 indiquez le type de fichier dans la liste déroulante de gauche  désignez le fichier sur votre disque dur par le bouton « Parcourir... » ou « Browse... »  cliquez sur « Transférer » pour l'envoyer vers le serveur TEL.
Vous pouvez transférer les fichiers par groupes de 5 au plus, autant de fois que nécessaire pour que la thèse soit complète. Lorsque c'est le cas, cliquez sur « étape suivante ». Pour les dépôts au format doc, rtf ou ps, TEL se charge automatiquement de créer un fichier pdf. Vous pouvez également déposer des documents annexes, comme par exemple la présentation faite lors de la soutenance. Pour cela, choisissez dans la liste déroulante « Fichiers annexes (ppt, video, ...) ».
Etape transfert de fichier(s)
Documentation HAL Page 38/72
Lors du dépôt de nouvelle version, TEL reporte tous les fichiers de la version précédente. S'ils sont devenus inutiles vous devez donc, soit les effacer (en cliquant sur la petite poubelle), soit télécharger des fichiers portant le même nom qui les remplaceront alors automatiquement.
Cette étape récapitule votre dépôt et vous n’avez plus qu’à cliquer sur « Déposer » pour le valider. Il est recommandé de relire toutes les informations saisies, les corriger si nécessaire en navigant dans les quatre étapes du dépôt à l’aide des boutons « étape suivante » et « étape précédente ».
6.3. Déposer un document avec lien sur arXiv
Quelques explications Pour un dépôt avec lien sur arXiv, il est nécessaire de fournir les références complètes du lien ; bien noter le domaine arXiv afin de faire la nouvelle entrée dans le domaine correspondant dans Hal.
1ère étape : serveur
Cliquer sur « Déposer » pour terminer le dépôt.
Documentation HAL Page 39/72
Lien sur arXiv Vous devez renseigner l’identifiant du document à récupérer sur le serveur arXiv. Le lien « Vérifier ici votre lien » vous permet de tester si le document correspondant est trouvé sur arXiv.
Les métadonnées sont renseignées par défaut à partir des données récupérées sur arXiv, vous avez la possibilité de les compléter.
3ème étape : renseigner les auteurs et les laboratoires Même fonctionnalité que pour le dépôt avec texte intégral (cf. §61).
4ème étape : récapitulation Cette étape récapitule votre dépôt et vous n’avez plus qu’à cliquer sur « Déposer » pour le valider.
Documentation HAL Page 40/72
6.4. Déposer une référence bibliographique
Quelques explications Les dépôts du type « référence biblliographique » ne sont pas consultable (par défaut) dans la base Hal. Les références bibliographiques (notices) doivent être utilisées lorsqu’on ne dispose pas du texte intégral, ou s’il existe une raison pour ne pas le rendre public. Elles ne sont pas un moyen indirect pour donner accès à un texte intégral sans le déposer sur Hal, par exemple en y incluant un lien http vers un site personnel, de laboratoire, d’un autre serveur, etc. Le CCSD ne propose aux lecteurs que des liens dont il peut garantir la stabilité à long terme. Il est possible de transformer une notice en dépôt de texte intégral (cf. §7.1), par exemple lorsqu’on retrouve ultérieurement le(s) fichier(s) contenant ce texte intégral. Pour un tel dépôt, il faut disposer de l’ensemble des références de publications et, le cas échéant, d’un lien arXiv ou DOI vers le texte intégral qui enrichira la notice. Tous les auteurs doivent être mentionnés, mais la donnée de l’affiliation (laboratoire) n’est obligatoire que pour l’un d’entre eux au moins. Le dépôt d’un lien DOI est recommandé, ainsi que celui de diverses données comme le résumé, les mots clé, les références PACS, les commentaires, etc. Aucun transfert ne sera fait vers arXiv pour ce type de dépôt. Les types de références bibliographiques sont :
 articles dans des revues avec comité de lecture  articles dans des revues sans comité de lecture  conférences invitées  communication avec actes  communication sans acte  Ouvrages scientifiques  Chapitres d’ouvrages scientifiques  Directions d’ouvrages  Brevets  Autres publications
Ce type doit obligatoirement être précisé pour tout dépôt de référence bibliographique. Les métadonnées à renseigner seront différentes selon le type de la référence choisi.
Documentation HAL Page 41/72
Documentation HAL Page 42/72
Formulaire de saisie des métadonnées (publications pour des revues à comité de lecture)
Le résumé peut être saisi en plusieurs langues et vous devez privilégier la langue du document. Pour les références qui nécessitent la précision d’un journal, la liste des journaux est proposée dans une fenêtre pop-up lorsque vous vous positionné dans la zone de texte correspondante ou lorsque vous cliquez sur « voir la liste ». Si vous ne trouvez pas votre journal dans la liste des domaines (liste déroulante en haut de la page), et seulement dans ce cas, vous avez la possibilité de l’ajouter dans la zone prévue à cet effet en bas de la page. Attention de bien sélectionner le domaine auquel il appartient, avant de cliquer sur le bouton « Ajouter ». Ce journal sera validé par le CCSD après vérification. La saisie de mots clés permet d’indexer votre document pour faciliter les recherches.
Documentation HAL Page 43/72
2ème étape : renseigner les auteurs et les laboratoires Même fonctionnalité que pour le dépôt avec texte intégral (cf. §5.1) mis à part le fait que seule une affiliation « auteur-laboratoire » est obligatoire.
3ème étape : récapitulation
Cette étape récapitule votre dépôt et vous permet de le valider en cliquant sur le bouton « Déposer ». Vous pourrez ultérieurement déposer le texte intégral correspondant depuis votre espace personnel (cf. §7.1) en cliquant sur « ajouter le fichier » après avoir sélectionné la notice.
Documentation HAL Page 44/72
7. Mon espace
7.1. Mes dépôts Dans cet espace vous accédez à la liste de vos documents :
 pour lesquels des modifications vous ont été suggérées  en attente de vérification  que vous avez déposés et qui sont accessibles en ligne
Pour modifier un document dont vous êtes le contributeur, il suffit :
 d’aller dans la rubrique « Mon espace > Mes dépôts »,  de sélectionner le document  de cliquer sur le bouton correspondant à l’action que vous souhaitez : modifier les
métadonnées, créer une nouvelle version, ajouter/modifier la référence de publication, ajouter un domaine, ajouter le fichier pour une notice, transférer la propriété.
Si vous avez le statut de référent laboratoire, vous pouvez modifier les métadonnées des documents liés au laboratoire en question, en cliquant sur le bouton « Modifier les métadonnées » à partir de la fiche concise ou détaillée du document. Si vous n’êtes ni contributeur, ni référent laboratoire, il est possible de modifier avec les identifiant/ mot de passe du document. La simple modification de métadonnées (correction de l’orthographe d’un nom, ajout d’un prénom, affiliation inexacte, etc.) peut se faire sans création de nouvelle version et n’est pas transféré sur arXiv. Lorsque les métadonnées d’un dépôt sont modifiées par quelqu’un d’autre que le premier déposant, ce dernier est automatiquement alerté par un message électronique, afin de pouvoir vérifier ce qui a été fait. Notez qu’il n’est pas possible de supprimer un domaine pour une publication. Si vous souhaitez modifier le fichier de votre dépôt il est nécessaire de déposer une nouvelle version. Lors du dépôt d’une version supplémentaire d’un document, le serveur Hal propose par défaut la récupération de toutes les informations de la version précédente, métadonnées et fichiers de textes ou de figures. Toutes les modifications sont possibles à la main dans les champs de métadonnées. Pour le remplacement des fichiers, il suffit de télécharger de nouvelles versions portant les mêmes noms que les fichiers à remplacer ; Hal remplacera les anciens par les nouveaux (en revanche, si le
Documentation HAL Page 45/72
nom des fichiers sont différents, Hal risque de juxtaposer des versions différentes du document, ce qui n’est pas souhaitable). Les versions précédentes seront conservées sur le serveur, mais les utilisateurs seront redirigés par défaut vers la dernière version. Si un auteur estime nécessaire de faire savoir qu’il ne considère plus son texte comme scientifiquement correct, il peut se rétracter en téléchargeant une version supplémentaire contenant par exemple les mots "article retiré par son auteur pour des raisons scientifiques", et donner plus de détails dans le champ "commentaires".
7.2. Mes statistiques
Vous pouvez choisir de consulter les statistiques de vos dépôts, des dépôts dont vous êtes auteur ou des dépôts de votre laboratoire pour les « référents laboratoire ».
Une fois le type sélectionné, vous devez définir le nombre de dépôt à afficher, le tri (date de mise en ligne, par défaut, consultation de la fiche concise, consultation de la fiche détaillée, consultation du ou des fichiers) ainsi que l’ordre (croissant ou décroissant) et le type des dépôts (article ou notice).
Documentation HAL Page 46/72
Cette fonctionnalité présente le nombre de consultation de la page concise, de la page détaillée et le nombre de téléchargement des fichiers.
Documentation HAL Page 47/72
7.3. Mes alertes Si vous vous êtes abonnés aux alertes automatiques vous allez pouvoir consulter, ajouter, modifier ou même supprimer un de vos abonnements dans la rubrique « Mon espace > Mes alertes ». Pour ajouter un abonnement :
 cliquer sur [+]  se positionner sur l’onglet correspondant au nouvel abonnement  renseigner les critères souhaités  cliquer sur « modifier ».
Pour supprimer un abonnement, cliquer sur le [-] correspondant.
http://hal.archives-ouvertes.fr/index.php?action_todo=subscribe
7.4. Mon compte Cette rubrique vous permet de consulter et de modifier les informations que vous avez renseignées lors de votre inscription. Si vous changez d’adresse mail, vous pouvez la modifier vous-même dans cette rubrique. Seul le champ identifiant (ou login) n’est pas modifiable.
Documentation HAL Page 48/72
8. Consultation des documents L’onglet « Consulter » donne accès à tous les documents disponibles en texte intégral dans Hal, y compris ceux où le texte intégral est fourni par un lien vers arXiv ou Tel. En revanche, les notices bibliographiques dépourvues de ces liens ne sont pas visibles (pour y avoir accès, voir §9). La consultation de documents peut se faire :
 par domaine  sur les 30 derniers dépôts faits avec texte intégral  par date de publication  par type de publication  par collection  par environnement (HAL-SHS, HAL-INRIA, HAL-INSERM, ...)  par établissement (extraction automatique)  sur arXiv (redirection sur le site d’ arXiv )  sur TEL pour la consultation des thèses
http://hal.archives-ouvertes.fr/index.php?action_todo=menu&to_open=browse Lors de la consultation d’un dépôt, il est possible de le récupérer au format BibTeX, EndNote et TEI ou de le transférer dans votre bibliothèque RefWorks.
Documentation HAL Page 49/72
9. Recherche de documents
Dans cette rubrique vous avez accès à plusieurs moteurs de recherche.
 Recherche simple : vous donne la possibilité de rechercher une expression sur n’importe quel champ.
 Recherche avancée : vous permet d’affiner votre recherche et de définir plusieurs critères de recherche.
Dans ces deux types de recherche vous pouvez choisir un ordre d’affichage. Pour voir les notices dans le résultat de vos recherches, il ne faut pas oublier de cocher la case « voir également les notices bibliographiques ».  L’accès par identifiant vous permet de rechercher un document précis, il suffit pour cela de
renseigner son identifiant complet et éventuellement sa version puis de cliquer sur « Rechercher ».
Pour la recherche d’une thèse vous serez redirigé sur le moteur de recherche de TEL.
http://hal.archives-ouvertes.fr/index.php?action_todo=menu&to_open=search
Documentation HAL Page 50/72
10.1. S’abonner
Dans la rubrique « Services > S’abonner », vous avez la possibilité de vous abonner pour recevoir les nouvelles publications déposées en choisissant des critères tels que l’instance, la fréquence, le type, le domaine, etc. Vous avez aussi la possibilité de définir plusieurs abonnements en cliquant sur le [+]. Après avoir renseigné toutes les données un compte abonné vous sera créé et vous pourrez vous connecter sur HAL, pour modifier les données de votre compte ou modifier votre abonnement.
Documentation HAL Page 51/72
Si vous souhaitez par la suite devenir contributeur afin d’effectuer des dépôts, vous pouvez, après vous êtes authentifié, modifier votre compte en cliquant sur le lien « modifier mon compte pour devenir un contributeur » dans « Mon espace > Mon compte » ; l’écran suivant apparaîtra.
Pour devenir contributeur, il vous sera nécessaire de fournir des informations supplémentaires telles que votre langue préférée, le nom de votre laboratoire, votre domaine de dépôt préféré et si vous souhaitez être reconnu par l’application comme auteur associé par défaut.
Documentation HAL Page 52/72
10.2. Consulter les laboratoires connus de HAL
Cette rubrique vous permet de rechercher les laboratoires connus de la base de données de HAL et de consulter leur fiche (sigle, Intitulé, url, etc.) Si votre laboratoire n’apparaît pas dans Hal, ou si vous remarquez une erreur ou omission, prière de le signaler à hal.support@ccsd.cnrs.fr en fournissant une information exacte et complète :
 nom  nom abrégé (sigle)  code CNRS si c’est le cas (UPR, UMR, etc.)  ensemble des tutelles (université, grande école, etc.)  adresse  pays
http://hal.archives-ouvertes.fr/index.php?action_todo=search_known_labo
10.3. Tester la compilation Tex/LaTeX
Ecran : Test de compilation
Cette fonctionnalité permet de tester une compilation avant d’effectuer un dépôt. Pour cela :
 transférez le ou les fichiers (pensez au fichier compressé) sources (TeX, LaTex, figures, styles, etc.) permettant la compilation. Vous pouvez transférer les fichiers par groupes de 5 au plus, autant de fois que nécessaire pour que l'article soit complet.
 cliquez sur « Compiler » Comme le serveur Hal vérifie avant d’accepter le document que la compilation TeX de l’ensemble des fichiers est possible, le dépôt ne sera pas accepté s’il en manque un seul. Le compilateur de Hal contient déjà un très grand nombre de macros, styles et classes, mais en cas d’utilisation d’une macro ou d’un style très spécifique il est nécessaire de fournir cet élément en même temps que le fichier TeX.
http://hal.archives-ouvertes.fr/index.php?action_todo=try_compilation
Documentation HAL Page 53/72
11. Extraction des données
11.1. Récupération d’url Il est possible de faire des liens sur une liste de publications :
 en passant par le moteur de recherche (simple, avancée ou par identifiant) (cf. §9), vous pouvez récupérer l’URL qui s’affiche sous le résultat pour obtenir un lien sur la page affichée.
 dans la rubrique « Services > Exporter une liste de résultats », vous pouvez construire votre fiche personnelle, la fiche personnelle de votre laboratoire, ... dans le format souhaité et créer une adresse que vous pourrez réutiliser dans vos sites. Vous pourrez également l'exporter localement dans le format souhaité. Cette fiche sera automatiquement actualisée si de nouveaux dépôts sont effectués depuis sa création.
 en utilisant une URL courte du type o http://hal.archives-ouvertes.fr/hal-XXXXXXXX où XXXXXXXX est le numéro du
document, pour accéder à la dernière version du document. o http://hal.archives-ouvertes.fr/hal-XXXXXXXX_N pour accéder à une version
antérieure numérotée N=1,2,... o http://hal.archives-ouvertes.fr/lab/nomlabo pour avoir un lien sur la liste des
publications liées au laboratoire « nomlabo » (sigle, nom du laboratoire, etc.) o http://hal.archives-ouvertes.fr/aut/lastname ou http://hal.archives-
ouvertes.fr/aut/firstname+lastname pour avoir un lien sur la liste des publications d’un auteur
o http://hal.archives-ouvertes.fr/autlab/lastname/nomlabo ou http://hal.archives- ouvertes.fr/autlab/firstname+lastname/nomlabo pour avoir un lien sur la liste des publications de l’auteur « nomauteur » appartenant au laboratoire « nomlabo »
 en passant par un tampon, ce qui permet de récupérer une URL du type http://hal.archives- ouvertes.fr/nomtampon (cf §12)
11.2. Exporter une liste de publication Cette fonctionnalité permet aux chercheurs ou aux laboratoires d’extraire leur production scientifique pour insertion dans un document tel qu’un rapport par exemple, avec des possibilités de personnalisation de la présentation (ordre des données, présence ou non du titre, etc.). Sont alors pris en compte les documents dont les métadonnées contiennent une référence bibliographique, qu’ils soient consultables ou non en texte intégral. Disponible dans « Services > Exporter une liste de publications », elle est décomposée en plusieurs étapes :
Documentation HAL Page 54/72
 rechercher la liste à exporter par l’intermédiaire d’un moteur de recherche semblable à celui de la recherche avancée.
 sélectionner les documents à exporter
Sélection des métadonnées et du type du fichier
 sélectionner les métadonnées à récupérer (titre, auteur(s), etc.) dans l’ordre souhaité  choisir un format d’export  cliquer sur « Exporter cette liste de publication »
Le fichier sera ensuite généré.
http://hal.archives-ouvertes.fr/index.php?action_todo=export
11.3. Exporter une liste de publication en regroupant les données de HAL et PubliCNRS
Vous exportez dans cette rubrique une liste de publication qui regroupe les dépôts faits dans HAL et les données de publiCNRS. Les types de références bibliographiques sont ceux que distingue le CNRS dans les rapports de recherche et le ministère pour les rapports quadriennaux des laboratoires. L'équivalence avec publiCNRS est la suivante :
 publications dans les revues à comité de lecture → article de périodique (ART)+avec comité de lecture (ACL)
 conférences invitées dans les congrès → congrès, colloque (COL)+conférence invitée (INV)  proceedings à comité de lecture → congrès, colloque (COL)+actes (ACT)  publication dans les revues sans comité → article de périodique (ART)+sans comité de
lecture (SCL)
Documentation HAL Page 55/72
 communication à des congrès, symposium → congrès, colloque (COL)+communication (COM)
 séminaire, workshop → congrès, colloque (COL)+ orale (ORA), poster (POS)  chapitre dans les ouvrages → contribution à un ouvrage, chapitre (COV)  livres et ouvrages → ouvrage (OUV)  brevets → brevet (BRE)  thèses, mémoire, HDR → travail universitaire (TRU)  autres → rapport (RAP), autre (AUT)
 rechercher la liste à exporter par l’intermédiaire d’un moteur de recherche semblable à celui
de la recherche avancée.  sélectionner les documents à exporter
Le fichier sera ensuite généré. Si vous souhaitez retrouver et exporter la totalité des dépôts de publiCNRS, ne sélectionnez aucun type de publication.
http://hal.archives-ouvertes.fr/index.php?action_todo=export_publicnrs
Documentation HAL Page 56/72
11.4. Flux RSS Le flux RSS permet d’obtenir toutes les publications déposées sur HAL dans la journée sans passer par l’interface web. C’est un fichier contenant le titre des articles, une courte description et un lien vers une page décrivant plus en détail l’article. Il est nécessaire de disposer d’un outil spécifique, appelé « lecteur de flus rss » pour visualiser correctement ce flux. Ce flux est accessible par l’adresse suivante : http://hal.archives-ouvertes.fr/rss.php.
Il est possible d’ajouter des paramètres à cette URL afin d’affiner ou d’élargir la liste.
 Language : en (valeur par défaut), fr  from : daily (valeur par défaut), weekly, monthly, yearly, all (seulement pour une recherche sur
un auteur)  published : year, start year-end year  format : fulltexte (valeur par défaut), withoutfile (ajoute les notices au résultat)  author : nom de l’auteur  tampon : nom du tampon  domaine : code du domaine  lab : nom du laboratoire (sigle, nom, affiliation)
Exemple : http://hal.archives-ouvertes.fr/rss.php?from=monthly&lab=lkb renvoi les publications déposées durant le dernier mois pour le laboratoire LKB.
Documentation HAL Page 57/72
12. Les collections Le dépôt de « tampons électroniques » permet une forme de certification dans Hal. Il ne s’agit pas de retirer des documents déposés par d’autres, ce qui serait contraire aux principes généraux de fonctionnement de la base et à ceux de OAI. Les tampons permettent uniquement d’apposer une sorte de validation à une sélection de documents de Hal, sans les modifier. L’opération se fait sous l’unique responsabilité du « tamponneur », qui détermine donc en quelque sorte la « valeur » du tampon. La sélection correspondante apparaît seule dans une extraction automatique de la base par tampon, appelée « collection », indépendamment de tous les autres documents contenus dans Hal. Il n’y a pas de limitation sur le nombre de tampons de Hal, ni sur le nombre de tampons distincts qu’un document donné peut recevoir. Le tamponnage se fait pour chaque document version par version. Tout lecteur peut donc demander la création d’un tampon personnel à son nom pour constituer une liste des articles qui l’intéressent ; c’est une utilisation possible. Plus officiellement, un responsable de laboratoire ou d’établissement peut demander la création d’un tampon avec un nom institutionnel, afin de construire facilement une liste visible d’articles reconnus officiellement en mettant un lien vers cette liste depuis le site internet officiel de son unité. Les tampons, combinés à la garantie d’url stables (hal.archives-ouvertes.fr/NOM_DE_LA_COLLECTION), peuvent également être très utiles pour la constitution d’épi-journaux ou de celle d’actes de congrès. La création d’une collection se fait sur simple demande au ccsd. Hal met à jour automatiquement des extractions automatiques contenant tous les documents ayant recueilli un même tampon, qu’on appelle « collections ». Elles sont personnalisables : choix des logos, modification de la page d’accueil… Un laboratoire peut s’il le désire se rendre propriétaire d’un tampon, certifier au passage tous les articles qu’il reconnaît comme faisant partie de sa production, et demander la création d’une extraction personnalisée sur ce tampon. Il lui suffira ensuite de mettre sur son site web un lien intitulé « articles scientifiques récents » pour obtenir un affichage instantané et à jour de sa production, ce qui joue alors le rôle de « présentoir électronique ». Une collection peut être :
 en mode manuel, où le tamponneur contrôle l'entrée de chaque document.  en mode automatique, où tous les documents correspondant à un certain critère sont
tamponnés automatiquement, le tamponneur pouvant ensuite détamponner les articles indésirables des imposteurs.
Le « tamponneur » responsable d’une collection va avoir accès à un module spécifique dans hal (menu « Mon Espace > Mes privilèges > Gérer mes collections »).
Documentation HAL Page 58/72
Ce module va permettre :
 de tamponner des articles  de consulter les articles en attente d’être tamponnés  de consulter la liste des tampons d’un article  de « détamponner » des articles  de personnaliser sa collection
12.1. Tamponner un article
Ajout d’un tampon à un article
Pour tamponner un article, il faut saisir son identifiant, sa version. Le système affiche alors la notice de l’article à tamponner. Si vous êtes responsable de plusieurs collections, il faut aussi choisir dans la liste le tampon à mettre. Cliquer ensuite sur le bouton « Tamponner ». Vous pouvez aussi tamponner plusieurs articles à la fois en consultant la liste des articles non encore tamponnés (cf. §12.2)
Documentation HAL Page 59/72
12.2. Consulter les articles en attente d’être validés.
Consultation de la liste des articles non encore tamponnés
Sélectionnez votre tampon si vous en avez plusieurs puis cliquez sur « Consulter » pour afficher la liste.
Liste des articles non encore tamponnés
A partir de cette liste vous pouvez tamponner plusieurs articles à la fois. Pour cela, sélectionnez les articles à tamponner puis cliquez sur le bouton « Tamponner les articles sélectionnés ». Si dans la liste, il y a des articles que vous ne souhaitez pas faire apparaitre dans la collection et ne plus voir dans cette liste, sélectionnez les et cliquez sur le bouton « Supprimer les articles sélectionnés de la liste ».
12.3. Consulter la liste des tampons d’un article
Consulter la liste des tampons d’un article
Saisir l’identifiant de l’article puis cliquer sur « Consulter » pour avoir la liste des tampons d’un article.
Documentation HAL Page 60/72
Liste des tampons d’un article
Une page s’affiche avec le récapitulatif du dépôt ainsi que la liste de ses tampons.
12.4. « Détamponner » des articles
« Détamponnage » d’un article
Pour retirer le tampon d’un article, il faut saisir son identifiant, sa version, sélectionner le tampon s’il y en a plusieurs puis cliquer sur le bouton « Détamponner ». Lorsque l’identifiant est renseigné, les informations du dépôt s’affiche.
12.5. Personnalisation de l’interface web de la collection
Paramétrage de l’interface d’une collection
La personnalisation permet :
 L’ajout de logos (et/ou de titres) ;  La modification des onglets pour la présentation des articles tamponnés ;  L’insertion d’une page de présentation de la collection ;
Documentation HAL Page 61/72
 La modification de la feuille de style de la collection ;
12.5.1. Présentation de l’interface de la collection L’interface web d’une collection est structurée en 3 parties :
1- La partie « en-tête » : permet de placer des logos (images ou texte) pour présenter la collection
2- La partie « onglets » : permet d’accéder aux articles tamponnés triés de certaines façons (par auteur, par date de dépôt, …)
3- Le « corps » de la collection : liste d’articles, fiche détaillée, page de présentation de la collection, …
Exemple de la collection du LKB (http://hal.archives-ouvertes.fr/LKB)
12.5.2. Configuration générale Ci-dessous la présentation des modifications qui peuvent être apportées dans la parte « Configuration générale »  Langues de l’interface
L’interface de la collection peut-être multi-langues. Pour rajouter une langue, il suffit d’en sélectionner une dans la liste de gauche. La première langue du tableau indique la langue par défaut de la collection.
Documentation HAL Page 62/72
 Choix des logos pour la partie « en-tête »
La partie « en-tête » de la collection peut contenir autant de logos que l’on souhaite. Pour en rajouter un, il suffit de cliquer sur le bouton « Ajouter un logo de type texte » ou « Ajouter un logo de type image ». Chaque type de logo va nécessiter des informations spécifiques. Pour un logo de type « texte », il faut renseigner :
- le champ « fr » : texte qui apparaîtra dans l’interface en français - le champ « en » : texte qui apparaîtra dans l’interface en anglais - le champ « class » : nom du style CSS à appliquer au texte
Pour un logo de type « image », il faut renseigner : - le champ « file » : fichier (jpeg, gif) à déposer sur le serveur hal si l’image n’a pas déjà
été déposée ou le champ « src » : le nom du fichier si l’image a déjà été déposée sur le serveur
- le champ « link » (facultatif) : un lien vers une page web. L’image sera alors cliquable - les champs « width » et « height » (facultatif) : taille de l’image - le champ « alt » (facultatif): message qui apparaîtra au survol de l’image
L’ordre d’apparition des logos dans la collection correspondra à l’ordre des logos dans l’interface de paramétrage. Il est possible de modifier cet ordre par simple glissé/déplacé
. Déplacement d’un bloc « logo »
Modifier l’ordre par glissé/déposé (cf. copie d’écran suivante).
Documentation HAL Page 63/72
 Choix des onglets
Cette partie permet de définir la liste des onglets qui seront affichés dans l’interface de la collection
o Onglet Accueil : page d’accueil / présentation de la collection o Onglet Consultation :
 Liste des articles : Affichage de tous les articles ordonnés par date de publication
 Année : Affichage des articles tamponnés classés par date de publication  Domaine Scientifique : Affichage des articles tamponnés classés par domaine
de dépôt (physique, sciences du vivant, …)  Liste par type de document : Affichage des articles tamponnés classés par
type de document (article publié, thèse, …)  Liste par auteur : Affichage des articles tamponnés classés par auteur  Liste par auteur du laboratoire: Affichage des articles tamponnés classés par
auteur appartenant au laboratoire renseigné dans le champ « Critère labo des auteurs ».
 Liste par laboratoire : Affichage des articles tamponnés classés par laboratoire
 Liste par laboratoire de l’affiliation: Affichage des articles tamponnés classés par laboratoire appartenant à l’institution renseignée dans le champ « Critère institution ».
 Par équipe de recherche : Affichage des articles tamponnés classés par équipe de recherche
 Par sous collection : Affichage des articles tamponnés classés par sous collections (par exemple pour des départements)
o Onglet Recherche :  Recherche : Ajout d’un moteur de recherche  Recherche avancée : Ajout d’un moteur de recherche offrant plus de
possibilités sur les critères de recherche  Recherche par identifiant : Ajout d’une recherche sur l’identifiant d’un article
o Onglet Service  Export d’une liste de publication : Ajout de la fonctionnalité d’export de liste de
publications o Onglet Lien
 lien : permet d’ajouter un onglet avec un lien vers une page web (exemple d’un tampon d’un laboratoire : lien vers le site web du laboratoire)
Documentation HAL Page 64/72
Remarque : o Un lien peut être ajouté dans n’importe quelle partie (Accueil, Consultation,
Recherche, Service ou Liens. o Si une rubrique ne contient pas de sous menu, l’onglet n’apparait pas, sauf pour
Pour sélectionner les onglets, ou modifier leur ordre il suffit de cliquer sur le petit carré jaune en face de la zone à déplacer et de la faire glisser à l’endroit voulu.
Sélection de rubrique
 Nombre d’articles affichés par page
Définition du nombre d’articles à afficher par page  Couleurs alternées
Définition des deux couleurs de fond alternées qui serviront lors de l’affichage des articles à l’écran.
Ouverture du lien dans : - la même fenêtre (_self) - une nouvelle fenêtre (_blank)
Libellé du lien en français
Documentation HAL Page 65/72
12.5.3. Personnalisation de la page d’accueil et de la feuille de style CSS
Il est possible de personnaliser la page d’accueil et la feuille de style CSS de la collection. Cependant, il faut connaître un minimum le langage HTML et CSS pour le réaliser.  Page d’accueil Pour changer la page d’accueil, sélectionner le fichier à modifier (home_fr.php pour la page d’accueil de la version française) puis cliquez sur « ok ».
Une page apparait et vous permet d’écrire directement le code HTML de votre page d’accueil ou d’effectuer un copier/coller. Vous pouvez aussi télécharger un fichier stocké sur votre disque par l’intermédiaire du champ « parcourir ».
Documentation HAL Page 66/72
Cliquer sur « Enregistrer les modifications apportées au fichier home_fr.php » pour que vos modifications soient prises en compte.  Feuille de style Pour changer la feuille de style, cliquez sur « ok » dans la partie « Style CSS ».
Une page apparait et vous permet de modifier directement le fichier css.
Cliquer sur « Enregistrer les modifications apportées au fichier style.css » pour que vos modifications soient prises en compte.
Documentation HAL Page 67/72
12.6. Statistiques de la collection
Vous avez la possibilité de visualiser différentes sortes de statistiques : répartition, cumul, évolution... Répartition d’articles par domaine pour une collection donnée :
Vous pouvez consulter la répartition des dépôts par sous domaines en cliquant sur le domaine.
Documentation HAL Page 68/72
Répartition d’articles par type de publication :
Documentation HAL Page 69/72
Cumul des dépôts :
Documentation HAL Page 70/72
Evolution des dépôts :
Pour chaque graphique il est possible de récupérer les données au format csv en cliquant sur le bouton « Récupérer les données ».
Documentation HAL Page 71/72
13.1. A propos des notices de publiCNRS… Les notices de publiCNRS n’ont pas été importées dans HAL. Elles ne sont exploitables au travers de HAL qu'en mode génération de listes dans la rubrique « Services> Exporter une liste de publication en regroupant les données de HAL et publiCNRS". Attention, pour retrouverez toutes les publications dans cette rubrique, il ne faut pas sélectionner de type de publication. Si vous souhaitez que vos notices soient réintégrées dans HAL vous pouvez le faire via une reprise systématique et à la main, des métadonnées dans la rubrique « Déposer > Réintégrer une notice de publiCNRS dans HAL ».
Récupération d’une notice publiCNRS
Important : HAL est une base de données essentiellement orientée texte intégral afin d'offrir avant tout un outil scientifique aux chercheurs. Néanmoins nous avons offert la possibilité d'inclure des notices bibliographiques afin que les laboratoires qui le souhaitent puissent extraire de HAL des listes exhaustives de leurs publications, dans tous les formats possibles et à tous les niveaux (chercheurs, laboratoires, établissements, etc.). Nous avons pris le soin de faire un modèle de données permettant sur cette archive ouverte d'offrir toutes les vues institutionnelles et cela en collectant de façon la plus rigoureuse possible, une relation exacte entre chaque auteur, son laboratoire et les tutelles de ce laboratoire. La qualité des données recueillies dans PubliCNRS n’a pas permis la réintégration automatique de ces données dans HAL.
13.2. HAL et Labintel Les dépôts associés à un (ou plusieurs) laboratoire affilié au CNRS et leurs mises à jour sont automatiquement basculés de HAL vers Labintel tous les jours.
13.3. HAL et CRAC Le système HAL est interconnecté avec l'application CRAC, c'est à dire que les chercheurs ayant rentré leurs publications dans HAL retrouvent la liste de ces dépôts dans la fiche chercheur.
Documentation HAL Page 72/72
13.4. Import de documents Un outil d’import permet d’importer automatiquement dans Hal des ensembles de documents sans passer par l’interface web. Ainsi en constituant un fichier de données structuré au format XML, il est possible d’insérer des documents dans la base de données. Pour pouvoir utiliser ce service d’import massif, il faut d’abord disposer d’un compte sur HAL et demander l’autorisation auprès de l’équipe HAL. L’import nécessite donc la création d’un fichier compressé incluant
 le fichier XML respectant la structure de données définie par le schéma XML de HAL  les textes intégraux qui peuvent être des fichiers PDF, Word etc.
L'adresse de la documentation technique qui explique l'utilisation de l'API est la suivante :
http://import.ccsd.cnrs.fr/doc/?instance=hal Prochainement des Web Services vont être mis en place pour permettre l'interfaçage avec la base de données de HAL, une documentation détaillée définissant les méthodes d'accès aux services de consultation des référentiels et de dépôt d'article sera bientôt disponible.
13.5. Import et EndNote Un service est disponible depuis peu pour vous permettre de créer à partir d’un fichier EndNote, une ébauche de fichier XML reprenant vos données. Pour cela, il vous faut à partir d'EndNote, exporter votre fichier avec le format XML. En uploadant ce fichier à l'URL http://import.ccsd.cnrs.fr/import/EndNote/filtreEndNoteXML.php, vous obtiendrez un fichier respectant la structure de HAL. Mais ce fichier n'est en aucune façon le fichier finalisé. Il vous revient de le complétez et de rajoutez les associations Auteur-Laboratoires. C'est une aide proposée pour l'élaboration du fichier XML compatible avec la structure de données HAL acceptée par l'API.
CCSD	/	CNRS	Les	Web	Services	HAL	Spécifications	techniques	de	l’utilisation	des	WebServices	sur	l’archive	ouverte	HAL	V	3.0
Equipe	CCSD
Référence	:	HALWS-­‐V3.0
Etat	:	document	de	travail
HALWS	–	V3
2	Les	Web	Services	HAL	Sommaire	Sommaire	...............................................................................................................................................	2
Les	Web	Services	HAL	............................................................................................................................	3
1.	LES	REFERENTIELS	DANS	HAL	...............................................................................................................	5
1.1.	Les	environnements	............................................................................................................	5	1.2.	Les	types	de	publication	......................................................................................................	6	1.3.	Les	métadonnées	................................................................................................................	7	1.4.	Les	domaines	scientifiques	..................................................................................................	9	1.5.	Les	laboratoires	.................................................................................................................	11	1.6.	Les	affiliations	d’un	laboratoire	.........................................................................................	15	1.7.	Les	revues	..........................................................................................................................	16	1.8.	Les	types	de	fichiers	..........................................................................................................	19	1.9.	Embargo	sur	les	fichiers	....................................................................................................	20	1.10.	Version	des	fichiers	déposés	.............................................................................................	21	1.11.	Les	collections	...................................................................................................................	22	1.12.	Métadonnée	audience	......................................................................................................	23	1.13.	Les	organismes	de	thèses	..................................................................................................	24	1.14.	Les	écoles	doctorales	........................................................................................................	25	1.15.	Les	projets	ANR	.................................................................................................................	27	1.16.	Les	projets	européens	.......................................................................................................	28
2.	Le	dépôt	........................................................................................................................................	29
2.1.	Dépôt	d’un	nouveau	document	dans	l’archive	.................................................................	29	2.2.	Correction	d’un	article	......................................................................................................	31	2.3.	Dépôt	d’une	nouvelle	version	...........................................................................................	32	2.4.	Modification	des	métadonnées	........................................................................................	34	2.5.	Ajout	/	Modification	du	type	de	publication	.....................................................................	35	2.6.	Ajout	de	domaine	scientifique	..........................................................................................	36	2.7.	Ajout	de	fichier	à	une	notice	bibliographique	...................................................................	37	2.8.	Ajout	de	fichiers	annexes	à	un	dépôt	avec	fichier	............................................................	38	2.9.	Ajout	d’un	article	dans	une	collection	...............................................................................	38	2.10.	Statut	d’un	article	..............................................................................................................	40	2.11.	Mise	en	ligne	des	fichiers	d’un	article	sous	embargo	.......................................................	41
3.	La	recherche	.................................................................................................................................	42
3.1.	Existence	...........................................................................................................................	42	3.2.	Recherche	..........................................................................................................................	42	3.3.	Récupération	des	métadonnées	d’un	article	....................................................................	44	3.4.	Récupération	du	texte	intégral	d’un	article	......................................................................	45	3.5.	Recherche	de	thèses	.........................................................................................................	46	3.6.	Récupération	des	statistiques	de	consultation	d’un	article	..............................................	47
4.	Les	doublons	................................................................................................................................	48
3	Les	Web	Services	HAL
ANNEXE	:	LES	STRUCTURES	........................................................................................................................	49
Les	Web	Services	HAL
L’archive	ouverte	scientifique	HAL	(	http://hal.archives-­‐ouvertes.fr	)	dispose	de	Services	Web	(WS)
fondés	sur	le	protocole	SOAP	utilisant	le	style	WSDL	document/literal.	HAL	défini	ainsi	un	certain
nombre	de	méthodes	qui	vont	permettre	à	un	système	informatique	local	de	réaliser	des	opérations
similaires	à	celles	que	fait	un	contributeur	lorsqu’il	utilise	l’application	HAL	au	travers	de	son	portail
Les	méthodes	principales	découlent	directement	d’un	dépôt	fournissant	des	données	qualifiées	à
l’aide	des	référentiels	obligatoires	utilisés	dans	le	modèle	de	données	de	HAL	:
v Le	WS	permettant	d'accéder	en	consultation	aux	référentiels	internes	de	HAL
(métadonnées,	laboratoires,	domaines	scientifiques,	etc.)	;	accessible	via	le	protocole	HTTP	à
l’URL	:
o Serveur	de	production	:	http://hal.archives-­‐ouvertes.fr/ws/ref.php	wsdl	:	http://hal.archives-­‐ouvertes.fr/ws/ref.php?wsdl
o Serveur	de	développement	/	test	:	http://paol.ccsd.cnrs.fr/ws/ref.php	wsdl	:	http://paol.ccsd.cnrs.fr/ws/ref.php?wsdl
v Le	WS	permettant	de	déposer,	compléter,	modifier	des	articles	scientifiques	;	accessible	via
le	protocole	HTTP	à	l’URL	:
o Serveur	de	production	:	http://hal.archives-­‐ouvertes.fr/ws/submit.php	wsdl	:	http://hal.archives-­‐ouvertes.fr/ws/submit.php?wsdl
o Serveur	de	développement	/	test	:	http://paol.ccsd.cnrs.fr/ws/submit.php	wsdl	:	http://paol.ccsd.cnrs.fr/ws/submit.php?wsdl
v Le	WS	permettant	de	consulter	ou	rechercher	les	articles	scientifiques	déposés	sur	HAL	;
accessible	via	le	protocole	HTTP	à	l’URL	:
o Serveur	de	production	:	http://hal.archives-­‐ouvertes.fr/ws/search.php	wsdl	:	http://hal.archives-­‐ouvertes.fr/ws/search.php?wsdl
o Serveur	de	développement	/	test	:	http://paol.ccsd.cnrs.fr/ws/search.php	wsdl	:	http://paol.ccsd.cnrs.fr/ws/search.php?wsdl
4	Les	Web	Services	HAL
Vous	pouvez	trouver	des	exemples	d’implémentation	(PHP)	de	ces	Services	Web	sur	le	site
http://www.ccsd.cnrs.fr/support.html#clientws
5	Les	Web	Services	HAL	1. LES	REFERENTIELS	DANS	HAL
1.1. Les	environnements	Hal	dispose	de	plusieurs	portails	d’entrée	différents	(environnement	ou	instance),	avec	des
métadonnées	spécifiques.
getRefInstance
Récupération	de	l’ensemble	des	environnements	de	la	plateforme	HAL.
Liste	des	paramètres
Valeurs	de	retour
v getRefInstanceResult	(ArrayOfStrings)
Liste	contenant	les	noms	des	différents	environnements	disponibles	de	l’archive	HAL
6	Les	Web	Services	HAL
1.2. Les	types	de	publication	HAL	permet	de	qualifier	un	dépôt	par	un	«	type	de	publication	»	lorsque	le	papier	est	publié	(article	de	journal,	chapitre	d’ouvrage,	etc.)
getRefTypePubli
Récupération	de	la	liste	des	types	de	publications	en	fonction	de	l’environnement.
v instance	(string)
Nom	de	l’environnement	pour	lequel	on	souhaite	récupérer	la	liste	des	types	de	publication.
La	liste	des	environnements	peut	être	récupérée	par	la	méthode	getRefInstance
v lang	(string)
Code	langue	au	format	ISO	639-­‐1	(alpha-­‐2)
v getRefTypePubliResult	(ArrayOfTypePubliStruct	:	tableau	de	TypePubliStruct)
Liste	des	types	de	publications.	L’attribut	type	permet	de	savoir	si	le	type	de	publication	est
déposable	avec	ou	sans	fichier.
7	Les	Web	Services	HAL
1.3. Les	métadonnées	Ces	référentiels	permettent	de	savoir	quelles	informations	sont	à	fournir	lors	du	dépôt	d’un	article
dans	l’archive	HAL.	La	liste	des	métadonnées	dépend	de	l’instance	et	du	type	de	publication.
getRefMetaData
Récupération	de	la	liste	des	métadonnées	à	fournir	lors	du	dépôt	d’un	article	en	fonction
de	l’instance	et	du	type	de	publication.
Nom	de	l’environnement.
v typePubli	(string)
Identifiant	du	type	de	publication.
La	liste	des	types	de	publications	peut	être	récupérée	par	la	méthode	getRefTypePubli
v getRefMetaDataResult	(ArrayOfMetaDataStruct	:	tableau	de	MetaDataStruct)
Liste	des	métadonnées	pour	un	type	de	publication	donné	ou	accessibles	à	tous	les	types.
8	Les	Web	Services	HAL
getRefMetaData_forTypePubli
Cette	méthode	permet	de	récupérer	les	métadonnées	spécifiques	à	fournir	à	HAL	lors	de
l’ajout	de	la	typologie	de	publication.
v getRefMetaData_forTypePubliResult	(ArrayOfMetaDataStruct	:	tableau	de	MetaDataStruct)
9	Les	Web	Services	HAL
1.4. Les	domaines	scientifiques	Un	article	peut	être	déposé	dans	un	ou	plusieurs	domaines.	Ce	référentiel	contient	la	liste	des
domaines	qui	peuvent	être	choisi	pour	déposer	un	article	suivant	un	portail.
getRefSubject_byCode
Accès	aux	informations	d’un	domaine	à	partir	de	son	code
v code	(string)
Identifiant	du	domaine	scientifique.
La	liste	des	codes	peut	être	retournée	par	la	méthode	getRefSubject
v getRefSubject_byCodeResult	(SubjectStruct)
Informations	sur	un	domaine	scientifique.
getRefSubject
Récupération	du	référentiel	des	domaines	scientifiques	pour	une	instance	donnée.
v getRefSubjectResult	(ArrayOfStrings)
Liste	des	codes	des	domaines	du	référentiel.
10	Les	Web	Services	HAL
getRefSubject_byCodeParent
Accès	aux	codes	des	sous	domaines	d’un	domaine	scientifique
v getRefSubject_byCodeParentResult	(ArrayOfStrings)
Liste	des	codes	des	sous	domaines	du	domaine	passé	en	argument
11	Les	Web	Services	HAL
1.5. Les	laboratoires	Ce	référentiel	liste	les	différents	laboratoires	connus	de	HAL.	Les	différentes	méthodes	permettant
d’accéder	au	référentiel	des	laboratoires	vont	retourner	un	objet	de	type	LabStruct	ou	un	tableau
d’identifiants	de	laboratoire.	L’objet	LabStruct	contient	toutes	les	informations	définissant	un
getRefLab_byId
Accès	aux	informations	d’un	laboratoire	à	partir	de	son	identifiant
v knownLabid	(int)
Identifiant	d’un	laboratoire	dans	l’archive	HAL
v getRefLab_byIdResult	(LabStruct)
Objet	contenant	les	différentes	informations	sur	un	laboratoire
getRefLab
Récupération	du	référentiel	des	laboratoires
v from	(date	au	format	AAAA-­‐MM-­‐JJ)
Récupération	des	identifiants	des	laboratoires	ajoutés	ou	modifiés	depuis	la	date	from.	Si	ce
paramètre	est	vide,	la	totalité	du	référentiel	sera	retourné.
v getRefLabResult	(ArrayOfInts)
Liste	des	identifiants	des	laboratoires
12	Les	Web	Services	HAL
getRefLab_byAffi
Récupération	du	référentiel	des	laboratoires	à	partir	d’une	affiliation
v affi	(string)
Affiliation	du	laboratoire.	Il	est	possible	de	rechercher	un	laboratoire	CNRS	par	son	code
v searchType	(string)
Type	de	recherche.	Ce	paramètre	peut	prendre	les	valeurs	like	(contient),	start_by
(commence	par),	end_by	(fini	par),	is_exactly	(correspond	exactement	à).	Par	défaut,	la
valeur	est	like.
v getRefLab_byAffiResult	(ArrayOfInts)
Liste	des	identifiants	des	laboratoires	correspondant	aux	critères	de	la	recherche
getRefLab_byShortName
Récupération	du	référentiel	des	laboratoires	à	partir	du	sigle	d’un	laboratoire
v shortName	(string)
Sigle	du	laboratoire	recherché
v getRefLab_byShortNameResult	(ArrayOfInts)
13	Les	Web	Services	HAL
getRefLab_byName
Récupération	du	référentiel	des	laboratoires	à	partir	du	nom	d’un	laboratoire
v name	(string)
Nom	du	laboratoire	recherché
v getRefLab_byNameResult	(ArrayOfInts)
getRefLab_byAuthor
Récupération	des	derniers	laboratoires	associés	à	un	auteur	lors	du	dernier	dépôt
v lastname	(string)
Nom	de	l’auteur
v firstname	(string)
Prénom	de	l’auteur
v email	(string)
Mail	de	l’auteur	(optionnel)
v getRefLab_byAuthorResult	(ArrayOfInts)
14	Les	Web	Services	HAL
getRefLab_search
Recherche	dans	le	référentiel	des	laboratoires.	Méthode	retournant	au	maximum	15	objets
laboratoires	dont	le	sigle,	le	nom	ou	une	des	affiliations	correspond	à	la	chaîne	de
caractère	passée	en	argument.
v search	(string)
Chaîne	de	caractère	à	rechercher
v getRefLab_searchResult	(ArrayOfLabStruct	:	tableau	de	LabStruct)
Liste	d’objets	laboratoire	correspondant	aux	critères	de	la	recherche
addRefLab
Ajout	d’un	nouveau	laboratoire	au	référentiel	de	HAL.	Ce	nouveau	laboratoire	ne	sera	pas
valide	(ne	sera	pas	retourné	par	les	autres	méthodes)	mais	possèdera	un	labid	et	pourra
être	utilisé	lors	d’un	dépôt.
v identification	(UserStruct)
Identifiants	d’un	compte	sur	la	plateforme	HAL
v lab	(addLabStruct)
Laboratoire	à	rajouter
v addRefLabResult	(Int)
Identifiant	du	nouveau	laboratoire
15	Les	Web	Services	HAL
1.6. Les	affiliations	d’un	laboratoire	Le	référentiel	des	affiliations	est	constitué	de	tous	les	organismes	qui	peuvent	être	associés	à	un
laboratoire.	Les	organismes	peuvent	être	des	institutions	(CNRS,	CEA,	…),	des	universités,	des
grandes	écoles	et	des	partenaires	privés.
getRefAffi
Récupération	du	référentiel	des	affiliations
Récupération	des	affiliations	ajoutées	ou	modifiées	depuis	la	date	from.	Si	ce	paramètre	est
vide,	la	totalité	du	référentiel	sera	retourné.
v getRefAffiResult	(ArrayOfStrings)
Liste	des	intitulés	des	affiliations	du	référentiel
getRefAffi_byName
v getRefAffi_byNameResult	(ArrayOfStrings)
16	Les	Web	Services	HAL
1.7. Les	revues	Les	méthodes	suivantes	retournent	soit	un	objet	de	type	ReviewStruct,	soit	un	tableau	d’entier
pointant	vers	un	objet	revue.	Cet	objet	contient	le	nom,	le	sigle,	l’ISSN,	l’éditeur	et	l’EISSN	de	la
getRefReview_byId
Récupération	des	informations	d’une	revue
v id	(int)
Identifiant	unique	d’une	revue	sur	l’archive	HAL
v getRefReview_byIdResult	(ReviewStruct)
Objet	contenant	les	différentes	informations	sur	une	revue
getRefReview
Récupération	du	référentiel	des	revues
Récupération	des	revues	ajoutées	ou	modifiées	depuis	la	date	from.	Si	ce	paramètre	est	vide,
la	totalité	du	référentiel	sera	retourné
v getRefReviewResult	(ArrayOfInts)
Tableau	contenant	les	identifiants	HAL	des	revues	du	référentiel.
17	Les	Web	Services	HAL
getRefReview_byName
Recherche	dans	le	référentiel	à	partir	du	nom	de	la	revue
Nom	de	la	revue	recherchée
v getRefReview_byNameResult	(ArrayOfInts)
getRefReview_byEditor
Recherche	dans	le	référentiel	à	partir	du	nom	de	l’éditeur
v editor	(string)
Nom	de	l’éditeur	recherché
v getRefReview_byEditorResult	(ArrayOfInts)
18	Les	Web	Services	HAL
getRefReview_byISSN
Recherche	dans	le	référentiel	à	partir	de	l’ISSN	de	la	revue
v issn	(string)
ISSN	de	la	revue	recherchée
v getRefReview_byISSNResult	(ArrayOfInts)
19	Les	Web	Services	HAL
1.8. Les	types	de	fichiers	Référentiel	contenant	tous	les	formats	de	fichiers	déposables	sur	HAL.
getRefFormat
Retourne	la	liste	des	formats	de	fichiers	déposables	sur	HAL.
v getRefFormatResult	(ArrayOfFormatStruct	tableau	de	FormatStruct)
Tableau	d’objet	contenant	les	informations	sur	les	formats	de	fichiers	déposables	dans	une
instance	de	HAL.
20	Les	Web	Services	HAL
1.9. Embargo	sur	les	fichiers	Lors	du	dépôt	d’un	article,	l’auteur	peut	vouloir	définir	une	période	d’embargo	pendant	laquelle	le
document	ne	sera	pas	visible.
getRefDateVisible
Retourne	les	différentes	durées	d’embargo	disponibles.
v aucun
v getRefDateVisibleResult	(ArrayOfDateVisibleStruct	tableau	de	DateVisibleStruct)
Tableau	d’objet	contenant	les	différentes	durées	d’embargo	disponibles.
21	Les	Web	Services	HAL
1.10. Version	des	fichiers	déposés	Lors	d’un	dépôt	sur	HAL	d’un	article	scientifique	avec	texte	attaché,	il	est	obligatoire	de	donner	le
droit	sur	les	fichiers	déposés	(ex.	fichier	auteur,	fichier	éditeur).	Cette	méthode	permet	de	connaître
les	différentes	valeurs	possibles.
getRefRightFulltext
Retourne	la	liste	des	droits	sur	les	fichiers
v getRefRightFulltextResult	(ArrayOfRightFulltextStruct	tableau	de	RightFulltextStruct)
Tableau	d’objet	contenant	les	différents	droits	disponibles.
22	Les	Web	Services	HAL
1.11. Les	collections	HAL	gère	des	collections	au	dessus	des	dépôts.	Cette	méthode	permet	de	connaître	la	liste	des
collections	administrée	par	un	utilisateur.
getRefCollection
Retourne	la	liste	des	tampons	d’un	utilisateur	sur	l’archive	HAL
v uid	(string)
Login	de	l’utilisateur	dans	l’archive	HAL
v getRefCollectionResult	(ArrayOfCollectionStruct	tableau	de	CollectionStruct)
Tableau	d’objet	contenant	les	informations	sur	les	collections	d’un	utilisateur.
23	Les	Web	Services	HAL
1.12. Métadonnée	audience	Référentiel	contenant	les	différentes	valeurs	pour	la	métadonnée	audience	de	HAL.
getRefAudience
Retourne	la	liste	des	valeurs	pour	la	métadonnée	«	audience	»
v getRefAudienceResult	(ArrayOfAudienceStruct	tableau	de	AudienceStruct)
Tableau	d’objet	contenant	les	informations	sur	les	valeurs.
24	Les	Web	Services	HAL
1.13. Les	organismes	de	thèses	Ce	référentiel	ne	s’utilise	que	pour	les	dépôts	de	thèses	ou	de	HDR	(sur	l’instance	TEL)
getRefOrgThe
Retourne	la	liste	des	organismes	de	thèses	du	référentiel
v pays	(string)
Identifiant	du	pays	(code	ISO	3166-­‐1).	FR	par	défaut.
v getRefOrgTheResult	(ArrayOfOrgTheStruct	tableau	de	OrgTheStruct)
Tableau	d’objet	contenant	les	informations	sur	les	organismes	de	thèses.
getRefOrgThe_byName
Recherche	dans	le	référentiel	à	partir	du	nom	de	l’organisme
Nom	de	l’organisme
v getRefOrgThe_byNameResult	(ArrayOfOrgTheStruct	tableau	de	OrgTheStruct)
25	Les	Web	Services	HAL
1.14. Les	écoles	doctorales	Ce	référentiel	ne	s’utilise	que	pour	les	dépôts	de	thèses	ou	de	HDR	(sur	l’instance	TEL)
getRefSchool
Retourne	le	référentiel	des	écoles	doctorales
v getRefSchoolResult	(ArrayOfSchoolStruct	tableau	de	SchoolStruct)
Tableau	d’objet	contenant	les	informations	sur	les	écoles	doctorales
getRefSchool_byName
Recherche	dans	le	référentiel	à	partir	du	nom	de	l’école	doctorale
Nom	de	l’école
v getRefSchool_byNameResult	(ArrayOfSchoolStruct	tableau	de	SchoolStruct)
26	Les	Web	Services	HAL
getRefSchool_byOrgThe
Recherche	dans	le	référentiel	à	partir	de	son	organisme	de	thèse
Nom	de	l’organisme	de	thèse
v getRefSchool_byOrgTheResult	(ArrayOfSchoolStruct	tableau	de	SchoolStruct)
27	Les	Web	Services	HAL
1.15. Les	projets	ANR	Accès	au	référentiel	des	projets	ANR
getRefCodeANR
Recherche	la	liste	des	projets	ANR	du	référentiel
Libellé	ou	code	d’un	projet	recherché
v getRefCodeANRResult	(ArrayOfInts)
Liste	des	identifiants	des	projets	ANR
getRefANR_byCode
Retourne	les	différentes	informations	d’un	projet	ANR	stockées	dans	le	référentiel
v code	(int)
Identifiant	du	projet	ANR
v getRefANR_byCodeResult	(ANRStruct)
Objet	contenant	les	informations	sur	un	projet	ANR
28	Les	Web	Services	HAL
1.16. Les	projets	européens	Accès	au	référentiel	des	projets	européens
getRefCodeProjEurope
Recherche	la	liste	des	projets	européens	du	référentiel
v getRefCodeProjEuropeResult	(ArrayOfInts)
Liste	des	identifiants	des	projets	européens
getRefProjEurope_byCode
Retourne	les	différentes	informations	d’un	projet	européen	stockées	dans	le	référentiel
Identifiant	du	projet	européen
v getRefProjEurope_byCodeResult	(ProjEuropeStruct)
Objet	contenant	les	informations	sur	un	projet	européen
29	Les	Web	Services	HAL	2. Le	dépôt
Chaque	dépôt	avec	texte	intégral	est	vérifié	au	CCSD	(statut	verify	lors	du	dépôt)	avant	sa	mise	en
ligne	définitive	sur	l’archive	ouverte.	HAL	propose	trois	méthodes	pour	avertir	les	systèmes	locaux
après	la	validation	:
v Par	mail.	HAL	envoie	un	courrier	à	un	email	définit	entre	le	CCSD	et	le	système	local
contenant	les	identifiants	de	l’article,	le	nouveau	statut	(accept,	update,	delete)	et	le
motif	(si	modification	ou	refus)	;
v Par	script	HTTP	méthode	POST.	Les	paramètres	sont	l’identifiant	(identifiant),	la	version
(version)	et	le	mot	de	passe	de	l’article	(passwd)	dans	HAL,	le	nouveau	statut	(status	:
accept,	update,	delete)	et	le	motif	(comment).	Un	code	retour	(0	:	OK	pas	de	problème,	1
:	problème	interne	et	2	:	article	inconnu	dans	le	système	local)	permet	à	HAL	de	s’assurer
que	la	mise	à	jour	a	pu	être	effectuée.
v Par	Web	Service.	Le	nom	de	la	méthode	est	hal_article_status.	Ce	WS	attendra	5
paramètres	en	entrée	:	l’identifiant,	la	version	et	le	mot	de	passe	de	la	publication	dans
HAL,	le	statut	(accept,	update,	delete)	et	le	motif	(si	modification	ou	refus).	La	chaine	de
caractère	en	retour	(local	-­‐>	0	:	OK	pas	de	problème,	1	:	problème	interne	et	2	:	article
inconnu)	permet	à	HAL	de	s’assurer	que	la	mise	à	jour	a	pu	être	effectuée.
L’utilisateur	désirant	utiliser	les	WS	de	dépôt	doit	dans	un	premier	temps	se	créer	un	compte	sur
un	portail	de	HAL	puis	demander	au	ccsd	(ccsd-­‐tech@ccsd.cnrs.fr)	de	lui	activer	son	compte	pour
l’utilisation	des	WS.	Pour	l’environnement	de	développement,	l’utilisateur	à	utiliser	est	«	test_ws	»
avec	le	mot	de	passe	«	test	».
2.1. Dépôt	d’un	nouveau	document	dans	l’archive
Dépôt	d’un	nouvel	article	dans	l’archive	HAL
Instance	dans	laquelle	on	souhaite	déposer	l’article.
30	Les	Web	Services	HAL
La	liste	des	instances	disponibles	est	accessible	à	partir	de	la	méthode	getRefInstance
Identifiants	de	connexion	sur	la	plate-­‐forme	HAL
v contributor	(ContributorStruct)
Informations	personnelles	sur	le	déposant	de	l’article	dans	le	système	local
v metadatas	(MetasStruct)
Métadonnées	de	l’article	déposé.	La	liste	des	métadonnées	dépend	de	l’instance	de	dépôt
(liste	accessible	à	partir	de	la	méthode	getRefMetaData	)	et	du	type	de	publication	(liste
accessible	à	partir	de	la	méthode	getRefMetaData_forTypePubli	)
v fullText	(FullTextStruct)
Structure	contenant	le	texte	intégral	de	l’article	et	l’origine	du	fichier	(fichier	auteur,	fichier
éditeur	;	le	code	est	retourné	par	la	méthode	getRefRightFulltext)
v uploadResult	(PendingArticletStruct)
Identifiant,	version,	mot	de	passe	de	l’article	et	état	du	dépôt	dans	l’archive	(verify,	accept,
update	ou	delete)
• La	métadonnée	«	type	de	publication	»	n’est	obligatoire	que	pour	le	dépôt	d’une	référence
bibliographique	(dépôt	sans	fichier).	Si	celle-­‐ci	n’est	pas	présente,	il	s’agit	alors	d’un
document	sans	références	de	publication	couramment	appelé	pre-­‐print	(code	=	UNDEFINED).	• Si	des	métadonnées	sont	multivaluée	(domaine	scientifique,	affiliation	des	laboratoires,	mots
clés,	etc.)	alors	chaque	valeur	est	séparée	par	le	caractère	«	;	».
• Le	format	des	dates	est	du	type	AAAA-­‐MM-­‐JJ,	AAAA-­‐MM	ou	AAAA.
31	Les	Web	Services	HAL
2.2. Correction	d’un	article	Cette	méthode	permet	de	modifier	un	article	pour	lequel	des	modifications	ont	été	demandées	par
les	modérateurs	de	HAL.	Ces	modifications	ont	été	transmises	au	système	local	selon	les	3	méthodes
définies	plus	haut	(mail,	requête	HTTP,	WS)
Correction	d’un	dépôt
v article	(ArticleIdentStruct)
Identifiants	de	l’article	sur	la	plateforme	HAL
v modifyResult	(PendingArticletStruct)
32	Les	Web	Services	HAL
2.3. Dépôt	d’une	nouvelle	version	Cette	méthode	permet	de	déposer	une	nouvelle	version	d’un	document	avec	texte	intégral	en	ligne
dans	l’archive	HAL.	Si	les	modifications	ne	portent	que	sur	les	métadonnées,	il	faut	utiliser	la
méthode	update.
Dépôt	d’une	nouvelle	version
(liste	accessible	à	partir	de	la	méthode	getRefMetaData)	et	du	type	de	publication	(liste
v replaceResult	(PendingArticletStruct)
• La	métadonnée	«	type	de	publication	»	est	obligatoirement	identique	à	la	version	précédente
sauf	si	elle	était	nulle	(cas	d’un	pre-­‐print).	Dans	ce	cas,	la	nouvelle	version	peut	recevoir	des
informations	de	publication.
• La	métadonnée	«	domaine	scientifique	»	ne	peut	être	modifiée	lors	de	la	création	d’une
nouvelle	version.	Celle-­‐ci	n’est	donc	pas	nécessaire	dans	la	liste	des	métadonnées	simples.
33	Les	Web	Services	HAL
• Le	code	php	utilisé	pour	cette	méthode	est	donc	le	même	que	pour	un	dépôt	en	remplaçant
le	paramètre	«	instance	»	(string)	par	le	paramètre	«	article	»	(ArticleIdentStruct)	et	en
supprimant	la	métadonnée	domaine	scientifique.
34	Les	Web	Services	HAL
2.4. Modification	des	métadonnées	Cette	méthode	est	appelée	pour	modifier	les	métadonnées	d’un	article	en	ligne	sur	l’archive	HAL.
Modification	des	métadonnées	d’un	article
v updateResult	(ArticleIdentStruct)
Identifiant	de	l’article	en	ligne	sur	la	plate-­‐forme	HAL
• Les	domaines	scientifiques	ne	peuvent	pas	être	modifiés	par	cette	méthode.	Il	faudra	utiliser
la	méthode	cross.
35	Les	Web	Services	HAL
2.5. Ajout	/	Modification	du	type	de	publication	Cette	méthode	peut	être	utilisée	lorsqu’un	article	déjà	présent	dans	l’archive	HAL	est	accepté	pour
publication	dans	une	revue.	Dans	ce	cas,	le	type	de	publication	change	et	la	méthode	jref	permet
d’apporter	des	informations	supplémentaires	sur	ce	nouveau	type	de	publication	(nom	du	journal,
éditeur,	…)
Ajout	(ou	modification)	du	type	de	publication	du	dépôt
Nouveau	type	de	publication	(liste	accessible	à	partir	de	la	méthode	getRefTypePubli)
v metas	(ArrayOfMetaStruct	:	tableau	de	MetaStruct)
Métadonnées	supplémentaires	à	fournir	dépendant	de	l’instance	de	dépôt	et	du	type	de
publication	(liste	accessible	à	partir	de	la	méthode	getRefMetaData_forTypePubli)
v jrefResult	(ArticleIdentStruct)
36	Les	Web	Services	HAL
2.6. Ajout	de	domaine	scientifique	Un	article	peut	être	rattaché	à	plusieurs	domaines	scientifiques.	Cette	méthode	va	permettre
d’ajouter	un	domaine	scientifique	à	un	article	déjà	présent	sur	l’archive	HAL.
Ajout	de	domaine	scientifique
v domain	(string)
Code	du	domaine	à	ajouter	à	l’article.	La	liste	des	codes	domaines	est	à	récupérer	par	les
méthodes	getRefSubject
v crossResult	(ArticleIdentStruct)
37	Les	Web	Services	HAL
2.7. Ajout	de	fichier	à	une	notice	bibliographique	Cette	méthode	permet	d’ajouter	le	texte	intégral	d’un	article	à	une	notice	bibliographique	en	ligne
sur	HAL	lorsque	celle-­‐ci	n’a	pas	de	document	attaché.
Ajout	de	fichier
v addFileResult	(PendingArticletStruct)
• Attention,	cette	méthode	ne	peut	être	utilisée	que	si	le	dépôt	est	une	notice	bibliographique
(dépôt	sans	texte	intégral).
38	Les	Web	Services	HAL
2.8. Ajout	de	fichiers	annexes	à	un	dépôt	avec	fichier	Cette	méthode	permet	à	un	administrateur	d’ajouter	des	fichiers	supplémentaires	(image	ou	annexe)	à	un	dépôt	avec	texte	intégral.
addSupplementaryData
Ajout	de	fichier	annexe
v files	(ArrayOfFileStruct)
Structure	contenant	le(les)	fichier(s)	annexe(s)
v addSupplementaryDataResult	(booléen)
• Attention,	cette	méthode	ne	peut	être	utilisée	que	par	l’administrateur	de	l’instance	du
dépôt	et	que	si	le	dépôt	à	un	fichier	(dépôt	avec	texte	intégral).
2.9. Ajout	d’un	article	dans	une	collection	Cette	méthode	permet	d’ajouter	un	article	dans	une	collection
Tamponnage	d’un	document
v collection	(string)
39	Les	Web	Services	HAL
Identifiant	de	la	collection.	La	liste	des	collections	peut	être	récupérée	par	la	méthode
v addCollectionResult	(ArticleIdentStruct)
40	Les	Web	Services	HAL
2.10. Statut	d’un	article	Cette	méthode	permet	de	récupérer	le	statut	d’un	article
Récupération	du	statut	d’un	document
v statusResult	(ArticleStatusStruct)
Statut	de	l’article	sur	la	plate-­‐forme	HAL	:	accept,	update,	verify	ou	delete
41	Les	Web	Services	HAL
2.11. Mise	en	ligne	des	fichiers	d’un	article	sous	embargo	Méthode	permettant	de	mettre	en	ligne	les	fichiers	texte	intégral	d’un	article	sous	embargo	dans
Mise	en	ligne	de	fichiers
v putOnLineResult	(boolean)
42	Les	Web	Services	HAL	3. La	recherche
3.1. Existence	Recherche	de	l’existence	d’un	papier	sur	HAL
existOnHAL
Recherche	dans	l’archive	HAL	d’un	papier	suivant	son	titre
v title	(string)
Le	titre	du	document	(le	système	supprime	les	chaines	(mots	et	caractères)	de	longueur	≤	2)
v status	(string)
Critère	sur	la	visibilité	de	l’article	;	peut	être	visible	ou	all
v existOnHALResult	(ArrayOfArticleStruct	=	tableau	de	ArticleStruct)
Résultat	de	la	recherche	sous	la	forme	d’un	tableau	d’articles
3.2. Recherche	Consultation/Recherche	sur	l’archive	HAL	suivant	des	critères	avancés
Recherche	dans	l’archive	HAL
v search	(ArrayOfSearchStruct	=	tableau	de	SearchStruct)
Objet	contenant	les	critères	de	recherche
v typePubli	(ArrayOfStrings)
Liste	des	identifiants	(code)	des	types	publications	dans	lesquelles	la	recherche	va	être
v onlyFullText	(boolean)
Recherche	uniquement	dans	les	dépôts	avec	texte	intégral	si	TRUE	;	sinon	la	recherche	se	fait
43	Les	Web	Services	HAL
sur	toute	la	base.
v orderBy	(string)
Critère	sur	l’ordre	de	sortie	;	peut	être	date,	title	ou	author
v searchResult	(ArrayOfArticleStruct	=	tableau	de	ArticleStruct)
44	Les	Web	Services	HAL
3.3. Récupération	des	métadonnées	d’un	article	Cette	méthode	permet	de	récupérer	les	informations	d’un	article	(métadonnées,	auteurs)	à	partir	de
son	identifiant.
getArticleMetadata
Récupération	des	métadonnées	d’un	article
v identifiant	(string)
Identifiant	de	l’article
v version	(int)
Version	de	l’article
v getArticleMetadataResult	(DatasStruct)
Structure	contenant	les	informations	sur	l’article	(métadonnées	simples,	métadonnées
45	Les	Web	Services	HAL
3.4. Récupération	du	texte	intégral	d’un	article	Cette	méthode	permet	de	récupérer	le	lien	vers	le	texte	intégral	(au	format	PDF	ou	JPEG)	d’un	article
ou	photo	présent	dans	l’archive	HAL.
getArticleFile
Récupération	du	fichier	PDF	d’un	article
v getArticleFileResult	(ArrayOfStrings)
Tableau	contenant	le(s)	lien()s	vers	le(s)	fichier(s)	PDF	ou	JPEG	correspondant	à	l’article	ou	la
photo	sur	la	base	HAL.
46	Les	Web	Services	HAL
3.5. Recherche	de	thèses	Recherche	de	l’existence	d’une	thèse	sur	TEL
search_thesis
Recherche	de	l’existence	de	thèses	dans	l’archive	TEL
Identifiants	de	connexion	privilégiés	sur	la	plate-­‐forme	HAL
Titre	de	la	thèse
v author	(string)
Auteur	de	la	thèse
v defencedate	(date)
Date	de	soutenance
v search_thesisResult	(ArrayOfArticleStruct	=	tableau	de	ArticleStruct)
47	Les	Web	Services	HAL
3.6. Récupération	des	statistiques	de	consultation	d’un	article	Cette	méthode	permet	de	récupérer	les	statistiques	de	consultation	d’un	article	à	travers	le	portail
getArticleCounter
v getArticleCounterResult	(CounterStruct)
Statistiques	de	consultation	de	l’article	:	notice/fiche	de	métadonnées	et	fichier(s).
48	Les	Web	Services	HAL	4. Les	doublons
Service	permettant	d’informer	la	base	HAL	sur	l’existence	d’éventuel	doublon	de	dépôt
v identifiants	(ArrayOfStrings)
Liste	des	identifiants	des	dépôts	qui	semble	être	des	doublons
Parmi	les	doublons,	renseigné	ici	le	dépôt	qui	vous	semble	le	plus	complet	et	à	conserver
v doublonResult	(string)
49	Les	Web	Services	HAL
ANNEXE	:	LES	STRUCTURES
Identifiant	Structure	ANRStruct
o code	(int)	:	identifiant	HAL	du	projet	o reference	(string)	:	référence	ANR	o annee	(string)	:	année	du	projet	o acronyme	(string)	:	acronyme	o titre	(string)	:	titre	o intitule	(string)	:	intitulé	o acroappel	(string)
ArticleIdentStruct
o identifiant	(string)	:	identifiant	o version	(int)	:	version	o passwd	(string)	:	mot	de	passe
ArticleStatusStruct
o status	(string)	:	état	de	l’article	(verify,	accept,	update	ou	delete)	o comment	(string)	:	commentaire	permettant	d’expliquer	la	demande
de	modification	ou	le	refus	de	l’article
ArticleStruct
o identifiant	(string)	:	identifiant	de	l’article	dans	l’archive	hal	o version	(int)	:	version	de	l’article	o url	(string)	:	url	stable	de	l’article	o title	(string)	:	titre	o havefile	(boolean)	:	indique	si	le	texte	integral	de	l’article	est	présent	o typePubli	(string)	:	type	du	document
AudienceStruct
o code	(int)	:	identifiant	du	type	d’audience	o libelle	(string)	:	libellé
50	Les	Web	Services	HAL
AuthorStruct
o labIds	(ArrayOfInts	=	tableau	d’int).	Chaque	entier	correspond	à	la	valeur	du	champ	labid	d’un	objet	LaboratoryStruct	(permet	d’associer
cet	auteur	à	1	ou	plusieurs	laboratoires)
o lastName	(string)	:	nom	o firstName	(string)	:	prénom	o otherName	(string)	:	autres	prénom,	initiales	o email	(string)	:	adresse	mail	de	l’auteur	o url	(string)	:	url	du	site	perso	de	l’auteur	o organism	(string)	:	établissement	de	rattachement	de	l’auteur	o researchTeam	(string)	:	équipe	de	recherche	de	rattachement	de
o corresponding	(boolean)	:	indique	si	l’auteur	est	l’auteur	correspondant	de	la	publication
Pour	chaque	auteur,	les	données	labIds,	lastName	et	firstName	sont
AutLabStruct
o authors	(ArrayOfAuthorStruct	=	tableau	de	AuthorStruct)	:	tableau	d’auteurs
o labs	(ArrayOfLaboratoryStruct	=	tableau	de	LaboratoryStruct)	:	tableau	de	laboratoires
CollectionStruct
o code	(string)	:	identifiant	de	la	collection	o name	(string)	:	intitulé	de	la	collection
ContributorStruct
o lastName	(string)	:	nom	o firstName	(string)	:	prénom	o email	(string)	:	email
CounterStruct
o metadata	(int)	:	fiche	o file	(int)	:	fichier(s)
51	Les	Web	Services	HAL
SearchStruct
o field	(string)	:	nom	du	champ	sur	lequel	la	recherche	est	faite.	La	recherche	peut	être	faite	sur	les	champs	suivants:
• title	:	titre	de	l’article
• abstract	:	résumé	de	l’article
• author	:	auteurs	de	la	publication
• lab	:	laboratoires	associés	aux	auteurs	de	l’article
• researchteam	:	équipe	de	recherche	des	auteurs
• collaboration	:	collaboration
• collection	:	identifiant	du	tampon	de	l’article
• year	:	année	de	publication	ou	année	d’écriture	ou	année	de
o searchType	(string)	:	type	de	recherche.	Ce	paramètre	peut	prendre	les	valeurs
• like	:	contient	(valeur	par	défaut)
• start_by	:	commence	par
• end_by	:	fini	par
• is_exactly	:	correspond	exactement	à
• gt	:	supérieur	à
• lt	:	inférieur	à
• ge	:	supérieur	ou	égal	à
• le	:	inférieur	ou	égal	à
o value	(string)	:	texte	recherché	o join	(string)	:	Utilisé	pour	joindre	plusieurs	critères	de	recherche.	Ce
paramètre	peut	prendre	les	valeurs	:
• and	:	et	(valeur	par	défaut)
• or	:	ou
• and_not	:	sauf
DateVisibleStruct
o code	(string)	:	durée	d’embargo	o libelle	(string)	:	libellé
52	Les	Web	Services	HAL
o name	(string)	:	nom	du	fichier	o md5	(string)	:	signature	md5	du	contenu	du	fichier	non	encodé	en	base
o format	(string)	:	code	o mainWebFile	(string)	:	fichier	principal	lors	d’un	dépôt	au	format	HTML
ou	XML
o content	(string)	:	contenu	du	fichier	encode	en	base	64	ou	url	du	fichier	o local	(boolean)	:	si	local=	true	alors	content	correspond	au	contenu	du
fichier	encode	en	base	64,	sinon	content	correspond	à	l’url	du	fichier
o mainWebFile	(string)	:	permet	de	renseigner	le	fichier	principal	lors	d’un	transfert	de	papier	au	format	HTML,	XML	ou	IMG.
Si	le	paramètre	md5	n’est	pas	vide,	celui-­‐ci	permet	de	vérifier	que	le
contenu	du	fichier	est	correct	après	transfert	sur	HAL.	Le	dépôt	d’archive
zip,	tar	(par	format	de	fichiers)	est	bien	sûr	possible.
o code	(string)	:	identifiant	du	format	o libelle	(string)	:	libellé
FullTextStruct
o right	(int)	:	droits	sur	les	fichiers	déposes	o files	(ArrayofFileStruct	=	tableau	de	FileStruct)	:	tableau	des	différents
fichiers	déposés
53	Les	Web	Services	HAL
LaboratoryStruct
o labId	(int)	:	identifiant	interne	à	la	structure	AutlabStruct	(permet	d’effectuer	les	associations	auteurs	/	laboratoires)
o knownLabid	(int)	:	identifiant	HAL	du	laboratoire	o shortName	(string)	:	sigle	o name	(string)	:	nom	o address	(string)	:	adresse	postale	o url	(string)	:	url	du	site	web	o pays	(string)	:	code	ISO	3166	alpha-­‐2	o affiliation	(ArrayOfStrings	=	tableau	de	string)	:	affiliations	du
Lorsque	l’on	renseigne	un	laboratoire	«	connu	»	de	HAL,	knownLabid	est	le
seul	champ	obligatoire.	Sinon,	name,	pays	et	au	moins	une	affiliation	sont
obligatoires	pour	renseigner	un	nouveau	laboratoire.	La	donnée	LabId	est
obligatoire	puisque	servant	à	associer	le	laboratoire	à	un	ou	plusieurs
LabStruct
o id	(int)	:	Identifiant	unique	du	laboratoire	o name	(string)	:	Nom	du	laboratoire	o shortName	(string)	:	Sigle	du	laboratoire	o address	(string)	:	Coordonnées	postales	du	labo	o url	(string)	:	adresse	du	site	web	du	labo	o pays	(string)	:	identifiant	du	pays	(code	ISO	3166-­‐1)	o affiliation	(ArrayOfStrings)	:	affiliations	du	laboratoire	o status	(string)	:	état	du	laboratoire	[open,	close	ou	tmp]
MetaDataStruct
o name	(string)	:	identifiant	o libelle	(string)	:	libelle	o comment	(string)	:	descriptif	o required	(boolean)	:	indique	si	la	métadonnée	est	obligatoire	ou	pas	o domain	(ArrayOfStrings)	:	codes	des	domaines	pour	lesquels	la
métadonnée	est	à	renseigner	(ALL	correspond	à	tous	les	domaines
54	Les	Web	Services	HAL
DatasStruct
o metaSimple	(ArrayOfMetaStruct	=	tableau	de	MetaStruct)	:	tableau	contenant	les	métadonnées	de	l’article
o metaAutLab	(AutLabStruct)	:	liste	des	auteurs	d’un	article
o metaName	(string)	:	nom	de	la	métadonnée	(titre,	résumé,	…)	o metaCode	(string)	:	code	si	la	méta	en	possède	(ex	langue,	domaine,	…)	o metaValue	(string)	:	valeur	de	la	métadonnée
OrgTheStruct
o name	(string)	:	nom	de	l’organisme	o academy	(string)	:	académie	o url	(string)	:	adresse	du	site	Web	de	l'organisme	o pays	(string)	:	code	ISO	3166-­‐1	du	pays	de	l’organisme
PendingArticleStruct
o identifiant	(string)	:	identifiant	o version	(int)	:	version	o passwd	(string)	:	mot	de	passe	o status	(string)	:	état	de	l’article	:
• verify	:	en	vérification
• accept	:	accepté
• update	:	demande	de	modification
• delete	:	supprimé
ProjEuropeStruct
o code	(int)	:	identifiant	HAL	du	projet	o numero	(string)	:	numéro	du	projet	o acronyme	(string)	:	acronyme	o titre	(string)	:	titre	o callid	(string)	o fundedby	(string)	o sdate	(date)	:	date	début	projet	o edate	(date)	:	date	fin	projet
55	Les	Web	Services	HAL
ReviewStruct
o name	(string)	:	nom	complet	de	la	revue	o shortName	(string)	:	nom	abrégé	de	la	revue	(s’il	existe	et	est	connu	du
référentiel)
o ISSN	(string)	:	ISSN	de	la	revue	(si	connu	du	référentiel)	o editor	(string)	:	éditeur	de	la	revue	(si	connu	du	référentiel)	o EISSN	(string)	:	ISSN	de	la	revue	version	électronique	(s’il	existe	et	est
connu	du	référentiel)
RightFulltextStruct
o code	(string)	:	droit	o libelle	(string)	:	libellé
SchoolStruct
o name	(string)	:	nom	de	l’école	o orgThe	(string)	:	organisme	de	thèse
SubjectStruct
o code	(string)	:	identifiant	du	domaine	o codeParent(string)	:	code	'père'	du	domaine	o deposable	(boolean)	:	prend	les	valeurs	'TRUE'	ou	'FALSE'	suivant	s'il	est
permis	de	déposer	dans	ce	domaine	ou	pas.
o haveNext	(boolean)	:	prend	les	valeurs	'TRUE'	ou	'FALSE'	o libelle	(string)	:	libellé	d’un	domaine
TypePubliStruct	o code	(string):	identifant	o libelle	(string)	:	libelle	o type	(string)	:	all,	file	ou	notice.
o uid	(string):	login	de	connexion	o passwd	(string)	:	mot	de	passe

References: §11
 §12
 §12
 §7
 §6
 §5
 §10
 §4
 §12
 §13
 §10
 §10
 §6
 §61
 §7
 §5
 §7
 §9
 §9
 §12
 §12