Voor een aantal rollen binnen een course is de Group Management Widget beschikbaar.
De Custom Group Management Widget vind je onderaan op de Course Home pagina. Met de Custom Group Management Widget kan je op course niveau de classlist, met de gegevens van ingeschreven gebruikers (inclusief groepsinschrijvingsgegevens), downloaden en gebruikers inschrijven in groepen met behulp van een geformatteerd .csv-bestand. Dit kan handig zijn, wanneer je bijvoorbeeld een groot aantal groepen moet aanmaken.
De widget is beschikbaar voor de onderstaande courserollen. Voor de overige rollen is de widget op de homepage onzichtbaar gemaakt.
Domain Admin
Course Organiser
Instructor - Examinator
Instructor
De widget bestaat uit 2 integrale delen: Download Classlist en Import Groups from a File (.csv).
Download Classlist
Met de knop "Download Classlist" kun je de classlist downloaden als een csv-bestand met de volgende velden: Username, FirstName, LastName, Role, Email, GroupName, GroupCode, GroupCategoryName, en Action
Het veld "Action" in het gedownloade bestand is altijd leeg. Het is voor het gemak toegevoegd, zodat je het kan invullen bij het importeren van een .csv-bestand (volgende stap).
Als een gebruiker geen groepsinschrijvingen heeft, is er ten minste één regel met de gebruikersinformatie, maar een blanco GroupName, GroupCode en GroupCategoryName.
Elke groep heeft minimaal één regel zonder Username en alleen GroupName, GroupCode and GroupCategoryName (alle andere velden zijn leeg) onderaan het bestand zodat er een overzicht is van alle groepen.
Als er een groepscategorie is zonder groepen, is er ten minste één regel met alleen GroupCategoryName (alle andere velden zijn leeg) onderaan het bestand.
Als een gebruiker in meerdere groepen is ingeschreven, wordt die gebruiker meerdere keren vermeld; elke groepsinschrijving komt op een nieuwe regel.
Als een gebruiker niet zichtbaar is in de classlist, wordt deze ook niet weergegeven in het gedownloade bestand.
Hier is een voorbeeld van het uitvoerbestand Download Classlist:
In bovenstaande tabel is te zien dat er voor de cursus (organisatie-eenheid-ID 7742) 2 classlist leden zijn ingeschreven als leerling. Test.Test1-user is ingeschreven in Group 1 onder groepscategorie Category 1. Test.Test2-user is ingeschreven in Group 2 onder groepscategorie Category 1. Daaronder staat een lijst van alle groepen die in deze cursus bestaan, ongeacht of ze leeg zijn of niet: Group 1, Group 2, Group 3, Group 4. De laatste regel toont groepscategorie Category 2 die leeg is.
Groepen importeren uit een bestand (.csv)
In de sectie Import groups from a file (csv) kun je inschrijvingen in groepen aanpassen door een .csv-bestand te uploaden.
Hier is een voorbeeld van een importbestand dat, wanneer het wordt geïmporteerd, Student 1 in Group 1 zal inschrijven, Student 2 uit Group 2 zal uitschrijven en vervolgens Student 2 zal inschrijven in Group 1.
Het importbestand moet aan de volgende eisen voldoen:
De gebruikers die in groepen moeten worden ingeschreven, moeten al zijn ingeschreven in de course zelf.
De groepscategorieën moeten al bestaan in de cursus.
De widget kan slechts 2 soorten acties begrijpen: "Enroll" en "Unenroll".
Regels met een leeg Action veld worden genegeerd.
Regels met fouten/typefouten in het Action veld resulteren in een fout.
Acties zijn niet hoofdlettergevoelig, dus bijv. "enroll", "Enroll" en "ENROLL" zullen werken.
De bestanden kunnen gedeeltelijke uploads zijn: als het actieveld (Enroll/Unenroll) leeg wordt gelaten, zal de widget die regel negeren, wat zal resulteren in geen actie en geen fout.
Regels met alleen GroupName, GroupCode en GroupCategoryName maar met een lege Username resulteren in geen actie en geen fout tenzij je een actie specificeert (Enroll/Unenroll) in het veld Action; in dergelijke gevallen resulteert dit in een fout.
Regels met alleen GroupCategoryName resulteren in geen actie en geen fout, tenzij je een actie specificeert (Enroll/Unenroll) in het veld Action; in dergelijke gevallen resulteert dit in een fout.
Met het .csv-bestand kan je nieuwe groepen aanmaken; als de widget geen bestaande groep kan vinden met de opgegeven naam binnen de gespecificeerde categorie, zal het eerst een nieuwe groep aanmaken en vervolgens de gebruiker inschrijven.
Namen van groepen die beheerders proberen te maken, moeten uniek zijn binnen de cursus.
Bij het maken van groepen kan het veld GroupsCode leeg worden gelaten omdat de widget een unieke groepscode zal genereren.
Regels die groepen maken, mogen geen lege Username hebben.
Regels die groepen maken, moeten de actie "Enroll" hebben in het veld Action.
Het importbestand moet een .csv-bestand zijn.
De naam van het importbestand moet beginnen met "classlist_".
Je kan slechts één bestand tegelijk uploaden.
De bestandsgrootte mag niet groter zijn dan 500 KB.
Het maximum aantal gebruikers dat moet worden ingeschreven/uitgeschreven mag niet meer zijn dan 1000, d.w.z. het maximum aantal rijen is 1001.
De bestandsheader moet de volgende velden bevatten:Username, FirstName, LastName, Role, Email, GroupName, GroupCode, GroupCategoryName, Action.
De velden die geldig moeten zijn om de import te laten werken, zijn Username, GroupName, GroupCategoryName en Action (deze mogen niet leeg zijn); andere velden zijn optioneel.
Tip voor aanmaken grote hoeveelheid groepjes voor groepsopdrachten
Tip! Wil je een grote reeks subgroepen aanmaken voor een groepsopdracht, waarbij je meerdere klassen hebt die je wilt opsplitsen in subgroepjes? Dan kun je dit in bulk doen. Bekijk daarvoor deze specifieke handleiding.
Na het aanmaken van de groepen, kan je ze koppelen aan een groepsopddracht.
Fouten bij het importeren
Als regels resulteren in een fout, zal de widget een .csv-bestand genereren en downloaden waarin de fouten samen met hun beschrijvingen worden vermeld in de laatste kolom ("Errors"). Het actieveld is bijvoorbeeld "ENROLLL" (drievoudige "L") in plaats van "ENROLL" (dubbele "L"):
Zie hieronder enkele voorbeelden van fouten.
- ERROR: Action must be either Enroll or Unenroll
The widget only accepts 2 types of Actions: “Enroll” and “Unenroll” (case-insensitive).
- ERROR: Group category with this name not found
The group category name provided does not exist in the course.
- ERROR: Group not found
The group name provided does not exist in the course.
- ERROR: Username not found
The username provided does not exist in the course classlist.
- ERROR: Group name must be unique
The group with such a name already exists in the course.
- ERROR: Group creation failed
Group that you were trying to create has not been created due to an error.
- ERROR: User unenrollment failed
Unenrollment action failed.
- ERROR: User enrollment failed
Enrollment action failed.