Formation « Utilisation avancée de HAL » - ccsd – 25 septembre 2012 Utiliser les WebServices

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre 2012 Sommaire Présentation Les différentes étapes Laccès aux référentiels Effectuer / modifier un dépôt Consulter / Rechercher des dépôts Exemple

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Présentation Services Web (WS) fondés sur le protocole SOAP Méthodes permettant à un système informatique local de réaliser des opérations telles que celles proposées sur linterface de HAL consultation des référentiels internes de HAL (métadonnées, laboratoires, domaines scientifiques, etc.) dépôt, modification darticles scientifiques consultation ou recherche darticles scientifiques déposés sur HAL

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Les différentes étapes Identifier les méthodes à utiliser ( Prendre connaissance des structures de chaque élément utile Pour effectuer /modifier des dépôts : Utiliser lenvironnement de développement pour tester, le compte à utiliser est « test_ws » avec le mot de passe « test » Se créer un compte sur un portail de HAL Demander au ccsd (ccsd dactiver ce compte pour lutilisation des WS Passer du serveur de développement au serveur de production

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Consultation des référentiels internes de HAL (métadonnées, laboratoires, domaines scientifiques, etc.) accessible via le protocole HTTP à lURL : Serveur de production : wsdl : Serveur de développement / test : wsdl :

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Les laboratoires addRefLab : Ajout d'un laboratoire au référentiel getRefAffi : Récupération du référentiel des affiliations getRefAffi_byName : Récupération des affiliations à partir du nom getRefLab : Récupération des laboratoires getRefLab_byAffi : Récupération des laboratoires à partir de leurs affiliations getRefLab_byAuthor : Récupération des laboratoires d'un auteur getRefLab_byId : Récupération des informations d'un laboratoire getRefLab_byName : Récupération des laboratoires à partir de leurs noms getRefLab_byShortName : Récupération des laboratoires à partir de leurs sigles getRefLab_search : Recherche de laboratoires Les revues getRefReview : Récupération des revues getRefReview_byEditor : Récupération des revues à partir d'un éditeur getRefReview_byISSN : Récupération des revues à partir de l'ISSN getRefReview_byId : Récupération des informations sur une revue getRefReview_byName : Récupération des revues à partir d'un nom getRefAudience : Récupération des audiences des journaux Les domaines getRefSubject : Récupération des domaines scientifiques getRefSubject_byCode : Récupération des informations sur un domaine scientifique getRefSubject_byCodeParent : Récupération des domaines scientifiques à partir du code parent

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Les projets ANR getRefANR_byCode : Récupération des informations d'un projet ANR à partir d'un code getRefCodeANR : Récupération de la liste des codes ANR Les projets européen getRefCodeProjEurope : Récupération de la liste des projets européens getRefProjEurope_byCode : Récupération des informations sur un projet européen Les métadonnées getRefMetaData : Récupération de la liste des métadonnées à renseigner lors d'un dépôt getRefMetaData_forTypePubli : Récupération de la liste des métadonnées à renseigner pour un type de publication Les fichiers getRefDateVisible : Récupération des periodes d'embargo getRefFormat : Récupération des formats de fichiers déposables getRefRightFulltext : Récupération des droits sur un fichier Le dépôt getRefCollection : Récupération des collections d'un utilisateurs getRefInstance : Récupération des instances de la plateforme HAL getRefTypePubli : Récupération des types de publications

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Les organismes de thèse getRefOrgThe : Récupération des organismes de thèses getRefOrgThe_byName : Récupération des organismes de thèses à partir de leurs noms Les écoles doctorales getRefSchool : Récupération des écoles doctorales getRefSchool_byName : Récupération des écoles doctorales à partir d'un nom getRefSchool_byOrgThe : Récupération des écoles doctorales à partir d'un organisme de thèses

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Recherche dun laboratoire

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Recherche dun laboratoire

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Recherche dun laboratoire

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consultation des référentiels Recherche dun laboratoire

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Effectuer / Modifier un dépôt déposer, compléter, modifier un dépôt accessible via le protocole HTTP à lURL : Serveur de production : wsdl : ouvertes.fr/ws/submit.php?wsdl ouvertes.fr/ws/submit.php?wsdl Serveur de développement / test : wsdl :

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Effectuer / Modifier un dépôt Chaque dépôt en texte intégral est vérifié au CCSD 3 méthodes pour avertir les systèmes locaux de lévolution du dépôt (accepté, en attente de modification, refusé) : Par mail (identifiant, statut, motif si modification ou refus) Par script HTTP méthode POST identifiant version password status comment Par WebServices hal_article_status

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Effectuer / Modifier un dépôt addCollection : Tamponnage d'un article addFile : Ajout d'un fichier à une référence bibliographique cross : Ajout d'un domaine scientifique jref : Ajout / modification du type de publication d'un article modify : Correction d'un dépôt putOnLine : Mise en ligne d'un document sous embargo replace : Dépôt d'une nouvelle version status : Récupération du statut d'un dépôt update : Modification des métadonnées d'un article upload : Dépôt d'un article

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consulter / Rechercher des articles déposer, compléter, modifier des dépôts accessible via le protocole HTTP à lURL : Serveur de production : wsdl : ouvertes.fr/ws/search.php?wsdl ouvertes.fr/ws/search.php?wsdl Serveur de développement / test : wsdl :

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Consulter / Rechercher des articles existOnHAL : Recherche de l'existence d'un papier dans l'archive HAL suivant le titre getArticleCounter : Récupération des statistiques de consultation d'un article getArticleFile : Récupération du texte intégral d'un article getArticleMetadata : Récupération des métadonnées d'un article search : Recherche dans l'archive HAL

Formation « Utilisation avancée de HAL » - ccsd – 25 septembre Exemple de code Une recherche : Un dépôt: