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.

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.

You can use any text editor to create and edit your SmartEvidence framework files. If you have an editor that supports syntax highlighting for JSON files, you have an advantage as you can differentiate text that you can change from prompts that Mahara needs to interpret the file.

You can also use a JSON editor, e.g. JSON Editor Online or JSONedit. 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. 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

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: The title of the framework as it should be shown to authors.

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. If the HTML code in the description field requires the use of quotation marks, these need to be escaped. Otherwise, they would be interpreted as commands. The escaping is done by placing a backslash right in front of the quotation mark: \".

5. selfassess: Determine whether people can self-assess their competencies or whether the competencies can only be assessed by somebody else. The following two values are allowed:

   • true: Authors can self-assess.

   • false: Authors cannot perform self-assessment.

6. evidencestatuses: Currently, there are four evidence statuses that can be used in an evidence map: begun, incomplete, partially complete, and completed. You can decide what words are used for these statuses in the framework that you set up. For example, this allows you to set up frameworks in different languages.

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.

You can check if your file contains all necessary syntax by pasting it into the JSON Formatter and Validator for example. If there are any issues and JSON cannot interpret your file, the validator specifies the places where the errors occur so you can track them down and fix.

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

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

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

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é

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.