De bestandsindelingen die door D2L® Standaard CSV worden geaccepteerd zijn:
- Organisaties
- Gebruikers
- Inschrijvingen
- Kenmerken van het Beheerdersdashboard en Cursusgroepen
- Manifest (vereist bij gebruik van versie 1.1 of hoger van D2L® Standaard CSV)
Bestanden worden geüpload in een zip-archief. De aanbevolen naamgevingsconventie is:
- D2LStdCSV-{JJJJmmddHHMMSS}.zip
|
Opmerking: Alleen zip-archieven (hoofdlettergevoelig, alleen kleine letters) mogen naar SFTP worden geüpload. |
Bestanden worden in alfabetische volgorde verwerkt. D2L® raadt u aan de bestanden in de volgende volgorde te verzenden:
- orgs (organisatie-eenheden)
- users (gebruikers)
- enrollments (inschrijvingen)
- attributes (kenmerken)
De aanbevolen naamgevingsconventie voor afzonderlijke D2L® Standaard CSV-bestanden is:
- 01 - Overige - {JJJJmmddUUMMSS}.csv
- Verwerking van aangepaste organisatie-eenheden buiten de standaard D2L®-organisatiestructuur wordt ondersteund in D2L® Standaard CSV 2.0 of hoger.
- 02 - Afdelingen- {JJJJmmddUUMMSS}.csv
- 03 - Semesters - {JJJJmmddUUMMSS}.csv
- 04 - Sjablonen - {JJJJmmddUUMMSS}.csv
- 05 - Aanbod - {JJJJmmddUUMMSS}.csv
- 06 - Secties - {JJJJmmddUUMMSS}.csv
- 07 - Gebruikers - {JJJJmmddUUMMSS}.csv
- 08 - Inschrijvingen - {JJJJmmddUUMMSS}.csv
- 09 - Kenmerken - {JJJJmmddUUMMSS}.csv
- manifest.json
Algemene regels voor inhoud van CSV-bestanden
- Waarden in bestanden zijn hoofdlettergevoelig. In de instructies wordt beschreven of hoofd- of kleine letters vereist zijn.
- Een lege waarde wordt weergegeven met twee komma's zonder spaties ertussen. (Zo geeft ,, een lege waarde aan, terwijl , , een spatie aangeeft, die wordt geparseerd als een ongeldige waarde).
- De CSV-bestanden moeten een koptekst (eerste regel) hebben die exact overeenkomt (hoofdletters/kleine letters en komma's) met de voorbeelden in <koppeling naar pagina die elk bestand definieert met voorbeelden>. Volgende regels in het bestand bevatten de gegevens die moeten worden verwerkt (gemaakt, bijgewerkt, verwijderd).
- CSV-bestanden moeten UTF-8-gecodeerd zijn.
- CSV-bestanden moeten differentiële SIS-gegevens (delta's) bevatten in plaats van complete SIS-datadrops.
- Het verzenden van een UPDATE-actie wanneer het object niet bestaat, resulteert in een aanvraag tot CREATE. Algemeen worden alleen de acties UPDATE of DELETE gebruikt, respectievelijk voor bijwerken of verwijderen.
- CSV-bestanden en het manifest moeten in het zip-archief zitten.
- Een manifest is vereist bij gebruik van versie 1.1 of hoger van D2L® Standaard CSV. Het manifest is een JSON-bestand dat de versie aankondigt van D2L® Standaard CSV die u gebruikt. Zie het onderwerp Manifest voor meer informatie.
- Het wordt aanbevolen om geen persoonlijk identificeerbare informatie (PII), zoals de namen van gebruikers of burgerservicenummers, op te nemen in door de organisatie gedefinieerde id’s (sourcedIds) voor gebruikers.
Regels voor ondersteunde typen organisatie-eenheden
De volgende typen organisatie-eenheid worden ondersteund in de integratie:
- Andere organisatie-eenheden (aangepaste organisatie-eenheden buiten de standaard D2L®-organisatiestructuur worden ondersteund in D2L® Standaard CSV versie 2.0 of hoger)
- Afdelingen
- Semesters
- Cursussjablonen
- Cursusedities
- Secties
Met de D2L® Standaard CSV-integratie kunnen organisatie-eenheden op de hierboven vermelde niveaus worden gemaakt, bijgewerkt en verwijderd.
Als u veel typen organisatie-eenheden in één CSV-bestand verzendt, moet u ervoor zorgen dat de hiërarchie in het bestand wordt gerespecteerd (bijvoorbeeld: afdelingen moeten worden verzonden vóór cursussjablonen). Als u een bovenliggende organisatie-eenheid niet verzendt voordat de onderliggende eenheid is gemaakt, mislukt de onderliggende organisatie-eenheid.
Als u gebruikersrelaties verzendt, moet u ervoor zorgen dat de hiërarchie van auditors en/of ouders/voogden in het bestand wordt gerespecteerd (ouders/voogden moeten bijvoorbeeld worden verzonden voor de cursisten). Als u dit niet doet, mislukt de relatie.
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 de organisatie-eenheden kunnen precies zoals in de CSV-bestanden worden aangeleverd als de namen of codes voldoen aan de vereisten voor geldige Brightspace®-tekens en uniek zijn voor verschillende organisatie-eenheden.
Codes van organisatie-eenheden mogen maximaal 50 tekens bevatten. Als ze langer zijn, wordt de code van de organisatie-eenheid automatisch afgekapt op 50 en kan dit leiden tot het dupliceren van codes van organisatie-eenheden in Brightspace® of het niet maken van een organisatie-eenheid.
|
Opmerking: Codes van organisatie-eenheden ondersteunen de volgende tekens niet:: , : % & # * ? < > | \ " ' en begin- of volgspaties. |
Regels voor andere ondersteunde typen organisatie-eenheden
Afdelingen, semesters, cursussjablonen, cursusedities en cursussecties worden eveneens ondersteund. Door deze organisatie-eenheden te verwerken wordt de organisatiestructuur in uw versie van Brightspace® gemaakt. Deze moeten minstens één keer worden verzonden om D2L® Standaard CSV te instrueren welke organisatie-eenheden het kan beheren. Zodra de integratie een organisatie-eenheid beheert, moeten alle toekomstige wijzigingen aan die organisatie-eenheid alleen worden doorgevoerd via de D2L® Standaard CSV-integratie om te zorgen voor het juiste eigendom van de gegevens.
|
Waarschuwing: Verzend organisatie-eenheden alleen opnieuw wanneer ze nieuw zijn gemaakt of bijgewerkt in uw SIS/HRIS. |
D2L® Standaard CSV kan het volgende doen:
- Een nieuwe organisatie-eenheid maken als deze niet bestaat.
- Deze toewijzen aan een bestaande organisatie-eenheid als deze is gemaakt door een andere bron dan D2L® Standaard CSV en de optie om toe te wijzen is geselecteerd in de configuratie.
- De naam bijwerken van een organisatie-eenheid die wordt beheerd.
- Aangepaste organisatie-eenheden als bovenliggende organisatie-eenheden toewijzen en verwijderen aan andere aangepaste organisatie-eenheden, afdelingen, semesters, cursussjablonen, cursusedities en cursussecties (van toepassing op D2L® Standaard CSV versie 2.0 of hoger).
- Cursussjabloon: Wijs de bovenliggende afdeling toe en werk deze bij op basis van de afdelingscode.
- Cursuseditie: Wijs de sjabloon en het semester van de bovenliggende cursus toe en werk deze bij op basis van de bovenliggende code.
- Cursuseditie: Werk alle cursusgegevens bij, inclusief de naam en datums van de cursuseditie. Schakel de cursuseditie uit.
- Cursussectie: Als u een cursussectie verwijdert, worden gebruikers automatisch uitgeschreven uit de verwijderde sectie.
- Een organisatie-eenheid verwijderen die door de integratie wordt beheerd.
D2L® Standaard CSV kan niet het volgende doen:
- Codes van organisatie-eenheid bijwerken.
- Handmatig gemaakte organisatie-eenheden verwijderen, tenzij ze zijn toegewezen met D2L® Standaard CSV.
- Een organisatie-eenheid verwijderen als er onderliggende onderdelen aan zijn gekoppeld. (onderliggende onderdelen moeten eerst worden verwijderd). Er doet zich één uitzondering voor: als secties zijn ingesteld voor verwijdering in de interface, kunnen cursusedities worden verwijderd als er een sectie aan is gekoppeld.
Regels voor gebruikerstypen
Door het verwerken van het gebruikerstype worden gebruikers in Brightspace® gemaakt, bijgewerkt, gedeactiveerd of verwijderd. Het gebruikerstype kan ook de relatie tussen ouder en kind in Brightspace® (D2L® Standaard CSV versie 1.1 of hoger) maken, bijwerken of verwijderen. Gebruikers moeten minimaal één keer worden verzonden om de integratie te instrueren welke gebruikers de integratie kan maken, bijwerken of verwijderen en welke bijbehorende inschrijvingen de integratie kan beheren.
|
Opmerking: De voornaam en achternaam van de gebruiker ondersteunen de volgende tekens niet: \ / : * ? " < > | @ , ; Gebruikersnaam en door organisatie gedefinieerde id ondersteunen de volgende tekens niet: / : * ? " < > | ' , ; Het e-mailadres van de gebruiker ondersteunt de volgende tekens niet: ( ) < > [ ] | \ ; : , “ |
D2L® Standaard CSV kan het volgende:
- Een nieuwe gebruiker maken als deze nog niet bestaat en deze inschrijven bij de organisatie.
- Een gebruiker toewijzen aan een bestaande gebruiker met dezelfde door de organisatie gedefinieerde id of gebruikersnaam.
- Gebruikersnaam, voornaam, achternaam, wachtwoord en e-mail bijwerken.
- Geprefereerde voor- en achternaam (D2L® Standaard CSV versie 2.0 of hoger) bijwerken.
- Sorteerbare achternaam (D2L® Standaard CSV versie 2.1 of hoger) bijwerken.
- Voornaamwoorden (D2L® Standaard CSV versie 3.0 of hoger) bijwerken.
- Wachtwoord is niet vereist en het wordt aanbevolen dat u het wachtwoord niet verzendt als u Single Sign-On (SSO) gebruikt.
- De rol op organisatieniveau bijwerken.
- Een gebruiker activeren, uitschakelen of verwijderen.
- Relaties tussen ouder/voogd en kind maken, bijwerken of verwijderen voor Brightspace® Ouder & voogd (D2L® Standaard CSV versie 1.1 of hoger).
- Een relatie tussen auditor en auditee bijwerken (D2L® Standaard CSV versie 2.0 of hoger).
D2L® Standaard-CSV zal niet:
- Door organisatie gedefinieerde id bijwerken; dit kan echter handmatig gedaan worden in de IPSIS-beheerinterface.
- Handmatig gemaakte gebruikers verwijderen, tenzij ze zijn toegewezen met D2L® Standaard CSV.
|
Opmerking: gebruikers in landen zoals Nederland, België en Sri Lanka hebben in sommige gevallen achternamen met een of meer voorvoegsels (in het Nederlands ook wel tussenvoegsels genoemd), zoals Van der Spiegel of Van Gogh, die deel uitmaken van de formele achternaam. In sommige gevallen mag de sorteerbare achternaam geen van dergelijke voorvoegsels bevatten. Beheerders kunnen aangeven of de juridische achternaam van een gebruiker afwijkt van de sorteerbare achternaam. Als klanten een sorteerbare achternaam opgeven, gebruikt Brightspace® de sorteerbare achternaam bij het alfabetisch sorteren van gebruikerslijsten. Sorteerbare achternaam is beschikbaar in D2L® Standaard CSV versie 2.1 of hoger. |
Regels voor records van het type Inschrijving
Door het verwerken van records van het inschrijvingstype worden gebruikers in een specifieke organisatie-eenheid in Brightspace® in- of uitgeschreven. 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. Het opnieuw verzenden van dezelfde waarschuwingen voor uitschrijvingsrecords in uw IPSIS-logboek.
D2L® Standaard CSV kan het volgende:
- Hiermee kunt u gebruikers in- en uitschrijven voor organisatie-eenheden (versie 2.0 of hoger) of alleen cursussecties (versie 1.0 en 1.1).
Regels voor kenmerken van Beheerdersdashboard en Cursusgroepen
Met behulp van D2L® Standaard CSV en Beheerdersdashboard en Cursusgroepen kunt u:
- Bepalen welke rapportagestructuur wordt gebruikt in het Beheerdersdashboard
- Kenmerken toekennen om het maken van automatische lidmaatschapsregels mogelijk te maken in Cursusgroepen
Kenmerken van het Beheerdersdashboard en Cursusgroepen via D2L® Standaard CSV zullen niet:
- Nieuwe gebruikersaccounts maken.