Documentatie over integraties

Hoe IPSIS zich verhoudt tot de Brightspace®-organisatiestructuur

OneRoster CSV

OneRoster CSV-integratie accepteert uw gegevens in een set CSV-bestanden (Comma Separated Values), die worden geüpload via een zip-archief met CSV-bestanden.

De bestandsindelingen waarmee u gaat werken, worden in de volgende volgorde verwerkt:

manifest.csv
academicsessions.csv
orgs.csv
courses.csv
classes.csv
users.csv
enrollments.csv

Toewijzing van waarden

In de onderstaande toewijzingstabel wordt uitgelegd hoe de objecttypen van OneRoster zich verhouden tot de D2L® Brightspace®-omgeving.

OneRoster	D2L® Brightspace
Academische sessies	Organisatie-eenheden*
Organisaties	Organisatie-eenheden*
Cursussen	Cursussjablonen
Groepen	Cursuseditie en cursussectie
Gebruikers	Gebruiker
Inschrijvingen	Inschrijving

*Het type organisatie-eenheid waaraan elk object is toegewezen, is afhankelijk van de configuratie-instelling van de D2L® SIS-integratie in de UI-toewijzingssectie van IPSIS-beheer.

De OneRoster CSV-integratie kan de hierboven vermelde niveaus maken en bijwerken. Alles wat buiten deze lijst valt, moet buiten deze integratie worden beheerd.

De naamgevingsconventies voor de organisatie-eenheid (naam/code) moeten de conventies volgen die in uw SIS worden beschreven. Brightspace® kan zoveel organisatie-eenheden accepteren als nodig is. Namen en codes van organisatie-eenheden kunnen ongewijzigd in de CSV-bestanden worden ingevoerd, mits namen of codes voldoen aan de vereisten voor geldige Brightspace®-tekens.

Manifest
- Het manifest moet bij elk pakket worden meegeleverd. Het manifest bevat de versie en de lijst met bestanden die naar Brightspace® worden verzonden. Het manifest specificeert bovendien Delta versus Bulk.
Academic Sessions, Orgs, Schools, Courses, Classes (Academische sessies, organisaties, scholen, cursussen, groepen)
Deze moeten minstens één keer worden verzonden om IPSIS te instrueren inzake welke organisatie-eenheid door IPSIS kan worden beheerd.

U moet alleen bestanden van de organisatie-eenheid opnieuw verzenden als deze moeten worden toegevoegd of bijgewerkt in de organisatiestructuur in 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 dan OneRoster
- 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 zal niet:
- 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)
- Start- of einddatums bij voor elk type organisatie-eenheid bijhouden
Gebruikers

Een nieuwe gebruiker maken
Als een gebruiker bestaat met OrgDefinedID of dezelfde gebruikersnaam, kan deze worden toegewezen aan de 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:

Gebruikers verwijderen

Inschrijvingen

Door het verwerken van het inschrijftype worden gebruikers in Brightspace® in- of uitgeschreven op het niveau van de cursussectie. Inschrijvingen moeten worden verzonden wanneer wijzigingen in het informatiesysteem worden aangebracht om deze veranderingen in Brightspace® nauwkeurig weer te geven. Een uitschrijving dient slechts eenmaal te worden verzonden. Als u dezelfde uitschrijving opnieuw verzendt, worden er waarschuwingen weergegeven in het IPSIS-logboek.

OneRoster CSV kan:

Gebruikers inschrijven in cursusedities en -secties
Gebruikers uitschrijven voor cursusedities en -secties

OneRoster CSV kan het volgende niet:

Gebruikers inschrijven op andere organisatieniveaus

Beperkingen en aannames

Uitschrijvingen bij bovenste organisatie-eenheden:

Op de pagina IPSIS-beheer moet u de optie Gebruikers voor SIS-organisaties uitschrijven als zij niet meer aan deze zijn gekoppeld in de SIS inschakelen om uitschrijvingen via de OneRoster-integratie mogelijk te maken.
Inschrijvingen in bovenste organisatorische eenheden die zijn gemaakt vóór de release van juni 2024/20.24.6, kunnen niet worden uitgeschreven via de OneRoster-integratie.
Inschrijvingen die handmatig in Brightspace® zijn gemaakt, kunnen niet worden uitgeschreven via de OneRoster-integratie.
Een gebruiker met een trapsgewijze rol die is uitgeschreven bij een bovenste organisatie-eenheid, kan toegang verliezen tot een groot aantal onderliggende organisatie-eenheden.

Niet-ondersteunde karakters:

De volgende karakters worden momenteel niet ondersteund voor de code van de organisatie-eenheid: \ : * ? " " < > | ' # , % &
De code van de organisatie-eenheid kan afkomstig zijn uit de volgende CSV-velden:
- Academische sessies: Titel
- Cursussen: Titel of CourseCode
- Klassen: Titel of ClassCode
- Organisaties: Naam of Identifier

Afkappen van velden:

Alle codes van organisatie-eenheden worden afgekapt tot een maximumlengte van 50 karakters.