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.

Téléverser un fichier .matrix contenant le référentiel de compétences.

  1. 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.

  2. 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.

  3. 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 de référentiel de compétences 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 plus facilement.

Vous pouvez également utiliser un éditeur JSON, par exemple l’éditeur en ligne JSON ou JSONedit. Ceux-ci vous permettent de modifier facilement le fichier, car vous pouvez le visualiser sans avoir besoin de maitriser un grande partie de 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

L’entête du fichier de la matrice

  1. 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.

  2. name: Le titre du référentiel tel qu’il doit être présenté aux auteurs.

  3. 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.

  4. Si le code HTML dans la rubriques description nécessite l’utilisation de guillemets, ils doivent être précédé d’un caractère d’échappement. Ceci est réalisé en plaçant le caractère \" avant le guillemet.

  5. 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.

  6. evidencestatuses : Actuellement, il y a quatre statuts qui peuvent être utilisés dans un référentiel de compétences : commencé, incomplet, partiellement complété et complété. 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 facilement des référentiels dans différentes langues.

  7. 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 contrôler la syntaxe de votre fichier en collant son contenu dans la fenêtre du service JSON Formatter and Validator par exemple. Si votre fichier contient des erreurs de syntaxe, le service vous indiquera où il conviendrait de modifier le fichier.

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

Les niveaux dans un fichier matriciel

  1. standards : Introduction de cette section. Vous pouvez définir autant de niveaux que vous désirez. Il n’y a pas de limite.

  2. 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.

  3. name : Titre du niveau de compétence. Cette information est requise et peut contenir jusqu’à 255 caractères.

  4. 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).

  5. 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.

  6. 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

Les éléments d’un niveau de compétence dans le fichier matriciel

  1. standardelements : Introduction à la section. Il n’y pas de limite quant au nombre d’éléments qui caractérisent un niveau de compétence.

  2. 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.

  3. 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.

  4. description: La description est facultative et s’affiche lorsque vous passez la souris sur le nom de la compétence (clic tactile sur mobile).

  5. stadardid : Correspond à l’identifiant (ID) du niveau auquel se rattache l’élément défini avant.

  6. 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.

  7. 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

La fin du fichier matriciel

  1. Ne mettez pas de virgule après la dernière accolade du dernier élément de niveau.

  2. 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é

Le résultat final une fois le fichier téléversé

  1. Titre du référentiel de compétences

  2. Description du référentiel de compétences

  3. Un niveau. On ne peut pas lui attribuer une production. Les productions sont attribuées seulement au plus bas des sous-niveaux.

  4. Un élément d’un niveau de compétence

  5. Un niveau de compétence avec un sous-niveau. Seul le dernier sous-niveau peut se voir rattaché des productions.

  6. 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.