Gebruik dit onderwerp voor inzicht in de conventies en vereisten voor D2L® Standaard CSV-bestandsindelingen.
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)
D2L® Standaard CSV-voorbeeldbestanden
CSV-voorbeeldbestanden kunnen worden gedownload in de IPSIS Learning Center-cursus. Deze cursus biedt up-to-date voorbeelden en richtlijnen om aan de slag te gaan met D2L® Standaard CSV.
We raden u aan naar de cursus te gaan voor toegang tot de nieuwste voorbeeldbestanden en gerelateerde bronnen.
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 Secure File Transfer Protocol (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 overeenkomt (hoofdlettergebruik en komma's).
- CSV-bestanden moeten UTF-8-gecodeerd zijn.
- CSV-bestanden moeten differentiële SIS-gegevens (studentinformatiesysteem, 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. Doorgaan worden alleen de acties BIJWERKEN en VERWIJDEREN 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 waarin de gebruikte versie van D2L® Standaard CSV wordt geïdentificeerd. Voor meer informatie raadpleegt u het onderwerp Manifest.
- 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; ondersteund in 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. Nadat de integratie een organisatie-eenheid bepaalt, moeten alle toekomstige wijzigingen via de integratie worden gemaakt.
- Als u veel typen organisatie-eenheden in één CSV-bestand verstuurt, moet u ervoor zorgen dat de hiërarchie wordt nageleefd (stuur bijvoorbeeld eerst afdelingen en dan pas cursussjablonen).
- Als u gebruikersrelaties verstuurt, moet u ervoor zorgen dat de hiërarchie wordt nageleefd (stuur bijvoorbeeld eerst naar ouders of voogden en dan pas naar cursisten).
- De naamgevingsconventie voor de naam en code van organisatie-eenheden moet de conventie volgen die in uw SIS is beschreven.
- Namen en codes van organisatie-eenheden kunnen 'as-is' worden gebruikt als ze aan de Brightspace®-vereisten voor tekens voldoen en uniek zijn.
- Codes van organisatie-eenheden mogen maximaal 50 tekens bevatten. Langere waarden worden afgekapt en kunnen duplicatie of fouten veroorzaken.
- Codes van organisatie-eenheden ondersteunen de volgende tekens niet: , : % & # * ? < > | \ ' ' of begin- of volgspaties.
D2L® Standaard CSV kan het volgende doen:
- Maak een nieuwe organisatie-eenheid als deze niet bestaat.
- Toewijzen aan een bestaande organisatie-eenheid als toewijzing is ingeschakeld in de configuratie.
- De naam bijwerken van een organisatie-eenheid die wordt beheerd.
- Bovenliggende relaties tussen organisatie-eenheden toewijzen en verwijderen.
- Bovenliggende afdelingen voor cursussjablonen toewijzen en bijwerken.
- Bovenliggende cursussjablonen en semesters voor cursusedities toewijzen en bijwerken.
- Informatie van een cursuseditie bijwerken, inclusief naam, datums en inactieve edities.
- Cursussecties verwijderen en gebruikers automatisch uitschrijven.
- 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.
- Een organisatie-eenheid verwijderen waaraan onderliggende eenheden zijn gekoppeld.
Regels voor gebruikers
Gebruikersrecords kunnen gebruikers maken, bijwerken, inactief maken of verwijderen in Brightspace® en relaties beheren.
Regels:
- Gebruikers moeten minstens één keer worden gestuurd om beheer door de integratie tot stand te brengen.
- De voornaam en achternaam ondersteunen de volgende tekens niet: \ / : * ? " < > | @ , ;
- Gebruikersnaam en Door organisatie gedefinieerde id ondersteunen de volgende tekens niet: / : * ? " < > | ' , ;
- E-mailadressen bieden geen ondersteuning voor de volgende tekens : ( ) < > [ ] | \ ; : , '
D2L® Standaard CSV kan het volgende:
- Gebruikers maken en inschrijven.
- Gebruikers toewijzen aan bestaande accounts.
- Gebruikersdetails bijwerken.
- Voorkeursnamen en sorteerbare namen bijwerken (hangt af van versie).
- Voornaamwoorden bijwerken (versie 3.0 of hoger).
- Gebruikers activeren, inactief maken of verwijderen.
- Ouder- of voogdrelaties beheren.
- Auditorrelaties bijwerken.
D2L® Standaard CSV kan niet:
- Door de organisatie gedefinieerde id bijwerken via CSV.
- Handmatig gemaakte gebruikers verwijderen, tenzij ze zijn toegewezen.
Regels voor inschrijvingen
Door het verwerken van inschrijvingsrecords worden gebruikers in organisatie-eenheden in- of uitgeschreven.
Regels:
- Stuur inschrijvingsrecords wanneer er wijzigingen zijn aangebracht in het bronsysteem.
- Stuur een uitschrijving niet vaker dan één keer.
- Wanneer u secties gebruikt, mag u alleen inschrijvingsrecords bieden voor secties.
- Stuur geen verschillende rollen voor secties in dezelfde editie.
- Klanten moeten niet verschillende rollen sturen voor secties in dezelfde editie. Dit leidt ertoe dat de rol in de cursuseditie en in een van de secties wordt overschreven, aangezien het LMS niet toestaat dat de sectierol afwijkt van de cursuseditie.
D2L® Standaard CSV kan het volgende:
- Gebruikers in- en uitschrijven voor organisatie-eenheden en secties.
Regels voor kenmerken van Beheerdersdashboard en Cursusgroepen
Met behulp van D2L® Standaard CSV en Beheerdersdashboard en Cursusgroepen kunt u:
- Rapportstructuren tot stand brengen.
- Automatische lidmaatschapsregels voor cursusgroepen inschakelen.
Kenmerken van het Beheerdersdashboard en Cursusgroepen via D2L® Standaard CSV zullen niet:
- Nieuwe gebruikersaccounts maken.