In dit onderwerp worden de conventies en vereisten voor D2L® Standaard CSV-bestandsindelingen uitgelegd.
Geaccepteerde indelingen voor D2L® Standaard CSV-bestanden
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)
Zip-archiefindeling voor D2L® Standaard CSV-bestanden
CSV-bestanden moeten in een zip-archief worden gecombineerd. De aanbevolen naamgevingsconventie voor een zip-archief is:
- D2LStdCSV-{JJJJmmddHHMMSS}.zip
|
Opmerking: U kunt alleen .zip-archieven (hoofdlettergevoelig, alleen kleine letters) uploaden naar SFTP. |
Bestanden worden in alfabetische volgorde verwerkt. D2L® raadt aan om individuele bestanden in het archief als volgt te ordenen:
- orgs (organisatie-eenheden)
- users (gebruikers)
- enrollments (inschrijvingen)
- attributes (kenmerken)
Aanbevolen naamgevingsconventies voor D2L® Standaard CSV-bestanden
De aanbevolen naamgevingsconventie voor individuele bestanden in een .zip-archief is:
- 01 - Overige - {YYYYmmddHHMMSS}.csv
- 02 - Afdelingen- {YYYYmmddHHMMSS}.csv
- 03 - Semesters - {YYYYmmddHHMMSS}.csv
- 04 - Sjablonen - {YYYYmmddHHMMSS}.csv
- 05 - Edities - {YYYYmmddHHMMSS}.csv
- 06 - Secties - {YYYYmmddHHMMSS}.csv
- 07 - Gebruikers - {YYYYmmddHHMMSS}.csv
- 08 - Inschrijvingen - {YYYYmmddHHMMSS}.csv
- 09 - Kenmerken - {YYYYmmddHHMMSS}.csv
- manifest.json
|
Opmerking: Het CSV-bestand 01 - Overige wordt gebruikt om aangepaste organisatie-eenheden buiten de standaard D2L®-organisatiestructuur te verwerken en vereist D2L® Standaard CSV versie 2.0 of hoger. |
Algemene regels voor inhoud van CSV-bestanden
- Waarden in bestanden zijn hoofdlettergevoelig.
- Een lege waarde wordt weergegeven met twee komma's zonder spaties ertussen. Bijvoorbeeld:
- ,, geeft een lege waarde aan
- , , geeft een spatie aan, die als ongeldige waarde wordt geparseerd.
-
De CSV-bestanden moeten een koptekst (eerste regel) hebben die exact overeenkomen (hoofdlettergebruik en komma's).
- 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 voor UPDATE of DELETE gebruikt.
- 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 burgerservicenummers, op te nemen in door de organisatie gedefinieerde id's voor gebruikers.
Regels voor organisatie-eenheden
De onderstaande typen organisatie-eenheden worden door D2L® Standaard CSV ondersteund:
- 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
Door deze organisatie-eenheden te verwerken wordt de organisatiestructuur in uw versie van Brightspace® gemaakt.
Regels:
- Brightspace® kan net zoveel organisatie-eenheden accepteren als nodig is.
- Organisaties 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.
- 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 naamgevingsconventie voor de naam en code van organisatie-eenheden moet de conventie volgen die in uw SIS is beschreven.
- Namen en codes van de organisatie-eenheden kunnen zoals in de CSV-bestanden worden aangeleverd als de namen en codes voldoen aan de vereisten voor geldige 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.
- Codes van organisatie-eenheden ondersteunen de volgende tekens niet: , : % & # * ? < > | \ " ' en begin- of volgspaties.
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 gebruikers
Gebruikersrecords kunnen gebruikers maken, bijwerken, inactief maken of verwijderen in Brightspace®. Het gebruikerstype kan ook de relatie tussen ouder en kind in Brightspace® maken, bijwerken of verwijderen.
Regels
- 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.
- De voornaam en achternaam ondersteunen de volgende tekens niet: \ / : * ? " < > | @ , ;
- Gebruikersnaam en Door organisatie gedefinieerde id ondersteunen de volgende tekens niet: / : * ? " < > | ' , ;
- E-mailadres ondersteunt de volgende tekens niet: ( ) < > [ ] | \ ; : , “
D2L® Standaard CSV kan het volgende:
- Een nieuwe gebruiker maken en inschrijven in 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 kan 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 inschrijvingen
Door het verwerken van inschrijvingsrecords worden gebruikers in een specifieke organisatie-eenheid in Brightspace® in- of uitgeschreven.
Regels:
Inschrijvingsrecords moeten worden verzonden wanneer er wijzigingen in het informatiesysteem zijn aangebracht.
- Een uitschrijving kan maar één keer worden verzonden. Het opnieuw verzenden van dezelfde uitschrijvingsrecord leidt tot een waarschuwing in uw IPSIS-logboek.
- Wanneer u secties in cursusedities gebruikt, mag u alleen inschrijvingsrecords bieden voor secties. Dit impliceert inschrijving in de cursuseditie en dit wordt verwerkt door IPSIS.
- Als u wel inschrijvingsrecords voor zowel cursusedities als -secties verzendt, maar alleen uitschrijvingen voor secties, kan dit ertoe leiden dat gebruikers onjuist opnieuw worden ingeschreven in cursusedities tijdens het samenvoegen van cursussen.
D2L® Standaard CSV kan het volgende:
- Gebruikers in- en uitschrijven voor organisatie-eenheden (versie 2.0 of hoger), cursusedities en secties.
- Gebruikers in- en uitschrijven van 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.
- 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.