I Canvas kan du skapa flera användare, konton, terminer, kurser, sektioner, registreringar och inloggningar på en gång via administrationsgränssnittet.
Detta dokument hänvisar till SIS Import CSV Format API sidan, där majoriteten av CSV-informationen är belägen. Alla CSV-filer är symbiotiska med varandra och berättar för Canvas hur all information för kontot ska hanteras. Visa SIS-förhållande-diagrammet.
Varje steg i den här lektionen ger exempel på CSV filer med beskrivningar av alla obligatoriska och frivilliga fält. Ni finner även länkar för att ladda ner varje fil, om ni vill lära er mer på djupet om formatering. Ladda ner ett nedladdningsbart zip paket av provfiler. Om det inte går att ladda ned CSV-länkar, försök öppna länken i en ny flik.
Du bör öva att importera data i din Canvas testmiljö innan du importerar något innehåll till din produktionsmiljö.
CSV filformat
För att ladda upp massdata till Canvas, behöver du skapa en eller flera CSV textfiler. CSV filer kan genereras av många program. Studentinformationssystemen (SIS) har ofta en metod för att generera rapporter i CSV format som kan modifieras för att passa det format som Canvas kräver. Om du inte vet hur man sparar en fil i CSV-format, se instruktionerna för det program du använder för att skapa din CSV-fil (t.ex. Excel).
När du använder instruktionsformatet för import av filer i SIS Importsidan, kan du importera en enskild CSV-textfil, eller så kan du komprimera flera filer till en enda ZIP-fil för att importera massdata. Om du laddar upp individuella filer manuellt, måste filerna laddas upp i den ordning som visas i den här lektionen.
CSV fältformatering
Den första raden i din CSV fil (rubriken) måste innehålla det fullständiga fältnamnet för varje fil. Kolumnernas ordningsföljd spelar ingen roll, men att ha raderna ordnade ordentligt är avgörande för filer som accounts.csv.
Klibbiga fält
Som standard skrivs vissa ändringar i användargränssnittet inte över av framtida SIS-import och anges som klibbiga. Alla klibbiga fält identifieras i detta dokument. Du kan åsidosätta dessa fält genom att ställa in override_sis_stickiness i API:n eller markera kryssrutan Skriv över UI ändringar i rutan för SIS-importsidan.
API Dokumentation
CSV-filer innehåller endast en viss uppsättning fält. Canvas innehåller ytterligare värden som finns tillgängliga via varje enskild API. Efter att ha kört CSV-filerna för din institution, är praxis för en majoritet av institutioner att ladda upp alla SIS CSV-filer och sedan använda Canvas API för att uppdatera hela kontot och kursattribut. För mer information, se Canvas API-dokumentationen för Användare, Konton, Villkor, Kurser, Sektioner, Inskrivningar och grupper. SIS Import kan också hanteras med hjälp av SIS Imports API.
Användarna (users) är de människor som har användarkonton inom en institution. En users.csv fil lägger ni helt enkelt till personer i systemet som generella användare. Filen enrollments.csv (inskrivningar) kommer att tilldela en roll (lärare, student, etc.) till dessa användare. När ett användarkonto är raderat kommer alla deras inskrivningar också att raderas och de kommer inte att kunna logga in till sina Canvas konton. Om ni fortfarande vill att användaren ska kunna logga in men inte delta eller om ni endast vill radera dem ifrån en specifik kurs, då ska ni lämna deras användarkonto som aktivt och ändra deras inskrivning (i enrollments.csv) till färdig eller raderad.
Ladda ner en prov-users.csv-fil med 10 Canvas användarkonton.
Obligatoriskt fält* | Klibbigt fält^
Canvas identifierar användare med e-postadressen. När eleverna läggs till på en kurs, försöker Canvas lösa e-postadresskonflikter när användaren loggar in till kursen för första gången.
Normalt är e-postadresserna unika för varje elev. Ibland kan flera elever dela en enda e-postadress. När du lägger till elever till kurser via SIS import, känner Canvas av när en e-postadress tilldelas mer än en student.
Ett konto är en organisationsenhet inom Canvas (t.ex. det överordnade kontot för en institution). Varje konto kan innehålla en hierarki av underkonton, som att skapa konton för enskilda skolor inom en institution, eller för enskilda skolor inom ett distrikt. Underkonton kan också innehålla flera underkonton, till exempel när en skola är indelad i avdelningar eller program, eller en skola som kan delas upp i årskurser eller ämnen.
Hämta en prov-accounts.csv-fil med följande underkonton:
Obligatoriskt fält* | Klibbigt fält^
Ett villkor ger en standarduppsättning med start- och slutdatum för kurser som tilldelas denna termin. Termindatum för kurser kan hanteras manuellt på kursnivå utan att använda en importfil. Genom att anknyta ett termins_id till många olika kurser kan man dock försäkra sig om att alla kurser i den terminen börjar och slutar vid samma tidpunkt. Uppladdade terminsdatum kommer även att hjälpa er sortera och organisera kurser när ni granskar data och rapporter i Adninistrationsgränssnittet.
Hämta en sample terms.csv-fil med 10 termer.
Obligatoriskt fält* | Klibbiga fält^
En kurs är en organiserad presentation av ett visst ämne. Ibland kan en kurs omfatta en rad kurser. Kurserna är placerade inom terminer för att skapa standard-start- och slutdatum. Men om en kurs innehåller specifika kursdatum kommer dessa datum att kringgå studenttillgång till datumen på terminen som identifieras av terminens term_id (om detta är inkluderat.) Värdet av att fästa ett term_id är att ni kommer att kunna sortera och organisera kurser när ni granskar data och rapporter i Administrationsgränssnittet. Ett term_id kan enkelt fästas till många olika kurser som börjar/slutar på samma gång. Om ni inte fäster en kurs till en termin kommer kursen att fästas till terminen som heter Standardtermin.
Om din institution har aktiverat Blueprint-kurser kan du använda en courses.csv för att lägga till tillhörande kurser till en planeringskurs. Observera att planritningen måste skapas och aktiveras som en planskrift innan tillhörande kurser kan läggas till.
Ladda ner en prov-courses.csv-fil med 10 kurser; de finns inom sina respektive underkonton inom en viss period.
Obligatoriskt fält* | Klibbiga fält^
En sektion delar upp eleverna inom en kurs. Flera sektioner kan också vara korslistade i en kurs, särskilt om alla studentsektioner lär sig samma kursmaterial. Flera sektioner kan placeras i en kurs, men en sektion kan inte innehålla flera sektioner. Sektioner ärver kursdatumen som anges med terminen. Men om en sektion inkluderar specifika datum, kommer dessa datum åsidosätta datumen för elevåtkomst för kursen och terminens start- och/eller slutdatum.
Om ni försöker radera en kurs och användarna är anslutna till sektioner kommer ni att behöva inkludera parametern för section_id i er CSV import liksom sektionen SIS IDs.
Hämta en sample sections.csv-fil med följande avsnitt:
Denna fil utgår ifrån att ni har flera sektioner inom en kurs. Många institutioner importerar kurs sektioner som separata kurser. Detta kan göras genom att (1) skapa en Canvas kurs för varje sektion i dina courses.csv, sedan (2) skapa en enstaka kurs för var och en av dessa kurser. Ni kan i princip använda samma data för kursen och sektionen inklusive SIS _ID som kommer att vara samma för både course_id och section_id.
Obligatoriskt fält* | Klibbiga fält^
En inskrivning är en användare som har registrerats i en kurs under en särskild roll. En CSV-fil med inskrivningar låter dig tilldela roller till användare och placera dem i lämpliga kurser. När en användares inskrivningsstatus är markerad som färdig kommer de att vara begränsade till skrivskyddad tillgång för den kursen.
Hämta en sample enrollments.csv-fil med följande registreringar:
Obligatoriskt fält*
Gruppkategorier gör det möjligt att organisera grupper i Canvas. En group_categories.csv låter dig skapa gruppkategorier på konto eller kursnivå. I användargränssnittet kallas gruppkategorier grupp-uppsättningar.
Hämta ett exempel group_categories.csv fil med följande gruppkategorier:
Obligatoriskt fält* | Klibbiga fält^
En grupp kan användas för att erbjuda samarbetsmöjligheter för studenter, lärare, administratörer eller andra användare. En groups.csv låter dig skapa grupper på kursnivå och kontonivå. Grupper som laddats upp via SIS kan endast uppdateras eller tas bort med SIS.
Hämta en groups.csv exempelfil med följande grupper:
Obligatoriskt fält* | Klibbiga fält^
Medlemskap i en grupp låter användaren samarbeta med aktiviteter i Canvas. Ett groups_membership.csv tillåter dig att lägga till eller ta bort personer till en grupp du har skapat via groups.csv.
Hämta en sample groups_membership.csv fil med följande gruppmedlemskap:
Obligatoriskt fält*
Korslistning låter dig flytta sektioner till en annan Canvas-kurs. En xlists.csv fil låter dig korslista sektioner till existerande kurser och skapa en sektionshierarki.
Sektions-id:n förväntas att redan finnas och refererar redan til andra kurs-id:n. Om ett sektions-id anges i den här filen kommer den att tas bort från dess existerande kurs-id, så att om en ny kurs tas bort eller korslistan tas bort, kommer sektionen att återgå till dess tidigare kurs-id. Om xlist_course_id inte refererar till en existerande kurs kommer den att skapas. Om du vill fylla i mer information om den korslistade kursen kan du göra det i courses.csv.
Ladda ner en xlistor.csv exempelfil med följande kurser och sektioner:
Obligatoriskt fält*
Observatörens roll kan användas för att skriva in föräldrar och länka dem till en student, vilket låter dem se deras students betyg och kursinteraktioner. En user_observers.csv tillåter dig att registrera och länka observatörer till var och en av de utsedda studenternas registreringar.
Hämta ett sample user_observers.csv fil med följande registreringar:
Obligatoriskt fält*
Med hjälp av filen logins.csv kan du skapa eller uppdatera inloggningsuppgifter för användare. Inloggningar kan endast läggas till för befintliga användare. Inloggningar kan tas bort med vilen users.csv.
Ladda ned en logins.csv-exempelfil med inloggningar för tre användare.
Obligatoriskt fält* | Klibbigt fält^
Anteckningar:
Admins hanterar inställningar för ett helt konto eller för ett underkonto. Ett admins.csv låter dig göra användare i Canvas till kontoadministratörer eller andra anpassade konton eller underkonto roller.
Ladda ner ett prov på admins.csv-fil med följande administratörer:
Obligatoriskt fält*
Ett SIS-ID är en unik identifierare för ett föremål i Canvas. Ett change_sis_id.csv tillåter dig att ändra bulk SIS-ID för befintliga konton, villkor, kurser, avsnitt, grupper eller användare
Ladda en prov på change_sis_id.csv-fil med följande SIS-ID-ändringar:
Obligatoriskt fält*