Mise à jour de STAR par import (Cycle mise à jour)

Mise à jour de STAR par import (Cycle
mise à jour)
Version : 20-02-2012
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Table des matières
1. Quelles données envoyer à STAR pour mise à jour? ................................................................1
2. Comment faire du TEF ? .......................................................................................................2
2.1. Extraire de la base locale en CSV ................................................................................2
2.2. Convertir le fichier CSV en XML (avec exportizer par exemple) ...................................2
2.3. Transformer le fichier XML en TEF (à partir d’un XSLT de transformation) .................2
3. Comment importer dans STAR ? ...........................................................................................4
4. Comment utiliser le Service Messagerie électronique de dépôt pour importer dans STAR ? .......5
4.1. Rappel .......................................................................................................................5
4.2. Comment envoyer le message à STAR ? ......................................................................6
4.3. Quels sont les contrôles ? ............................................................................................7
5. Comment utiliser le Service Web de dépôt pour importer dans STAR ? ....................................9
5.1. Comment déposer les fichiers sur DepotTEF ? .............................................................9
5.2. Comment déposer les métadonnées de la thèse (fichier TEF) sans le document ? ..........10
5.2.1. Quels sont les paramètres ? ............................................................................10
5.2.2. Quels sont les contrôles ? ...............................................................................11
5.3. Comment déposer les métadonnées de la thèse (fichier TEF) et l’édition de diffusion ? .12
5.3.1. Quels sont les paramètres ? ............................................................................12
5.3.2. Quels sont les contrôles ? ...............................................................................12
5.3.3. Comment s’effectuent les validations ? ...........................................................12
ii
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Chapitre 1. Quelles données envoyer à
STAR pour mise à jour?
Les établissements de soutenance peuvent transférer leurs données (métadonnées et documents) par le
moyen d'un Web service ou par le simple envoi de message électronique (métadonnées seules).
Lors de la mise à jour, les métadonnées qui ne peuvent pas être modifiées sont :
• le numéro national de thèse
• l'url pérenne qui est construite à partir du numéro national de thèse
• l'url de diffusion sur la plateforme de l'ABES qui est construite à partir du numéro national de thèse
• le libellé de l'établissement de soutenance (qui est déjà en lecture seule lors du dépôt national)
• les données concernant l'édition d'archivage
• le champ CONTENTIDS
Dans le cadre d’une mise à jour, l’application STAR est capable de recevoir du TEF
[http://www.abes.fr/abes/page%2C403%2Ctef.html] :
• via un Service Web ou via messagerie électronique
• accompagné ou non du (des) fichier(s) thèse.
1
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Chapitre 2. Comment faire du TEF ?
Une application de gestion administrative des doctorants (du type Apogée) ne sait pas faire du TEF. Mais
en règle générale sait produire du CSV.
L'ABES collabore avec différents établissements pour mettre au point des programmes de conversion vers
TEF. Il s'agit de scripts XSLT qui permettent de passer d'un format XML vers TEF.
Exemples : ePrints, Dspace, OGET (Lyon 2)... vers TEF
Tous ces programmes sont publiés, réutilisables et modifiables par tous les établissements de soutenance.
Certaines applications de gestion administrative n'ont pas de format XML. Etant donné le nombre
d'établissements concernés, l'ABES propose un script pour transformer un export en format CSV vers
TEF.
2.1. Extraire de la base locale en CSV
Il n'y a pas de CSV normalisé d'un établissement à l'autre (les noms des entêtes de colonnes choisis
peuvent être différents…) nous vous proposons le modèle suivant (ce n'est bien sur qu'un exemple, vous
avez tout loisir d'exporter de façon différente vos données) :
Modèle de fichier CSV auquel les établissements peuvent se reporter pour effectuer leur propre export
localement afin de dénommer les entêtes de colonnes, spécifier les formats dates… (voir
Exemple_tabule.csv [http://documentation.abes.fr/aidestar/TEF/modeles/Exemple_tabule.csv])
Si vous effectuez des imports en majuscules il vous est demandé d’effectuer avant validation une
transformation en minuscules.
2.2. Convertir le fichier CSV en XML (avec
exportizer par exemple)
Il est nécessaire de transformer le CSV en XML via par exemple un logiciel libre de conversion comme
exportizer
(voir
mode
d’emploi
joint
[http://documentation.abes.fr/aidestar/pdf/Mode_Emploi_Exportizer.pdf]), voir exemple de fichier
résultat [http://documentation.abes.fr/aidestar/TEF/modeles/Exemple_tabule.xml].
2.3. Transformer le fichier XML en TEF (à partir
d’un XSLT de transformation)
L’ABES vous propose ensuite un XSLT de conversion de cet XML en TEF (Modele_xml2tef.xsl
[http://documentation.abes.fr/aidestar/TEF/modeles/Modele_xml2tef.xsl]). Attention, cet XSLT est en
version 2.0 et nécessite d'utiliser un processeur compatible 2.0 (exemple : Saxon-B, Gestalt,
AltovaXML...) – Cet XSLT est un exemple, chaque établissement peut bien sûr l’adapter à sa situation
locale, modifier les intitulés des colonnes, en ajouter….
L’ XSLT génère autant de fichiers TEF qu’il y a d’enregistrements (les fichiers TEF en question sont
2
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
créés dans un répertoire "out", paramètre modifiable) voir exemple de fichier résultat :
NICE_20005876.xml [http://documentation.abes.fr/aidestar/TEF/modeles/NICE_20005876.xml]
3
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Chapitre 3. Comment importer dans
STAR ?
Une fois les fichiers TEF créés, il ne reste plus à l’établissement qu’à les envoyer à STAR accompagnés
ou non du fichier thèse zippé (PDF ou XML).
STAR peut être alimenté par import de deux manières différentes :
• par imports complets de métadonnées via le Service Web
• par imports complets de métadonnées via la messagerie électronique
• Le Service Web ou la messagerie effectue un contrôle de conformité du fichier TEF envoyé. A l’issue
de cette étape le service renvoie à l’établissement deux fichiers résultats (fichier SVRL et fichier
HTML lisible).
Le Service Web effectue également un contrôle de validité du fichier thèse zippé.
4
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Chapitre 4. Comment utiliser le Service
Messagerie électronique de dépôt pour
importer dans STAR ?
L’établissement désirant utiliser le Service Messagerie électronique de dépôt doit dans un premier temps
déclarer ce paramétrage dans la FICHE ETABLISSEMENT (sous la responsabilité du
CORRESPONDANT STAR).
Il s’agit d’y déclarer :
• L’adresse de messagerie
Plusieurs adresses de messagerie peuvent être déclarées
• Le type de validation : cœur pour les imports par messagerie
4.1. Rappel
Pour alimenter STAR via la messagerie, vous devez envoyer des métadonnées de thèse au format TEF
(2.0).
• Consulter le site http://www.abes.fr/abes/documents/tef/index.html
Vous pouvez envoyer un fichier de métadonnées complet ou non.
Un fichier en TEF incomplet doit contenir au minimum :
• L’identifiant local de thèse (réutilisé dans l'attribut CONTENTIDS du mets:div de type 'THESE')
• Le Titre
• Le Prénom et Nom du doctorant
• La Date de soutenance
• La Discipline
• Le Nom de l'établissement de soutenance
• Le Type de doctorat
• Le Nom du directeur
5
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
4.2. Comment envoyer le message à STAR ?
L’accès au Service Messagerie électronique est contrôlé sur l’adresse de messagerie inclue dans le
« from » du message.
L’adresse de messagerie inscrite par le CORRESPONDANT STAR dans les paramètres de votre
environnement STAR (FICHE ETABLISSEMENT) vous permet ensuite d’alimenter STAR par envoi de
fichiers attachés.
Modalités à suivre pour l’envoi de vos messages :
Adresse du dépôt : [email protected] [mailto:[email protected]]
Sujet : Code court de votre établissement (INPL, PA01…)
Corps du message : Vide
Document attaché : Joindre un fichier TEF par thèse
Exemple de message :
6
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
4.3. Quels sont les contrôles ?
Le Service Messagerie électronique effectue un contrôle de conformité du fichier TEF envoyé, seule
cette étape est susceptible de renvoyer à l’établissement un message d’erreur de non conformité au
Schematron Validation Report Language (fichier SVRL et fichier HTML lisible). Pour connaître le
Schematron, consulter http://www.schematron.com/
• Exemples de réponse avec erreur
Puis en sélectionnant les détails :
7
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
• Exemple de réponse sans erreur
D’autres erreurs sont possibles : adresse de messagerie électronique non déclarée, erreur sur l’intitulé
court de l’établissement dans le sujet. Le système vous renverra un message.
En cas d’oubli de fichier TEF en document attaché, aucun message de retour n’est envoyé.
A l’issue de l’envoi conforme, l’établissement peut vérifier les données envoyées en se connectant à
l’application STAR à l’aide des logins de connexion (SCOL, FICH, BIBL, VALID ou STAR). Vous
pouvez :
• Compléter les métadonnées manquantes,
• Déposer le(s) fichier(s) thèse,
• Valider la fiche de thèse.
8
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Chapitre 5. Comment utiliser le Service
Web de dépôt pour importer dans
STAR ?
L’établissement désirant utiliser le Service Web de dépôt doit dans un premier temps déclarer ce
paramétrage dans la FICHE ETABLISSEMENT (sous la responsabilité du CORRESPONDANT STAR).
Il s’agit d’y déclarer :
• L’adresse IP (l’accès au Service Web est contrôlé sur adresse IP)
Plusieurs adresses IP peuvent être déclarées.
• Les caractéristiques du fichier source : TEF complet, TEF quasi-Complet (sauf autorités Sudoc), TEF
incomplet.
Les Services Web (en anglais Web Services) représentent un mécanisme de communication entre
applications distantes à travers le réseau internet indépendant de tout langage de programmation et de
toute plate-forme d'exécution :
- utilisant le protocole HTTP comme moyen de transport. Ainsi, les communications s'effectuent sur un
support universel, maîtrisé et généralement non filtré par les pare-feux ;
- employant une syntaxe basée sur la notation XML pour décrire les appels de fonctions distantes et les
données échangées ;
- organisant les mécanismes d'appel et de réponse.
5.1. Comment déposer les fichiers sur
DepotTEF ?
STAR dispose d’un Service Web fondé sur le protocole SOAP (1.1 et 1.2) et transporte les métadonnées
de thèses :
• au format TEF (2.0)
http://www.abes.fr/abes/documents/tef/index.html
• complet ou non
9
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
Un fichier en TEF incomplet doit contenir au minimum :
Un identifiant local de thèse (réutilisé dans l'attribut CONTENTIDS du mets:div de type 'THESE')
Titre
Prénom et nom du doctorant
Date de soutenance
Discipline
Nom de l'établissement de soutenance
Type de doctorat
Nom du directeur
• Avec ou sans le(s) fichier(s) thèse.
Le Service Web, permettant de déposer les métadonnées de thèses et les documents thèses, est accessible
via le protocole HTTP à l’URL suivante :
http://starimport.theses.fr/axis2/services/DepotTEF
Le WSDL de ce Service Web est disponible à la même URL en ajoutant en fin d’URL la chaîne « ?wsdl
»
ou
«
.wsdl
»
:
http://starimport.theses.fr/axis2/services/DepotTEF?wsdl
ou
http://starimport.theses.fr/axis2/services/DepotTEF.wsdl
[http://starimport.theses.fr/axis2/services/DepotTEF?wsdl]
2 méthodes pour DepotTEF sont possibles :
• Déposer les métadonnées de la thèse (fichier TEF) uniquement
• Déposer les métadonnées de la thèse et l’édition de diffusion
5.2. Comment déposer les métadonnées de la
thèse (fichier TEF) sans le document ?
Deposer : permet le dépôt des métadonnées de la thèse (fichier TEF) uniquement
5.2.1. Quels sont les paramètres ?
idEtablissement de type "xsd:string": identifiant de l’établissement déposant (code établissement sur 4
caractères) - paramètre facultatif, peut être récupéré dans la table de correspondance adresse IP/code
établissement
tef de type "xmime:base64Binary" : Jeu de métadonnées pour les thèses électroniques soutenues en
10
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
France (http://fr.wikipedia.org/wiki/Base64).
5.2.2. Quels sont les contrôles ?
Le Service Web effectue un contrôle de conformité du fichier TEF envoyé, seule cette étape est
susceptible de renvoyer à l’établissement un message d’erreur de non conformité au Schematron
Validation Report Language (fichier SVRL). Pour connaître le shematron, consulter
http://www.schematron.com/
Pour
une
lecture
plus
aisée,
un
lien
vers
un
XSLT
de
transformation
[http://documentation.abes.fr/aidestar/TEF/modeles/VoirSVRL.xsl] est intégré au fichier SVRL. Vous
pouvez toujours voir le détail des erreurs SVRL en affichant la source du document.
Exemple de réponse (extrait) :
Un message « en clair » explique la raison de la non-conformité du fichier TEF
5.3. Comment déposer les métadonnées de la
11
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
thèse (fichier TEF) et l’édition de diffusion ?
DeposerAvecZip : permet le dépôt des métadonnées de la thèse et l’édition zippée de diffusion.
5.3.1. Quels sont les paramètres ?
idEtablissement de type "xsd:string" : identifiant de l’établissement déposant (code établissement sur 4
caractères) - paramètre facultatif, peut être récupéré dans la table de correspondance adresse IP/code
établissement
tef de type "xmime:base64Binary" : Jeu de métadonnées pour les thèses électroniques soutenues en
France (http://fr.wikipedia.org/wiki/Base64).
zip de type "xmime:base64Binary": Encodage en base 64 qui encapsule le fichier zip
5.3.2. Quels sont les contrôles ?
• Le Service Web effectue un contrôle de conformité du fichier TEF envoyé, seule cette étape est
susceptible de renvoyer à l’établissement un message d’erreur de non conformité au Schematron
Validation Report Language (fichier SVRL). Pour connaître le shematron, consulter
http://www.schematron.com/
• Pour
une
lecture
plus
aisée,
un
lien
vers
un
XSLT
de
transformation
[http://documentation.abes.fr/aidestar/TEF/modeles/VoirSVRL.xsl] est intégré au fichier SVRL. Vous
pouvez toujours voir le détail des erreurs SVRL en affichant la source du document.
• Le Service Web contrôle la correspondance entre noms de fichiers déclarés dans le fichier TEF et noms
de fichiers présents dans le zip.
Exemple de réponse :
<svrl:text>
Le nombre de fichiers déclarés dans le TEF et le nombre de fichiers présents dans le ZIP ne sont pas
identiques.
<svrl:text>
5.3.3. Comment s’effectuent les validations ?
A l’issue d’un envoi conforme, l’établissement peut également vérifier la conformité des métadonnées et
du fichier envoyés en se connectant à l’application STAR à l’aide des logins de connexion SCOL, BIBL,
FICH et STAR.
• Vous pouvez compléter les métadonnées manquantes
• Vous pouvez déposer le(s) fichier(s) thèse
• Vous pouvez procéder aux validations
12
Mise à jour de STAR par import (Cycle mise à jour)
Version : 20-02-2012
L’ensemble des contrôles et validations se fait de façon synchrone et automatique, par FACILE du
CINES.
Chaque acteur devra intervenir afin de procéder à la validation des métadonnées sous sa responsabilité
(SCOL, BIBL, FICH, STAR).
Ces opérations peuvent paraître lourdes, mais l’ABES ne souhaite pas mettre en œuvre un système
complet et global sans prendre le temps de vérifier soigneusement chacune des étapes.
Pour les établissements effectuant des versements complets (TEF complet / valide et fichiers validés),
nous procéderons donc, dans un second temps, au chaînage complet des opérations sans qu’aucune
intervention dans l’application STAR ne soit nécessaire.
13