Les données SIS peuvent être téléversés via le lien Importations SIS dans les paramètres du compte. Les données SIS ne sont accessibles qu'au niveau du compte et ne peuvent pas être ajoutées aux sous-comptes.
La page Importation SIS prend en charge plusieurs formats d'importation standard dans Canvas : les fichiers CSV au format Infrastructure ou les fichiers zip de fichiers CSV, les fichiers zip de XML IMS Enterprise Specification, ou les fichiers XML Banner Grade Exchange Results. Les fichiers peuvent être définis pour une mise à jour par lot complète et pour remplacer les modifications de l'interface utilisateur.
Veuillez vous assurer d'être conscient des risques associés à ces options de téléversement. Pour plus de détails sur ces risques, veuillez consulter la Leçon sur les importations SIS.
Traitement des API
Les importations SIS sont ajoutées à une file d'attente qui traite chaque CSV importé séparément (qu'il soit téléversé individuellement ou dans un fichier ZIP). Les erreurs d'importation sont affichées dans la page d'importation SIS.
Pratique de l'API
Avant d'importer des informations SIS, pratiquez l'utilisation de l'API pour gérer les données SIS. Vous devriez également utiliser votre environnement de test pour éviter les conflits avec vos données de production en direct. Une fois que vous avez confirmé vos données dans votre environnement de test, vous pouvez réappliquer votre intégration SIS à votre environnement de production. De plus, certaines options de données SIS ne sont disponibles que via l'API.
Remarques :
- Les importations SIS doivent être activées par votre Responsable succès client avant que les fichiers puissent être téléversés sur votre compte.
- L'importation des fichiers SIS nécessite une autorisation de compte. Si vous n'avez pas accès à la gestion des fichiers SIS, cela signifie que votre institution a restreint cette fonction.
- Avant d'autoriser un rôle d'utilisateur, vous devez vous assurer que le rôle que vous souhaitez attribuer à l'utilisateur existe déjà dans votre compte. En savoir plus sur la création de rôles de niveau utilisateur.
Conseil de dépannage : Certains champs deviennent « collant » lorsque des informations sont modifiées directement par un utilisateur ou un administrateur. Ce caractère collant empêche les modifications automatiques via une importation SIS. Si aucune modification ne se produit après l'importation des données SIS, les utilisateurs ont peut-être apporté des modifications via l'interface utilisateur (IU). Vous pouvez remplacer les modifications à l'aide de l’option de remplacement des modifications de l'IU.
Si vous utilisez un système automatisé pour importer des données à partir d'un SIS, vous souhaiterez peut-être empêcher les utilisateurs de modifier leur nom directement dans Canvas. Pour empêcher les utilisateurs de modifier leurs propres noms, désélectionnez l'option Les utilisateurs peuvent modifier leur nom (Users can edit their name) dans les paramètres du compte.
Vous pouvez voir une liste complète des champs qui peuvent devenir « collants » sur la page de l'API d'importation SIS.
Ouvrir un compte
Dans Navigation globale, cliquez sur le lien Admin [1], puis sur le nom du compte [2].
Ouvrir l'importation SIS
Dans Navigation du compte, cliquez sur le lien Importation SIS (Import SIS).
Sélectionner le fichier
Cliquez sur Choisir le fichier (Choose File) et localisez le fichier d'importation SIS sur votre ordinateur.
Sélectionner le type d'importation
Dans le menu Type d'importation, sélectionnez le format du fichier que vous téléversez dans Canvas. Par défaut, le menu sélectionne l'option d'importation CSV.
Définir la mise à jour par lot complète
Si vous souhaitez créer une mise à jour par lots complète, cochez la case Il s'agit d'une mise à jour complète par lots (This is a full batch update) [1], un avertissement informe les utilisateurs des risques associés au fait de cocher la case Il s'agit d'une mise à jour complète par lots (This is a full batch update). Dans le menu déroulant Période d’enseignement [2], sélectionnez la période d’enregistrement pour la mise à jour par lot complète. Avec cette option, tous les cours, sections ou inscriptions avec un enregistrement d'ID SIS dans Canvas lié à la période d’enseignement sélectionnée dans la liste déroulante peuvent être supprimés. Pour les inscriptions, cette option implique que l'utilisateur lié et les cours/sections nécessitent des identifiant SIS. Un enregistrement Canvas sera supprimé s'il n'est pas inclus dans le fichier d'importation courant.
Cette option n'affectera que les données créées via les importations SIS précédentes. Les cours créés manuellement, par exemple, ne seront pas supprimés, même s'ils n'apparaissent pas dans la nouvelle importation SIS.
Remarques : Assurez-vous d'être conscient des risques associés avant de sélectionner cette option.
Annuler les modifications de l'interface utilisateur
Si vous souhaitez annuler les modifications apportées à l'interface utilisateur, cochez la case Annuler les modifications de l'interface utilisateur (Override UI changes). Ce changement indique à Canvas d'écraser toutes les données « adhésives » modifiées par les utilisateurs dans leurs comptes avec les données que vous importez.
- Si cette case n'est PAS cochée lors de l'importation d'un nouvel utilisateur, aucun changement de nom ne sera annulé dans l'interface utilisateur, mais si l'utilisateur a supprimé son adresse e-mail répertoriée, elle sera rajoutée mais non marquée comme adresse par défaut.
- Si cette case EST cochée lors d'une importation de nouveaux utilisateurs, le nom complet et le nom triable changeront, mais le nom d'affichage n'est pas modifié. L'adresse e-mail est ajoutée, mais elle n'est toujours pas marquée comme adresse par défaut.
Sélectionner l'option d'interface utilisateur
Le fait de substituer les modifications de l'interface utilisateur permet également l'une des deux options supplémentaires suivantes : traiter les modifications au fur et à mesure que l'interface utilisateur change ou effacer l'état modifié de l'interface utilisateur. Vous ne pouvez sélectionner qu'une seule option.
Si vous souhaitez sélectionner une option, cochez la case à côté de votre préférence :
- Traiter comme modification de l'interface utilisateur (Process as UI changes [1] : remplace les modifications qui ont eu lieu dans l'interface utilisateur en tant que données « adhésives » ; toutes les données agissent comme si les modifications étaient réellement mises à jour manuellement dans l'interface utilisateur.
- Effacer le statut de modification de l'interface utilisateur (Clear UI-changed state) [2] : supprime le caractère « collant » de toutes les données qui existent dans cette importation ; les importations futures avec ces données ne mentionneront pas de données dans l'interface utilisateur comme « collantes ».
Traiter les données
Cliquez sur le bouton Traiter les données (Process data) .
Confirmer les modifications
Après avoir cliqué sur le bouton Traiter les données, une fenêtre de confirmation s'affiche. Cliquez sur Annuler (Cancel) [1] our arrêter ou Confirmer (Confirm) [2] pour continuer.
Afficher les données d'importation
Une fois l'importation terminée, Canvas affiche les résultats du fichier importé, ainsi que jusqu'à 50 erreurs et avertissements. Si vous avez importé une mise à jour par lot complète, les résultats indiquent également le nombre d'éléments supprimés du compte. Les éléments supprimés incluent les inscriptions, les cours et les sections.
Une fois la page actualisée, ces informations resteront dans la page Importation SIS sous l'en-tête Dernier lot jusqu'à ce qu'une autre importation soit effectuée.
Télécharger les erreurs
Si vous souhaitez télécharger tous les avertissements et erreurs de votre dernier fichier d'importation, revenez à la page Importation SIS. Sous l'en-tête Dernier lot [1], cliquez sur l'icône Téléchargement du dernier lot [2]. Un fichier CSV est téléchargé avec toutes les erreurs et avertissements de votre dernière importation.
Remarque :
- Il vous faudra peut-être rafraîchir la page pour voir l'icône de téléchargement.
- Si le rapport est téléchargé, le lien expire au bout d'une heure. Si la page est actualisée, une nouvelle URL est générée et active pendant une heure.
Erreurs de révision
Si vous constatez qu'un fichier a échoué, consultez tous les messages d'erreur disponibles. Tenez compte des points suivants lors de la vérification des erreurs :
- Il se peut que vous constatiez que le fichier lui-même contenait un message d'erreur ou que des lignes particulières du fichier ont échoué.
- Vous pouvez aussi utiliser l'API d'erreurs d'importation SIS pour obtenir des informations supplémentaires concernant le dépannage, qui renvoie le numéro de ligne dans le ficher CSV où l'erreur s'est produite.
- Le fichier CSV nécessite un formatage spécifique pour être téléversé correctement. En particulier, examinez les en-têtes du fichier CSV. En savoir plus sur le formatage des fichiers CSV.
- Les fichiers CSV d'importation SIS doivent être codés en UTF-8 sans marque d'ordre d'octet. La plupart des applications codent automatiquement en UTF-8, bien que certains programmes, tels que Microsoft Excel, passent à un codage alternatif. Si votre logiciel est capable d'encoder des fichiers en UTF-8, sélectionnez UTF-8 comme option lors de l'enregistrement.
- Certains messages d'erreur nécessitent que vous contactiez l’équipe de soutien technique pour les examiner.
