I dati SIS possono essere caricati tramite il link Importazioni SIS nelle Impostazioni account. I dati SIS sono accessibili solo a livello di account e non possono essere aggiunti a sotto-account.
La pagina di importazione SIS supporta alcuni formati per le importazioni standard in Canvas Career: file CSV in formato Instructure o un file zip di file CSV, file zip XML IMS Enterprise Specification o file XML Banner Grade Exchange Results. I file possono essere impostati per un aggiornamento batch completo e per sovrascrivere le modifiche dell'interfaccia utente.
Assicurati di essere a conoscenza dei rischi associati a queste opzioni di caricamento. Per maggiori dettagli su questi rischi, consulta la lezione sull'importazione di dati SIS .
Elaborazione API
Le importazioni SIS vengono aggiunte a una coda che elabora ciascun file CSV importato separatamente (sia che venga caricato singolarmente o all'interno di un file ZIP). Gli errori di importazione vengono visualizzati nella pagina di importazione SIS.
Pratiche API
Prima di importare le informazioni SIS, esercitatevi a utilizzare l'API per gestire i dati SIS. Dovreste anche utilizzare un ambiente di test per evitare conflitti con i dati di produzione. Una volta verificati i dati nell'ambiente di test, potete riapplicare l'integrazione SIS all'ambiente di produzione. Inoltre, alcune opzioni relative ai dati SIS sono disponibili solo tramite API.
Note:
- L'importazione dei dati SIS deve essere abilitata dal tuo Customer Success Manager prima che i file possano essere caricati sul tuo account.
- L'importazione dei file SIS è un'autorizzazione di account. Se non si dispone dell'autorizzazione per gestire i file SIS, significa che l'istituto ha limitato questa funzionalità.
- Prima di impostare le autorizzazioni per un ruolo utente, è necessario assicurarsi che il ruolo che si desidera assegnare all'utente esista già nel proprio account.
Suggerimento per la risoluzione dei problemi: alcuni campi diventano "persistenti" quando le informazioni vengono modificate direttamente da un utente o da un amministratore. Questa condizione impedisce le modifiche automatiche tramite l'importazione da SIS. Se le modifiche non vengono applicate dopo l'importazione dei dati da SIS, è possibile che gli utenti abbiano apportato modifiche tramite l'interfaccia utente (UI). È possibile ignorare le modifiche utilizzando l' opzione "Ignora modifiche interfaccia utente" .
Se si utilizza un sistema automatizzato per importare dati da un SIS, potrebbe essere opportuno impedire agli utenti di modificare direttamente il proprio nome in Canvas Career. Per impedire agli utenti di modificare il proprio nome, deselezionare l'opzione "Gli utenti possono modificare il proprio nome" nelle impostazioni dell'account .
È possibile consultare un elenco completo dei campi che potrebbero diventare permanenti nella pagina dell'API di importazione SIS .
Apri SIS Import
Nella navigazione globale, fare clic sul collegamento Admin [1], quindi fare clic sul collegamento Importazione SIS [2].
Seleziona il file
Fai clic sul pulsante Scegli un file da importare e individua il file di importazione SIS sul tuo computer.
Imposta l'aggiornamento completo del batch
Se si desidera creare un aggiornamento batch completo, selezionare la casella di controllo Questo è un aggiornamento batch completo [1]. Un avviso informa gli utenti dei rischi associati alla selezione della casella di controllo Questo è un aggiornamento batch completo . Nel menu a discesa Semestre [2], digitare il semestre da cercare, quindi selezionarlo per applicare l'aggiornamento batch completo. Con questa opzione, è possibile eliminare tutti i corsi, le sezioni o le iscrizioni con un record ID SIS in Canvas Career collegato al semestre selezionato nel menu a discesa. Per le iscrizioni, questa opzione significa che l'utente e il corso/le sezioni collegati richiedono ID SIS. Un record di Canvas Career verrà eliminato se non è incluso nel file di importazione corrente.
Questa opzione influirà solo sui dati creati tramite precedenti importazioni SIS. I corsi creati manualmente, ad esempio, non verranno eliminati anche se non compaiono nella nuova importazione SIS.
Note:
- Assicurati di essere consapevole dei rischi associati prima di selezionare questa opzione.
- Quando si importano file CSV di sezioni tramite SIS Imports, i valori di integration_id esistenti vengono ora mantenuti se la colonna integration_id non è inclusa nel file di importazione. Per rimuovere un integration_id , è necessario annullarlo esplicitamente utilizzando il file
change_sis_id.csv .
Ignora le modifiche dell'interfaccia utente
Se desideri ignorare le modifiche apportate all'interfaccia utente (UI), seleziona la casella di controllo "Ignora modifiche UI" . Questa opzione indica a Canvas Career di sovrascrivere tutti i dati "persistenti" modificati dagli utenti nei loro account con i dati che stai importando.
- Se questa casella NON è selezionata durante l'importazione di un nuovo utente, nessuna modifica al nome verrà sovrascritta nell'interfaccia utente, ma se l'utente ha rimosso il proprio indirizzo email, questo verrà aggiunto nuovamente ma non contrassegnato come predefinito.
- Se questa casella è selezionata durante l'importazione di un nuovo utente, il nome completo e il nome ordinabile cambieranno, ma il nome visualizzato non verrà modificato. L'indirizzo email verrà aggiunto, ma non verrà comunque contrassegnato come predefinito.
Seleziona l'opzione dell'interfaccia utente
L'override delle modifiche all'interfaccia utente consente inoltre di scegliere tra due opzioni aggiuntive: elaborare come modifiche all'interfaccia utente o cancellare lo stato modificato dall'interfaccia utente. È possibile selezionare una sola opzione.
Se desideri selezionare un'opzione, seleziona la casella di controllo accanto alla tua preferenza:
- Elabora come modifiche dell'interfaccia utente [1]: sovrascrive le modifiche che hanno avuto luogo nell'interfaccia utente come dati "persistenti"; tutti i dati si comportano come se le modifiche fossero state effettivamente aggiornate manualmente nell'interfaccia utente
- Cancella lo stato modificato dell'interfaccia utente [2] : rimuove la "persistenza" di tutti i dati presenti in questa importazione; le importazioni future con questi dati non indicheranno alcun dato nell'interfaccia utente come "persistente".
Elabora i dati
Fai clic sul pulsante Elabora dati .
Conferma le modifiche
Dopo aver cliccato sul pulsante Elabora dati, viene visualizzata una finestra di dialogo di conferma. Clicca su Annulla [1] per interrompere o su Conferma [2] per procedere.
Visualizza i dati di importazione
Al termine del processo di importazione, Canvas Career visualizza i risultati del file importato, insieme a un massimo di 50 errori e avvisi. Se è stato importato un aggiornamento batch completo, i risultati mostrano anche il numero di elementi eliminati rimossi dall'account. Gli elementi eliminati includono iscrizioni, corsi e sezioni.
Dopo aver aggiornato la pagina, queste informazioni rimarranno nella pagina di importazione SIS sotto l'intestazione "Ultimo lotto" fino a quando non verrà effettuata una nuova importazione.
Errori di download
Se desideri scaricare tutti gli avvisi e gli errori dal tuo ultimo file di importazione, torna alla pagina Importazione SIS. Sotto la voce Ultimo batch [1], fai clic sull'icona Scarica ultimo batch [2]. Verrà scaricato un file CSV contenente tutti gli errori e gli avvisi dell'ultima importazione.
Nota :
- Potrebbe essere necessario aggiornare la pagina per visualizzare l'icona di download.
- Se il report viene scaricato, il link scade dopo un'ora. Se la pagina viene aggiornata, viene generato un nuovo URL che rimane attivo per un'ora.
Revisione degli errori
Se riscontri un errore durante l'esecuzione di un file, esamina i messaggi di errore disponibili. Tieni presente quanto segue quando esamini gli errori:
- Potresti scoprire che il file stesso presenta un messaggio di errore oppure che alcune righe del file non sono state elaborate correttamente.
- È possibile utilizzare l' API SIS Import Errors per ulteriori dettagli sulla risoluzione dei problemi, che restituirà il numero di riga del file CSV in cui si è verificato l'errore.
- Il file CSV richiede una formattazione specifica per essere caricato correttamente. In particolare, si prega di esaminare le intestazioni del file CSV. Ulteriori informazioni sulla formattazione dei file CSV sono disponibili qui.
- I file CSV importati da SIS devono essere codificati in UTF-8 senza byte order mark. La maggior parte delle applicazioni li codifica automaticamente in UTF-8, sebbene alcuni programmi, come Microsoft Excel, possano utilizzare una codifica alternativa. Se il software in uso è in grado di codificare i file in formato UTF-8, selezionare UTF-8 come opzione durante il salvataggio.
- Alcuni messaggi di errore richiedono di contattare l'assistenza per una verifica.
