SIS-gegevens kunnen worden geüpload via de link 'SIS-import' in de accountinstellingen. SIS-gegevens zijn alleen toegankelijk op accountniveau en kunnen niet worden toegevoegd aan subaccounts.
De SIS-importpagina ondersteunt een aantal formaten voor standaardimporten naar Canvas Career: een CSV-bestand in Instructure-formaat of een zipbestand met CSV-bestanden, een IMS Enterprise Specification XML-zipbestand of een Banner Grade Exchange Results XML-bestand. Bestanden kunnen worden ingesteld voor een volledige batchupdate en om wijzigingen in de gebruikersinterface te overschrijven.
Zorg ervoor dat u op de hoogte bent van de risico's die verbonden zijn aan deze uploadopties. Voor meer informatie over deze risico's kunt u de les over SIS-import raadplegen.
API-verwerking
SIS-importen worden toegevoegd aan een wachtrij die elk geïmporteerd CSV-bestand afzonderlijk verwerkt (ongeacht of ze individueel of in een ZIP-bestand zijn geüpload). Importfouten worden weergegeven op de SIS-importpagina.
API-praktijk
Voordat u SIS-informatie importeert, oefent u met het gebruik van de API om SIS-gegevens te beheren. Gebruik uw testomgeving ook om conflicten met uw productieomgeving te voorkomen. Zodra u uw gegevens in de testomgeving hebt gecontroleerd, kunt u de SIS-integratie opnieuw toepassen op uw productieomgeving. Daarnaast zijn sommige SIS-gegevensopties alleen beschikbaar via de API.
Opmerkingen:
- SIS-import moet door uw Customer Success Manager zijn ingeschakeld voordat bestanden naar uw account kunnen worden geüpload.
- Het importeren van SIS-bestanden is een accountmachtiging. Als u geen toegang hebt tot het beheren van SIS-bestanden, heeft uw instelling deze functie beperkt.
- Voordat u machtigingen voor een gebruikersrol instelt, moet u ervoor zorgen dat de rol die u aan de gebruiker wilt toewijzen al in uw account bestaat.
Tip voor probleemoplossing: bepaalde velden worden 'vastgezet' wanneer informatie rechtstreeks door een gebruiker of beheerder wordt gewijzigd. Vastzetting voorkomt automatische wijzigingen via een SIS-import. Als er na het importeren van SIS-gegevens geen wijzigingen worden doorgevoerd, hebben gebruikers mogelijk wijzigingen aangebracht via de gebruikersinterface (UI). U kunt wijzigingen overschrijven met de optie 'UI-wijzigingen overschrijven' .
Als u een geautomatiseerd systeem gebruikt om gegevens uit een SIS te importeren, wilt u mogelijk voorkomen dat gebruikers hun naam rechtstreeks in Canvas Career kunnen wijzigen. Om te voorkomen dat gebruikers hun eigen naam aanpassen, schakelt u de optie ' Gebruikers kunnen hun naam bewerken' uit in de accountinstellingen .
Een volledige lijst met velden die mogelijk vast komen te zitten, vindt u op de SIS Import API-pagina .
Open SIS Import
Klik in de globale navigatie op de link Admin [1] en vervolgens op de link SIS Import [2].
Selecteer bestand
Klik op de knop ' Een bestand kiezen om te importeren' en selecteer het SIS-importbestand op uw computer.
Volledige batchupdate instellen
Als u een volledige batchupdate wilt maken, selecteert u het selectievakje 'Dit is een volledige batchupdate' [1]. Een waarschuwing informeert gebruikers over de risico's die verbonden zijn aan het selecteren van dit selectievakje. Typ in het vervolgkeuzemenu 'Term' [2] de term waarnaar u wilt zoeken en selecteer deze om de volledige batchupdate toe te passen. Met deze optie kunnen alle cursussen, secties of inschrijvingen met een SIS ID-record in Canvas Career die gekoppeld zijn aan de in het vervolgkeuzemenu geselecteerde term, worden verwijderd. Voor inschrijvingen betekent deze optie dat de gekoppelde gebruiker en cursus/secties een SIS ID nodig hebben. Een Canvas Career-record wordt verwijderd als het niet is opgenomen in het huidige importbestand.
Deze optie is alleen van toepassing op gegevens die zijn aangemaakt via eerdere SIS-importen. Handmatig aangemaakte cursussen worden bijvoorbeeld niet verwijderd, zelfs als ze niet in de nieuwe SIS-import voorkomen.
Opmerkingen:
- Zorg ervoor dat u op de hoogte bent van de bijbehorende risico's voordat u voor deze optie kiest.
- Bij het importeren van sectie-CSV's met SIS Imports worden bestaande integration_id- waarden behouden als de kolom integration_id niet in het importbestand is opgenomen. Om een integration_id te verwijderen, moet deze expliciet worden verwijderd met behulp van het bestand
change_sis_id.csv .
Gebruikersinterface-wijzigingen overschrijven
Als u wijzigingen in de gebruikersinterface (UI) wilt overschrijven, selecteert u het selectievakje 'UI-wijzigingen overschrijven '. Deze wijziging geeft Canvas Career de opdracht om alle door gebruikers in hun accounts gewijzigde 'permanente' gegevens te overschrijven met de gegevens die u importeert.
- Als dit vakje NIET is aangevinkt bij het importeren van nieuwe gebruikers, worden naamswijzigingen in de gebruikersinterface niet overschreven. Als de gebruiker echter zijn of haar opgegeven e-mailadres heeft verwijderd, wordt dit opnieuw toegevoegd, maar niet als standaard gemarkeerd.
- Als dit vakje is aangevinkt bij het importeren van nieuwe gebruikers, worden de volledige naam en de sorteerbare naam gewijzigd, maar de weergavenaam blijft ongewijzigd. Het e-mailadres wordt toegevoegd, maar blijft niet als standaard gemarkeerd.
Selecteer UI-optie
Het overschrijven van UI-wijzigingen biedt ook twee extra opties: verwerken als UI-wijzigingen of de status 'UI-gewijzigd' wissen. U kunt slechts één optie selecteren.
Als u een optie wilt selecteren, vink dan het selectievakje naast uw voorkeur aan:
- Verwerking als UI-wijzigingen [1]: overschrijft wijzigingen die in de UI hebben plaatsgevonden als "sticky" data; alle data gedraagt zich alsof de wijzigingen daadwerkelijk handmatig in de UI zijn bijgewerkt.
- Wis de UI-gewijzigde status [2] : verwijdert de "vasthoudendheid" van alle gegevens die in deze import aanwezig zijn; bij toekomstige importen met deze gegevens wordt in de gebruikersinterface geen enkele gegevens meer als "vasthoudend" weergegeven.
Procesgegevens
Klik op de knop 'Gegevens verwerken '.
Wijzigingen bevestigen
Nadat u op de knop 'Gegevens verwerken' hebt geklikt, verschijnt een bevestigingsvenster. Klik op 'Annuleren' [1] om te stoppen of op 'Bevestigen' [2] om verder te gaan.
Importgegevens bekijken
Na het importeren toont Canvas Career de resultaten van het geïmporteerde bestand, samen met maximaal 50 fouten en waarschuwingen. Als u een volledige batchupdate hebt geïmporteerd, worden ook de verwijderde items uit het account weergegeven. Verwijderde items omvatten inschrijvingen, cursussen en secties.
Nadat u de pagina hebt vernieuwd, blijft deze informatie op de SIS-importpagina onder de kop 'Laatste batch' staan totdat er een nieuwe import wordt uitgevoerd.
Downloadfouten
Als u alle waarschuwingen en fouten van uw laatste importbestand wilt downloaden, gaat u terug naar de SIS-importpagina. Klik onder de kop 'Laatste batch' [1] op het pictogram 'Laatste batch downloaden' [2]. Er wordt een CSV-bestand gedownload met alle fouten en waarschuwingen van uw laatste import.
Opmerking :
- Mogelijk moet u de pagina vernieuwen om het downloadpictogram te zien.
- Als het rapport wordt gedownload, verloopt de link na een uur. Als de pagina wordt vernieuwd, wordt een nieuwe URL gegenereerd die een uur geldig is.
Fouten controleren
Als u merkt dat een bestand niet werkt, bekijk dan de beschikbare foutmeldingen. Let bij het bekijken van de foutmeldingen op het volgende:
- Mogelijk blijkt dat het bestand zelf een foutmelding bevat, of dat bepaalde regels in het bestand niet werken.
- U kunt de SIS Import Errors API gebruiken voor aanvullende informatie over probleemoplossing. Deze API retourneert het CSV-regelnummer waar de fout is opgetreden.
- Het CSV-bestand vereist een specifieke opmaak om correct te kunnen worden geüpload. Controleer met name de CSV-headers. Lees meer over het formatteren van CSV-bestanden.
- SIS Import CSV-bestanden moeten gecodeerd zijn in UTF-8 zonder bytevolgordemarkering. De meeste toepassingen coderen automatisch naar UTF-8, hoewel sommige programma's, zoals Microsoft Excel, overschakelen naar een alternatieve codering. Als uw software bestanden kan coderen vanuit UTF-8, selecteer dan UTF-8 als optie bij het opslaan.
- Voor bepaalde foutmeldingen dient u contact op te nemen met de ondersteuning voor beoordeling.
