SACoche : Évaluer par compétences et estimer la maitrise du socle commun

Menu de gauche

Interfaçage des évaluations avec un module externe

Fonctionnalité nécessitant le codage et la mise en place du module externe par vos soins.


Générer des énoncés d’évaluation

Principe

À partir d’une banque d’exercices pour chaque item, certains mettent en place des outils de génération d’énoncés, souvent à composante aléatoire pour des (ré)évaluations personnalisées (exemple).
Une fois l’évaluation créée dans SACoche (date, titre, élèves, items, …), l’idée est de transmettre à cet outil les informations afin qu’il génère les énoncés.

Liaison avec le module externe / Fonctionnement

Se connecter à SACoche avec un compte professeur et se rendre dans le menu ÉvaluationsInterfaçage avec un module externe.
Y renseigner l’adresse de la page du module externe à appeler.
Par exemple https://www.mon-site-perso.fr/generer-enonces.php.

Dans le menu ÉvaluationsÉvaluer une classe ou un groupe ou Évaluer des élèves sélectionnés, créer une évaluation si besoin.
Dans la liste des actions associées à une évaluation se trouve alors l’icône action_module.
Cliquer dessus appelle le module en lui transmettant en GET l’adresse du fichier de données, avec la variable "json".
Par exemple https://www.mon-site-perso.fr/generer-enonces.php?json=url-du-fichier-de-donnees.

Spécifications techniques

Le fichier de données, au format JSON donc, contient un tableau selon ce modèle (encodage UTF-8).

  {
    "structure" : {
      "uai" : ...,
      "id"  : ...,
      "nom" : ...,
    },
    "devoir" : {
      "id"       : ...,
      "groupe"   : ...,
      "intitule" : ...,
      "date"     : ...,
    },
    "prof" : {
      "id"     : ...,
      "nom"    : ...,
      "prenom" : ...,
    },
    "item" : {
      id : {
        "id"  : ...,
        "ref" : ...,
        "nom" : ...,
      },
      ...
    },
    "eleve" : {
      id : {
        "id"     : ...,
        "nom"    : ...,
        "prenom" : ...,
      },
      ...
    },
    "panier" : {
      eleve_id : {
        item_id : true,
        ...
      },
      ...
    }
  }
  

Les données peuvent être récupérées par exemple comme ceci en langage PHP.

  <?php
  header('Content-Type: text/html; charset=utf-8');
  if(isset($_GET['json']))
  {
    $file_data = file_get_contents($_GET['json']);
    $array_data = json_decode($file_data,TRUE);
    // affichage pour vérification
    echo'<pre>';
    print_r($array_data);
    echo'</pre>';
  }
  ?>
  

Importer une évaluation (avec des notes)

Principe

À partir d’une interface de travail externe (QCM ou autre), certains génèrent ou saisissent des notes.
L’idée est de transmettre les informations à SACoche afin qu’il créé une évaluation correspondante et y importe les notes.
Par "note" il faut comprendre un code de notation utilisé dans SACoche ; si l’interface externe génère par exemple une note chiffrée sur 20, c’est à vous de la convertir préalablement en niveau de compétence.

Liaison avec le module externe / Fonctionnement

Se connecter à SACoche avec un compte professeur et se rendre dans le menu ÉvaluationsInterfaçage avec un module externe.
Y renseigner l’adresse du dossier du module externe où le fichier avec les informations à récupérer sera trouvé.
Par exemple https://www.mon-site-perso.fr/bilan-evaluation/.

Se rendre dans le menu ÉvaluationsÉvaluer des élèves sélectionnés.
Dans la liste d’en-tête à côté de l’icône action_ajouter se trouve alors l’icône action_module.
Cliquer dessus permet d’indiquer le nom du fichier à récupérer avec les données à importer.
Par exemple evaluation-1234.json ou generer-export-json.php?id=1234.

Il est aussi possible d’appeler SACoche pour qu’il charge le fichier directement, avec une adresse de cette forme :
https://adresse-de-sacoche/?page=evaluation&section=gestion_selection&import=nom-du-fichier.

Spécifications techniques

Le fichier de données, au format JSON donc, doit contenir un tableau selon ce modèle (encodage UTF-8).
Les indications entre parenthèses sont informatives, elles ne font pas partie du contenu du fichier.
Les identifiants nécessaires des élèves et des items peuvent être récupérés depuis le menu Informations personnellesExtraction de données.
Les codes de notation sont ceux de saisie au clavier (DOC), éventuellement modifiés (voir votre menu Informations généralesCodes de notation / États d’acquisition).

  {
    "date_devoir"  : ..., (JJ/MM/AAAA)
    "date_visible" : ..., (JJ/MM/AAAA)
    "intitule"     : ..., (maxlength 60)
    "diagnostic"   : ..., (0|1)
    "discret"      : ..., (0|1)
    "saisie" : {
      eleve_id : {
        item_id : ..., (1|2|3|4|A|D|E|F|N|R|P)
        ...
      },
      ...
    }
  }
  

Les données peuvent être générées par exemple comme ceci en langage PHP.
Les seuls caractères autorisés pour le nom du fichier sont les lettres non accentuées, les chiffres, et "-_.?&".

  <?php
  $array_data = array(
    'date_devoir'  => $date,
    'date_visible' => $date,
    'intitule'     => $titre,
    'diagnostic'   => 0,
    'discret'      => 0,
    'saisie        => array(),
  );

  $array_data['saisie'][$eleve_id1][$item_id1] = $note1;
  $array_data['saisie'][$eleve_id2][$item_id2] = $note2;
  ...

  $json_data = json_encode($array_data);

  // Pour une écriture dans un fichier
  file_put_contents($filename,$json_data);

  // Pour une sortie directe
  header('Content-Type: application/json; charset=utf-8');
  header('Content-Length: '.strlen($json_data));
  exit($json_data);
  ?>
  

SACoche vérifie que les élèves sont affectés à l’enseignant, que les items existent, et que les notes sont valides.
Chaque import créé une nouvelle évaluation et de nouvelles saisies : attention aux doublons !


Documentations associées