======Intégrer un référentiel de compétences dans Moodle====== Il y a deux possibilités pour intégrer un référentiel dans Moodle : * soit **par fichier csv** que vous transmettez à une personne qui a les droits pour l'intégrer ; * soit **par l'interface** si vous avez les droits de le faire directement (ex : administrateur plateforme ou ingénieur pédagogique). Seuls les référentiels officiels peuvent être intégrés dans les plateformes pédagogiques Ecampus, Collegium Santé et Prélude. =====Par fichier csv===== Nous recommandons de travailler avec le logiciel Open office Calc mais si vous ne disposez pas de ce logiciel vous pouvez tout de même [[moodle:ouverture_csv_avec_excel|ouvrir un CSV avec Microsoft Excel]] ====Étape 1 : remplir son fichier csv==== ===Préparer son fichier dans un tableur=== ===Ligne 1=== Le fichier doit avoir en première ligne les entêtes de colonnes suivantes : ^ Élément ^ Obligatoire/Optionnel ^ Définition ^ | **ID de la compétence parente** | Obligatoire | Identifiant unique de la compétence parente dans une hiérarchie. Laissez vide pour une compétence racine. | | **ID** | Obligatoire | Identifiant unique pour chaque compétence. Cet ID permet de différencier les compétences dans Moodle. | | **Nom abrégé** | Obligatoire | Nom court de la compétence utilisé pour une identification rapide et lisible. | | **Description** | Obligatoire | Détail ou explication précise de la compétence. Peut inclure des informations supplémentaires sur les objectifs. | | **Format de description** | Obligatoire | Définit si la description est en texte brut ou en HTML. Par défaut, la valeur est "1" pour HTML. | | **Valeurs du barème** | Obligatoire | Liste des niveaux d’évaluation associés à la compétence (ex. : Non compétent, En cours, Compétent). | | **Configuration du barème** | Obligatoire | Format JSON définissant les niveaux du barème et leurs propriétés (par exemple : niveau par défaut ou proficient). | | **Type de règle de compétence** | Optionnel | Permet de spécifier une règle particulière liée à la validation ou l’évaluation de la compétence. | | **Règle d’objectif** | Optionnel | Spécifie une règle conditionnant la validation de la compétence en fonction d’un objectif. | | **Règle de paramétrage** | Optionnel | Définit des paramètres supplémentaires pour évaluer ou valider la compétence. | | **IDs des compétences croisées associées** | Obligatoire | Liste des identifiants de compétences liées ou croisées qui partagent des objectifs ou des dépendances. | | **ID d’exportation** | Optionnel | Utilisé pour identifier la compétence dans un contexte d’exportation ou pour l’interopérabilité avec d’autres outils. | | **Est un référentiel** | Obligatoire | Indique si l’élément est un référentiel global ou une compétence spécifique. La valeur est généralement "1" pour référentiel.| | **Taxonomie** | Obligatoire | Classification ou type de la compétence (ex. : compétence, objectif, comportement). Utilisé pour organiser le référentiel. | ===Ligne 2=== En seconde ligne, on renseigne les **caractéristiques de notre référentiel**, c'est-à-dire : * ''ID'' = code du référentiel * ''Nom abrégé'' = intitulé du référentiel * ''Description'' = facultatif, on peut par exemple renseigner ici le nom complet de la formation associée à ce référentiel * ''Format de description'' = 1 * ''Valeurs du barème'' = barème (ou scale) choisi par défaut pour ce référentiel (Attention, les valeurs du barèmes précisés ici doivent être parfaitement identiques à celle du barème existant, séparés par des virgules sans espace) * ''Configuration du barème'' = renseignement de l’identifiant du barème choisi s'il existe déjà dans la plateforme (''scaleid''), de l'échelon par défaut (''scaledefault'' à 1) et du ou des échelons qui permettent de valider (''proficient'' à 1) ; les échelons sont pris dans l'ordre définis dans le barème ; * ''Est un référentiel'' = 1 * ''Taxonomie'' = liste des niveaux choisis dans le référentiel présentés du plus haut niveau au plus fin, en anglais, séparés par des virgules, tout en minuscule et sans espace. Ex : ''domain,competency,proficiency,level''. Le choix s'effectue dans la liste suivante : - behaviour = Comportement; - competency = Compétence; - concept = Concept; - domain = Domaine; - indicator = Indicateur; - level = Niveau; - outcome = Objectif; - practice = Entraînement; - proficiency = Aptitude; - skill = Habileté; - value = Valeur; Cette taxonomie n'est pas issue de travaux de recherches mais d'une revue de lecture dans différents secteurs effectuée par [[https://moodle.org/mod/forum/discuss.php?d=316151#p1340786|Damyon Wiese]] Pour la ligne 2, __ne pas remplir les autres champs__.\\ \\ ===Lignes 3 et suivantes=== Pour la ligne 3 et suivante, on peut remplir les **compétences**, **sous-compétences**, etc. On remplis pour **chaque ligne** : * de manière obligatoire : * ''ID'', * ''Nom abrégé'', * ''Format de description'' = 1 * de manière facultative : ''Description'', On remplis pour chaque **niveau parent** : * de manière obligatoire : case ''ID de la compétence parente'' vide * de manière facultative : * ''Type de règle de compétence (optionnelle)'' notamment ''core_competency\competency_rule_all'' si on veut que toutes les niveaux enfants soient validés pour valider le niveau parent. * ''Règle d'objectif (optionnelle)'', * ''Règle de paramétrage (optionnelle)'' On remplis pour chaque **niveau enfant** : * de manière obligatoire : ''ID de la compétence parente'' = préciser ici l'ID du niveau parent. * de manière facultative : ''Valeurs du barème'' et ''Configuration du barème'' uniquement si on souhaite un barème spécifique pour un niveau de la taxonomie qui soit différent du barème par défaut. \\ >> Référez vous à l'exemple ci dessous\\ >> **légende** >> * ❌ = ne pas remplir >> * ''______'' = optionnel\\ >> {{ :moodle4:competence:referentiel_competence_test.xlsx |}} ===Enregistrer son fichier=== Vous devez choisir : * enregistrer sous le format ''.csv'' * ouvrir l'édition des paramètres du filtre * Choisir le format ''UTF-8'' et le séparateur point-virgule '';'' Un pas à pas détaillé de l'enregistrement sous open office CALC est accessible dans le tutoriel suivant : [[moodle4:inscriptions:inscription_import|Inscription des utilisateurs en lots dans UN espace de cours (avec un fichier .csv)]] ====Étape 2 : intégrer le fichier csv==== Personne cible : administrateur plateforme, ingénieur pédagogique. ===Vérifier la correspondance avec le barème (scale)=== **1.** Aller dans ''administration du site > Notes > Barèmes''. {{ :moodle4:competence:bareme.jpg?500 |}} **2.** Cliquer sur la roue crantée au niveau du barème existant souhaité (colonne "modifier"). {{ :moodle4:competence:modifier_bareme.jpg?800 |}} **3.** Dans l'URL, relevez son identifiant (scaleid) comme dans l'exemple suivant, il s'agit du barème n°39 : https://lfoadtest.unicaen.fr/moodle/grade/edit/scale/edit.php?courseid=0&id=39 {{ :moodle4:competence:url_id.jpg?nolink |}} **4.** Ajuster si nécessaire la colonne ''Configuration du barème'' en remplaçant la valeur du ''scaleid'' par celui relevé ci-dessus. {{ :moodle4:competence:configuration_bareme.jpg?nolink |}} **5.** Enregistrer. ===Charger le référentiel=== **1.** Aller dans ''administration du site > Compétences > Importation de référentiel de compétences''.\\ **2.** Charger le fichier et choisir le bon **délimiteur** (virgule ou point-virgule) et l'encodage **UTF-8**.\\ **3.** Vérifier la **correspondance** des données entre champs à renseigner dans l'import et entêtes de colonnes de votre fichier.\\ **4.** Valider et vérifier que l'import s'est bien déroulé, notamment le barème (en anglais "scale").\\ =====Par l'interface===== Cette méthode n'est pas recommandée car elle est relativement fastidieuse et la possibilité d'erreur de frappe est d'autant plus importante que le référentiel est long. Pour accéder à l'interface, il faut aller dans ''administration du site > Compétences > Référentiel de compétences > Ajouter un référentiel de compétences''.