Skip to main content

12. Collaborator aan niveau koppelen

12.1 Schermafbeelding

oefenhub_docent_10_collaborator_v1_8.png

12.2 Scherm meta data

VeldWaarde
Scherm-IDSCH-DOC-10-01
SchermnaamCollaborator aan niveau koppelen
Doelgroep / onderdeelDocent
Bronbestandoefenhub_docent_10_collaborator_v1_8.html
MockupversieV1.8
Screenshotbestandoefenhub_docent_10_collaborator_v1_8.png
Processtap / contextDocent beheert collaborators voor één geselecteerd niveau binnen Oefenaanbod.
DocumentatiestatusUitgewerkt op basis van HTML-mockup, PNG-screenshot, Functioneel Ontwerp, Technisch Ontwerp, Software Requirements Specification en ondersteunende documentatie.
OpmerkingenDe in de mockup zichtbare waarden zoals niveau, eigenaar, aantallen, docentnamen en koppeldata zijn voorbeeldwaarden. Deze worden runtime bepaald op basis van het geselecteerde niveau, de ingelogde docent en bestaande docent-docentrelaties.
Route / URL-patroonDocentnavigatie > Oefenaanbod > geselecteerd niveau > Collaborators beheren.
Autorisatie / vereiste rol-contextActieve docentcontext met beheerrecht op het geselecteerde niveau. In de reguliere docentflow is dit de actuele eigenaar van het niveau; beheerderondersteuning valt buiten dit schermdocument.
Primair domeinobject / hoofdentiteitCollaborator-koppelingen op niveau-laag.
Gerelateerde schermen / navigatie03_niveaus_en_categorieen, 13_eigenaarschap_overdragen.

12.3 Functionele beschrijving

Dit scherm ondersteunt het koppelen en ontkoppelen van docent-collaborators aan één geselecteerd niveau. Het scherm wordt geopend vanuit een niveau binnen Oefenaanbod en werkt altijd binnen de actieve docentcontext.

Een collaborator is een docent met een actieve docent-docentrelatie met de eigenaar van het niveau, die expliciet aan dit niveau wordt gekoppeld om mee te werken aan categorieën, oefeningen en configuraties binnen dat niveau. De collaborator krijgt hierdoor bewerkrechten binnen de inhoudsstructuur van het niveau, maar krijgt geen toegang tot leerlingen, resultaten, geschiedenis of live meekijken van de eigenaar.

Het scherm toont links de docenten die beschikbaar zijn om te koppelen. Dit zijn docenten met een actieve docent-docentrelatie met de huidige docent, die nog geen actieve collaborator zijn op het geselecteerde niveau. Rechts staan de docenten die al collaborator zijn op dit niveau.

De acties Koppel geselecteerd en Ontkoppel geselecteerd verplaatsen geselecteerde docenten tussen de twee lijsten als niet-opgeslagen wijziging binnen het scherm. De wijziging wordt pas definitief verwerkt wanneer de docent op Wijzigingen opslaan klikt. Hierdoor kan de docent meerdere koppel- en ontkoppelacties in één keer voorbereiden en daarna als één wijzigingsset opslaan.

Interpretatie van mockupwaarden

De mockup toont voorbeeldwaarden zoals Groep 7, Eva Jansen, Actieve collaborators: 3, Gekoppeld 3, Beschikbaar 5 en concrete docentnamen. Deze waarden zijn geen vaste systeemwaarden. In de applicatie worden zij dynamisch bepaald op basis van:

  • het geselecteerde niveau;
  • de actuele eigenaar van dat niveau;
  • actieve docent-docentrelaties van de eigenaar;
  • bestaande actieve collaborator-koppelingen op het niveau;
  • de tijdelijke selecties en verplaatsingen die de gebruiker in het scherm uitvoert.

Procesverloop

  1. De docent opent het scherm vanuit een geselecteerd niveau binnen Oefenaanbod.
  2. Het systeem controleert of de docent dit niveau mag beheren.
  3. Het systeem laadt de niveaucontext, de eigenaar en de actuele collaboratorstatus.
  4. Het systeem bepaalt welke docenten beschikbaar zijn om te koppelen.
  5. De docent selecteert één of meerdere docenten links of rechts.
  6. De docent gebruikt Koppel geselecteerd of Ontkoppel geselecteerd om een niet-opgeslagen wijziging te maken.
  7. De docent bevestigt de wijzigingsset via Wijzigingen opslaan.
  8. Het systeem verwerkt de delta, past collaborator-records aan, registreert auditinformatie en toont terugkoppeling.

Business rules

  • Alleen docenten met een actieve docent-docentrelatie met de eigenaar van het niveau mogen als beschikbare collaborator worden getoond.
  • De actuele eigenaar van het niveau wordt niet als beschikbare collaborator getoond, omdat eigenaarschap en collaboratorstatus functioneel verschillende rollen binnen hetzelfde niveau zijn.
  • Een docent mag niet dubbel als actieve collaborator op hetzelfde niveau worden gekoppeld.
  • Ontkoppelen verwijdert de collaborator-koppeling niet fysiek, maar deactiveert deze administratief zodat historie en auditinformatie behouden blijven.
  • Collaboratorrechten zijn niveaugebonden en geven uitsluitend toegang tot inhoudelijke bewerking van categorieën, oefeningen en configuraties binnen dat niveau.
  • Collaboratorrechten geven geen toegang tot leerlinglijsten, leerlingautorisaties, resultaten, geschiedenis of live meekijken.
  • Zolang de gebruiker niet-opgeslagen wijzigingen nog niet heeft opgeslagen, mogen deze wijzigingen niet als definitieve autorisatie worden gebruikt.
  • Bij het verbreken van een docent-docentrelatie moeten actieve collaborator-koppelingen tussen dezelfde docenten administratief worden gedeactiveerd via het relatiebeheerproces.
  • Als de pagina zonder beschikbare docenten of zonder gekoppelde collaborators wordt geopend, blijft het scherm bruikbaar met een duidelijke lege staat in de betreffende lijst.

12.4 UI-elementen en velddefinities

Element-IDTypeGUI-verwijzingOmschrijvingZichtbaar labelOpmerkingTechnische naam
SCH-DOC-10-01-S01SectionKruimelpad bovenaanToont de navigatiecontext vanaf Home via Oefenaanbod en het geselecteerde niveau naar het huidige scherm.Home > Oefenaanbod > <niveau> > Collaborators autoriserenNiveau is dynamisch.CollaboratorBreadcrumb
SCH-DOC-10-01-S02SectionIntrokaartLegt uit dat collaborators bewerkrechten krijgen op het geselecteerde niveau, maar geen leerling- of resultaattoegang krijgen.Collaborator aan niveau koppelenDe tekst bevat dynamisch de naam van het niveau.CollaboratorIntroPanel
SCH-DOC-10-01-F01FieldIntrokaart, tekst en chipNaam van het geselecteerde niveau waarvoor collaborators worden beheerd.Niveau: <niveau>Voorbeeldwaarde in mockup: Groep 7.LevelName
SCH-DOC-10-01-F02FieldIntrokaart, chipNaam van de actuele eigenaar van het niveau.Eigenaar: <docentnaam>Voorbeeldwaarde in mockup: Eva Jansen.OwnerDisplayName
SCH-DOC-10-01-F03FieldIntrokaart, chipAantal actieve collaborators op het niveau vóór of na de actuele niet-opgeslagen wijziging, afhankelijk van gekozen UI-implementatie.Actieve collaborators: <aantal>Moet consistent zijn met de rechterlijst of met de opgeslagen uitgangssituatie.ActiveCollaboratorCount
SCH-DOC-10-01-F04FieldIntrokaart, teller rechtsAantal docenten dat actief als collaborator aan het niveau is gekoppeld.GekoppeldVoorbeeldwaarde in mockup: 3.LinkedCollaboratorCount
SCH-DOC-10-01-F05FieldIntrokaart, teller rechtsAantal docenten dat op basis van actieve docent-docentrelatie beschikbaar is om te koppelen.BeschikbaarVoorbeeldwaarde in mockup: 5.AvailableCollaboratorCount
SCH-DOC-10-01-S03SectionHoofdkaartBeheerblok waarin de beschikbare docenten en huidige collaborators naast elkaar worden getoond.Collaborators beheren - <niveau>Niveau is dynamisch.CollaboratorManagePanel
SCH-DOC-10-01-F06FieldDropdown boven de lijstenFiltert de lijst met beschikbare docenten.Filter beschikbare docentenOpties uit mockup: Alle beschikbare docentrelaties, Alleen actief samenwerkend, Alleen nog niet gekoppeld.AvailableTeacherFilter
SCH-DOC-10-01-F07FieldDropdown boven de lijstenBepaalt de sorteervolgorde van de beschikbare docenten.Sorteer beschikbare docentenOpties uit mockup: Achternaam (A-Z), Voornaam (A-Z), Recent gekoppeld.AvailableTeacherSortOrder
SCH-DOC-10-01-T01Table/ListLinker transferlijstToont docenten die gekoppeld kunnen worden als collaborator op het niveau.Beschikbare docentenAlleen docenten met actieve docent-docentrelatie en zonder actieve collaborator-koppeling op dit niveau.AvailableTeachersList
SCH-DOC-10-01-FORM01Form controlCheckbox per beschikbare docentSelecteert een beschikbare docent voor koppelen.Geen apart label; gekoppeld aan docentnaamSelectie is tijdelijke UI-state.AvailableTeacherSelection
SCH-DOC-10-01-B01ButtonLinker transferlijstSelecteert alle zichtbare beschikbare docenten.Selecteer allesWerkt op de zichtbare/filterde lijst.SelectAllAvailableTeachersButton
SCH-DOC-10-01-B02ButtonMidden tussen de lijstenVerplaatst geselecteerde beschikbare docenten naar de rechterlijst als niet-opgeslagen koppeling.Koppel geselecteerd →Nog geen definitieve database-mutatie.LinkSelectedCollaboratorsButton
SCH-DOC-10-01-B03ButtonMidden tussen de lijstenVerplaatst geselecteerde collaborators naar de linkerlijst als niet-opgeslagen ontkoppeling.← Ontkoppel geselecteerdNog geen definitieve database-mutatie.UnlinkSelectedCollaboratorsButton
SCH-DOC-10-01-T02Table/ListRechter transferlijstToont docenten die momenteel of tijdelijk in de schermstatus als collaborator aan het niveau gekoppeld zijn.Collaborators op dit niveauBevat per docent minimaal naam en koppelcontext.CurrentCollaboratorsList
SCH-DOC-10-01-FORM02Form controlCheckbox per huidige collaboratorSelecteert een collaborator voor ontkoppelen.Geen apart label; gekoppeld aan docentnaamSelectie is tijdelijke UI-state.CurrentCollaboratorSelection
SCH-DOC-10-01-B04ButtonRechter transferlijstSelecteert alle zichtbare collaborators op dit niveau.Selecteer allesWerkt op de zichtbare/filterde lijst.SelectAllCurrentCollaboratorsButton
SCH-DOC-10-01-B05ButtonOnder de transferlijstenVerwerkt alle niet-opgeslagen wijzigingen definitief.Wijzigingen opslaanSchrijft koppelingen/ontkoppelingen en auditinformatie weg.SaveCollaboratorChangesButton
SCH-DOC-10-01-M01MessageLinker of rechter lijstInformatieve lege staat wanneer een lijst geen records bevat.Nog geen beschikbare docenten / Nog geen collaborators gekoppeldTekst mag afwijken, maar moet functioneel duidelijk zijn.CollaboratorEmptyStateMessage
SCH-DOC-10-01-M02MessageNa opslaanTerugkoppeling na succesvolle of mislukte opslag.Wijzigingen opgeslagen / Wijzigingen konden niet worden opgeslagenFoutteksten horen aan te sluiten op de validatie- en foutafhandelingsspecificatie.CollaboratorSaveFeedbackMessage

12.5 Waardelagen

Element-IDGUI-verwijzingZichtbaar labelTechnische naamDatabronWaardebronDatatypeBewerkbaarValidatie / regel
SCH-DOC-10-01-S01Kruimelpad<niveau>LevelNameTeacherLevels.NamedatabasestringNeeAlleen tonen als de gebruiker het niveau in de actieve docentcontext mag beheren.
SCH-DOC-10-01-F01Niveauchip en tekstNiveauLevelNameTeacherLevels.NamedatabasestringNeeWaarde hoort bij het geselecteerde TeacherLevelId uit de route- of schermcontext.
SCH-DOC-10-01-F02EigenaarchipEigenaarOwnerDisplayNameTeacherLevels.OwnerTeacherUserId -> Users / gebruikersprofieldatabasestringNeeDe eigenaar is de actuele eigenaar van het niveau; niet afleiden uit de ingelogde gebruiker zonder controle.
SCH-DOC-10-01-F03Chip actieve collaboratorsActieve collaboratorsActiveCollaboratorCountTeacherLevelCollaboratorsberekendintegerNeeTelt actieve collaborator-records met IsActive = true voor het geselecteerde niveau.
SCH-DOC-10-01-F04Teller rechtsGekoppeldLinkedCollaboratorCountTeacherLevelCollaboratorsberekendintegerNeeTelt actieve gekoppelde collaborators voor het niveau. Bij niet-opgeslagen wijzigingen moet de UI consistent kiezen tussen opgeslagen telling of niet-opgeslagen telling.
SCH-DOC-10-01-F05Teller rechtsBeschikbaarAvailableCollaboratorCountUserRelationships, Users, TeacherLevelCollaboratorsberekendintegerNeeTelt actieve docent-docentrelaties die nog niet als actieve collaborator op dit niveau bestaan.
SCH-DOC-10-01-F06FilterdropdownFilter beschikbare docentenAvailableTeacherFilterUI-keuzelijst / filterdefinitieuser inputenum/stringJaFilter werkt alleen op beschikbare docenten en mag geen docenten buiten de autorisatiecontext tonen.
SCH-DOC-10-01-F07SorteerdropdownSorteer beschikbare docentenAvailableTeacherSortOrderUI-keuzelijst / gebruikerskeuzeuser inputenum/stringJaSorteren wijzigt alleen de presentatievolgorde, niet de autorisatieset.
SCH-DOC-10-01-T01LinkerlijstBeschikbare docentenAvailableTeachersListUserRelationships, Users, Roles, TeacherLevelCollaboratorsdatabase + berekendcollectionNeeAlleen actieve docent-docentrelaties met rolcontext Docent; huidige eigenaar en al gekoppelde collaborators uitsluiten.
SCH-DOC-10-01-FORM01Checkbox linksSelectie beschikbare docentAvailableTeacherSelectionUI-stateuser inputbooleanJaSelectie is tijdelijk en wordt pas functioneel na Koppel geselecteerd.
SCH-DOC-10-01-B01Selecteer alles linksSelecteer allesSelectAllAvailableTeachersUI-stateuser inputactionJaSelecteert uitsluitend zichtbare records binnen het actieve filter.
SCH-DOC-10-01-B02MiddenknopKoppel geselecteerd →PendingCollaboratorsToAddUI-state, bij opslaan TeacherLevelCollaboratorsuser inputaction/collectionJaMag alleen geselecteerde docenten uit de beschikbare lijst naar de niet-opgeslagen collaboratorlijst verplaatsen.
SCH-DOC-10-01-B03Middenknop← Ontkoppel geselecteerdPendingCollaboratorsToRemoveUI-state, bij opslaan TeacherLevelCollaboratorsuser inputaction/collectionJaMag alleen geselecteerde docenten uit de collaboratorlijst naar de niet-opgeslagen beschikbare lijst verplaatsen.
SCH-DOC-10-01-T02RechterlijstCollaborators op dit niveauCurrentCollaboratorsListTeacherLevelCollaborators, Usersdatabase + UI-statecollectionNeeToont actieve opgeslagen collaborators plus niet-opgeslagen koppelingen, afhankelijk van UI-state.
SCH-DOC-10-01-FORM02Checkbox rechtsSelectie collaboratorCurrentCollaboratorSelectionUI-stateuser inputbooleanJaSelectie is tijdelijk en wordt pas functioneel na Ontkoppel geselecteerd.
SCH-DOC-10-01-B04Selecteer alles rechtsSelecteer allesSelectAllCurrentCollaboratorsUI-stateuser inputactionJaSelecteert uitsluitend zichtbare collaboratorrecords in de rechterlijst.
SCH-DOC-10-01-B05OpslaanknopWijzigingen opslaanSaveCollaboratorChangesTeacherLevelCollaborators met grant-/revoke-auditvelden, eventueel SystemMessagesuser input + databaseactionJaVerwerkt alleen de delta tussen beginsituatie en niet-opgeslagen UI-status; dubbele actieve koppelingen zijn niet toegestaan.
SCH-DOC-10-01-M01Lege staatNog geen ...CollaboratorEmptyStateAfgeleide UI-stateberekendstringNeeWordt getoond wanneer beschikbare lijst of collaboratorlijst leeg is.
SCH-DOC-10-01-M02OpslagfeedbackWijzigingen opgeslagen / foutmeldingSaveFeedbackResultaat van serviceactieberekendstringNeeFoutmeldingen mogen geen technische IDs of stacktraces tonen.

12.6 Schermtrace naar SRS en acceptatiecriteria

De onderstaande tabel legt per schermrequirement de koppeling naar het centrale schermrequirements-trace-register, SRS-requirements en acceptatiecriteria vast. De normatieve requirementtekst staat in de SRS; dit schermdocument beschrijft alleen de lokale schermcontext.

Deze tabel bevat alleen schermtraceability. De normatieve requirementtekst en acceptatiecriteria staan centraal in de SRS.

SchermrequirementDektSchermcontext
REQ-SCH-DOC-10-01-01SRS-TCH-008
AC-TCH-008
Het collaboratorbeheer openen voor precies één geselecteerd niveau binnen de actieve docentcontext
REQ-SCH-DOC-10-01-02SRS-TCH-008
AC-TCH-008
Vóór het tonen van data controleren of de gebruiker het geselecteerde niveau mag beheren
REQ-SCH-DOC-10-01-03SRS-RDM-005
SRS-RDM-002
SRS-RDM-001
SRS-TCH-008
AC-RDM-005
AC-RDM-002
AC-RDM-001
AC-TCH-008
De niveaucontext, eigenaar en actuele collaboratoraantallen dynamisch bepalen uit de geselecteerde niveaucontext
REQ-SCH-DOC-10-01-04SRS-RDM-005
SRS-RDM-002
SRS-RDM-001
SRS-TCH-008
AC-RDM-005
AC-RDM-002
AC-RDM-001
AC-TCH-008
Het systeem mag mockupwaarden zoals niveau, eigenaar, aantallen, docentnamen en koppeldata nooit als vaste of hardcoded waarden gebruiken
REQ-SCH-DOC-10-01-05SRS-TCH-008
AC-TCH-008
Links alleen docenten tonen met een actieve docent-docentrelatie met de eigenaar van het niveau
REQ-SCH-DOC-10-01-06SRS-TCH-008
AC-TCH-008
In de beschikbare lijst docenten uitsluiten die al actieve collaborator zijn op het geselecteerde niveau
REQ-SCH-DOC-10-01-07SRS-TCH-008
AC-TCH-008
De actuele eigenaar van het niveau uitsluiten als beschikbare collaborator
REQ-SCH-DOC-10-01-08SRS-TCH-008
AC-TCH-008
Rechts de huidige actieve collaborators van het geselecteerde niveau tonen
REQ-SCH-DOC-10-01-09SRS-AUTH-001
SRS-LIVE-002
AC-AUTH-001
AC-LIVE-002
Expliciet zichtbaar maken dat collaborators wel aan oefeningen en configuraties mogen werken, maar geen toegang krijgen tot leerlingen, resultaten, geschiedenis of live meekijken
REQ-SCH-DOC-10-01-10SRS-AUTH-001
SRS-TCH-008
AC-AUTH-001
AC-TCH-008
Filteren op beschikbare docenten ondersteunen zonder de autorisatiegrenzen van de docentcontext te doorbreken
REQ-SCH-DOC-10-01-11SRS-AUTH-001
SRS-TCH-008
AC-AUTH-001
AC-TCH-008
Sorteren op beschikbare docenten ondersteunen zonder de onderliggende autorisatieset te wijzigen
REQ-SCH-DOC-10-01-12SRS-TCH-001
AC-TCH-001
Selectie van één of meerdere docenten in beide transferlijsten ondersteunen
REQ-SCH-DOC-10-01-13SRS-TCH-001
AC-TCH-001
De actie Selecteer alles alleen werken op records die binnen de huidige lijst en filtercontext zichtbaar zijn
REQ-SCH-DOC-10-01-14SRS-TCH-006
AC-TCH-006
De actie Koppel geselecteerd geselecteerde beschikbare docenten als niet-opgeslagen wijziging naar de collaboratorlijst verplaatsen zonder direct databasewijzigingen door te voeren
REQ-SCH-DOC-10-01-15SRS-TCH-006
AC-TCH-006
De actie Ontkoppel geselecteerd geselecteerde collaborators als niet-opgeslagen wijziging naar de beschikbare lijst verplaatsen zonder direct databasewijzigingen door te voeren
REQ-SCH-DOC-10-01-16SRS-TCH-001
AC-TCH-001
Niet-opgeslagen wijzigingen pas definitief verwerken na de actie Wijzigingen opslaan
REQ-SCH-DOC-10-01-17SRS-TCH-001
AC-TCH-001
Bij opslaan alleen de delta tussen de oorspronkelijke en actuele niet-opgeslagen UI-status verwerken
REQ-SCH-DOC-10-01-18SRS-TCH-008
AC-TCH-008
Het systeem mag nooit meer dan één actieve collaborator-koppeling toestaan voor dezelfde docent en hetzelfde niveau
REQ-SCH-DOC-10-01-19SRS-TCH-006
AC-TCH-006
Ontkoppelen administratief verwerken door de collaborator-koppeling te deactiveren in plaats van fysiek te verwijderen
REQ-SCH-DOC-10-01-20SRS-NFR-AUD-001
SRS-TCH-008
AC-NFR-AUD-001
AC-TCH-008
Koppel- en ontkoppelacties auditbaar vastleggen met uitvoerende gebruiker, tijdstip, niveau, betrokken docent en actietype
REQ-SCH-DOC-10-01-21SRS-AUTH-001
SRS-LIVE-002
AC-AUTH-001
AC-LIVE-002
Voorkomen dat collaboratorbeheer leerlingrelaties, leerlingautorisaties, resultaten, geschiedenis of live meekijkrechten wijzigt
REQ-SCH-DOC-10-01-22SRS-TCH-006
AC-TCH-006
Een bruikbare lege staat tonen wanneer er geen beschikbare docenten of geen huidige collaborators zijn
REQ-SCH-DOC-10-01-23SRS-RDM-005
SRS-RDM-002
SRS-RDM-001
SRS-TCH-001
AC-RDM-005
AC-RDM-002
AC-RDM-001
AC-TCH-001
Na succesvolle opslag duidelijke functionele terugkoppeling tonen en de lijsten en tellers opnieuw synchroniseren met de opgeslagen werkelijkheid
REQ-SCH-DOC-10-01-24SRS-TCH-006
AC-TCH-006
Bij opslagconflicten, zoals een inmiddels gewijzigde collaboratorstatus, opnieuw valideren tegen de actuele database en een begrijpelijke melding tonen
REQ-SCH-DOC-10-01-25SRS-AUTH-004
SRS-TCH-006
AC-AUTH-004
AC-TCH-006
Technische identifiers zoals GUID's, interne relatie-ID's en collaborator-record-ID's niet zichtbaar maken aan docenten
REQ-SCH-DOC-10-01-26SRS-TCH-006
AC-TCH-006
Bij het verbreken van een docent-docentrelatie via relatiebeheer actieve collaborator-koppelingen tussen dezelfde docenten administratief deactiveren, zodat dit scherm daarna geen ongeldige collaboratorstatus toont

12.7 Technische koppeling

Voor technische uitwerking zijn vooral relevant: