Skip to main content

Cursus in Canvas Monitor

Handleiding: een cursus en module aan een blok toevoegen

Doel

Deze handleiding beschrijft hoe een beheerder een nieuwe Canvas-cursus als blok toevoegt aan Canvas Monitor en daarna een Canvas-module koppelt. Dit gebeurt in twee afzonderlijke fasen:

  1. Maak eerst de cursus aan in Canvas Monitor.
  2. Wacht tot de nachtelijke batchverwerking is voltooid.
  3. Voeg daarna de geïmporteerde module toe aan Canvas Monitor.

Terminologie

  • Een course in Canvas wordt in Canvas Monitor gebruikt als blok.
  • Een Canvas assignment group wordt in Canvas Monitor als module gekoppeld.
  • De cursus moet al in Canvas bestaan. Voor het aanmaken in Canvas Monitor is het Canvas-cursus-ID nodig.

Locatie

De beheerfuncties staan na het inloggen in het menu Beheer:

  • Beheer > Cursus voor het aanmaken en wijzigen van cursussen.
  • Beheer > Modules voor het koppelen en wijzigen van modules.

Deze menuopties zijn alleen zichtbaar voor het beheeraccount.

Fase 1: de cursus aanmaken

  1. Controleer in Canvas of de cursus en de assignment group(s) die als module moeten worden gebruikt al bestaan.
  2. Noteer het numerieke cursus-ID uit de Canvas-URL. Bij https://talnet.instructure.com/courses/12345 is het cursus-ID bijvoorbeeld 12345.
  3. Log in op Canvas Monitor met het beheeraccount.
  4. Ga naar Beheer > Cursus.
  5. Klik op Create Course.
  6. Vul alle velden in zoals hieronder beschreven.
  7. Klik op Save.
  8. Controleer op de detailpagina of alle waarden correct zijn opgeslagen.

Velden van de cursus

  • Dit is het cursus ID uit canvas

    • Vul het numerieke ID van de cursus in Canvas in.
    • Dit veld is verplicht en moet uniek zijn.
    • Na het opslaan kan dit ID niet meer in het formulier worden gewijzigd.
    • Gebruik niet het ID van een module of assignment group.

  • Cursusnaam (staat in het moduleoverzicht)

    • Vul een herkenbare naam voor de cursus in.
    • Deze naam wordt in het moduleoverzicht van Canvas Monitor getoond.
    • Het veld is verplicht en mag maximaal 18 tekens bevatten.

  • Sort order in cursus overzicht

    • VulIs eenniet geheelvanbelang getalvoor instudenten, datalleen devoor sorteervolgordehet cursus overzicht van cursussen bepaalt.
    • Een lager getal komt eerder in het overzicht.
    • Het veld is verplicht.
    • Gebruik bij voorkeur stappen van 10, bijvoorbeeld 10, 20 en 30. Daardoor kan later eenvoudiger een cursus tussen twee bestaande cursussen worden geplaatst.docenten.

  • Bloknaam (B1, B2, B3,..)

    • Vul de korte bloknaam in, bijvoorbeeld B1, B2 of B3.
    • Deze bloknaam wordt standaard gebruikt voor alle gekoppelde modules van deze cursus.
    • Het veld is verplicht en mag maximaal 6 tekens bevatten.
    • Het teken / is niet toegestaan.
    • Een module kan deze standaard bloknaam later overschrijven met een eigen bloknaam.

  • Prio voor update (1, meest)

    • Vul een geheel getal in dat de prioriteit voor de gegevensimport bepaalt.
    • 1Gebruik is3, dit zorgt ervoor dat elke nacht de hoogstegegevens prioriteit.uit HogereCanvas getallenworden hebben een lagere prioriteit.
    • Het veld is verplicht.
    • Gebruik voor een cursus dieverwerkt in de reguliereCanvas nachtverwerking moet worden meegenomen de prioriteit die binnen de bestaande beheerafspraken wordt gebruikt.monitor

Fase 2: wachten op de nachtelijke batchverwerking

Na het opslaan van de cursus moet de nachtelijke batchverwerking eerst worden afgerond. De batch leest voor de nieuwe cursus onder meer de assignment groups en opdrachten uit Canvas in.

Voeg de module daarom niet direct na het aanmaken van de cursus toe. De module kan pas correct vanuit het moduleoverzicht worden gekoppeld wanneer de bijbehorende Canvas assignment group daar zichtbaar is.

Ga de volgende werkdag verder en voer deze controle uit:

  1. Ga naar Beheer > Modules.
  2. Zoek de nieuwe cursus op naam, bloknaam of cursus-ID.
  3. Controleer of de verwachte Canvas-module in de lijst staat.
  4. Controleer of bij In CM een rood kruis staat. Dit betekent dat de assignment group uit Canvas is geïmporteerd, maar nog niet als module aan Canvas Monitor is gekoppeld.

Wanneer de cursus of module nog niet zichtbaar is:

  • Controleer of het Canvas-cursus-ID correct is ingevuld.
  • Controleer of de assignment group in Canvas bestaat.
  • Controleer of de gekozen updateprioriteit door de nachtelijke batch wordt verwerkt.
  • Wacht zo nodig een volgende batch af of laat de beheerder van de Canvas-koppeling de import controleren.
  • Maak de module niet handmatig aan via een los module-ID; open de module vanuit Beheer > Modules, zodat het juiste geïmporteerde ID wordt gebruikt.

Fase 3: de module toevoegen

  1. Ga na een geslaagde nachtverwerking naar Beheer > Modules.
  2. Zoek de gewenste assignment group van de nieuwe cursus.
  3. Controleer aan de hand van Cursus ID, Module ID en Module Canvas-naam dat dit de juiste module is.
  4. Klik op de naam in de kolom Module Canvas-naam. Bij een nog niet gekoppelde module opent het scherm Create Module Def.
  5. Controleer het vooraf ingevulde module-ID en de modulenaam.
  6. Vul de overige velden in.
  7. Klik op Save.
  8. Ga terug naar Beheer > Modules en controleer of bij In CM een vinkje staat.
  9. Controleer ook de kolommen Actief, Positie en Due Date.

Velden van de module

  • Module ID uit Canvas (read-only)

    • Dit is het ID van de Canvas assignment group.
    • Het veld wordt automatisch gevuld wanneer de module vanuit Beheer > Modules wordt geopend.
    • Het ID is alleen-lezen en moet niet handmatig worden aangepast.

  • Module naam in Canvas Monitor

    • Dit is de naam die Canvas Monitor voor de module toont.
    • Bij het aanmaken wordt de Canvas-naam vooraf ingevuld; pas deze alleen aan als in Canvas Monitor een andere weergavenaam nodig is.
    • Het veld is verplicht en mag maximaal 80 tekens bevatten.

  • Bloknaam

    • Laat dit veld leeg om de bloknaam van de cursus te gebruiken. Gebruik anders B1, B2, .....
    • Vul alleen een waarde in wanneer deze module onder een afwijkende bloknaam moet worden getoond.
    • Een ingevulde waarde overschrijft dus de bloknaam van de cursus.
    • De waarde mag maximaal 6 tekens bevatten en mag geen / bevatten.

  • Norm Uren

    • Vul het normatieve aantal studie-uren van de module in.
    • Dit moet een geheel getal zijn.
    • De technische standaardwaarde is 10 uur, maar vul en controleer de gewenste waarde altijd expliciet.

  • Positie

    • Bepaalt de volgorde van de module in de overzichten.
    • Dit is een verplicht geheel getal en moet uniek zijn.
    • Gebruik bij voorkeur stappen van 10 om later ruimte te houden voor tussenvoegingen.
    • De volgorde kan later via Beheer > Modules > Volgorde aanpassen... worden gewijzigd.

  • SQL voldaanregel

    • Bepaalt wanneer de module in Canvas Monitor als voldaan geldt.
    • Dit veld is verplicht en mag maximaal 200 tekens bevatten.
    • Bij een nieuwe module wordt standaard punten > 95 ingevuld. Controleer altijd of deze regel past bij de module.
    • Beschikbare waarden in een regel zijn onder meer punten, punten_eo, ingeleverd, ingeleverd_eo, minpunten, maxpunten en punten_max.
    • Voorbeeld: punten > 90 and punten_eo > 20 and ingeleverd >= 10 and minpunten >= 1.
    • Laat een afwijkende of complexe regel controleren door degene die de Canvas-koppeling beheert; een onjuiste regel geeft onjuiste voortgangsresultaten.

  • Due Date (Optional)

    • Optionele einddatum van de module.
    • Vul de datum in via het datumveld.
    • Gebruik Clr om een bestaande datum leeg te maken.
    • Modules met een verstreken einddatum kunnen in rapportages over verlopen modules worden gebruikt.

  • Canvas URL suffix (optional)

    • Optioneel achtervoegsel voor de Canvas-link vanuit het studentdetailoverzicht.
    • Laat dit veld leeg wanneer geen afwijkende Canvas-link nodig is.
    • Vul dit alleen in wanneer bekend is welk Canvas-pad aan de standaard opdrachtlink moet worden toegevoegd.
    • De waarde mag maximaal 120 tekens bevatten.

  • Generiek Vak

    • Aangevinkt: de module wordt als generiek vak behandeld.
    • Uitgevinkt: de module wordt als developmentmodule behandeld.
    • Bij het aanmaken staat dit veld standaard aan. Controleer dit dus altijd bewust.

  • Actief

    • Aangevinkt: de module is zichtbaar en wordt gebruikt in Canvas Monitor.
    • Uitgevinkt: de module is feitelijk verborgen; dit heeft in de overzichten hetzelfde effect als verwijderen zonder de koppeling zelf weg te halen.
    • Controleer na het opslaan in het moduleoverzicht of de module als actief staat aangegeven.

  • Op Home Page (Nakijken)

    • Aangevinkt: de module wordt opgenomen in het nakijkoverzicht op de homepage.
    • Uitgevinkt: de module verschijnt daar niet.
    • Dit werkt alleen samen met een actieve module.

Invoer en resultaat

Benodigde invoer:--

  • Een bestaande Canvas-cursus.
  • Het Canvas-cursus-ID.
  • Minimaal één bestaande Canvas assignment group die als module moet worden gekoppeld.
  • De gewenste bloknaam, sorteervolgorde en updateprioriteit.
  • De module-instellingen, waaronder positie, normuren en voldaanregel.

Resultaat:

  • De Canvas-cursus staat als blok in Canvas Monitor.
  • De nachtelijke batch heeft de assignment groups en opdrachten geïmporteerd.
  • De gekozen assignment group is als module aan Canvas Monitor gekoppeld.
  • De module staat met de juiste instellingen in de relevante overzichten.

Eindcontrole

Controleer na het toevoegen minimaal het volgende:

  1. Beheer > Cursus toont het juiste cursus-ID, de juiste cursusnaam en bloknaam.
  2. De link op het cursus-ID opent de bedoelde cursus in Canvas.
  3. Beheer > Modules toont bij de nieuwe module een vinkje onder In CM.
  4. Actief heeft de gewenste waarde.
  5. De positie sluit aan op de gewenste modulevolgorde.
  6. De bloknaam komt uit de cursus, tenzij bewust een afwijkende bloknaam op de module is ingevuld.
  7. De voldaanregel past bij de puntentelling en het aantal opdrachten van de module.
  8. Het nakijkoverzicht toont de module wanneer Op Home Page (Nakijken) is ingeschakeld.

Foutscenario's en aandachtspunten

  • Wanneer opslaan mislukt, controleer dan eerst de maximale veldlengtes, verplichte velden en unieke ID's en posities.
  • Wanneer een module niet in Beheer > Modules staat, is de nachtelijke import waarschijnlijk nog niet uitgevoerd of is de cursus niet in de batchselectie opgenomen.
  • Wanneer de verkeerde assignment group wordt gekoppeld, kunnen resultaten en opdrachten aan de verkeerde module worden toegeschreven. Controleer daarom altijd cursus-ID én module-ID.
  • Wanneer Generiek Vak onjuist staat, komt de module in de verkeerde rapportages terecht.
  • Wanneer Actief uit staat, is de module niet zichtbaar in de normale Canvas Monitor-overzichten.
  • Wanneer de voldaanregel onjuist is, kan Canvas Monitor een module ten onrechte wel of niet als voltooid markeren.
  • Gebruik Delete op het moduleformulier alleen wanneer de koppeling met Canvas Monitor echt moet worden verwijderd. Dit verwijdert de Canvas assignment group zelf niet.

Gerelateerde bestanden

 

  • models/Course.php — validatie en velddefinities van cursussen.
  • views/course/_form.php — invoerformulier voor cursussen.
  • controllers/CourseController.php — aanmaken en wijzigen van cursussen.
  • models/ModuleDef.php — validatie en velddefinities van modules.
  • views/module-def/_form.php — invoerformulier en veldhulp voor modules.
  • views/module-def/create.php — standaardwaarden bij het toevoegen van een module.
  • controllers/ModuleDefController.php — aanmaken, wijzigen en ontkoppelen van modules.
  • controllers/ReportController.php — moduleoverzicht en koppellinks naar geïmporteerde assignment groups.
  • import/import_fast.py — import van cursusgegevens, assignment groups en opdrachten uit Canvas.
Back to top