OneRoster-bestanden moeten tekstbestanden in CSV-indeling (Comma Separated Values) zijn, gecodeerd in UTF-8. Om deze bestanden te genereren, opent u uw SIS-gegevens met behulp van de exporttools en volgt u de instructies van uw leverancier. Neem contact op met uw SIS-provider voor hulp bij het extraheren van gegevens naar de OneRoster CSV-indeling.
Brightspace® ondersteunt de IMS OneRoster v1.1-specificatie. Beheerders kunnen een OneRoster 1.1-compatibel pakket uploaden met de vereiste roostergegevens, zoals scholen, groepen, gebruikers en inschrijvingen, en bekijk de resultaten in Brightspace®.
OneRoster CSV ondersteunt de volgende bestanden en verwerkt ze in de aangegeven volgorde:
- manifest.csv
- academicsessions.csv
- orgs.csv
- courses.csv
- classes.csv
- users.csv
- enrollments.csv
De OneRoster CSV-bestanden gebruiken
In de volgende secties vindt u een beschrijving op hoofdlijnen van de typen OneRoster CSV-bestanden. Ga voor meer informatie naar CSV-gegevensreeksen voor OneRoster.
Vereist CSV-manifestbestand
U moet bij elk pakket een manifestbestand opnemen. Het manifest bevat de versie en de lijst met bestanden die u naar Brightspace® verzendt, en geeft aan of het pakket met roostergegevens delta- (alleen wijzigingen sinds de laatste update) of bulkinhoud (alle bestanden) bevat.
CSV-bestandstypen AcademicSessions, Orgs, Courses en Classes
De OneRoster CSV-integratie kan de organisatieniveaus maken en bijwerken die worden vermeld in het gedeelte De toewijzing van gegevenstypen begrijpen tussen OneRoster en Brightspace® van het onderwerp OneRoster-integratie voorbereiden. U moet alle organisatieniveaus die niet in de lijst verschijnen, beheren buiten de OneRoster-integratie.
Volg de naamgevingsconventies (naam/code) die zijn gedefinieerd in uw SIS voor organisatie-eenheden. Brightspace® accepteert elk aantal organisatie-eenheden en u kunt de namen en codes van deze eenheden opnemen in CSV-bestanden, mits deze voldoen aan de beperkingen van Brightspace® op illegale tekens.
Stuur organisatieniveaus ten minste één keer om aan te geven welke organisatie-eenheden door IPSIS kunnen worden gecontroleerd. Verzend de bestanden van de organisatie-eenheid alleen opnieuw als u ze wilt toevoegen of bijwerken in de organisatiestructuur van de leeromgeving.
OneRoster CSV kan:
- Een nieuwe organisatie-eenheid maken als deze niet bestaat
- Een toewijzing maken naar een bestaande organisatie-eenheid als deze is gemaakt door een andere bron
- De naam of code van een organisatie-eenheid bijwerken die door OneRoster CSV wordt beheerd
- Cursussjabloon: bovenliggende scholen toewijzen en bijwerken op basis van de schoolcode
- Cursuseditie: bovenliggende scholen toewijzen en bijwerken op basis van de schoolcode
- Cursuseditie: sjabloon en semester van de bovenliggende cursus toewijzen en bijwerken op basis van de bovenliggende code
- Cursuseditie: Alle cursusgegevens bijwerken, inclusief de naam van de cursuseditie
- Codes van organisatie-eenheden bijwerken
- Inhoud van een cursus naar nieuwe cursus kopiëren
- Een organisatie-eenheid verwijderen als het delta-bestand wordt verzonden met status tobedeleted en de organisatie-eenheid geen inschrijvingen heeft
OneRoster CSV kan niet het volgende doen:
- Handmatig gemaakte organisatie-eenheden verwijderen tenzij deze aan OneRoster CSV zijn toegewezen
- Een organisatie-eenheid verwijderen als hieraan onderliggende niveaus zijn gekoppeld (onderliggende niveaus moeten eerst worden verwijderd)
Type CSV-bestand Gebruikers
Met verwerking van het gebruikerstype worden in Brightspace® gebruikers gemaakt, bijgewerkt of gedeactiveerd. Gebruikersgegevens moeten minstens één keer worden verzonden om IPSIS te instrueren welke gebruikersprofielen het kan maken en bijwerken en voor welke gebruikersprofielen het inschrijvingen kan beheren. Brightspace® schrijft gebruikers automatisch in op school.
OneRoster CSV kan:
- Een nieuwe gebruiker maken
- Als een gebruiker bestaat met dezelfdeOrgDefinedID of dezelfde gebruikersnaam, kan deze worden toegewezen aan een bestaande gebruiker
- Voornaam, Achternaam, Wachtwoord en E-mail bijwerken
- De rol op organisatieniveau bijwerken
- Een gebruiker activeren of deactiveren
- De door de organisatie gedefinieerde id of gebruikersnaam bijwerken
- Gebruikers van bovenste organisatorische eenheden inschrijven of uitschrijven
OneRoster CSV zal niet:
Type CSV-bestand Inschrijvingen
Door het verwerken van het inschrijftype worden gebruikers in Brightspace® in- of uitgeschreven op het niveau van de cursussectie. Verzend inschrijvingen alleen wanneer er wijzigingen plaatsvinden in uw informatiesysteem om Brightspace® up-to-date te houden. Verzend een uitschrijving slechts één keer, omdat er bij het opnieuw verzenden waarschuwingen worden gegenereerd in het IPSIS-logboek.
OneRoster CSV kan:
- Gebruikers in- of uitschrijven voor de cursuseditie en secties
OneRoster CSV kan het volgende niet:
- Schrijf gebruikers in op andere organisatieniveaus (behalve zoals hierboven is aangegeven, door gebruik te maken van de gebruikersrecord).
Beperkingen en aannames
Uitschrijvingen bij bovenste organisatie-eenheden
De term bovenste organisatie-eenheid verwijst naar elke organisatie-eenheid in de hiërarchie boven een cursuseditie, zoals de school waar de cursus wordt aangeboden. Gebruikers worden doorgaans ingeschreven voor zowel de cursuseditie als de bijbehorende school, die dienst doet als de bovenste organisatie-eenheid.
- Als u uitschrijvingen wilt inschakelen met behulp van de OneRoster-integratie, selecteert u op de pagina IPSIS-beheer de optie Gebruikers voor SIS-organisaties uitschrijven als zij niet meer aan deze zijn gekoppeld in het SIS.
- De OneRoster-integratie kan gebruikers niet uitschrijven van bovenste organisatie-eenheden die zijn gemaakt vóór de release van juni 2024/20.24.6 of van inschrijvingen die handmatig zijn gemaakt in Brightspace®.
- Bij uitschrijving van een gebruiker met een trapsgewijze rol die is uitgeschreven bij een bovenste organisatie-eenheid, kan de toegang tot een groot aantal onderliggende organisatie-eenheden verloren gaan.
Niet-ondersteunde tekens
De code van de organisatie-eenheid kan afkomstig zijn uit de volgende CSV-velden:
- Academische sessies: titel
- Cursussen: titel of courseCode
- Groepen: titel of classCode
- Organisaties: naam van id
De volgende tekens worden momenteel niet ondersteund voor de code van de organisatie-eenheid:
- \ (schuine streep naar achteren)
- : (dubbele punt)
- * (sterretje)
- ? (vraagteken)
- " " (aanhalingstekens openen en sluiten)
- < > (kleiner-dan- en groter-dan-tekens)
- | (sluisteken)
- ‘ (apostrof)
- # (hekje)
- , (komma)
- % (procentteken)
- & (en-teken)
Alle codes van organisatie-eenheden worden afgekapt tot een maximumlengte van 50 karakters.
CSV-bestanden verwerken
Zip CSV-bestanden voordat u ze uploadt naar Brightspace®. U kunt het ZIP-bestand uploaden:
- Handmatig: Sleep het bestand naar de interface IPSIS-beheer > Dashboard.
- Automatisch: Upload het ZIP-bestand naar de SFTP-site die is ingesteld tijdens uw eerste configuratie. Brightspace® controleert de SFTP-site elke tien minuten.