• Groepen in bulk inladen
• Fouten bij het importeren
• Csv-bestand downloaden vanuit een cursus

In deze handleiding maken we gebruik van het voorbeeldbestand dat hieronder staat. Deze kun je zelf naar wens aanpassen.

1. Navigeer in je cursus naar Course Tools -> Groups
2. Klik op New Category om een nieuwe groepscategorie aan te maken
   
   Je maakt hier de categorie aan voor de groepsopdracht. De groepen zelf laden we later in bulk in.

3. Vul de belangrijkste gegevens in, zoals de naam, enrolment type, aantal gebruikers per groep.|
   
   In onderstaand voorbeeld noemen we de categorie 'GroepsopdrachtX'. We willen dat studenten zichzelf inschrijven voor de groepjes (self-enrolment) en er mogen maximaal 3 studenten in een groep.
   
4. Klik vervolgens op Save. De categorie zal nu worden gemaakt.

Vervolgens gaan we in bulk groepen toevoegen aan deze categorie. Dit kan middels het bestand dat hierboven is gedeeld. Dit bestand dien je zelf passend te maken, waarbij de volgende details van belang zijn:

1. Het is verplicht om bij het aanmaken van groepen minimaal één user in te schrijven. Daarvoor gebruik je een dummy. In dit voorbeeld de TLC Dummy. Dit kun je in principe laten staan. Gebruikers die in groepen moeten worden ingeschreven moeten al zijn ingeschreven in de cursus zelf.
2. Zorg voor een duidelijke Group Name. In dit voorbeeld hebben we Klas A t/m Klas F, welke we opsplitsen in 10 groepjes per klas.
   Namen van groepen moeten uniek zijn binnen de cursus.
3. De Group Code kun je leeg laten, dit vult Brightspace zelf in.
4. Bij Group Category vul je alleen de exacte naam in van categorieën die al bestaan in je cursus. In dit voorbeeld dus de categorie die je in de stap hierboven hebt aangemaakt.
5. Vul bij Action altijd Enroll in. Regels met een leeg Action veld worden genegeerd.

6. Sla het bestand vervolgens op als .csv, waarbij de velden worden gescheiden door komma's. Open het bestand in een teksteditor en vervang de puntkomma's (;) door een komma (,) en sla .csv bestand op.

• De naam van het importbestand moet beginnen met "classlist_".
• 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 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.

7. Helemaal onderaan de homepage van je cursus vind je de group management widget. Upload hier het bestand en klik op import.

De groepen zijn nu aangemaakt. In iedere groep is de dummy ingeschreven. Dit kun je in één keer ongedaan maken door de dummy uit de classlist te verwijderen.

1. Ga hiervoor naar Course Tools -> Classlist.
2. Klik op het tabje All
3. Selecteer de dummy en Unenroll deze.

De groepen zijn nu gereed voor gebruik. Studenten kunnen zich nu inschrijven voor de groepjes (wanneer er voor self-enrolment is gekozen) en je kunt de groepjes koppelen aan de groepsopdracht.

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.

• De widget accepteert slechts 2 soorten acties: "Enroll" en "Unenroll" (niet hoofdlettergevoelig).

• De opgegeven groepscategorienaam bestaat niet in de cursus.

• De opgegeven groepsnaam bestaat niet in de cursus.

• De groep met zo'n naam bestaat al in de cursus.

• De groep die u probeerde te maken, is niet gemaakt vanwege een fout.

• Uitschrijvingsactie is mislukt.

• Inschrijvingsactie mislukt.

Via de Group Management Widget kun je niet alleen groepen importeren met behulp van een csv-bestand. Je kunt ook een csv-bestand met gegevens uit een specifieke cursus downloaden, zodat je het csv-bestand niet volledig met de hand hoeft in te vullen.

1. Klik op de knop Download Classlist om de classlist te downloaden als een csv-bestand.
   Dit bestand zal uit de volgende velden bestaan: Username, FirstName, LastName, Role, Email, GroupName, GroupCode, GroupCategoryName, en Action

In bovenstaande tabel kunnen we 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. Hieronder zien we 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.

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