DocScoDocMM/docs/FAQ.md

7.9 KiB

FAQ / Questions fréquemment posées

Le projet ScoDoc

Qui sont les développeurs ? Le projet est-il pérenne ?

ScoDoc a été conçu et développé par Emmanuel Viennet, puis complété par plusieurs contributeurs, enseignants ou BIATSS dans les IUT et universités. Son développement est toujours actif, voir le dépôt git https://scodoc.org/git.

En 2020, une association a été créée pour soutenir et pérenniser le projet: par exemple pour acquérir services et équipements pour le développement informatique, recruter stagiaires, apprentis, ou mener une veille scientifique et technologique sur le sujet: voir AssociationScoDoc. L'avenir du logiciel dépend donc de vous: adhérez, ou incitez votre institution (département IUT, Institut, École) à le faire.

Utilisation de ScoDoc

Comment prendre en compte les notes de sport ou autres bonus ?

Voir CalculNotes

Qui peut voir les notes, et quand ?

Tous les collègues (enseignants et administratifs) pouvant accéder au département peuvent voir les notes, en passant par la page du module concerné.

Les notes n'apparaissent dans les bulletins et tableaux récapitulatifs que lorsqu'elles sont prises en compte dans les moyennes: soit parce que toutes les notes des étudiants inscrits à cette évaluation sont saisies, soit parce qu'il s'agit d'une évaluation avec "prise en compte immédiate".

Les étudiants n'ont pas accès à ScoDoc, et ne peuvent donc pas voir leurs notes, sauf si une interface spécifique est configurée ("portail", avec affichage sur leur ENT en général, cet affichage pouvant être désactivé depuis ScoDoc pour un semestre particulier). A défaut, il faut leur envoyer leurs bulletins par mail.

Comment supprimer une évaluation ?

  1. Supprimer toutes les notes saisies dans cette évaluation, s'il y en a: passer par la page "Saisie des notes" et suivre le lien "Effacer toutes les notes de cette évaluation".

  2. Lorsqu'il n'y a plus de notes, une croix rouge apparait sur le tableau de bord du module: cliquer dessus pour supprimer l'évaluation.

En IUT, comment gérer les licences professionnelles ?

  • On peut créer un département regroupant les licences, ou bien rattacher chaque licence à un département existant. Cette dernière solution est préférable si des étudiants de DUT poursuivent en licence (ainsi, on a automatiquement accès à leur parcours complet).

  • La plupart des licences pro durent un an, mais sont gérées comme un seul semestre (pas de jury à mi-parcours). Indiquer "pas de semestre" dans l'option "Semestre dans la formation" (page "modification du semestre").

Comment gérer les étudiants les démissionnaires ?

  • Sur la fiche d'un étudiant, on peut choisir plusieurs options:

    • Supprimer cet étudiant : il sera totalement supprimé de la base, sans remède. Cette option n'est en principe jamais utile, sauf pour corriger une fausse manœuvre au moment des inscriptions.

    Ou bien au niveau de son inscription dans un semestre, via le menu Scolarité:

    • Démission : l'étudiant restera dans le semestre, mais sera indiqué comme démissionnaire. C'est ce qu'il faut faire quand un étudiant signale son abandon en cours d'année, passé le délai légal ou il peut se désengager (typiquement, après le 15 octobre).

    • Désinscrire (en cas d'erreur) : l'étudiant reste dans ScoDoc, ses données (et ses notes) sont conservées, mais il n'est plus inscrit au semestre et n'apparait plus dans les listes. C'est ce qu'il faut choisir en début d'année, soit en cas d'erreur de manipulation, soit si l'étudiant abandonne en tout début d'année (il ne sera alors pas compté dans les inscrits).

Mes données sont erronées, que faire ?

En cas de problème (bug, erreur de manipulation, suspicion de piratage), différents journaux peuvent être consultés.

Les utilisateurs autorisés peuvent facilement voir:

  • les opérations effectuées sur un étudiant (inscriptions, saisies d'absences, ...), accessibles via le menu "Etudiant" / "Voir le journal..." en haut de sa fiche individuelle.

  • les différentes saisies de notes, via le formulaire de saisie de notes (toutes les valeurs précédemment saisies sont conservées, ainsi que la date et l'identité de l'utilisateur ayant effectué la saisie).

Les administrateurs (informaticiens) peuvent aussi consulter les journaux (logs) du serveur, voir plus loin.s

Comment signaler un problème ?

Nous vous remercions de nous signaler tous les problèmes que vous rencontrez: erreurs, comportement bizarre ou malcommode. Nous ne promettons pas de les régler rapidement, ni même plus tard: le logiciel est fourni sans aucune garantie. Mais nous faisons de notre mieux:

Configuration

Comment changer les logos sur les documents PDF (PV...)

Il faut (pour l'instant) être administrateur sur le serveur ScoDoc, et passer par l'onglet "configuration" accessible aux admins sur la page d'accueil.

Les logos sont stockés dans le répertoire /opt/scodoc-data/config/logos/ et doivent être des images JPEG (extension .jpg). Il faut aussi indiquer les tailles des images dans le fichier de configuration config/scodoc_config.py, variable CONFIG.LOGO_FOOTER_HEIGHT etc.

  • Sur les PV, logo_header.jpg est affiché en haut, et logo_header.jpg en bas de la page.
  • Sur les bulletins de notes, c'est configurable (et on peut utiliser d'autres logos), voir ParametrageBulletins

Administration

Quel système d'exploitation ?

ScoDoc est accessible depuis n'importe quel navigateur Web (Firefox, Chrome, ...).

Le serveur ScoDoc fonctionne sous linux. Il n'est testé qu'avec Debian (stable). Le script d'installation ( GuideInstallDebian11 ) assure l'installation de tout les éléments nécessaires au bon fonctionnement de ScoDoc. Une distribution sous forme de container Docker est envisagée.

Quand et comment mettre à jour le logiciel ?

Des améliorations et corrections sont fréquemment introduites. Les plus importantes sont annoncées sur la liste de diffusion "scodoc-annonces". Les mises à jour sont normalement automatiquement appliquées chaque semaine. Voir aussi la page MisesAJour.

Quelles sauvegardes des données ?

Voir SauvegardesBases.

Où sont les journaux (logs) ?

Les administrateurs du serveur peuvent consulter:

  • Le journal du serveur Web (nginx)
/var/log/nginx/scodoc*.log
  • le fichier /opt/scodoc-data/log/scodoc.log reçoit des messages de déboggage de ScoDoc.

J'ai installé ScoDoc mais je n'ai pas de certificat SSL !

Il est de plus en plus important d'installer un certificat SSL; les navigateurs Web sont de plus en plus méfiants et vos utilisateurs seront très gênés si votre ScoDoc n'a pas de certificat valide. Si votre établissement (par exemple via RENATER) ne vous fournit pas de de certificat, je conseille de passer par Let's Encrypt dont l'utilisation est très simple et rapide.

Pour vos tests en local, avec Chrome, modifier le paramétrage en réglant: chrome://flags/#allow-insecure-localhost (et/ou taper "thisisunsafe" sur la page bloquée).

Comment supprimer un département ?

Voir les commandes d'administration dans GuideConfig

Comment contribuer au projet ?

Voir la page.