SIS-data kan uploades via linket SIS-import i kontoindstillinger. SIS-data er kun tilgængelige på kontoniveau og kan ikke føjes til underkonti.
SIS-importsiden understøtter et par formater til standardimport til Canvas Career: Instructure-formateret CSV-fil eller en zip-fil med CSV-filer, IMS Enterprise Specification XML zip eller Banner Grade Exchange Results XML. Filer kan indstilles til en fuld batchopdatering og til at tilsidesætte ændringer i brugergrænsefladen.
Sørg for at du er opmærksom på de risici, der er forbundet med disse uploadmuligheder. For flere oplysninger om disse risici, se venligst lektionen om SIS-import .
API-behandling
SIS-importer føjes til en kø, der behandler hver importeret CSV-fil separat (uanset om den uploades individuelt eller i en ZIP-fil). Importfejl vises på SIS-importsiden.
API-praksis
Før du importerer SIS-oplysninger, bør du øve dig i at bruge API'en til at administrere SIS-data. Du bør også bruge dit testmiljø for at undgå konflikter med dine live produktionsdata. Når du har bekræftet dine data i dit testmiljø, kan du genanvende din SIS-integration til dit produktionsmiljø. Derudover er nogle SIS-datamuligheder kun tilgængelige via API'en.
Noter:
- SIS-import skal aktiveres af din Customer Success Manager, før filer kan uploades til din konto.
- Import af SIS-filer er en kontotilladelse. Hvis du ikke har adgang til at administrere SIS-filer, har din institution begrænset denne funktion.
- Før du angiver tilladelser for en brugerrolle, skal du sikre dig, at den rolle, du vil tildele brugeren, allerede findes på din konto.
Tip til fejlfinding: Visse felter bliver "klæbende", når oplysninger ændres direkte af en bruger eller administrator. Klæbende felter forhindrer automatiske ændringer via en SIS-import. Hvis der ikke sker ændringer efter import af SIS-data, kan brugerne have foretaget ændringer via brugergrænsefladen (UI). Du kan tilsidesætte ændringer ved hjælp af indstillingen Tilsidesæt ændringer i brugergrænsefladen .
Hvis du bruger et automatiseret system til at importere data fra et SIS, kan du begrænse brugernes mulighed for at redigere deres navn direkte i Canvas Career. For at forhindre brugere i at ændre deres egne navne skal du fravælge indstillingen Brugere kan redigere deres navn i kontoindstillingerne .
Du kan se en komplet liste over felter, der kan blive fastlåste, på SIS Import API-siden .
Åbn SIS-import
I Global Navigation skal du klikke på linket Admin [1] og derefter klikke på linket SIS Import [2].
Vælg fil
Klik på knappen Vælg en fil, der skal importeres , og find SIS-importfilen på din computer.
Indstil fuld batchopdatering
Hvis du vil oprette en fuld batchopdatering, skal du markere afkrydsningsfeltet Dette er en fuld batchopdatering [1]. En advarsel informerer brugerne om de risici, der er forbundet med at markere afkrydsningsfeltet Dette er en fuld batchopdatering . I rullemenuen Term [2] skal du skrive det term, du vil søge efter, og derefter vælge det for at anvende den fulde batchopdatering. Med denne mulighed kan alle kurser, sektioner eller tilmeldinger med en SIS ID-post i Canvas Career, der er linket til det Term, der er valgt i rullemenuen, slettes. For tilmeldinger betyder denne mulighed, at den linkede bruger og kurset/sektionerne kræver SIS ID'er. En Canvas Career-post vil blive slettet, hvis den ikke er inkluderet i den aktuelle importfil.
Denne indstilling påvirker kun data, der er oprettet via tidligere SIS-importer. Manuelt oprettede kurser slettes f.eks. ikke, selvom de ikke vises i den nye SIS-import.
Noter:
- Sørg for at du er opmærksom på de tilknyttede risici, før du vælger denne mulighed.
- Når du importerer sektions-CSV'er ved hjælp af SIS Imports, bevares eksisterende integration_id- værdier nu, hvis integration_id- kolonnen ikke er inkluderet i importfilen. For at fjerne et integration_id skal det eksplicit fjernes ved hjælp af
change_sis_id.csv -filen.
Tilsidesæt ændringer i brugergrænsefladen
Hvis du vil tilsidesætte ændringer i brugergrænsefladen (UI), skal du markere afkrydsningsfeltet Tilsidesæt ændringer i brugergrænsefladen . Denne ændring fortæller Canvas Career, at alle "fastlåste" data, der er ændret af brugerne i deres konti, skal overskrives med de data, du importerer.
- Hvis denne boks IKKE er markeret, når du importerer en ny bruger, vil ingen navneændringer blive tilsidesat i brugergrænsefladen, men hvis brugeren har fjernet sin angivne e-mailadresse, vil den blive tilføjet igen, men ikke markeret som standard.
- Hvis denne boks ER markeret, når du importerer en ny bruger, ændres det fulde navn og det sorterbare navn, men det viste navn ændres ikke. E-mailadressen tilføjes, men er stadig ikke markeret som standard.
Vælg brugergrænsefladeindstilling
Tilsidesættelse af ændringer i brugergrænsefladen giver også mulighed for en af to yderligere muligheder: behandl som ændringer i brugergrænsefladen eller ryd tilstanden for ændret brugergrænseflade. Du kan kun vælge én mulighed.
Hvis du vil vælge en af mulighederne, skal du markere afkrydsningsfeltet ud for din præference:
- Behandles som ændringer i brugergrænsefladen [1]: tilsidesætter ændringer, der har fundet sted i brugergrænsefladen, som "fastlåste" data; alle data fungerer, som om ændringerne faktisk blev opdateret manuelt i brugergrænsefladen.
- Ryd UI-ændret tilstand [2] : fjerner "klæbningen" af alle data, der findes i denne import; fremtidige importer med disse data vil ikke angive nogen data i brugergrænsefladen som "klæbende"
Procesdata
Klik på knappen Behandl data .
Bekræft ændringer
Efter at have klikket på knappen Behandl data, vises en bekræftelsesmodal. Klik på Annuller [1] for at stoppe eller Bekræft [2] for at fortsætte.
Vis importdata
Efter importprocesserne viser Canvas Career resultaterne af den importerede fil sammen med op til 50 fejl og advarsler. Hvis du importerede en fuld batchopdatering, viser resultaterne også antallet af slettede elementer, der er fjernet fra kontoen. Slettede elementer omfatter tilmeldinger, kurser og sektioner.
Når du har opdateret siden, forbliver disse oplysninger på SIS-importsiden under overskriften Sidste batch, indtil der foretages en ny import.
Downloadfejl
Hvis du vil downloade alle advarsler og fejl fra din seneste importfil, skal du vende tilbage til SIS-importsiden. Klik på ikonet Download af seneste batch [2] under overskriften Sidste batch [1]. En CSV-fil downloades og indeholder alle fejl og advarsler fra din seneste import.
Bemærk :
- Du skal muligvis opdatere siden for at se downloadikonet.
- Hvis rapporten downloades, udløber linket efter en time. Hvis siden opdateres, genereres en ny URL, som er aktiv i en time.
Gennemgå fejl
Hvis du opdager, at en fil har fejlet, skal du gennemgå eventuelle fejlmeddelelser, der er tilgængelige for dig. Bemærk følgende, når du gennemgår fejl:
- Du kan opleve, at selve filen havde en fejlmeddelelse, eller at bestemte linjer i filen fejlede.
- Du kan bruge SIS Import Errors API'en til yderligere fejlfindingsoplysninger, som returnerer CSV-linjenummeret, hvor fejlen opstod.
- CSV-filen kræver specifik formatering for at blive uploadet korrekt. Gennemgå især CSV-headerne. Få mere at vide om formatering af CSV-filer.
- SIS Import CSV-filer skal kodes i UTF-8 uden byteordenstegn. De fleste applikationer koder automatisk til UTF-8, selvom nogle programmer, f.eks. Microsoft Excel, vil skifte til en alternativ kodning. Hvis din software er i stand til at kode filer ud af UTF-8, skal du vælge UTF-8 som en indstilling, når du gemmer.
- Visse fejlmeddelelser kræver, at du kontakter support for at få dem gennemgået.
