Commit e7f75e14 authored by LE GAC Renaud's avatar LE GAC Renaud
Browse files

Update the documentation.

parent 1e8eff7a
......@@ -10,18 +10,19 @@ KM3NET,proceedings,inspirehep.net,find km3net and not antares and tc c,ACTI
ATLAS,articles,cds.cern.ch,ATLAS Papers,ACL
ATLAS,talks,cds.cern.ch,ATLAS Conference Slides,COM
ATLAS,proceedings,inspirehep.net,find atlas and tc c,ACTI
ATLAS,theses,cds.cern.ch,ATLAS Theses,PHD
ATLAS,theses,cds.cern.ch,ATLAS Theses,PHD
D0,articles,inspirehep.net,find cn d0 and tc p and not tc c,ACL
D0,proceedings,inspirehep.net,find cn d0 and tc c,ACTI
D0,preprints,inspirehep.net,find D0 and not tp p and not tc c,PRE
H1,articles,inspirehep.net,find cn h1 and tc p and not tc c,ACL
H1,proceedings,inspirehep.net,find h1 and tc c,ACTI
LHCb,articles,cds.cern.ch,"LHCb Papers, LHCb Detector Performance Papers",ACL
LHCb,articles,inspirehep.net,find cn LHCb and tc p and not tc c,ACL
LHCb,notes,cds.cern.ch,"LHCb Notes, LHCb Conference Contributions",AP
LHCb,preprints,cds.cern.ch,"LHCb Papers, LHCb Detector Performance Papers",PRE
LHCb,proceedings,cds.cern.ch,LHCb Conference Proceedings,ACTI
LHCb,reports,cds.cern.ch,LHCb Reports,AP
LHCb,talks,cds.cern.ch,LHCb Talks,COM
LHCb,theses,cds.cern.ch,LHCb Theses,PHD
LHCb,theses,cds.cern.ch,LHCb Theses,PHD
SuperNEMO,articles,cds.cern.ch,SuperNEMO Papers,ACL
SuperNEMO,articles,inspirehep.net,find cn SuperNEMO and tc p and not tc c,ACL
......@@ -3,3 +3,4 @@ IPNL,`902974 <http://inspirehep.net/record/902974>`_
LAL,`903100 <http://inspirehep.net/record/903100>`_
LAPP,`903421 <http://inspirehep.net/record/903421>`_
LPC Caen,`902703 <http://inspirehep.net/record/902703>`_
LPSC, `902828 <http://inspirehep.net/record/902828>`_
\ No newline at end of file
......@@ -74,11 +74,9 @@ du laboratoire, il faut définir *l'identifiant* du laboratoire :
Définir un moissonneur
^^^^^^^^^^^^^^^^^^^^^^
Un moissonneur est affecté à chaque couple (``équipe``, ``projet``) pour chaque
catégorie de publication définit par la paire de variables (``catégorie``, ``code``)
Ici, la variable catégorie est très similaire à celle définie dans le chapitre
:ref:`categories`, mais corresponds en faite à l’automate logiciel qui va
analyser les données. C'est pourquoi leurs noms sont en anglais.
Les automates logiciels sont au nombre de sept :
catégorie de publication définit par la paire de variables
(``automate``, ``code``). La variable ``automate`` est le nom de l’automate
logiciel qui va analyser les données. Il y en a sept :
* ``articles``
* ``notes``
......@@ -113,8 +111,8 @@ Il a sept champs :
* **projet**
choisir une valeur parmi les projets définis.
* **catégorie**
choisir une valeur parmi les automates logiciels
* **automate**
choisir un automate parmis les valeurs proposées.
* **entrepôt**
choisir un entrepôt
* **collections**
......@@ -132,14 +130,23 @@ Il a sept champs :
find cn d0 and tc p and not tc
sélectionne les articles publiés par la collaboration D0.
* **ratio**
paramètre historique qui devrait disparaître dans la version 0.9.
* **code**
c'est le code AERES. Il dépend du choix de l'automate logiciel.
* **scan**
le moissonneur sera exécuté lors d'un moissonnage automatique
quand cette valeur est coché
.. note::
Il est possible de définir plusieurs moissonneurs qui recherche, par
exemple, les articles de la collaboration LHCb. Le premier dans
l'entrepôt `cds.cern.ch`_ et le second dans `inspirehep.net`_.
.. warning::
It n'est pas posssible de définir plusieurs moissoneur quand le premier
recherche, par exemple, les articles de LHCb de catégorie ``ACL`` et
le second ceux de catégorie ``ACLN``.
Les configurations existantes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Les configurations existantes et éprouvées sont données dans
......@@ -182,21 +189,21 @@ cette exécution. Il comprend cinq champs :
une année quand le premier champ est défini, une période couvrant
plusieurs années quand les deux champs sont définis.
* **Projet**
choisir un projet
* **Catégorie**
choisir un automate logiciel
choisir un projet.
* **Automate**
choisir un automate logiciel.
* **Mode**
dans le mode ``essai à blanc`` la base de données n'est pas modifié
dans le mode ``essai à blanc`` la base de données n'est pas modifié.
* **Format du rapport**
le rapport d'exécution peut être extrait au format PDF ou LaTeX
le rapport d'exécution peut être extrait au format PDF ou LaTeX.
Pour lancer le moissonnage cliquer sur le bouton ``Go``
Pour lancer le moissonnage cliquer sur le bouton ``Go``.
Après un certain temps, parfois plusieurs minutes, le compte rendu du moissonnage
Après un certain temps, plusieurs minutes, le compte rendu du moissonnage
apparait sur le panneau central.
.. note::
le bouton ``>>`` à la droite du *selector* permet de la masquer /
le bouton ``>>`` à la droite du *selector* permet de le masquer /
démasquer.
Comprendre le rapport
......@@ -229,8 +236,8 @@ sur la fiche dans l'entrepôt.
:align: center
:width: 90%
La liste des publications pour lesquelles les auteurs ne sont
pas encore définis.
La liste des articles soumis mais qui ne sont pas encore
publiés.
Parfois, un enregistrement rejeté par un moissonneur peu être corrigé par
l'utilisateur puis insérer dans la base. Pour lancer cette opération, lancer le
......@@ -363,13 +370,93 @@ l'année *x+1* inclut jusqu’à l'année courante.
Moissonnage automatique
^^^^^^^^^^^^^^^^^^^^^^^
Cette fonctionnalité sera disponible à partir de la version 0.9.
Cette fonctionnalité n'est pas encore disponible.
Opérations effectuées par un automate
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. index::
pair: Automate; Opérations effectuées par un automate
#. Demande à l'entrepôt, les identifiants (*id*) des publications
qui correspondent à la requête de l'utilisateur.
#. Élimine tous les identifiants pour lesquels ils existent un enregistrement
dans la base de donnée. La comparaison est effectuée en utilisant le
champ *origin*.
#. Demande à l'entrepôt, les descriptions XML des publications restantes.
La syntaxe XML est vérifiée et les données sont décodées.
#. Rejette les publications pour lesquelles ils existent un enregistrement
dans la base de données qui corresponds au *secondary_oai_url*.
La comparaison est effectuée en utilisant le champ *origin*.
Cette étape est nécessaire quand des articles sont
moissonnés dans plusieurs entrepôts.
#. Vérifie que l’identifiant *oai* de la publication est bien défini et
correspond à la trame attendue.
Il est créé, si ce n'est pas le cas. A cette étape l'identifiant *oai*
est toujours définit.
#. Rejette les publications dite *temporaire*.
#. Vérifie que les *auteurs* sont définis. Rejette la publication si ce
n'est pas le cas.
#. Vérifie que *mon laboratoire* est dans la liste des laboratoires
qui signent la publication. Rejette la publication si ce n'est pas
le cas. Quand les affiliations ne sont pas définies, les auteurs de
mon laboratoire sont cherchés en utilisant la fameuse
*liste de secours pour les auteurs de mon laboratoire*.
Rejette la publication quand elle n'est pas signé par au moins un
auteur de mon laboratoire.
#. Vérifie que la *collaboration* est bien défini et est en accord avec les
règles typographiques utilisées par la base de données.
Rejette la publication si ce n'est pas le cas.
#. Plusieurs vérifications sont alors effectuées. Elles dépendent de la
catégorie de la publication. Elles concernent, la revue, le pays,
*etc*.
#. A la fin de ce processus, la revue, le nom des auteurs sont formaté selon
les règles typographiques utilisées en France.
Finalement, la liste des signataires de mon laboratoire est extraite.
#. La publication est cherchée dans la base de donnée en utilisant des
informations comme le titre, l'année de la publication, la revue, *etc*.
Les informations utilisées dépendent de la catégorie de la publication.
Rejette la publication quand une correspondance a été trouvée.
#. Insère la publication dans la base de données.
Les synonymes
^^^^^^^^^^^^^
.. index::
pair: Moissonner; Synonymes
Au court d'un moissonnage, l'automate rejette une publication si la
*collaboration*, le *pays* ou la *revue* ne correspond pas à une valeur
existante dans la base de donnée.
Ces informations sont sujettes à beaucoup de variations : ::
LHCb Collaboration, LHCb col., LHCb c., LHCb, ...
Afin de minimiser le processus de correction, le mécanisme *synonyme* a été
mis en place. Il se base sur le champ ``synonymes`` des tables
``collaborations``, ``pays`` et ``revues``.
La logique est la suivante :
#. Un automate cherche si la *collaboration* est définie dans le champ
``collaborations.collaboration``.
#. Si ce n'est pas le cas, il cherche si le champ ``collaborations.synonyms``
contient la valeur. Rejette la publication quand il n'y a pas
de correspondance. Dans ce cas, la valeur incriminée est affichée dans
le rapport de moissonnage, dans la colonne *synonyme*.
#. L'utilisateur peut alors entré cette valeur dans la table
``collaborations`` en tant que synonyme par exemple,
puis relancer le moissonneur.
.. _arcanes:
Les arcanes du format MARC
^^^^^^^^^^^^^^^^^^^^^^^^^^
.. index::
pair: Format; MARC12
Les enregistrements retournés par un entrepôt sont au format MARC_ qui est
un standard pour décrire des données bibliographique.
Dans ce standard, les données sont structuré à travers un jeu de clé
......
docs/user/images/form-harvester.png

28.9 KB | W: | H:

docs/user/images/form-harvester.png

24.4 KB | W: | H:

docs/user/images/form-harvester.png
docs/user/images/form-harvester.png
docs/user/images/form-harvester.png
docs/user/images/form-harvester.png
  • 2-up
  • Swipe
  • Onion skin
docs/user/images/home-harvester.png

76.6 KB | W: | H:

docs/user/images/home-harvester.png

76.6 KB | W: | H:

docs/user/images/home-harvester.png
docs/user/images/home-harvester.png
docs/user/images/home-harvester.png
docs/user/images/home-harvester.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -3,6 +3,7 @@
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Guide utilisateur
=================
......@@ -31,9 +32,3 @@ Annexe
institute_identifier
Index
=====
* :ref:`genindex`
* :ref:`search`
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment