11.9.4. Importer un fichier de référentiel de compétences¶
Administration menu → Extensions → Compétences → Importer
Vous pouvez importer un référentiel en cliquant sur le lien Importer dans la navigation du module Compétences. Le fichier du cadre doit se terminer par l’extension .matrix pour être reconnu et interprété par Mahara.
Téléverser un fichier .matrix contenant le référentiel de compétences.¶
Cliquez sur le lien Importation pour accéder à l’écran où vous pouvez téléverser un fichier de référentiel de compétences.
Cliquez sur le le bouton Browse pour sélectionner le fichier qui contient le référentiel de compétences que vous désirez utiliser.
Cliquez sur le bouton Téléverser la matrice pour téléverser le fichier.
Le fichier est vérifié pour détecter les problèmes de structure du fichier. Il est rejeté si des problèmes sont rencontrés. Les problèmes les plus courants sont :
Le nom court comporte plus de 100 caractères.
Le nom d’un élément de niveau comporte plus de 255 caractères.
La ponctuation ou les parenthèses ne sont pas correctes.
Un validateur JSON tel que JSON Formatter & Validator ou JSON Formatter peut généralement dénicher les erreurs de syntaxe. Les erreurs de longueur de caractères doivent être résolues manuellement.
11.9.4.1. Créer un fichier de référentiel de compétences¶
Commencez avec référentiel de compétences en téléchargeant un fichier existant <https://seafile.catalyst.net.nz/d/c5a4876b06>`_. Vous pouvez ensuite effectuer un nombre quelconque de modifications.
Note
Si vous avez créé vos propres fichiers référentiels de compétences SmartEvidence et que vous souhaitez partager avec la communauté, veuillez nous les envoyer pour examen et inclusion dans la zone de téléchargement.
Vous pouvez utiliser n’importe quel éditeur de texte pour créer et modifier vos fichiers du cadre SmartEvidence. Si vous avez un éditeur qui supporte la coloration syntaxique pour les fichiers JSON, vous avez un avantage car vous pouvez différencier le texte que vous pouvez modifier des invites dont Mahara a besoin pour interpréter le fichier.
Vous pouvez également utiliser un éditeur JSON, par exemple JSON Editor Online ou JSONedit. Vous pouvez visualiser votre fichier même sans trop connaître la syntaxe JSON.
Note
Il est préférable de commencer votre référentiel à l’aide d’un des exemples car vous voyez alors bien la structure et avez tous les éléments pertinents dans le fichier.
11.9.4.2. Début du fichier¶
Un fichier décrivant un référentiel de compétences contient en en-tête un nombre de paramètres qui vous permet de le modifier à votre guise et en fonction de vos besoins.
L’entête du fichier de la matrice¶
institution : Le nom court de l’institution dans laquelle le cadre doit être utilisé est saisi ici. Si le référentiel est destiné à toutes les institutions, le paramètre all est placé ici.
Note
Le nom court de l’institution peut être vu en passant la souris sur le nom de l’institution sur la Page de présentation des institutions et en regardant la fin de l’URL. Le dernier paramètre est le nom court de l’institution.
name: Le titre du référentiel tel qu’il doit être présenté aux auteurs.
description : La description du référentiel qui sera affichée sur la page du module Compétences dans une collection. Cette rubrique contient du code HTML standard.
Si le code HTML du champ de description nécessite l’utilisation de guillemets, ceux-ci doivent être échappés. Sinon, ils seraient interprétés comme des commandes. L’échappement se fait en plaçant une barre oblique inverse juste devant le guillemet :
\".selfassess: Déterminez si les personnes peuvent auto-évaluer leurs compétences ou si les compétences ne peuvent être évaluées que par quelqu’un d’autre. Les deux valeurs suivantes sont autorisées :
true: Les auteurs peuvent s’auto-évaluer.
false: Les auteurs ne peuvent pas effectuer d’auto-évaluation.
evidencestatuses: Actuellement, quatre statuts peuvent être utilisés dans une matrice de compétences : commencé, incomplet, partiellement atteint et atteint. Vous pouvez décider quels mots sont utilisés pour ces statuts dans le référentiel que vous configurez. Par exemple, cela vous permet de mettre en place des référentiels dans différentes langues.
standards : Le reste du document concerne les normes et sous-normes qui composent les compétences.
Note
Soyez prudent lorsque vous modifiez un fichier d’un référentiel de compétences. Veillez à ne pas supprimer les virgules, les guillemets, les parenthèses, les accolades ou toute autre marque dans les sections que vous utilisez. Ils sont nécessaires à l’interprétation correcte du fichier.
Vous pouvez vérifier si votre fichier contient toute la syntaxe nécessaire en le collant dans le JSON Formatter and Validator par exemple. S’il y a des problèmes et que JSON ne peut pas interpréter votre fichier, le validateur précise les endroits où les erreurs se produisent afin que vous puissiez les retrouver et les corriger.
11.9.4.3. Section des niveaux de compétences¶
Vous pouvez définir les Niveaux à la suite des informations initiales. Ils correspondent au niveau des en-têtes de la page d’aperçu du module Compétences.
Les niveaux dans un fichier matriciel¶
standards : Introduction de cette section. Vous pouvez définir autant de niveaux que vous désirez. Il n’y a pas de limite.
shortname : Chaque compétence doit avoir un nom court, par exemple un numéro ou un résumé du titre complet. Le nom court est obligatoire et comporte au maximum 100 caractères.
name : Titre du niveau de compétence. Cette information est requise et peut contenir jusqu’à 255 caractères.
description : La description est optionnelle et elle est affichée lorsque vous placez la souris sur le nom du niveau (toucher-cliquer sur une plateforme mobile).
standardid : Donnez à chaque niveau une valeur cardinale afin qu’il puisse être affiché dans l’ordre que vous désirez et aussi qu’on puisse se référer à cette numérotation dans les éléments de définition de la compétence.
Ne placez pas de virgule après l’accolade finale du dernier niveau.
11.9.4.4. Section des éléments du niveau de compétence¶
Définissez toutes les éléments qui forment le niveau de compétence; par ex. les sous-niveaux d’acquisition de compétence tendant vers l’acquisition de la compétence globale. C’est à ces éléments que vous allez pouvoir ajouter des production pour prouver l’atteinte de la compétence.
Note
Placez les sous-niveaux directement après le niveau principal afin que le groupage se fasse correctement.
Les éléments d’un niveau de compétence dans le fichier matriciel¶
standardelements : Introduction à la section. Il n’y pas de limite quant au nombre d’éléments qui caractérisent un niveau de compétence.
shortname: Le nom court est affiché sur la page de présentation du référentiel SmartEvidence. Il est obligatoire et comporte un maximum de 100 caractères.
name : Le titre de l’élément pour le niveau de compétence visé. Cette rubrique est obligatoire et peut contenir au maximum 255 caractères.
description: La description est facultative et s’affiche lorsque vous passez la souris sur le nom de la compétence (clic tactile sur mobile).
stadardid : Correspond à l’identifiant (ID) du niveau auquel se rattache l’élément défini avant.
elementid : Attribuez à votre élément caractérisant le niveau de compétence un identifiant unique (ID). De cette manière vous pourrez lier un ou plusieurs sous-niveau à ce niveau. L’identifiant doit être placé entre deux guillemets simples.
parentelementid : Correspond à l’identifiant de l’élément parent. En renseignant cette information, vous faite de cet élément un sous-élément dépendant de l’élément parent. L’identifiant doit être placé entre deux guillemets simples.
Note
Lorsqu’un élément qui caractérise un niveau de compétence a un sous-niveau, le premier ne peut pas être associé à une production; seul le dernier sous-niveau peut se voir attribué une production par l’utilisateur afin de prouver qu’il a atteint celui-ci.
11.9.4.5. La fin du fichier¶
Lorsque vous avez défini tous vos niveaux ainsi que les éléments qui les caractérisent, vous pouvez terminer le fichier.
La fin du fichier matriciel¶
Ne mettez pas de virgule après la dernière accolade du dernier élément de niveau.
Assurez-vous que tous les crochets.
11.9.4.6. Le résultat¶
Une fois le fichier terminé, vous pouvez l’importer dans Mahara et commencer à l’utiliser.
Le résultat final une fois le fichier téléversé¶
Titre du référentiel de compétences
Description du référentiel de compétences
Un niveau. On ne peut pas lui attribuer une production. Les productions sont attribuées seulement au plus bas des sous-niveaux.
Un élément d’un niveau de compétence
Un niveau de compétence avec un sous-niveau. Seul le dernier sous-niveau peut se voir rattaché des productions.
Un troisième niveau d’éléments.
Note
Vous pouvez avoir plus de trois niveaux dans votre référentiel. Toutefois la lecture du référentiel décroît avec l’augmentation de son nombre de sous-niveaux.