Canvas consente di importare file CSV per creare manualmente in blocco utenti, account, termini, corsi, sezioni, iscrizioni e accessi tramite l'interfaccia di amministrazione.
Questo documento fa riferimento alla pagina API SIS Import CSV Format , dove si trova la maggior parte delle informazioni CSV. Ogni file CSV interagisce con gli altri e indica a Canvas come gestire le informazioni per l'account. Visualizza il diagramma delle relazioni SIS .
File di esempio
Ogni passaggio di questa lezione fornisce dettagli sui file CSV e descrizioni di ciascun campo obbligatorio e facoltativo. Ogni passaggio include anche un link per scaricare un file CSV di esempio. I file di esempio contengono tutti i campi obbligatori e potrebbero contenere anche campi facoltativi. Inoltre, è possibile scaricare un pacchetto compresso di tutti i file di esempio . Se i link CSV non vengono scaricati, provare ad aprirli in una nuova scheda.
Dovresti esercitarti a importare dati nel tuo ambiente di test Canvas prima di importare qualsiasi contenuto nel tuo ambiente di produzione.
Formato file CSV
Per caricare dati in blocco su Canvas, è necessario creare uno o più file di testo CSV. I file CSV possono essere generati da molti programmi. I Sistemi Informativi Studenteschi (SIS) spesso dispongono di un metodo per generare report in formato CSV che può essere modificato per adattarsi al formato richiesto da Canvas. Se non sai come salvare un file in formato CSV, consulta la documentazione del programma che stai utilizzando per creare il file CSV (ad esempio Excel).
Quando si utilizza il formato Instructure per l'importazione di file nella pagina di importazione SIS , è possibile importare un singolo file di testo CSV oppure comprimere più file in un unico file ZIP per importare i dati in blocco. Se si caricano manualmente singoli file, è necessario caricarli nell'ordine mostrato in questa lezione.
Formattazione del campo CSV
La prima riga del file CSV (intestazione) deve includere il nome completo del campo per ciascun file. L'ordine delle colonne non è importante, ma disporre di righe ordinate correttamente è fondamentale per file come accounts.csv.
Campi appiccicosi
Per impostazione predefinita, alcune modifiche apportate all'interfaccia utente non vengono sovrascritte dalle future importazioni SIS e sono definite "sticky". Tutti i campi "sticky" sono identificati in questo documento. È possibile sovrascrivere questi campi impostando override_sis_stickiness nell'API o selezionando la casella di controllo "Ignora modifiche interfaccia utente" nella pagina "Importazione SIS" .
Documentazione API
I file CSV includono solo un set specifico di campi. Canvas contiene valori aggiuntivi disponibili tramite ciascuna API. Dopo aver eseguito i file CSV per il tuo istituto, la prassi standard per la maggior parte degli istituti è caricare tutti i file CSV SIS e quindi utilizzare l'API Canvas per aggiornare tutti gli attributi dell'account e del corso. Per ulteriori informazioni, consulta la documentazione dell'API Canvas per Utenti, Account, Termini, Corsi, Sezioni, Iscrizioni e Gruppi. Le importazioni SIS possono essere gestite anche tramite l' API Importazioni SIS .
Nota: la riga di intestazione nei file CSV definisce quali campi dati verranno elaborati da Canvas. Mentre le guide all'importazione SIS elencano tutti i campi supportati, il file CSV effettivo deve includere solo le colonne che si stanno aggiornando. Se un campo supportato manca nel file, è possibile aggiungere manualmente l'intestazione alla prima riga.
utenti.csv
Gli utenti sono le persone che dispongono di account utente all'interno di un istituto. Il file users.csv aggiunge gli utenti al sistema come utenti generici. Il file enrollments.csv assegnerà un ruolo (insegnante, studente, ecc.) a questi utenti. Quando un account utente viene eliminato, anche tutte le sue iscrizioni verranno eliminate e l'utente non potrà accedere al proprio account Canvas. Se si desidera che l'utente possa comunque accedere ma non partecipare, o se si desidera eliminarlo solo da un corso specifico, è necessario lasciare il suo account utente attivo e modificare la sua iscrizione (nel file enrollments.csv) rispettivamente in completata o eliminata .
Scarica un file users.csv di esempio con 10 account utente Canvas.
Campo obbligatorio*| Campo appiccicoso^
- ID utente*: Questo è un valore univoco utilizzato per identificare chiunque abbia un account Canvas. Questo valore non deve cambiare per l'utente e deve essere univoco per tutti gli utenti. Nell'interfaccia utente, questo è chiamato ID SIS e può essere composto da qualsiasi combinazione di caratteri. È possibile trovare questo ID SIS visitando qualsiasi account utente e visualizzando le relative informazioni di accesso.
- integration_id: identificatore univoco secondario utile per integrazioni SIS più complesse. Questo identificatore non deve cambiare per l'utente e deve essere univoco a livello globale.
- ID di accesso*^:
- Password: se l'account è configurato per utilizzare il protocollo LDAP o SSO, questa password non è obbligatoria. In caso contrario, questa è la password per il 'login_id' sopra indicato. Questa password deve essere lunga almeno 8 caratteri.
- ssha_password: invece di una password in testo normale, è possibile passare una password pre-hashed utilizzando lo schema di generazione password SSHA in questo campo. Sebbene sia preferibile passare una password in testo normale, è comunque consigliabile incoraggiare gli utenti a modificare la propria password dopo il primo accesso.
- authentication_provider_id: questo è il provider di autenticazione a cui è associato il login. I login associati a un provider specifico possono essere utilizzati solo con quel provider. I provider legacy (LDAP, CAS, SAML) cercheranno i login a loro associati o quelli non associati. I nuovi provider cercheranno solo i login a loro esplicitamente associati. Può essere l'ID intero del provider o il tipo di provider (in tal caso, troverà il primo provider corrispondente).
- first_name^: Questo è il nome (di battesimo) dell'utente. Se presente, viene utilizzato per costruire full_name e/o sortable_name.
- last_name^: questo è il cognome dell'utente. Se presente, viene utilizzato per costruire full_name e/o sortable_name.
- full_name^: indica sia il nome che il cognome dell'utente. Omettere first_name e last_name se forniti.
- sortable_name^ : questa è l'opzione del nome ordinabile in Canvas, solitamente dedotta dal nome dell'utente, ma può essere personalizzata.
- short_name^: questo è il nome visualizzato dell'utente, solitamente dedotto dal nome dell'utente, ma può essere personalizzato.
- Email: questo è l' indirizzo email assegnato dall'istituzione e sarà anche contrassegnato come indirizzo email predefinito per questo account utente. Questo indirizzo email deve essere comunque fornito anche se è lo stesso del login_id dell'utente.
- Pronomi^: se i pronomi personali sono abilitati, questi sono i pronomi personali visualizzati dopo il nome di un utente in Canvas. Il campo "Pronomi" accetta tutti i pronomi, anche se non sono stati creati nella pagina "Impostazioni account".
- declared_user_type: questo tipo di utente dichiarato può essere amministrativo, osservatore, personale, studente, studente_altro o insegnante. È possibile passare "<delete>" per rimuovere il tipo di utente dichiarato dall'utente.
- canvas_password_notification: il valore predefinito è "false". Se impostato su "true", l'utente riceve una notifica per la configurazione della password se l'authentication_provider_id è canvas. Se l'istituto non dispone di un'integrazione Canvas SIS, questo campo è obbligatorio per notificare ai nuovi utenti la creazione degli account.
- home_account: impostando home_account su true verrà creato un nuovo utente nell'account di destinazione per l'importazione SIS e verrà unito un altro utente esistente da un altro account all'interno del consorzio con un integration_id corrispondente. Verrà ignorato a meno che l'account di destinazione non sia associato a un consorzio con unione automatica.
- stato*^:Qui puoi aggiungere o rimuovere un utente da Canvas. Contrassegna come attivo per aggiungere un utente, sospeso per sospenderlo o eliminato per rimuoverne uno esistente.
Nota: i file CSV non devono necessariamente contenere tutti i campi possibili. Per garantire un'importazione corretta, il file deve includere tutte le intestazioni obbligatorie , ma le intestazioni facoltative (come integration_id o authentication_provider_id) devono essere incluse solo se si forniscono dati per quei campi specifici.
Conflitti di indirizzi email
Canvas identifica gli utenti tramite l'indirizzo email. Quando gli studenti vengono aggiunti a un corso, Canvas tenta di risolvere eventuali conflitti di indirizzo email quando l'utente accede per la prima volta al corso.
Normalmente, gli indirizzi email sono univoci per ogni studente. A volte, più studenti possono condividere un unico indirizzo email. Quando si aggiungono studenti ai corsi tramite importazione SIS, Canvas riconosce quando un indirizzo email è assegnato a più di uno studente.
- Se un nuovo ID SIS è associato a un indirizzo email già assegnato a un ID SIS esistente, Canvas invia un'email all'indirizzo email.
- Quando gli utenti vengono aggiunti a un account tramite importazione SIS, non riceveranno una notifica via email a meno che il sistema non rilevi un utente duplicato. Tuttavia, se un utente viene aggiunto o iscritto manualmente, riceverà un'email che lo informerà dell'aggiunta o dell'iscrizione a un nuovo corso. Lo studente che condivide un indirizzo email riceverà una notifica che l'indirizzo email è già in uso e verrà invitato a creare un nuovo account in Canvas. Questa procedura può essere applicata anche quando si aggiunge un utente all'iscrizione a un corso.
account.csv
Un account è un'unità organizzativa all'interno di Canvas (ad esempio, l'account principale di un istituto). Ogni account può contenere una gerarchia di sottoaccount, ad esempio la creazione di account per singoli college all'interno di un istituto o per singole scuole all'interno di un distretto. I sottoaccount possono anche contenere più sottoaccount, ad esempio quando un college si suddivide in dipartimenti o programmi, o una scuola si suddivide in livelli di istruzione o materie.
Scarica un file accounts.csv di esempio con i seguenti sottoconti:
- 3 sottoaccount all'interno del tuo account principale/root. (Arti e discipline umanistiche, Economia, Matematica e scienze)
- 4 sottoconti all'interno del tuo sottoconto aziendale. (Contabilità, Informatica, Economia e Marketing)
- 3 sottoconti all'interno del tuo sottoconto Matematica e Scienze. (Biologia, Fisica e Statistica)
- 1 sottoaccount all'interno del tuo sottoaccount Arti e discipline umanistiche. (Arti visive)
- 2 sottoaccount all'interno del tuo sottoaccount Arti visive. (Fotografia e Media digitali)
Campo obbligatorio*| Campo appiccicoso^
- ID account*:Si tratta di un identificatore univoco utilizzato per creare un sottoaccount. Il file courses.csv consente di assegnare i corsi a un ID account specifico. Questo identificatore univoco non deve cambiare per l'account e deve essere univoco a livello globale per tutti gli account. Nell'interfaccia utente di Canvas, questo è chiamato ID SIS e può essere modificato accedendo alle Impostazioni di ciascun sottoaccount.
- parent_account_id*^: Questo identificatore indica che un sottoconto deve essere annidato sotto questo account principale. Se questo campo è vuoto, il sottoconto verrà annidato sotto l'account principale o principale. Si noti che anche se tutti i valori sono vuoti, la colonna deve essere inclusa per differenziare il file da un'importazione di gruppo.
- nome*^ : Questo è il nome del sottoconto.
- stato*:Ecco come puoi creare o rimuovere un sottoaccount. Contrassegna come attivo per aggiungere un sottoaccount o elimina per rimuoverne uno esistente.
- integration_id: identificatore univoco secondario utile per integrazioni SIS più complesse. Questo identificatore non deve cambiare per l'account e deve essere univoco a livello globale.
termini.csv
Un semestre fornisce un set predefinito di date di inizio e fine per qualsiasi corso assegnato a quel semestre. Le date dei semestri dei corsi possono essere gestite manualmente a livello di corso senza un file di importazione. Tuttavia, associando un term_id a più corsi diversi si garantisce che tutti i corsi di quel semestre inizino/finiscano alla stessa ora. Le date dei semestri caricate ti aiuteranno anche a ordinare e organizzare i corsi quando visualizzi dati e report nell'interfaccia di amministrazione.
Scarica un file terms.csv di esempio con 10 termini.
Campo obbligatorio*| Campo appiccicoso^
- term_id*: Si tratta di un identificatore univoco per il termine. Il file courses.csv ti permetterà di fare riferimento a questo term_id in modo che i tuoi corsi sappiano quando iniziare e quando concludere. Questo identificatore non deve cambiare per il termine e deve essere univoco a livello globale per tutti i termini. Nell'interfaccia utente, questo è chiamato ID SIS.
- nome*^: Questo è il nome del termine. Definisci una buona convenzione di denominazione che ti aiuti a fare riferimento facilmente ai tuoi termini. Esistono molti strumenti di amministrazione che consentono di cercare o interrogare i dati in base al nome del termine.
- stato*: Ecco come puoi creare o rimuovere un termine. Contrassegna come attivo per aggiungere un termine o elimina per rimuoverne uno esistente.
- start_date^: Questa è la data di inizio del trimestre. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ (La T può essere sostituita da uno spazio, come mostrato nello screenshot di esempio). Ad esempio, 26 agosto 2013 alle 17:00 EST verrebbe scritto 2013-08-26T17:00-5:00
- end_date^: Questa è la data di fine del termine. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ (La T può essere sostituita da uno spazio, come mostrato nello screenshot di esempio). Per impostazione predefinita, l'accesso utente viene interrotto a mezzanotte della data di fine indicata, il che significa che il giorno precedente è l'ultimo giorno intero in cui gli utenti hanno accesso al termine. La procedura consigliata è impostare la data di fine al giorno successivo alla fine del termine.
- integration_id: identificatore univoco secondario utile per integrazioni SIS più complesse. Questo identificatore non deve cambiare per il termine e deve essere univoco a livello globale.
- date_override_enrollment_type: consente di impostare o rimuovere le date di inizio e fine per un tipo di iscrizione specifico all'interno di un semestre esistente. Quando impostato, tutte le colonne tranne term_id, status, start_date e end_date devono essere ignorate per la riga. Se lo stato è impostato su attivo, le date del semestre si applicheranno solo alle iscrizioni del tipo specificato. Se lo stato è impostato su eliminato, le date attualmente impostate verranno rimosse per il tipo di iscrizione specificato. Il tipo di iscrizione può essere impostato su StudentEnrollment, TeacherEnrollment, TaEnrollment o DesignerEnrollment.
corsi.csv
Un corso è una presentazione organizzata su un argomento specifico. A volte un corso può includere una serie di corsi. I corsi vengono inseriti all'interno di semestri per creare date di inizio e fine predefinite. Tuttavia, se un corso include date specifiche, queste sovrascriveranno le date di accesso degli studenti al semestro, identificate dal term_id (se incluso). Il vantaggio di associare un term_id è che sarà possibile ordinare e organizzare i corsi durante la visualizzazione di dati e report nell'interfaccia di amministrazione. Un term_id può essere facilmente associato a molti corsi diversi che iniziano/terminano contemporaneamente. Se non si collega un corso a un semestro, il corso verrà collegato al semestro denominato "Semestro predefinito".
Se il tuo istituto ha abilitato i corsi Blueprint, puoi utilizzare un file courses.csv per aggiungere corsi associati a un corso Blueprint. Tieni presente che il corso Blueprint deve essere creato e abilitato come tale prima di poter aggiungere corsi associati.
Scarica un file courses.csv di esempio con 10 corsi; risiedono nei rispettivi sottoaccount in un termine specifico.
Campo obbligatorio*| Campo appiccicoso^
- ID_corso*:Si tratta di un identificatore univoco utilizzato per differenziare i corsi all'interno di Canvas. Questo identificatore non deve cambiare per ogni corso e deve essere univoco a livello globale per tutti i corsi . Nell'interfaccia utente, questo è chiamato ID SIS.
- nome_abbreviato*^: Questo è il nome breve del corso. Nell'interfaccia utente di Canvas è anche chiamato Codice Corso o Codice di Riferimento .
- nome lungo*^: Questo è il nome lungo (completo) del corso. (Può essere uguale al nome breve, ma se sono disponibili entrambi, fornire entrambi garantirà una migliore esperienza utente.)
- account_id^: Questo è l'identificativo univoco dell'account SIS ID (dal file accounts.csv) che indica al corso sotto quale sottoaccount risiederà. Se non viene specificato un account_id per un nuovo corso, il corso verrà associato al tuo account principale/root. L'ID SIS è disponibile nelle Impostazioni del sottoaccount.
- term_id^: Questo è l'identificatore univoco del termine (dal file terms.csv) che indica al corso quando iniziare e quando concludere. Se si associa un term_id a un corso, non è necessario inserire una start_date o una end_date.
- stato*^: Questo è lo stato del corso, noto anche come workflow_state. Questo campo consente di creare, rimuovere, concludere o pubblicare un corso. Contrassegna come attivo per aggiungere un corso, eliminato per rimuovere un corso esistente, completato per concludere un corso esistente o pubblicato per pubblicare un corso nuovo o esistente.
- integration_id: identificatore univoco secondario utile per integrazioni SIS più complesse. Questo identificatore non deve cambiare per il corso e deve essere univoco a livello globale.
- start_date^: Questa è la data di inizio del corso. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ (La T può essere sostituita da uno spazio).
- end_date^: Questa è la data di fine del corso. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ (la T può essere sostituita da uno spazio). Per impostazione predefinita, l'accesso degli utenti viene interrotto a mezzanotte della data di fine indicata, il che significa che il giorno precedente è l'ultimo giorno intero in cui gli utenti hanno accesso al corso. La procedura consigliata è impostare la data di fine al giorno successivo alla fine del corso.
- course_format : questo è il formato del corso. Il formato può essere online , in presenza o misto .
- blueprint_course_id : ID del corso blueprint a cui si desidera aggiungere un corso associato. Per rimuovere il collegamento al corso blueprint, è possibile passare "dissociate" al posto dell'ID. Nell'interfaccia utente, questo è l'ID SIS del corso blueprint.
- homeroom_course: utilizzato per designare i corsi in aula per gli account Canvas per Elementary. Richiede l'abilitazione dell'impostazione Canvas per Elementary.
sezioni.csv
Una sezione suddivide gli studenti all'interno di un corso. È anche possibile raggruppare più sezioni in un unico corso, soprattutto se tutte le sezioni degli studenti studiano lo stesso materiale. È possibile inserire più sezioni in un unico corso, ma una sezione non può contenere più sezioni. Le sezioni ereditano le date del corso stabilite dal semestre. Tuttavia, se una sezione include date specifiche, queste sovrascriveranno le date di accesso degli studenti al corso e le date di inizio e/o fine del semestre.
Se stai cercando di eliminare un corso e gli utenti sono associati a sezioni, dovrai includere il parametro section_id nell'importazione CSV, nonché gli ID SIS delle sezioni.
Scarica un file sections.csv di esempio con le seguenti sezioni:
- 4 sezioni del corso ACCT300 - Contabilità dei costi
- 4 sezioni nel corso ACCT310 - Contabilità gestionale
- 2 sezioni nel corso BIO101 - Introduzione alla biologia
Questo file presuppone che siano presenti più sezioni all'interno di un corso. Molti istituti importano le sezioni dei corsi come corsi separati. Questo può essere fatto (1) creando un corso Canvas per ogni sezione nel file courses.csv, quindi (2) creando una singola sezione in ciascuno di questi corsi. È possibile utilizzare essenzialmente gli stessi dati per il corso e la sezione, incluso l'ID SIS che sarà lo stesso sia per course_id che per section_id.
Campo obbligatorio*| Campo appiccicoso^
- section_id*:Si tratta di un identificatore univoco utilizzato per creare sezioni all'interno di un corso. Questo identificatore non deve cambiare per la sezione e deve essere univoco a livello globale. Nell'interfaccia utente, questo è chiamato ID SIS.
- ID_corso*^: Questo è l'identificatore univoco del corso in cui la sezione verrà aggiunta o eliminata (aggiunta in courses.csv).
- nome*^: Questo è il nome della sezione. Le sezioni sono ordinate alfabeticamente per nome.
- stato*:Ecco come creare o rimuovere una sezione all'interno di un corso. Contrassegna come attiva per creare una sezione o eliminata per rimuoverne una esistente.
- integration_id: identificatore univoco secondario utile per integrazioni SIS più complesse. Questo identificatore non deve cambiare per la sezione e deve essere univoco a livello globale.
- start_date^: Questa è la data di inizio della sezione. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ (la T può essere sostituita da uno spazio).
- end_date^: Questa è la data di fine della sezione. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ (la T può essere sostituita da uno spazio). Per impostazione predefinita, l'accesso utente viene interrotto a mezzanotte della data di fine indicata, il che significa che il giorno precedente è l'ultimo giorno intero in cui gli utenti hanno accesso alla sezione. La procedura consigliata è impostare la data di fine al giorno successivo alla fine della sezione.
Nota: quando si importano file CSV di sezione, i valori integration_id esistenti vengono ora mantenuti se la colonna integration_id non è inclusa nel file di importazione. Per rimuovere un integration_id , è necessario annullarne esplicitamente l'impostazione tramite il file change_sis_id.csv .
iscrizioni.csv
Un'iscrizione è un utente che è stato iscritto a un corso con un ruolo specifico. Un file enrollments.csv consente di assegnare ruoli agli utenti e di inserirli nei corsi appropriati. Quando lo stato di iscrizione di un utente è contrassegnato come completato, l'accesso a quel corso sarà limitato alla sola lettura.
Nota: i file CSV di iscrizione SIS che includono i valori start_date ed end_date sostituiscono le date dei termini, dei corsi e delle sezioni.
Scarica un file enrollments.csv di esempio con le seguenti iscrizioni:
- 1 utente come docente nel corso ACCT300 - Contabilità dei costi
- 1 utente come ta nel corso ACCT300 - Contabilità dei costi
- 1 utente come progettista nel corso ACCT300 - Contabilità dei costi
- 3 utenti come studenti nella sezione 1 del corso ACCT300 - Contabilità dei costi
- 3 utenti come studenti nella sezione 2 del corso ACCT300 - Contabilità dei costi
- 1 utente come osservatore di uno studente nella sezione 1 del corso ACCT300 - Contabilità dei costi
Campo obbligatorio*| Campo appiccicoso^
- course_id*: (obbligatorio se section_id è mancante) Identificativo univoco del corso a cui l'utente sarà iscritto (aggiunto in courses.csv). Se si iscrivono studenti al corso anziché a una sezione specifica, inserire course_id in questo campo. Altrimenti, lasciarlo vuoto.
- root_account : questo è il dominio dell'account in cui cercare l'utente.
- start_date^: Questa è la data di inizio dell'iscrizione. Affinché start_date abbia effetto, è necessario compilare anche end_date. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ.
- end_date^: Questa è la data di fine dell'iscrizione. Affinché end_date abbia effetto, è necessario compilare anche start_date. Il formato deve essere ISO 8601 : AAAA-MM-GGTHH:MM:SSZ.
- ID utente*:Questo è l'identificativo univoco dell'utente che verrà iscritto ai corsi designati (aggiunto in users.csv). Se user_integration_id è presente, questo campo verrà ignorato.
- user_integration_id*: (obbligatorio se user_id è mancante)Questo è l'identificatore univoco secondario dell'utente (aggiunto in users.csv come integration_id).
- ruolo*:Questo è il ruolo che verrà assegnato a un utente per il corso designato. È possibile iscrivere un utente con uno qualsiasi dei seguenti ruoli: insegnante, progettista, assistente, studente, osservatore o un ruolo personalizzato da te definito. Ogni ruolo ha un set di autorizzazioni che gli amministratori possono personalizzare a livello di account principale/root o di sottoaccount.
- role_id*: (obbligatorio se il ruolo è mancante)Si tratta dell'identificatore univoco per il ruolo in cui l'utente verrà aggiunto come parte di un'iscrizione.
- section_id*:(Obbligatorio se il course_id è mancante) Questo è l'identificativo univoco per la sezione a cui l'utente verrà iscritto (aggiunto in sections.csv). Se si iscrivono studenti a una sezione specifica di un corso, inserire qui il section_id della sezione. Altrimenti, lasciare questo campo vuoto. Se non viene specificato alcun section_id, verrà utilizzata la sezione predefinita per il corso. Se non esiste una sezione predefinita, ne verrà creata automaticamente una senza un ID SIS.
- stato*: Ecco come iscrivere, concludere, disattivare (rendere inattivo) o rimuovere un'iscrizione a un corso. Contrassegna come attivo per iscrivere un utente a un corso, completato per concludere l'iscrizione di un utente a un corso, inattivo per disattivare l'utente dal corso ed eliminato per rimuovere un utente da un corso. Quando si trova in stato "inattivo", uno studente verrà elencato nell'elenco del corso per gli insegnanti, ma non potrà visualizzare o partecipare al corso finché l'iscrizione non verrà attivata.
- associated_user_id: (solo per il ruolo di osservatore) Questo è l'identificativo univoco dell'utente le cui informazioni (inclusi i voti) l'osservatore potrà visualizzare. L'osservatore deve essere iscritto allo stesso corso/sezione dell'utente che si desidera che osservi. Questo campo verrà ignorato per qualsiasi ruolo diverso da osservatore.
- limit_section_privileges: in questo modo si stabilisce che l'iscrizione consentirà all'utente di visualizzare e interagire solo con gli utenti iscritti alla sezione specificata da course_section_id. Il valore predefinito di questo campo è falso. Limitare l'interazione degli studenti per sezione riguarda solo Collaborazioni, Chat, Persone e Conversazioni. Quando si iscrivono docenti e assistenti, le limitazioni di sezione consentono a tali utenti di valutare gli studenti nelle loro stesse sezioni. Gli argomenti di discussione e le Pagine non sono interessati dalle limitazioni di sezione e possono essere visualizzati da qualsiasi studente. Queste aree di funzionalità possono essere limitate creando contenuti nei gruppi del corso.
- notifica: è il modo in cui scegli di inviare una notifica agli utenti iscritti quando si iscrivono a un corso.
Nota: il campo root_account è consigliato quando si identificano gli utenti in un account attendibile .
categorie_gruppo.csv
Le categorie di gruppo consentono di organizzare i gruppi in Canvas. Un file group_categories.csv consente di creare categorie di gruppo a livello di account o corso. Nell'interfaccia utente, le categorie di gruppo sono chiamate set di gruppi.
Scarica un file group_categories.csv di esempio con le seguenti categorie di gruppo:
- Gruppi di amministrazione
- Gruppi di designer
- Gruppi di progetto di storia
Campo obbligatorio*| Campo appiccicoso^
- group_category_id:Questo è l'identificatore utilizzato per fare riferimento alla categoria del gruppo. L'identificatore non deve cambiare per la categoria del gruppo e deve essere univoco a livello globale.
- account_id: questo è l'identificativo che associa la categoria del gruppo a un account (aggiunto in accounts.csv). Se non viene specificato alcun account o corso, il gruppo verrà associato all'account root.
- course_id: questo è l'identificativo che associa la categoria del gruppo a un corso (aggiunto in courses.csv). Se non viene specificato alcun corso o account, il gruppo verrà associato all'account root.
- nome_categoria*^ : Questo è il nome della categoria del gruppo.
- stato*:Questo è lo stato della categoria del gruppo. Contrassegna come attivo per creare la categoria del gruppo o eliminato per eliminarla.
gruppi.csv
Un gruppo può essere utilizzato per offrire opportunità di collaborazione a studenti, docenti, amministratori o altri utenti. Un file groups.csv consente di creare gruppi a livello di corso e di account . I gruppi caricati tramite SIS possono essere aggiornati o eliminati solo tramite SIS.
Scarica un file groups.csv di esempio con i seguenti gruppi:
- Amministratori
- Insegnanti di matematica
- Designer
Campo obbligatorio*| Campo appiccicoso^
- group_id*:Questo è l'identificatore univoco utilizzato per fare riferimento al tuo gruppo. Non deve cambiare per il gruppo e deve essere univoco a livello globale.
- group_category_id: questo è l'identificativo della categoria di gruppo (aggiunto in group_categories.csv) in cui si sta aggiungendo un gruppo. Se non viene specificata alcuna categoria di gruppo, il gruppo verrà inserito nella categoria di gruppo predefinita per l'account o il corso definito. Se non viene specificato alcun account o corso, il gruppo verrà inserito nella categoria di gruppo predefinita per l'account root.
- account_id: questo è l'identificativo che associa il gruppo a un account (aggiunto in accounts.csv). Se non viene specificato alcun valore, il gruppo verrà associato all'account root.
- course_id: questo è l'identificativo che associa il gruppo a un corso (aggiunto in courses.csv). Se non viene specificato alcun corso o account, il gruppo verrà associato all'account root.
- nome*^: Questo è il nome del gruppo.
- stato*:Questo è lo stato del gruppo. Contrassegna come disponibile per rendere il gruppo accessibile all'iscrizione, oppure come eliminato per eliminarlo.
gruppi_appartenenza.csv
L'appartenenza a un gruppo consente agli utenti di collaborare alle attività in Canvas. Un file groups_membership.csv consente di aggiungere o rimuovere in blocco persone da un gruppo creato tramite groups.csv.
Scarica un file groups_membership.csv di esempio con le seguenti appartenenze ai gruppi:
- 1 utente accettato nel gruppo Amministratori
- 1 utente accettato nel gruppo Insegnanti di matematica
- 1 utente eliminato nel gruppo Insegnanti di matematica
Campo obbligatorio*
- group_id*:Questo è l'identificatore univoco utilizzato per fare riferimento al tuo gruppo (aggiunto in groups.csv).
- ID utente*:Questo è l'identificatore univoco dell'utente che vuoi aggiungere al gruppo (aggiunto in users.csv).
- stato*:Questo è lo stato degli utenti nel gruppo. Contrassegna come accettato per aggiungere un utente a un gruppo o come eliminato per rimuoverlo.
xlists.csv
L'inserimento incrociato di sezioni consente di spostarle in un altro corso. Un file xlist.csv consente di inserire sezioni in corsi esistenti e di creare una gerarchia di sezioni.
Si prevede che gli ID di sezione esistano già e facciano riferimento ad altri ID di corso. Se in questo file viene fornito un ID di sezione, questo verrà spostato dall'ID di corso esistente a un nuovo ID di corso, in modo che se il nuovo corso viene rimosso o l'elenco incrociato viene rimosso, la sezione tornerà al suo ID di corso precedente. Se xlist_course_id non fa riferimento a un corso esistente, verrà creato. Se si desidera fornire ulteriori informazioni sul corso elencato in modo incrociato, è possibile farlo in courses.csv.
Scarica un file xlists.csv di esempio con i seguenti corsi e sezioni:
- 4 sezioni attive del corso ACCT300 - Contabilità dei costi sono integrate nel corso ACCT310 - Contabilità gestionale
Campo obbligatorio*
- xlist_course_id*:Questo è l'identificatore del nuovo corso (aggiunto in courses.csv).
- section_id*:Questo è l'identificatore della sezione (aggiunto in sections.csv).
- stato*:Questo è lo stato della sezione. Contrassegna come attiva per rendere la sezione attiva o eliminata per rimuoverla.
osservatori_utente.csv
Il ruolo di osservatore può essere utilizzato per iscrivere i genitori e collegarli a uno studente, consentendo loro di visualizzare i voti e le interazioni dei propri figli durante i corsi. Un file user_observers.csv consente di iscrivere e collegare osservatori a ciascuna iscrizione dello studente designato.
Scarica un file user_observers.csv di esempio con le seguenti registrazioni:
- 2 osservatori attivi
- 1 osservatore eliminato
Campo obbligatorio*
- observer_id*:Questo è l'identificatore univoco dell'osservatore (aggiunto come user_id in users.csv).
- student_id*:Questo è l'identificatore univoco dello studente (aggiunto come user_id in users.csv).
- stato*:Questo è lo stato dell'osservatore. Contrassegna come attivo per iscrivere l'osservatore per ciascuna iscrizione dello studente, oppure elimina per rimuovere tutte le iscrizioni dell'osservatore.
login.csv
Il file logins.csv consente di creare o aggiornare le credenziali di accesso per gli utenti. Gli accessi possono essere aggiunti solo agli utenti esistenti. Gli accessi possono essere rimossi utilizzando il file users.csv.
Scarica un file logins.csv di esempio con tre accessi utente.
Campo obbligatorio*| Campo appiccicoso^
- ID utente*:Questo è l'identificativo univoco dell'utente (riportato in enrollments.csv). Questo valore non deve cambiare per l'utente e deve essere univoco per tutti gli utenti. Denominato ID SIS nell'interfaccia utente di Canvas.
- integration_id: identificatore univoco secondario utile per integrazioni SIS complesse. Questo valore non deve cambiare per l'utente e deve essere univoco per tutti gli utenti. Questo campo deve essere lasciato vuoto quando si uniscono utenti con ID di integrazione corrispondenti.
- ID di accesso*:Questo è il nome che l'utente utilizzerà per accedere a Canvas. Per i servizi di autenticazione configurati, come LDAP, questo sarà il nome utente del sistema remoto.
- password: questa è la password che l'utente utilizzerà per accedere a Canvas. Questo campo non deve essere compilato per gli account configurati su LDAP o SSO.
- ssha_password: si tratta di una password generata con uno schema di generazione SSHA pre-hashed.
- authentication_provider_id: questo è il provider di autenticazione a cui è associato l'accesso.
- existing_user_id^: questo è l'ID SIS dell'utente, come riportato nel file users.csv.
- existing_integration_id^: questo è l'ID di integrazione dell'utente, come riportato nel file users.csv.
- existing_canvas_user_id^: Questo è l'ID Canvas dell'utente.
- root_account: questo è l'account di dominio dell'utente.
- email: questo è l'indirizzo email dell'utente.
Note:
- existing_user_id, existing_integration_id o existing_canvas_user_id*: (obbligatorio per un'importazione corretta di logins.csv)
- root_account*: (obbligatorio quando si identificano gli utenti in unaccount attendibilead esempio, quando si elencano più utenti in più account all'interno di un account attendibile).
- stato*: (obbligatorio quando si esegue un'importazione SIS tramite logins.csv)
amministratori.csv
Gli amministratori gestiscono le impostazioni per un intero account o sottoaccount. Un file admins.csv consente di designare gli utenti in Canvas come amministratori dell'account o altri ruoli personalizzati per account o sottoaccount.
Scarica un file admins.csv di esempio con i seguenti amministratori:
- 2 amministratori di account attivi
- 1 account amministratore eliminato
- 2 ruoli di account personalizzati attivi
Campo obbligatorio*
- ID utente*: Questo è l'ID univoco dell'utente che desideri designare come amministratore (aggiunto in users.csv).
- ID account*: Questo è l'identificativo univoco dell'account in cui si desidera che risieda l'amministratore (aggiunto in accounts.csv). Se questa colonna viene lasciata vuota, l'utente risiederà nell'account root. Questa colonna è sempre obbligatoria, anche se il valore è vuoto.
- role_id*: (obbligatorio se il ruolo è mancante)Questo è l'ID del ruolo, che può essere l'ID predefinito o un ID personalizzato definito dall'account.
- ruolo*: (obbligatorio se role_id è mancante)Questo è il nome del ruolo, che può essere il ruolo predefinito di Amministratore Account o un ruolo personalizzato definito dall'account. Se si aggiunge un amministratore account, formattare il campo in "AccountAdmin". Se si aggiunge un ruolo personalizzato, formattare il campo esattamente come appare nell'interfaccia utente di Canvas.
- stato*: Questo è lo stato dell'amministratore. Contrassegna come attivo per creare un amministratore attivo o eliminato per rimuoverlo.
- root_account: questo è il dominio dell'account in cui cercare l'utente.
cambia_sis_id.csv
Un ID SIS è un identificatore univoco per un oggetto in Canvas. Un file change_sis_id.csv consente di modificare in blocco gli ID SIS per account, termini, corsi, sezioni, gruppi o utenti esistenti.
Scarica un file change_sis_id.csv di esempio con le seguenti modifiche dell'ID SIS:
- 1 modifica dell'ID SIS dell'utente
- 1 cambio ID SIS del corso
- 1 termine di modifica dell'ID SIS
Campo obbligatorio*
- vecchio_id*: Questo è l'ID SIS corrente dell'oggetto.
- nuovo_id*: Questo è l'ID SIS desiderato per l'oggetto. Il nuovo ID SIS deve essere attualmente univoco per il tipo di oggetto e per l'account root.
- tipo*: Questo è il tipo di oggetto. Il tipo può essere account, termine, corso, sezione, gruppo o utente.