open-education-api / specification

OpenAPI (fka Swagger) specification for the Open Education API.
Other
32 stars 26 forks source link

Groups & Group roles definition #47

Closed usapieter closed 2 years ago

usapieter commented 7 years ago

after discussing with @tomkuipers and @joostfarla this morning: none of us had relevant experience with groups and group roles.

Are there any institutions (or SURF) with best practices in groups/group roles management?

In my experience groups are defined per application - and there is no supersource for groups and grouproles, rendering any implementation of an OOAPI for this nearly impossible, or with such limitations that it is not very useful.

Why are groups and group roles in the 2.0 specs? And what are the intended usecases?

joostfarla commented 7 years ago

Removed for now. We'll keep this issue open for further discussion (v3).

fransward commented 5 years ago

Waiting for use cases to use groups and group roles

JanHendrikvanSchaik commented 3 years ago

Zoals vandaag besproken op de OOAPI meeting een uiteenzetting van groepen, zodat we daar use cases uit kunnen destilleren.:

Tussen logistieke systemen en leerlingvolgsystemen worden momenteel groepen en groepslidmaatschappen uitgewisseld.

Er zijn in deze systemen meerdere soorten groepen:

  1. Klassen: een groep studenten die meestal een jaar lang een groot deel van de lessen samen volgt.
  2. Lesgroepen: een groep studenten die een serie lessen voor een vak in een aantal weken volgt. In een lesgroep kunnen studenten van meerdere klassen zitten, of een klas kan opgesplitst worden in een aantal lesgroepen voor een bepaald vak (serie lessen in een periode)
  3. Begeleidingsgroepen/mentorgroepen: een bundeling studenten met een mentor
  4. Etc.

Groepen worden voor verschillende doelen gebruikt:

  1. Verwerken van inschrijvingen/indelen van personen op basis van criteria die helpen bij het zo goed mogelijk les kunnen geven (didactische criteria). Studenten met een zelfde achtergrond (VWO leerlingen) worden in regelmatig in een zelfde groep gestopt, omdat dat handig is bij het lesgeven. Of geografisch (studenten uit zelfde regio bij elkaar in de klas), of verhouding jongens/meisjes. In welke groep je als student zit is vaak een keuze van docent of coördinator, geen toeval. Je volgt allemaal dezelfde cursus, maar er is nog geen rooster. Door dan al een klas te formeren en studenten in deze klas te stoppen, kunnen we wel een rooster maken waar geen conflicten in optreden.
  2. Vastleggen van een clustering van studenten en lessen voor meerdere weken. Je zit een een bepaalde groep en dus zit je bij alle lessen van dat vak voor de komende weken. Het is dus het voorkomen van redundante informatie en een efficiënte manier van uitwisselen van gegevens. Als wij een rooster publiceren met groepen per les of studenten per les, scheelt een factor 15 vaak in bericht omgang. Vooral als groepssamenstellingen lange tijd stabiel zijn.
  3. Snelle manier van machtingen/rechten aanmaken in ELO's.

Voorbeeld van use case: Als roostermaker wil ik een rooster maken, rekening houdend met de groepsindeling die in een ander systeem is gemaakt. In dat rooster mag ik als individu geen twee activiteiten/lessen op zelfde tijdstip hebben. De offerings op components zijn op dat moment nog niet bekend, want het rooster bestaat nog niet. De offering op course wel, maar daar zijn welllicht wel 100 studenten mee geassocieerd. Als rooster maker mag ik niet zelf bedenken welke student welke components met welke andere studenten tegelijk volgt. Daarom krijg ik graag de bedachte groepsindelingen door.

fransAdvitrae commented 3 years ago

Graag nog een keer aandacht voor dit onderwerp. Binnen de praktijk van de onderwijslogistiek, planning en roostering, speelt de indeling in groepen zoals hierboven omschreven een belangrijke rol. Dit geldt niet alleen in de Xedule omgeving maar deze indeling wordt ook gebruikt in andere onderwijs applicaties zoals Eduarte, Magister, Osiris, SomToday, StuComm Untis en Trajectplanner.

jelmerderonde commented 3 years ago

@fransAdvitrae en @JanHendrikvanSchaik

Bij SURF zijn we vandaag bezig geweest met een conceptagenda voor het werkgroepoverleg van 15 juni. Ons voorstel zou zijn om dit daar weer aan de orde te stellen.

Het lijkt ons handig als jullie daar nog iets meer uitleg bij geven:

Dat maakt het gesprek concreet en hopelijk kunnen we dan aan het einde van dat agendapunt met de groep een knoop doorhakken over hoe een verdere uitwerking eruit zou moeten komen te zien.

Het lijkt ons het handigst als jullie zo'n korte uitwerking aan deze issue toevoegen als een nieuwe comment, dan houden we alles bij elkaar.

fransAdvitrae commented 3 years ago

Hi Jelmer,

Jan Hendrik en ik zijn gestart met de afstemming. We streven er naar om op 8 juni input te leveren voor het overleg van 15 juni. We verwachten ongeveer een half uur nodig te hebben om dit met de groep af te stemmen.

Graag tot de 15e.

Met vriendelijke groet,

Frans van Iersel

[Logo Advitrae]

Van: Jelmer de Ronde @.> Verzonden: dinsdag 18 mei 2021 17:11 Aan: open-education-api/specification @.> CC: Frans van Iersel @.>; Assign @.> Onderwerp: Re: [open-education-api/specification] Groups & Group roles definition (#47)

@fransAdvitraehttps://github.com/fransAdvitrae en @JanHendrikvanSchaikhttps://github.com/JanHendrikvanSchaik

Bij SURF zijn we vandaag bezig geweest met een conceptagenda voor het werkgroepoverleg van 15 juni. Ons voorstel zou zijn om dit daar weer aan de orde te stellen.

Het lijkt ons handig als jullie daar nog iets meer uitleg bij geven:

Dat maakt het gesprek concreet en hopelijk kunnen we dan aan het einde van dat agendapunt met de groep een knoop doorhakken over hoe een verdere uitwerking eruit zou moeten komen te zien.

Het lijkt ons het handigst als jullie zo'n korte uitwerking aan deze issue toevoegen als een nieuwe comment, dan houden we alles bij elkaar.

— You are receiving this because you were assigned. Reply to this email directly, view it on GitHubhttps://github.com/open-education-api/specification/issues/47#issuecomment-843254412, or unsubscribehttps://github.com/notifications/unsubscribe-auth/ATCFCVTXFAE4DKA3VLQ2CDDTOJ7QTANCNFSM4DNYUB5A.

JanHendrikvanSchaik commented 3 years ago

210615 presentatie OOAPI werkgroep.pptx Hierbij de uitwerking die we as dinsdag middag verder zullen toelichten.

jelmerderonde commented 2 years ago

Opmerkingen uit de werkgroep van 16 november:

De werkgroep is van mening dat een dergelijke toevoeging aan de OOAPI gewenst is. Het heeft wel nog een verdere uitwerking nodig.

@hermanvand, @fransAdvitrae en @arthurvanalten maken een vervolguitwerking. @fransAdvitrae zorgt voor een vervolgafspraak.

jelmerderonde commented 2 years ago

Zie ook issue #135

hermanvand commented 2 years ago

Er is een vervolg ontwerp gemaakt, wat in de werkgroep van 25/1 besproken is. Op basis van het overleg is het ontwerp nog vereenvoudigd. Het laatste ontwerp is bij deze opmerking bijgesloten. Op basis hiervan kunnen we de ooapi aanpassen.

idee groepen voor ooapi - 20220310.pdf

jelmerderonde commented 2 years ago

A note: how can you easily query the membership count of a group?

jelmerderonde commented 2 years ago

Er is een vervolg ontwerp gemaakt, wat in de werkgroep van 25/1 besproken is. Op basis van het overleg is het ontwerp nog vereenvoudigd. Het laatste ontwerp is bij deze opmerking bijgesloten. Op basis hiervan kunnen we de ooapi aanpassen.

idee groepen voor ooapi - 20220310.pdf

De werkgroep gaat akkoord met het nieuwe voorstel.

Maar wil nog wel een attribuut personCount toevoegen.

jelmerderonde commented 2 years ago

Closed by #180