11.9.4. Importer un fichier de référentiel de compétences

Administration menu → Extensions → Compétences → Importer

You can import a SmartEvidence framework by clicking the Import link in the SamrtEvidence navigation. The framework file must end in the extension .matrix to be recognised and interpreted by Mahara.

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

You can also use a JSON editor, e.g. JSON Editor Online. You can view your file without much of the JSON syntax.

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. Start of the file (version 1)

Note

SmartEvidence version 1 and version 2 differ only in the general setup, but not in the standards and standard elements.

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.

The start of a matrix file for SmartEvidence version 1

  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

    You can see the institution short name on the Institution overview page.

  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 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 : \".

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

  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 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. new in Mahara 24.04 Start of the file (version 2)

The main differences between version 1 and version 2 of SmartEvidence for the setup are:

  • Self assessment can be mixed with external assessment.

  • A total of five assessors, including the learner themselves, can be defined. These can correspond to different roles in Mahara.

  • An assessor does not have to have the “Staff” role any more.

Note

If you want to transform a file you created earlier into a SmartEvidence version 2 file, you only need to adjust this general section, in particular:

  • self-assess

  • version

  • evidencestatuses

The start of a matrix file for SmartEvidence version 2

  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

    You can see the institution short name on the Institution overview page.

  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 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 : \".

  5. selfassess: Determine whether people can self-assess their competencies alongside other assessors. The following two values are allowed:

    • true: Les auteurs peuvent s’auto-évaluer.

    • false: Les auteurs ne peuvent pas effectuer d’auto-évaluation.

  6. evidencestatuses: This section contains the information about the different roles that can assess a SmartEvidence version 2 collection. You can have up to five assessors, including the portfolio author themselves. If you want to have fewer than five assessors, only put as many sections into the file as you need, ensuring that they all follow the correct formatting.

  7. Evidence status role section: Each section consists of the following:

    • title: Give your role a title.

    • mahara_roles: Decide, which system role or roles the person must have to perform the assessment. Possible are:

      • member: A regular account holder

      • institutionstaff: A person with the “Institution staff role”

      • institutionsupportadmin: A person with the “Institution support administrator role”

      • institutionadmin: A person with the “Institution administrator” role

      • staff: A person with the “Site staff” role

      • siteadmin: A person with the “Site administrator” role

    • begun: The status that indicates that there is evidence mapped against this standard element. The text can be different for each role.

    • incomplete: The status that indicates that the evidence mapped against this standard element doesn’t meet the criteria. The text can be different for each role.

    • partialcomplete: The status that indicates that there is not sufficient evidence mapped against this standard element or that it only partially meets the criteria. The text can be different for each role.

    • completed: The status that indicates that the evidence mapped against this status element is sufficient to meet the standard. The text can be different for each role.

    • new in Mahara 24.04 merit: The status that indicates that there is more than enough evidence mapped against the standard element. The text can be different for each role.

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

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

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

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

  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.