Envoyer et partager les copies sur OwncloudNextcloud

Version 2 (Rémi G., 03/19/2018 11:00 am)

1 1
h1. Présentation
2 1
3 1
"AMCtoOwncloud":https://github.com/remjg/AMCtoOwncloud est un _script Nautilus_ qui permet d'envoyer simplement les copies corrigées avec _Auto Multiple Choice_ sur un serveur _Owncloud/Nextcloud_.
4 1
5 1
Chaque copie est téléversée dans un dossier unique créé pour chaque étudiant qui sera :
6 1
* _partagé avec l'étudiant_ (qui peut être un utilisateur local ou distant sur un serveur fédéré) ;
7 1
* _partagé par lien_.
8 1
9 1
Les liens partagés sont ensuite sauvegardés dans un nouveau fichier @.csv@ (comportement par défaut) ou dans le fichier @.csv@ courant.
10 1
11 1
Après exécution du programme, la hiérarchie des fichiers est la suivante :
12 1
13 1
<pre>
14 1
Contrôles/
15 1
├── 3emeE/
16 1
|   ├── MOUSE Mickey (3998) - Interros Maths/
17 1
│   │   └── Interro 1 - MOUSE Mickey (3998).pdf
18 1
│   └── MOUSE Minnie (3999) - Interros Maths/
19 1
│       └── Interro 1 - MOUSE Minnie (3999).pdf
20 1
└── 4emeE/
21 1
    └── DUCK Donald (4999) - Interros Maths/
22 1
        └── Interro 1 - DUCK Donald (3999).pdf
23 1
</pre>
24 1
25 1
Les noms @Contrôles@, @Interro 1@, et @Interros Maths@ sont modifiables, et les autres champs sont extraits du fichier @.csv@ des étudiants. Par exemple, si vous n'avez pas de classes saisies dans votre fichier @.csv@, et si vous dossier racine est vide @''@, l'organisation des fichiers deviendra :
26 1
27 1
<pre>
28 1
MOUSE Mickey (3998) - Interros Maths/
29 1
    └── Interro 1 - MOUSE Mickey (3998).pdf
30 1
MOUSE Minnie (3999) - Interros Maths/
31 1
    └── Interro 1 - MOUSE Minnie (3999).pdf
32 1
DUCK Donald (4999) - Interros Maths/
33 1
    └── Interro 1 - DUCK Donald (3999).pdf
34 1
</pre>
35 2 Rémi G.
36 2 Rémi G.
h1. Utilisation
37 2 Rémi G.
38 2 Rémi G.
Faire un _clic droit_ sur les copies corrigées (ou sur les dossiers les contenant) et se rendre dans le menu _scripts_ :
39 2 Rémi G.
40 2 Rémi G.
!https://github.com/remjg/AMCtoOwncloud/raw/master/docs/UsingScript1-Menu.png!
41 2 Rémi G.
42 2 Rémi G.
Saisir le mot de passe _Owncloud_ , le nom du contrôle, et attendre :
43 2 Rémi G.
44 2 Rémi G.
!https://github.com/remjg/AMCtoOwncloud/raw/master/docs/UsingScript2-Output.png!
45 2 Rémi G.
46 2 Rémi G.
Les éventuels problèmes rencontrés devraient être indiqués (erreurs d'identification, d'envoi ou de partage, fichiers non associés à des étudiants, etc...).
47 2 Rémi G.
48 2 Rémi G.
h1. Installation
49 2 Rémi G.
50 2 Rémi G.
Copier @AMCtoOwncloud.sh@ and @.AMCtoOwncloud.py@ dans le répertoire des scripts Nautilus : @~/.local/share/nautilus/scripts/@
51 2 Rémi G.
52 2 Rémi G.
!https://github.com/remjg/AMCtoOwncloud/raw/master/docs/InstallingScript.png!
53 2 Rémi G.
54 2 Rémi G.
Installer les modules Python suivants :
55 2 Rémi G.
56 2 Rémi G.
@requests@, @lxml.html@, @owncloud@ (voir [pyocclient](https://github.com/owncloud/pyocclient)).
57 2 Rémi G.
58 2 Rémi G.
Généralement, les premiers sont déjà présents sous forme de paquets dans votre distribution. Pour installer le module @owncloud@, j'utilise la commande suivante :
59 2 Rémi G.
60 2 Rémi G.
<pre>
61 2 Rémi G.
pip3 install pyocclient
62 2 Rémi G.
</pre>
63 2 Rémi G.
64 2 Rémi G.
Vérifier que @gnome-terminal@ est installé ou éditer le fichier @AMCtoOwncloud.sh@ pour utiliser un autre terminal.
65 2 Rémi G.
66 2 Rémi G.
h1. Configuration
67 2 Rémi G.
68 2 Rémi G.
Éditer le fichier @.AMCtoOwncloud.py@ et changer les paramètres suivants à la fin du programme :
69 2 Rémi G.
70 2 Rémi G.
<pre>
71 2 Rémi G.
CSV = '/chemin/vers/csv/etudiants.csv'
72 2 Rémi G.
FOLDER = 'Contrôles/'
73 2 Rémi G.
ADDRESS = 'https://ncloud.zaclys.com'
74 2 Rémi G.
USERNAME = 'NomUtilisateur'
75 2 Rémi G.
</pre>
76 2 Rémi G.
77 2 Rémi G.
Le fichier @.csv@ contenant les informations des étudiants doit utiliser des points-virgules @;@ comme séparateurs ainsi que les en-têtes de colonnes ci-dessous (il y a des paramètres optionnels dans la méthode `identify_students()` pour personnaliser ce comportement, voir [plus bas](https://github.com/remjg/AMCtoOwncloud/blob/master/README-FR.md#cas-particuliers-dutilisation)):
78 2 Rémi G.
79 2 Rémi G.
<pre>
80 2 Rémi G.
group;surname;name;id;owncloud;email
81 2 Rémi G.
3emeE;MOUSE;Mickey;3998;cabitzmil;mickeymouse@domain.com
82 2 Rémi G.
3emeE;MOUSE;Minnie;3999;agrevet;minniemouse@domain.com
83 2 Rémi G.
4emeE;DUCK;Donald;4999;prenaud@aFederatedServer.com;donaldduck@domain.com
84 2 Rémi G.
</pre>
85 2 Rémi G.
86 2 Rémi G.
Enfin, *les copies corrigées doivent comporter le numéro d'étudiant* dans leur nom de fichier
87 2 Rémi G.
(le premier nombre est extrait pour associer chaque copie à l'étudiant correspondant). Pour ce faire, ne pas oublier de configurer _auto-multiple-choice_ avec les mêmes en-têtes que dans votre fichier @.csv@ :
88 2 Rémi G.
89 2 Rémi G.
!https://github.com/remjg/AMCtoOwncloud/raw/master/docs/RenamingAnnotatedPapers.png!