Comment formater les fichiers texte au format CSV pour charger des données SIS dans un compte Canvas ?

Canvas vous permet de créer en masse manuellement des utilisateurs, des comptes, des échéances, des cours, des sections, des inscriptions et des identifiants via l'interface Administrateur.

Ce document mentionne la page API au format du CSV des importations SIS où se trouvent la majorité des informations CSV. Chaque fichier CSV est en symbiose avec un autre et dit à Canvas comment gérer toutes les informations du compte. Afficher le diagramme de relation SIS.

Dans cette leçon, vous trouverez des exemples de fichier CSV avec les descriptions de chaque champ obligatoire et optionnel. Vous trouverez également un lien pour télécharger chaque fichier si vous souhaitez étudier de plus près le formatage. Téléchargez un package zippé de tous les fichiers exemples. Si un lien de téléchargement de fichier CSV ne fonctionne pas, essayez de l'ouvrir dans un nouvel onglet.

Vous devriez tester l'importation de données dans votre environnement de test de Canvas avant d'importer des contenus dans votre environnement de production.

Format de fichier CSV

Afin de télécharger en masse des données dans Canvas, vous devez créer un ou plusieurs fichiers texte CSV.  Les fichiers CSV peuvent être générés par de nombreux programmes. Le système d'information sur les élèves (SIS) dispose souvent d'une méthode de génération de rapports au format CSV qui peuvent être modifiés pour s'adapter au format requis par Canvas. Si vous ne savez pas comment sauvegarder un fichier au format CSV, veuillez consulter la documentation du programme que vous utilisez pour créer votre ficher CSV (par ex. Excel).

Lorsque vous utilisez le format Infrastructure pour importer les fichiers dans la page d'Import SIS, vous avez la possibilité d'importer un fichier texte CSV individuel, ou pouvez compresser plusieurs fichiers dans une arche ZIP unique afin de réaliser un import groupé des données. Si vous transférer manuellement des fichiers individuels, ces derniers doivent l'être dans l'ordre indiqué dans cette leçon.

Formatage champs CSV

Il est impératif que la première ligne de votre fichier CSV (en-tête) comprenne le nom complet de champ de chaque fichier. L'ordre des colonnes n'a pas d'importance, mais avoir un ordre de lignes correct est crucial pour les fichiers comme les comptes.csv.

Champs adhésifs

Par défaut, certains changements effectués sur l'interface utilisateur ne sont pas écrasés par les futures importations SIS. Ils sont alors décrits comme « adhésifs ». Tous les champs adhésifs sont identifiés dans ce document. Vous pouvez écraser ces champs en paramétrant override_sis_stickiness dans l'API ou en cochant la case « Écraser les changements d'interface utilisateur » dans la page d'importations SIS.

Documentation API

Les fichiers CSV comprennent uniquement un ensemble spécifique de champs. Canvas contient des valeurs supplémentaires qui sont disponibles par l'entremise de chaque API individuel. Après avoir exécuté les fichiers CSV pour votre institution, une pratique courante pour la majorité des institutions est de télécharger tous les fichiers SIS CSV, puis d'utiliser l'API de Canvas pour mettre à jour le compte et les attributs du cours dans leur intégralité. Pour plus d'informations, consultez la documentation de l'API de Canvas concernant les utilisateurs, les comptes, les trimestres, les cours, les sections, les inscriptions et les groupes. Les importations SIS peuvent également être gérées à l'aide de l'API des importations SIS.

users.csv

Les utilisateurs sont les personnes qui ont des comptes d'utilisateurs au sein d'une institution. Le fichier utilisateurs.csv ajoute des personnes dans le système en tant qu'utilisateurs génériques. Le fichier enrollments.csv attribuera un rôle (enseignant, élève, etc.) à ces utilisateurs. Lorsqu'un compte utilisateur est supprimé toutes les inscriptions de cet utilisateur seront également supprimées et ils ne pourra plus se connecter à son compte Canvas. Si vous souhaitez toujours que l'utilisateur puisse continuer à se connecter, mais qu'il ne participe plus ou si vous souhaitez seulement le supprimer d'un cours spécifique, vous devrez alors laisser le compte utilisateur sur actif et passer son inscription (dans inscriptions.csv) sur finie ou supprimée, respectivement.

Téléchargez un fichier exemple users.csv avec 10 comptes d'utilisateur Canvas.

Champ requis* | Champ adhésif^

  • user_id* : Il s'agit de l'unique valeur utilisée pour identifier quiconque possédant un compte dans Canvas. Cette valeur ne doit pas être changée pour l'utilisateur, et doit être unique pour tous les utilisateurs. Dans l'interface utilisateur, elle est nommée l'ID SIS et peut être constituée de toute combinaison de caractères. Vous trouverez cette ID SIS en consultant un compte utilisateur et ses Informations d'authentification.
  • integration_id : Il s'agit de l'identifiant unique secondaire utilisé pour les intégrations SIS plus complexes. Cet identifiant ne doit pas changer pour l'utilisateur et doit être mondialement unique.
  • login_id*^ : Il s'agit du nom utilisateur utilisé pour se connecter à Canvas. Si vous avez un service d'authentification configuré (comme LDAP), il correspondra généralement au nom utilisateur dans le système distant. Login_id peut contenir des lettres, des nombres, ou les symboles suivants :  - _ = + . @
  • mot de passe :  Si le compte est configuré pour utiliser LDAP ou un protocole SSO, ce n'est alors pas nécessaire. Dans le cas contraire, il s'agit du mot de passe pour le "login_id" ci-dessus. Ce mot de passe doit contenir au moins 6 caractères.
  • ssha_password : Au lieu d'un mot de passe en texte clair, vous pouvez adopter un mot de passe pré-crypté à l'aide du système de génération de mot de passe SSHA dans ce champ. Bien que cela soit plus sûr que d'adopter un mot de passe en texte clair, vous devez toujours encourager les utilisateurs à changer leur mot de passe après leur première connexion. Découvrez comment générer des mots de passe SSHA.
  • authentication_provider_id: Il s'agit du fournisseur d'authentification auquel la connexion est associée. Les connexions associées à un fournisseur spécifique ne peuvent être utilisées qu'avec ce fournisseur. Les fournisseurs d'applications patrimoniales (LDAP, CAS, SAML) recherchent les identifiants qui leur sont associés, ou les identifiants non associés. Les nouveaux fournisseurs ne rechercheront que les identifiants qui leur sont explicitement associés. Il peut s'agir de l'ID entier du fournisseur ou du type de fournisseur (dans ce cas, il trouvera le premier fournisseur correspondant).  
  • first_name^ :  C'est le prénom de l'utilisateur donné. Si présent, utilisé pour la construction de full_name et/ou sortable_name.
  • last_name^ :  C'est le nom de famille de l'utilisateur. Si présent, utilisé pour la construction de full_name et/ou sortable_name.
  • full_name^ : Il s'agit à la fois du prénom et du nom de l'utilisateur. Omettre first_name et last_name si ce champ est utilisé.
  • sortable_name^: Il s'agit de l'option de nom pouvant être trié dans Canvas, généralement déduit du nom de l'utilisateur, mais cela peut être personnalisé.
  • short_name^ : Il s'agit du nom d'affichage de l'utilisateur, généralement déduit du nom de l'utilisateur, mais il peut être personnalisé.
  • e-mail :  Il s'agit de l'adresse e-mail attribuée à l'institution et sera également identifiée comme adresse e-mail par défaut. Cette adresse e-mail devra être renseignée même si elle est identique au login_id de l'utilisateur.
  • pronoms : Si les pronoms personnels sont activés, ce sont les pronoms personnels qui s'affichent après le nom de l'utilisateur dans Canvas. Le champ des pronoms accepte tous les pronoms, même s'ils ne sont pas créés à partir de la page Paramètres du compte.
  • declared_user_type : Ce type d'utilisateur déclaré peut être administratif, observateur, personnel, élève, élève_autre (student_other) ou enseignant. Peut passer "" pour supprimer le type d'utilisateur déclaré de l'utilisateur.
  • canvas_password_notification : La valeur par défaut est « faux ». Lorsque la valeur est « vrai », l'utilisateur est averti qu'il doit configurer le mot de passe si authentication_provider_id est Canvas.
  • home_account : Définir home_account sur « vrai » créera un nouvel utilisateur dans le compte cible pour l'importation SIS et fusionnera avec un autre utilisateur existant d'un autre compte au sein du consortium avec un integration_id correspondant. Sera ignoré sauf si le compte cible est associé à un consortium de fusion automatique.
  • status*^ :  C'est ici que vous pouvez ajouter ou supprimer un utilisateur de Canvas. Cochez actif pour ajouter un utilisateur, suspendu pour suspendre un utilisateur et supprimé pour supprimer un utilisateur existant.

 

Conflits d'adresses e-mail

Canvas identifie les utilisateurs par l'adresse e-mail. Lorsque les élèves sont ajoutés à un cours, Canvas tente de corriger tout conflit sur l'adresse e-mail, lorsque l'utilisateur se connecte au cours pour la première fois.

Les adresses e-mail sont généralement personnelles pour chaque élève. Parfois, des élèves peuvent partager une même adresse e-mail. Lors de l'ajout d'élèves à des cours via l'importation SIS, Canvas identifie lorsqu'une adresse e-mail est attribuée à plusieurs élèves.

  • Si une nouvelle ID SIS est associée à une adresse e-mail déjà affectée à une ID SIS existante, Canvas envoie un mail à l'adresse e-mail.
  • Lorsque des utilisateurs sont ajoutés à un compte via une importation SIS, ils ne recevront pas de notification par e-mail à moins que le système détecte un utilisateur en double. Toutefois, si des utilisateurs sont ajoutés ou inscrits manuellement, ils recevront un e-mail les informant qu'ils ont été ajoutés ou inscrits à un nouveau cours. L'élève partageant une adresse e-mail sera informé que l'adresse e-mail est déjà utilisée et sera invité à créer un nouveau compte. Ce processus peut être également appliqué lors de l'ajout d'un utilisateur à une inscription au cours.

accounts.csv

Un compte représente une unité de l'organisation au sein de Canvas (par exemple, le compte parent pour une institution). Chaque compte peut contenir une hiérarchie de sous-comptes, tels que la création de comptes pour les collèges individuels au sein d'une institution, ou pour chaque école au sein d'un district. Les sous-comptes peuvent également contenir plusieurs sous-comptes, comme quand un collège se subdivise en départements ou programmes, ou quand une école se subdivise en niveaux de notes ou sujets.

Téléchargez un fichier exemple accounts.csv avec les sous-comptes suivants :

  • 3 sous-comptes dans votre compte principal / racine. (Arts & Sciences humaines, Commerce, Mathématiques & Science)
  • 4 sous-comptes dans votre sous-compte Commerce. (Comptabilité, Science Informatique, Economie, et Marketing)
  • 3 sous-comptes à l'intérieur de votre sous-compte Mathématiques & Science (Biologie, Physique et Statistiques)
  • 1 sous-compte à l'intérieur de votre sous-compte Arts et Sciences Humaines. (Arts Visuels)
  • 2 sous-comptes dans votre sous-compte Arts visuels. (Photographie et médias numériques)

Champ requis* | Champ adhésif^

  • account_id* :  Il s'agit de l'identifiant unique utilisé pour créer un sous-compte. Le fichier cours.csv vous permettra d'attribuer des cours à un identifiant particulier de compte. Cet identifiant unique ne doit pas changer pour le compte et doit être en général unique sur tous les comptes. Dans l'UI Canvas, il s'appelle l'ID SIS et peut être modifié en consultant les Paramètres de chaque sous-compte respectif.
  • parent_account_id*^ : Cet identifiant indique qu'un sous-compte doit être imbriqué à son compte parent. Si ce champ est vide, alors le sous-compte sera imbriqué à votre compte racine ou principal. Notez que même si toutes les valeurs sont vides, la colonne doit être insérée pour différencier le fichier de l'importation du groupe.
  • name*^ :  C'est le nom du sous-compte.
  • status* : Il s'agit de la façon dont vous pouvez créer ou supprimer un sous-compte. Cochez actif pour ajouter un sous-compte ou supprimé pour retirer un sous-compte existant.
  • integration_id : Il s'agit de l'identifiant unique secondaire utilisé pour les intégrations SIS plus complexes. Cet identifiant ne doit pas changer pour le compte, et doit être totalement unique.

terms.csv

Un trimestre fournit un ensemble par défaut de dates de début et de fin aux cours assignés à ce trimestre. Les dates de ce trimestre de cours peuvent être gérées manuellement au niveau du cours sans un fichier d'importation. Toutefois, relier un term_id à plusieurs cours différents assure que tous les cours de ce trimestre commenceront/finiront en même temps. Les dates de trimestre téléchargées vous aideront également à classer et à organiser des cours en visualisant les données et les rapports dans l'interface Administrateur.

Téléchargez un fichier exemple terms.csv avec 10 trimestres

Champ requis* | Champ adhésif^

  • term_id* :  Il s'agit de l'unique identifiant pour le trimestre. Le cours.csv vous permettra de faire référence à ce term_id afin que vos cours connaissent le début et la fin. Cet identifiant ne doit pas changer pour le trimestre, et doit être globalement unique pour tous les trimestres. Dans l'interface utilisateur, cela s'appelle l'ID SIS.
  • name*^ :  C'est le nom de votre trimestre. Utiliser une bonne convention d'appellation vous aidera à référencer facilement vos trimestres.  Il existe de nombreux outils administrateurs qui vous permettront de rechercher ou d'interroger des données à partir du nom du trimestre.
  • status* :  Il s'agit de la façon dont vous pouvez créer ou supprimer un trimestre. Cochez actif pour ajouter un trimestre ou supprimé pour retirer un trimestre existant.
  • start_date^ :  Il s'agit de la date à laquelle le trimestre commence. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ (le T peut être remplacé par un espace, comme vu sur l'impression écran exemple). Par exemple 26 août 2013 à 5:00pm EST sera écrit 2013-08-26T17:00-5:00
  • end_date^ :  Il s'agit de la date à laquelle le trimestre se termine. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ (le T peut être remplacé par un espace, comme vu sur l'impression écran exemple). Par défaut, l'accès des utilisateurs est coupé à minuit à la date de fin indiquée, c'est-à-dire que le jour précédent est le dernier jour complet auquel les utilisateurs ont accès au trimestre. La meilleure pratique consiste à fixer votre date de fin au lendemain du trimestre.
  • integration_id : Il s'agit de l'identifiant unique secondaire utilisé pour les intégrations SIS plus complexes. Cet identifiant ne doit pas changer pour la période, et doit être totalement unique.
  • date_override_enrollment_type: Il est ainsi possible de définir ou de supprimer les dates de début et de fin pour un type d'inscription spécifique dans une période d'échéance existante. Lorsqu'elle est définie, toutes les colonnes sauf term_id, status, start_date et end_date doivent être ignorées pour la ligne. Si le statut est activé, les dates de trimestre s'appliquent uniquement aux inscriptions du type donné. Si le statut est défini sur supprimé, les dates actuellement définies seront supprimées pour le type d'inscription donné. Le type d'inscription peut être défini sur StudentEnrollment, TeacherEnrollment, TaEnrollment ou DesignerEnrollment.

courses.csv

Un cours est la présentation organisée d'un sujet particulier. Parfois, un cours peut inclure une série de cours. Les cours sont placés dans les trimestres pour créer des dates de début et de fin par défaut. Toutefois, si un cours comprend des dates précises de cours, ces dates remplacent les dates d'accès des élèves au cours du trimestre, identifiées par le term_id (si inclus). L'intérêt de lier un term_id est que vous pourrez classer et organiser les cours en visualisant les données et les rapports, dans l'interface Administrateur. Un term_id peut être facilement lié à plusieurs cours différents qui commencent/finissent en même temps. Si vous ne liez pas un cours à un trimestre, alors ce cours sera lié au trimestre appelé Trimestre par défaut.

Si votre institution a activé les Projets de cours, vous pouvez utiliser un courses.csv pour ajouter des cours associés à un Projet de cours. Veuillez noter que le Projet de cours doit être créé et activé en tant que Projet de cours avant que des cours associés ne puissent être ajoutés.

Téléchargez un fichier exemple courses.csv avec 10 cours ; ils sont intégrés à leurs sous-comptes respectifs pendant un trimestre spécifique.

Champ requis* | Champ adhésif^

  • course_id* :  Il s'agit de l'unique identifiant utilisé pour différencier les cours dans Canvas. Cet identifiant ne doit pas changer pour le cours, et doit être globalement unique pour tous les cours. Dans l'interface utilisateur, cela s'appelle l'ID SIS.
  • short_name*^ :  Il s'agit d'un nom abrégé pour le cours. Dans l'UI de Canvas, cela s'appelle également le Code du cours ou Code de référence.
  • long_name*^ :  Il s'agit du nom long (complet) pour le cours. (Il peut être identique au nom court, mais si deux noms sont disponibles, fournir les deux permettra une meilleure expérience utilisateur).
  • account_id^ :  Il s'agit de l'identifiant unique du compte SIS ID (extrait du fichier accounts.csv) qui indique au cours sous quel sous-compte il résidera. Si une account_id n'est pas spécifiée pour un nouveau cours, le cours sera alors rattaché à votre compte principal/racine. Le SIS ID se trouve dans les paramètres du sous-compte.
  • term_id^ :  Il s'agit de l'identifiant unique du trimestre (à partir du terms.csv) qui indiquera quand commence et finit le cours. En associant une term_id à un cours, il ne sera pas nécessaire de renseigner une start_date ou end_date.
  • status*^ :  Il s'agit de la façon donc vous pouvez créer, supprimer, clôturer ou publier un cours. Marquer comme Actif pour ajouter un cours, Supprimé pour supprimer un cours existant, Achevé pour clôturer un cours existant, ou Publié pour publier un cours existant.
  • integration_id : Il s'agit de l'identifiant unique secondaire utilisé pour les intégrations SIS plus complexes. Cet identifiant ne doit pas changer pour le cours, et doit être totalement unique.
  • start_date^ :  Il s'agit de la date à laquelle le cours commence. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ (le T peut être remplacé par un espace)
  • end_date^ :  Il s'agit de la date à laquelle le cours se termine. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ (le T peut être remplacé par un espace) Par défaut, l'accès des utilisateurs est coupé à minuit à la date de fin indiquée, c'est-à-dire que le jour précédent est le dernier jour complet auquel les utilisateurs ont accès au cours. La meilleure pratique consiste à fixer votre date de fin au lendemain du cours.
  • course_format : C'est le format du cours. Le format peut être en ligne, on_campus, ou combiné.
  • blueprint_course_id : Il s'agit de l'identifiant de cours du projet auquel vous souhaitez ajouter un cours associé. Pour supprimer le lien Projet de cours, vous pouvez faire passer « dissociate » en lieu et place de l'identifiant. Dans l'interface utilisateur, il s'agit de l'identifiant SIS du projet de cours.
  • homeroom_course : Ceci est utilisé pour désigner les cours de salle de classe pour les comptes « Canvas élémentaire ». Nécessite l'activation du paramètre Canvas élémentaire (Canvas for for Elementary).

sections.csv

Une section subdivise les élèves dans un cours. Plusieurs sections peuvent aussi être communes à un cours, surtout si toutes les sections d'élèves apprennent le même matériau de cours. Plusieurs sections peuvent être placées dans un cours, mais une section ne peut pas contenir plusieurs sections. Les sections héritent des dates de cours telles que fixées par le trimestre. Toutefois, si une section comprend des dates précises, ces dates remplaceront les dates d'accès des élèves au cours et les dates de début et/ou de fin.

Si vous essayez de supprimer un cours et que les utilisateurs sont associés à des sections, vous aurez besoin d'inclure le paramètre section_id dans l'importation CSV ainsi que les ID SIS de la section.

Téléchargez un fichier exemple sections.csv avec les sections suivantes :

  • 4 sections dans le cours ACCT300 - Comptabilité Analytique
  • 4 sections dans le cours ACCT310 - Comptabilité Financière
  • 2 sections dans le cours BIO101 - Introduction à la Biologie

Ce fichier suppose que vous pouvez avoir plusieurs sections à l'intérieur d'un même cours. De nombreuses institutions importent les sections de cours comme des cours distincts. Cela peut être fait par (1) la création d'un cours Canvas pour chaque section dans votre cours.csv, puis (2) la création d'une section unique dans chacun de ces cours. Vous pouvez principalement utiliser les mêmes données pour le cours et la section, y compris l'ID SIS qui sera le même pour à la fois cours_id et section_id.

Champ requis* | Champ adhésif^

  • section_id* :  Il s'agit de l'identifiant unique utilisé pour créer des sections à l'intérieur d'un cours. Cet identifiant ne doit pas changer pour la section, et doit être globalement unique. Dans l'interface utilisateur, cela s'appelle l'ID SIS.
  • course_id*^ :  Il s'agit de l'identifiant unique du cours dans lequel la section peut être ajoutée ou supprimée (ajoutée dans courses.csv).
  • name*^ :  Il s'agit du nom de la section. Sections are ordered alphabetically by name.
  • status* :  Il s'agit de la façon dont vous pouvez créer ou supprimer une section à l'intérieur d'un cours. Cochez comme actif pour créer une section ou supprimé pour retirer une section existante.
  • integration_id : Il s'agit de l'identifiant unique secondaire utilisé pour les intégrations SIS plus complexes. Cet identifiant ne doit pas changer pour la section, et doit être globalement unique.
  • start_date^ :  Il s'agit de la date à laquelle la section commence. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ (le T peut être remplacé par un espace)
  • end_date^ :  Il s'agit de la date à laquelle la section se termine. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ (le T peut être remplacé par un espace) Par défaut, l'accès des utilisateurs est coupé à minuit à la date de fin indiquée, c'est-à-dire que le jour précédent est le dernier jour complet auquel les utilisateurs ont accès à la section. La meilleure pratique consiste à fixer votre date de fin au lendemain de la section.

enrollments.csv

Une inscription représente un utilisateur qui a été inscrit à un cours dans un rôle spécifique. Une inscription.csv vous permet d'attribuer des rôles aux utilisateurs et de les placer dans les cours appropriés. Lorsque le statut de l'inscription des utilisateurs est marqué comme terminé, ils seront limités à un accès en lecture seule à ce cours.

Remarque : Les fichiers CSV d'inscription SIS qui incluent les valeurs start_date et end_date remplacent les dates des sessions, les dates des cours et les dates des sections.

Téléchargez un fichier exemple enrollments.csv avec les inscriptions suivantes :

  • 1 utilisateur comme enseignant dans le cours ACCT300 - Comptabilité Analytique
  • 1 utilisateur comme ae dans le cours ACCT300 - Comptabilité Analytique
  • 1 utilisateur comme concepteur dans le cours ACCT300 - Comptabilité Analytique
  • 3 utilisateurs comme élèves dans la section 1 du cours ACCT300 - Comptabilité Analytique
  • 3 utilisateurs comme élèves dans la section 2 du cours ACCT300 - Comptabilité Analytique
  • 1 utilisateur comme observateur d'un élève dans la section 1 du cours ACCT300 - Comptabilité Analytique

Champ requis* | Champ adhésif^

  • course_id* :  (Requis si la section_id manque) Il s'agit de l'identifiant unique pour le cours dans lequel l'utilisateur sera inscrit (ajouté dans courses.csv). Pour l'inscription des élèves dans un cours plutôt que dans une section spécifique, renseignez la course_id dans ce champ. Dans le cas contraire, laissez-le vide.
  • root_account : Il s'agit du domaine du compte pour rechercher l'utilisateur.
  • start_date^ : Il s'agit de la date de début de l'inscription. Pour que start_date prenne effet, le champ end_date doit également être renseigné. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ.
  • end_date^ : Il s'agit de la date de fin de l'inscription. Pour que end_date prenne effet, le champ end_date doit également être renseigné. Le format doit être en ISO 8601: AAAA-MM-JJTHH:MM:SSZ.
  • user_id*:  Il s'agit de l'identifiant unique de l'utilisateur qui sera inscrit dans les cours désignés (ajouté dans users.csv). Si user_integration_id est présent, ce champ sera ignoré.
  • user_integration_id* : (Requis si user_id est absent) Il s'agit de l'identifiant unique secondaire de l'utilisateur (ajouté dans users.csv en tant qu'integration_id).
  • role* :  Il s'agit du rôle assigné à un utilisateur pour le cours désigné. Vous inscrivez un utilisateur ayant l'un des rôles suivants : enseignant, concepteur, ae, élève, observateur ou un rôle personnalisé que vous définissez.  Chaque rôle a un ensemble de droits que les Administrateurs peuvent personnaliser sur le compte principal/racine ou au niveau du sous-compte.
  • role_id* : (Requis si le rôle manque) Il s'agit de l'identifiant unique du rôle dans lequel l'utilisateur sera ajouté dans le cadre d'une inscription.
  • section_id* :  (Requis si la cours_id est absent) Il s'agit de l'identifiant unique pour la section dans laquelle l'utilisateur sera inscrit (ajouté à sections.csv). Pour l'inscription des élèves dans une section spécifique d'un cours, renseignez ici la section_id de la section. Dans le cas contraire, laissez ce champ vide. Si aucune section_id n'est spécifiée, la section par défaut pour le cours sera utilisée. Si une section par défaut n'existe pas, une sera automatiquement créée sans une ID SIS.
  • status* : Il s'agit de la façon dont vous inscrivez, clôturez, désactivez (rendez inactive) ou supprimez une inscription à un cours. Cochez comme actif pour inscrire un utilisateur dans un cours, terminé pour achever l'inscription d'un utilisateur dans un cours, inactif pour désactiver l'utilisateur dans le cours ou supprimé pour retirer un utilisateur d'un cours. Lorsque l'état de l'élève est « inactif », il sera répertorié dans la liste des cours de l'instructeur, mais il ne sera pas en mesure d'afficher le cours ou d'y participer tant que l'inscription ne sera pas activée.  
  • associated_user_id :  (Fonction observateur uniquement)  Il s'agit de l'identifiant unique de l'utilisateur pour lequel l'observateur pourra visualiser les informations (y compris les notes). L'observateur devrait être inscrit dans le/la même cours/section que l'utilisateur que vous souhaitez qu'il observe. Ce champ sera ignoré pour tout autre rôle que celui d'observateur.
  • limit_section_privileges : Il s'agit de la façon dont l'inscription permettra à l'utilisateur de voir et d'interagir avec les utilisateurs inscrits dans la section donnée par course_section_id. Ce champ se met par défaut sur faux. Limiter les élèves à interagir par section affecte uniquement Collaborations, Discussion, Personnes et Conversations. Lors de l'inscription des instructeurs et des AE, les limitations de section permettent à ces utilisateurs de noter les élèves dans leur(s) même(s) section(s). Les sujets de discussion et les pages ne sont pas affectés par les limitations de section et peuvent être visualisés par un élève. Ces fonctions peuvent être restreintes en créant du contenu dans des groupes de cours.
  • notifier : C'est ainsi que vous choisissez d'envoyer une notification à l'utilisateur ou aux utilisateurs inscrits lorsqu'ils sont inscrits à un cours.

group_categories.csv

Les catégories de groupe vous permettent d'organiser des groupes dans Canvas Un fichier group_categories.csv vous permet de créer des catégories de groupe au niveau du compte ou du cours. Dans l'interface utilisateur, les catégories de groupe sont appelées ensembles de groupes.

Téléchargez un fichier exemple de group_categories.csv avec les catégories de groupes suivantes :

  • Groupes d'administration
  • Groupes de concepteurs
  • Historique Groupes de projets

Champ requis* | Champ adhésif^

  • group_category_id : Il s'agit de l'identifiant utilisé pour référencer votre catégorie de groupe. L'identifiant ne doit pas changer pour la catégorie de groupe, et doit être globalement unique.
  • account_id : L'identifiant qui relie la catégorie de groupe à un compte (ajouté dans accounts.csv). Si aucun compte ou cours n'est spécifié, le groupe sera relié au compte racine.
  • course_id : Il s'agit de l'identifiant qui relie la catégorie de groupe à un cours (ajouté dans courses.csv). Si aucun compte ou cours n'est spécifié, le groupe sera relié au compte racine.
  • category_name*^ : Il s'agit du nom de la catégorie de groupe.
  • status* : Il s'agit du statut de la catégorie de groupe. Marquez-le comme active pour créer la catégorie de groupe ou comme supprimée pour supprimer la catégorie de groupe.

groups.csv

Un groupe peut être utilisé pour renforcer les opportunités de collaboration pour les élèves, les instructeurs, les administrateurs ou les autres utilisateurs. Un fichier groups.csv vous permet également de créer des groupes au niveau du compte et des groupes au niveau du cours. Les groupes transférés via SIS ne peuvent être mis à jour ou supprimés que via SIS.

Téléchargez un fichier exemple groups.csv avec les groupes suivantes :

  • Administrateurs
  • Professeur de mathématiques
  • Concepteurs

Champ requis* | Champ adhésif^

  • group_id* : Il s'agit de l'identifiant unique utilisé pour référencer votre groupe. Il ne doit pas changer pour le groupe et il doit être globalement unique.
  • group_category_id : Il s'agit de l'identifiant de la catégorie de groupe (ajouté dans group_categories.csv) dans laquelle vous ajoutez un groupe. Si aucune catégorie de groupe n'est spécifiée, le groupe sera placé dans la catégorie de groupe par défaut pour le compte ou le cours définis. Si aucun compte ou cours n'est spécifié, le groupe sera placé dans la catégorie de groupe par défaut au compte racine.
  • account_id : L'identifiant qui relie le groupe à un compte (ajouté dans accounts.csv). Si aucun n'est spécifié, le groupe sera relié au compte racine.
  • course_id : Il s'agit de l'identifiant qui relie le groupe à un cours (ajouté dans courses.csv). Si aucun compte ou cours n'est spécifié, le groupe sera relié au compte racine.
  • name*^ : Il s'agit du nom du groupe.
  • status* : Désigne le statut du groupe. Marquez-le comme disponible pour que le groupe soit ouverts aux inscriptions ou comme supprimé pour supprimer le groupe.

groups_membership.csv

L'adhésion à un groupe permet aux utilisateurs de participer aux activités dans Canvas. Un groups_membership.csv vous permet d'ajouter ou de supprimer en masse des personnes à un groupe que vous avez créé via groups.csv.

Téléchargez un fichier exemple de groups_membership.csv avec les adhésions aux groupes suivantes :

  • 1 utilisateur accepté dans le groupe des administrateurs
  • 1 utilisateur accepté dans le groupe des enseignants de maths
  • 1 utilisateur supprimé dans le groupe des enseignants de maths

Champ requis*

  • group_id* : Il s'agit de l'identifiant unique utilisé pour référencer votre groupe (ajouté à groups.csv).
  • user_id*: Il s'agit de l'identifiant unique de l'utilisateur que vous souhaitez ajouter au groupe (ajouté à users.csv).
  • status* : Désigne le statut des utilisateurs dans le groupe. Marquez-le comme accepté pour ajouter un utilisateur à un groupe ou comme supprimé pour retirer un utilisateur d'un groupe.

xlists.csv

Les listes croisées vous permettent de déplacer des sections dans un autre cours. Un fichier xlist.csv vous permettra de croiser des sections dans des cours existants et de créer une hiérarchie des sections.

Les ID de sections sont censés déjà exister et déjà référencer d'autres ID de cours. Si un ID de section est fourni dans ce fichier, il sera déplacé vers un nouvel ID de cours de façon à ce que le nouveau cours ou sa liste croisée soit déplacés. La section retrouvera alors son ID de cours précédent. Si xlist_course_id ne contient aucun cours existant, il sera créé. Si vous souhaitez fournir plus d'informations sur sur le cours croisé, faites-le dans le fichier courses.csv.

Téléchargez un exemple de fichier xlists.cvs avec les cours et sections suivants :

  • 4 sections actives du cours ACCT300 - Comptabilité de coûts croisés dans le cours ACCT310 - Comptabilité managériale

Champ requis*

  • xlist_course_id* : L'identifiant du nouveau cours (ajouté dans courses.csv).
  • section_id* : L'identifiant de la section (ajouté dans sections.csv).
  • status* : Le statut de la section. Marquez-le comme active pour que la section soit active ou comme supprimée pour supprimer la section.

user_observers.csv

Le rôle d'Observateur peut être utilisé pour inscrire les parents et les relier à un élève, ce qui leur permet d'afficher les notes de leurs élèves et les interactions du cours. Un user_observers.csv vous permet d'inscrire et de lier des observateurs à chacune des inscriptions de l'élève désigné.

Téléchargez un fichier exemple user_observers.csv avec les inscriptions suivantes :

  • 2 observateurs actifs
  • 1 observateur supprimé

Champ requis*

  • observer_id* : Il s'agit de l'identifiant unique de l'observateur (ajouté en tant qu'user_id dans users.csv).
  • student_id* : Il s'agit de l'identifiant unique de l'élève (ajouté en tant qu'user_id dans users.csv).
  • status* : Le statut de l'observateur. Marquez-le comme actif pour enrôler l'observateur pour chacune des entrées d'élève ou comme supprimé pour supprimer l'ensemble des entrées de l'observateur.

logins.csv

Le fichier logins.csv vous permet de créer ou de mettre à jour les informations d'identification de vos utilisateurs. Ces identifiants peuvent uniquement être ajoutés à des utilisateurs existants. Les identifiants peuvent être supprimés à l'aide du fichier users.csv.

Téléchargez un fichier exemple logins.csv avec les trois identifiants d'utilisateurs.

Champ requis*  | Champ adhésif^

  • user_id*: Il s'agit de l'identifiant unique de l'utilisateur (référencé par enrollments.csv). Cette valeur ne doit pas être changée pour l'utilisateur, et doit être unique pour tous les utilisateurs. SIS ID appelé dans l'interface utilisateur Canvas.
  • integration_id : Il s'agit de l'identifiant unique secondaire utilisé pour les intégrations SIS complexes. Cette valeur ne doit pas être changée pour l'utilisateur, et doit être unique pour tous les utilisateurs. Ce champ doit être laissé vierge lors de la fusion d'utilisateurs dont les ID d'intégration correspondent.
  • login_id*: Il s'agit du nom utilisé par l'utilisateur pour se connecter à Canvas. Pour les services d'authentification configurés tels que LDAP, cela correspond au nom d'utilisateur du système distant.
  • mot de passe : Il s'agit du mot de passe utilisé par l'utilisateur pour se connecter à Canvas. Ce champ ne doit pas être rempli pour les comptes configurés pour LDAP ou SSO.
  • ssha_password : Il s'agit d'un mot de passe généré avec un schéma de génération pré-haché SSHA.
  • authentication_provider_id: Il s'agit du fournisseur d'authentification auquel la connexion est associée.
  • existing_user_id^: Il s'agit de l'ID SIS de l'utilisateur, tel qu'il peut être trouvé dans le fichier users.csv.
  • existing_integration_id^: Il s'agit de l'ID d'intégration de l'utilisateur, tel qu'il peut être trouvé dans le fichier users.csv.
  • existing_canvas_user_id^: Il s'agit de l'ID Canvas de l'utilisateur.
  • root_account : Il s'agit du compte de domaine de l'utilisateur.
  • e-mail : Il s'agit de l'adresse e-mail de l'utilisateur.

Remarques :

  • Pour pouvoir importer logins.csv, il est nécessaire qu'au moins un des champs suivants soit rempli : existing_user_id, existing_integration_id ou existing_canvas_user_id.
  • Le champ root_account est requis lors de l'identification des utilisateurs d'un compte Trust (c'est-à-dire, lors du transfert des utilisateurs entre les comptes au sein d'un compte trust.

admins.csv

Les administrateurs gèrent les paramètres d'un compte entier ou d'un sous-compte. Un admins.csv vous permet de désigner des utilisateurs dans Canvas en tant qu'administrateurs de compte ou d'autres rôles personnalisés de compte ou sous-compte.

Téléchargez un fichier exemple admins.csv avec les administrateurs suivants :

  • 2 administrateurs compte actifs
  • 1 administrateur compte supprimé
  • 2 fonctions de compte personnalisés actifs

Champ requis*

  • user_id*: Il s'agit de l'identifiant unique de l'utilisateur que vous souhaitez désigner en tant qu'administrateur (ajouté dans users.csv).
  • account_id* : Il s'agit de l'identifiant unique du compte sur lequel vous souhaitez intégrer l'administrateur (ajouté dans accounts.csv). Si cette colonne est laissée vide, l'utilisateur est intégré au compte racine. Il est toujours requis de compléter cette colonne, même si la valeur est nulle.  
  • role_id* : (Requis si le rôle manque) Il s'agit de l'identifiant du rôle, soit par défaut ou personnalisé, défini par le compte.
  • role* : (Requis si le role_id manque) Il s'agit du nom du rôle, soit l'administrateur du compte par défaut, soit un rôle personnalisé défini par le compte. Si vous ajoutez un administrateur de compte, formatez le champ à lire 'AccountAdmin'. Si vous ajoutez un rôle personnalisé, formatez le champ exactement comme il apparaît dans l'interface utilisateur de Canvas.
  • status* : Il s'agit du statut de l'administrateur. Cochez comme actif pour créer un administrateur actif ou supprimé pour supprimer un administrateur.
  • root_account : Il s'agit du domaine du compte pour rechercher l'utilisateur.

change_sis_id.csv

Un identifiant SIS est un identifiant unique pour un objet dans Canvas. Un change_sis_id.csv vous permet de convertir en masse des identifiants SIS pour les comptes, les trimestres, les cours, les sections, les groupes ou les utilisateurs existants.

Téléchargez un fichier exemple change_sis_id.csv avec les modifications des identifiants SIS suivants :

  • 1 modification de l'identifiant SIS d'un utilisateur
  • 1 modification de l'identifiant SIS d'un cours
  • 1 modification de l'identifiant SIS d'un trimestre

Champ requis*

  • old_id* : Il s'agit de l'identifiant SIS actuel de l'objet.
  • new_id* : Il s'agit de l'identifiant SIS souhaité de l'objet. Le nouvel identifiant SIS doit être actuellement unique au type d'objet et au compte racine.
  • type* : Il s'agit du type d'objet. Type peut être un compte, un trimestre, un cours, une section, un groupe ou un utilisateur.