Cette rubrique explique les conventions et les exigences relatives aux formats de fichiers D2L Standard CSV.
Formats acceptés pour les fichiers D2L Standard CSV
Les formats de fichier acceptés par CSV standard D2L sont les suivants :
- Organisations
- Utilisateurs
- Inscriptions
- Attributs relatifs aux outils Tableau de bord du gestionnaire et Groupes d’apprentissage
- Un fichier Manifest est requis si vous utilisez la version 1.1 ou une version ultérieure de D2L Standard CSV
Format d’archive ZIP pour les fichiers D2L Standard CSV
Les fichiers CSV doivent être combinés dans une archive ZIP. La convention d’appellation recommandée pour les archives ZIP est la suivante :
- D2LStdCSV-{AAAAmmjjHHMMSS}.zip
|
Remarque : Vous ne pouvez téléverser que des archives .zip (minuscules sensibles à la casse) vers SFTP. |
Les fichiers sont traités en ordre alphabétique. D2L recommande d’organiser les fichiers individuels dans l’archive comme suit :
- Organisations
- utilisateur
- Inscriptions
- Attributs
Conventions d’appellation recommandées pour les fichiers D2L Standard CSV :
La convention d’appellation recommandée pour les fichiers individuels dans une archive .zip est la suivante :
- 01 - Autre - {AAAAmmjjHHMMSS}.csv
- 02 - Départements - {AAAAmmjjHHMMSS}.csv
- 03 - Semestres - {AAAAmmjjHHMMSS}.csv
- 04 - Modèles - {AAAAmmjjHHMMSS}.csv
- 05 - Offres de cours - {AAAAmmjjHHMMSS}.csv
- 06 - Sections - {AAAAmmjjHHMMSS}.csv
- 07 - Utilisateurs - {AAAAmmjjHHMMSS}.csv
- 08 - Inscriptions - {AAAAmmjjHHMMSS}.csv
- 09 - Attributs - {AAAAmmjjHHMMSS}.csv
- manifest.json
|
Remarque : La convention d’appellation de fichier CSV 01 - Autre est utilisée pour traiter des unités organisationnelles personnalisées en dehors de la structure organisationnelle D2L standard et nécessite la version D2L Standard CSV 2.0 ou une version supérieure. |
Règles courantes relatives au contenu des fichiers CSV
- Les valeurs des fichiers sont sensibles à la casse.
- Une valeur vide est représentée par deux virgules sans espace entre elles. Par exemple :
- ,, indique une valeur vide
- , , indique un caractère d’espace, qui est analysé comme une valeur non valide.
-
Les fichiers CSV doivent avoir un en-tête (première ligne) qui doit correspondre exactement (casse et virgules).
- Les fichiers CSV doivent être encodés au format UTF-8.
- Les fichiers CSV devraient contenir des données différentielles de SIS, plutôt que des données complètes.
-
L'envoi d'une MISE À JOUR lorsque l'objet n'existe pas devient une demande de CRÉATION. Les actions courantes sont uniquement la MISE À JOUR et la SUPPRESSION.
- Les fichiers CSV et manifest doivent être inclus dans une archive .zip.
- Un fichier Manifest est requis si vous utilisez l'intégration CSV standard D2L version 1.1 ou ultérieure. Le fichier Manifest est un fichier JSON qui annonce la version de CSV standard D2L que vous utilisez. Pour en savoir plus, reportez-vous à la rubrique Manifest.
-
La pratique exemplaire est de ne pas inclure de renseignements personnels comme le numéro d’assurance sociale de l’utilisateur dans les ID définis par l’organisation.
Règles pour les unités organisationnelles
Les types d’unités organisationnelles énumérés ci-dessous sont pris en charge par D2L Standard CSV :
- Autres unités organisationnelles (les unités organisationnelles personnalisées qui ne font pas partie de la structure organisationnelle standard de D2L sont prises en charge par les versions 2.0 et ultérieures de D2L Standard CSV)
- Départements
- Semestres
- Modèles de cours
- Offres de cours
- Sections
Le traitement de ces unités organisationnelles crée la structure organisationnelle dans votre instance de Brightspace.
Règles :
- Brightspace peut accepter autant d’unités organisationnelles que nécessaire.
- Les organisations doivent être transmises au moins une fois pour indiquer à la plateforme D2L Standard CSV les unités organisationnelles qu’elle pourra contrôler. Lorsque l'intégration contrôle une unité organisationnelle, toutes les modifications ultérieures apportées à cette UO devront uniquement être effectuées par le biais de l'intégration D2L Standard CSV afin d'assurer la propriété exacte des données.
- Si vous envoyez un grand nombre de types d'unité organisationnelle dans un seul fichier CSV, assurez-vous que leur hiérarchie est respectée dans le fichier (par exemple, le type Départements doit être envoyé avant Modèles de cours). Une tentative d'envoi d'une UO primaire avant la création d'une UO secondaire entraînera l'échec de l'opération.
- Si vous envoyez des relations d’utilisateur, assurez-vous que le fichier respecte la hiérarchie vérificateurs et/ou parents/tuteurs (p. ex., les parents ou tuteurs doivent être envoyés avant les apprenants). Le non-respect de cette directive entraînera l'échec de la relation.
- La convention d’appellation du nom et du code de l’unité organisationnelle doit suivre celle décrite dans votre SIS.
- Les noms et les codes d’unités organisationnelles peuvent être fournis tels quels par le biais de fichiers CSV tant qu’ils respectent les exigences de Brightspace en matière de caractères non valides et qu’ils sont uniques au niveau des différentes unités organisationnelles.
- Les codes d'unité organisationnelle sont limités à 50 caractères. S'ils sont plus longs, ils sont automatiquement tronqués à 50, ce qui peut entraîner des doublons dans Brightspace ou l'échec de la création d'une unité organisationnelle.
- Les codes d’unités organisationnelles ne prennent pas en charge les caractères suivants : , : % & # * ? < > | \ " ' et espaces de début ou de fin.
D2L Standard CSV peut effectuer ce qui suit :
- Créer une nouvelle unité organisationnelle, si elle n'existe pas déjà.
- Effectuer la mise en correspondance avec une UO existante créée par une source différente de D2L Standard CSV (si l'option de mise en correspondance est sélectionnée dans la configuration).
- Mettre à jour le nom d'une UO qu'elle contrôle.
- Attribuer et supprimer des unités organisationnelles personnalisées en tant qu’unités primaires des autres unités organisationnelles personnalisées, départements, semestres, modèles de cours, offres de cours et sections de cours (applicables aux version 2.0 et ultérieures de D2L Standard CSV).
- Modèle de cours : Attribuer et mettre à jour un département primaire basé sur le code de département
- Offre de cours : Attribuer et mettre à jour un modèle de cours et un semestre primaires basés sur le code primaire
- Offre de cours : Mettre à jour tous les détails de cours, y compris le nom et les dates. Offres de cours inactives.
- Section de cours : La suppression d'une section de cours désinscrit automatiquement les utilisateurs de la section supprimée.
- Supprimer une UO qu'elle contrôle.
D2L Standard CSV ne peut pas effectuer ce qui suit :
- Mettre à jour les codes d'unité organisationnelle.
- Supprimer les UO créées de façon manuelle, à moins qu'elles n'aient été mises en correspondance avec l'intégration CSV standard D2L.
- Supprimer une unité organisationnelle qui comprend des liens vers des UO secondaires (les UO secondaires doivent être supprimées en premier). Un exception est déclenchée si des sections sont configurées de sorte à être supprimées dans l’interface, des offres de cours peuvent être supprimées si elles sont liées à une section.
Règles pour les utilisateurs
Les enregistrements d’utilisateur peuvent créer, mettre à jour, désactiver ou supprimer des utilisateurs dans Brightspace. Le type de dossier Utilisateur peut également créer, mettre à jour ou supprimer la relation primaire-secondaire dans Brightspace.
Règles
- Les utilisateurs doivent être transmis au moins une fois pour indiquer à l’intégration les utilisateurs qui peuvent être créés, mis à jour ou supprimés ainsi que les inscriptions qui peuvent être gérées.
- Le prénom et le nom de famille ne prennent pas en charge les caractères suivants : \ / : * ? " < > | @, ;
- Le nom d’utilisateur et l’ID défini par l’organisation ne prennent pas en charge les caractères suivants : / : * ? " < > | ', ;
- L’adresse courriel ne prend pas en charge les caractères suivants : ( ) < > [ ] | \ ; : , “
L’intégration D2L Standard CSV permet les opérations suivantes :
- Créer un utilisateur et l’inscrire dans l’organisation.
- Établir une correspondance entre un utilisateur et un utilisateur existant ayant le même ID ou nom d’utilisateur défini par l’organisation.
- Mettre à jour le nom d'utilisateur, le prénom, le nom de famille, le mot de passe et l'adresse courriel.
- Mettre à jour le prénom et le nom de famille préférés (versions 2.0 et ultérieures de D2L Standard CSV).
- Mettre à jour le nom de famille triable (versions 2.1 et ultérieures de D2L Standard CSV).
- Mettre à jour les pronoms (versions 3.0 et ultérieures de D2L Standard CSV).
- Le mot de passe n'est pas requis et il est recommandé de ne pas le transmettre si vous utilisez l'authentification unique (SSO).
- Actualiser le rôle de niveau d'organisation.
- Activer, désactiver ou supprimer un utilisateur
- Créer, mettre à jour ou supprimer des relations parent/tuteur/enfant pour Brightspace pour les parents et les tuteurs (versions 1.1 et ultérieures de D2L Standard CSV).
- Mettre à jour une relation vérificateur-vérifié (versions 2.0 et ultérieures de D2L Standard CSV).
L’intégration D2L Standard CSV ne permet pas les opérations suivantes :
- Mettre à jour l'ID défini par l'organisation; cette opération peut toutefois être effectuée manuellement dans l'interface Administration d'IPSIS.
- Supprimer des utilisateurs créés de façon manuelle, à moins qu'ils n'aient été mis en correspondance avec D2L Standard CSV.
|
Remarque : Pour les utilisateurs de certains pays, dont les Pays-Bas, la Belgique et le Sri Lanka, les noms de famille peuvent avoir un ou plusieurs préfixes (connus en néerlandais sous le nom de « Tussenvoegsel ») qui font partie du nom de famille officiel. Dans certains cas, le nom de famille triable ne doit pas inclure ces préfixes. Les administrateurs peuvent indiquer si le nom de famille officiel d’un utilisateur diffère du nom de famille triable. Si les clients incluent un nom de famille triable, Brightspace utilise le nom de famille triable lors du classement alphabétique des listes d’utilisateurs. Le nom de famille triable est offert dans les versions 2.1 et ultérieures de D2L Standard CSV. |
Règles pour les inscriptions
Le traitement des enregistrements d’inscription inscrit ou désinscrit des utilisateurs dans une unité organisationnelle spécifique de Brightspace.
Règles :
Les enregistrements d’inscription doivent être envoyés lorsque des modifications sont apportées au système d’information.
- Une désinscription ne doit être envoyée qu’une seule fois. Le renvoi d’une désinscription entraîne l’affichage d’un avertissement dans votre journal IPSIS.
- Lorsque vous utilisez des sections dans les offres de cours, fournissez des enregistrements d’inscription uniquement pour les sections. L’inscription à l’offre de cours est implicite et gérée par IPSIS.
- L’envoi d’enregistrements d’inscription pour les offres de cours et les sections, mais l’envoi de désinscriptions pour les sections seulement peut entraîner la réinscription erronée des utilisateurs dans les offres de cours pendant la fusion de cours.
L’intégration D2L Standard CSV permet les opérations suivantes :
- Inscrire et désinscrire des utilisateurs dans des unités organisationnelles (versions 2.0 ou une version supérieure), des offres de cours ou des sections.
- Inscrire et désinscrire des sections de cours seulement (versions 1.0 et 1.1).
Règles relatives aux attributs du Tableau de bord du gestionnaire et des Groupes d'apprentissage
À partir de D2L Standard CSV, les attributs du Tableau de bord du gestionnaire et des Groupes d’apprentissage permettent ce qui suit :
- Établir la structure de rapport utilisée dans le Tableau de bord du gestionnaire
- Permettre la création de règles d’appartenance automatique dans les Groupes d’apprentissage.
Les attributs du Tableau de bord du gestionnaire et des Groupes d’apprentissage ne permettent pas ce qui suit :
- Créer de nouveaux comptes d'utilisateur.