Utilisez cette section pour comprendre 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
- Fichier Manifest (requis lors de l’utilisation de la version 1.1 ou supérieure de D2L Standard CSV
Exemple de fichiers D2L Standard CSV
Des exemples de fichiers CSV peuvent être téléchargés dans le cours IPSIS du Centre d’apprentissage. Ce cours fournit des exemples à jour et des conseils pour vous aider à commencer à utiliser les fichiers D2L Standard CSV.
Nous vous recommandons de consulter le cours pour accéder aux plus récents exemples de fichiers et aux ressources connexes.
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 (minuscule sensible à la casse) vers le Protocole de transfert de fichiers sécurisé (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 correspond 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 (deltas) du Système informatique de renseignements sur les élèves (SIS) plutôt que des données complètes du SIS.
- L'envoi d'une MISE À JOUR lorsque l'objet n'existe pas devient une demande de CRÉATION. En général, seules les actions METTRE À JOUR et SUPPRIMER sont utilisées.
- 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 identifie la version D2L Standard CSV utilisée. Pour en savoir plus, consultez le sujet Manifest.
- La pratique exemplaire est de ne pas inclure de renseignements permettant d’identifier la personne, comme les numéros d’assurance sociale des utilisateurs, 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 (unités organisationnelles personnalisées en dehors de la structure organisationnelle standard de D2L; prises en charge dans la version 2.0 ou supérieure)
- 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. Une fois que l’intégration contrôle une unité organisationnelle, tous les changements futurs doivent être effectués par le biais de l'intégration.
- Si vous envoyez un grand nombre de types d’unités organisationnelles dans un seul fichier CSV, assurez-vous que la hiérarchie est respectée (par exemple, envoyez Départements avant Modèles de cours).
- Si vous envoyez des relations d’utilisateur, assurez-vous que la hiérarchie est respectée (par exemple, envoyez Parents ou tuteurs avant Apprenants).
- La convention d’appellation du nom et du code de l’unité organisationnelle doit suivre celle décrite dans votre SIS.
- Les noms et codes des unités organisationnelles peuvent être utilisés tels quels s’ils répondent aux exigences de Brightspace en matière de caractères et sont uniques.
- Les codes d'unité organisationnelle sont limités à 50 caractères. Les valeurs plus longues sont tronquées, ce qui peut entraîner des doublons ou des échecs.
- 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.
- Effectuer la mise en correspondance avec une unité organisationnelle existante si la correspondance est activée dans la configuration.
- Mettre à jour le nom d'une UO qu'elle contrôle.
- Attribuer et supprimer les relations primaires entre les unités organisationnelles.
- Attribuer et mettre à jour le département primaire pour les modèles de cours.
- Attribuer et mettre à jour le modèle et le semestre du cours primaires pour les offres de cours.
- Mettre à jour les détails des offres de cours, y compris le nom et les dates, et désactiver des offres.
- Supprimer des sections de cours et désinscrire automatiquement les utilisateurs.
- 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 unités organisationnelles créées manuellement, à moins qu’elles ne soient mises en correspondance.
- Supprimer une unité organisationnelle ayant des liens vers des nœuds secondaires.
Règles pour les utilisateurs
Les enregistrements d’utilisateur peuvent créer, mettre à jour, désactiver ou supprimer des utilisateurs dans Brightspace et gérer les relations.
Règles :
- Les utilisateurs doivent être transmis au moins une fois pour établir la gestion par l’intégration.
- 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 : / : * ? " < > | ', ;
- Les adresses courriel ne prennent pas en charge les caractères suivants : ( ) < > [ ] | \ ; : , "
L’intégration D2L Standard CSV permet les opérations suivantes :
- Créer des utilisateurs et les inscrire.
- Faire correspondre les utilisateurs avec des comptes existants.
- Mettre à jour les détails d’utilisateur.
- Mettre à jour les noms préférés et les noms triés (selon la version).
- Mettre à jour les pronoms (version 3.0 ou supérieure).
- Activer, désactiver ou supprimer des utilisateurs.
- Gérer les relations avec les parents ou les tuteurs.
- Mettre à jour les relations du vérificateur.
L’intégration D2L Standard CSV ne permet pas les opérations suivantes :
- Mettre à jour l’ID défini par l’organisation par le biais de CSV.
- Supprimer les utilisateurs créés manuellement, à moins qu’ils ne soient mis en correspondance.
Règles pour les inscriptions
Le traitement des enregistrements d’inscription inscrit des utilisateurs dans des unités organisationnelles ou les désinscrit.
Règles :
- Envoyer les enregistrements d’inscription lorsque des changements surviennent dans le système source.
- Envoyer une désinscription une seule fois.
- Lors de l’utilisation de sections, fournir des enregistrements d’inscription uniquement pour les sections.
- Éviter d’envoyer des rôles différents pour des sections de la même offre.
- Les clients doivent éviter d’envoyer des rôles différents pour des sections de la même offre. Cela entraînera l’écrasement du rôle dans l’offre et dans l’une des sections, car le SGA ne permet pas que le rôle de la section soit différent de celui de l’offre.
L’intégration D2L Standard CSV permet les opérations suivantes :
- Inscrire des utilisateurs dans des unités organisationnelles et des sections ou les désinscrire
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 des structures de rapport.
- Activer des règles d’appartenance automatique dans les Groupes d’apprentissage.
Les attributs du Tableau de bord du gestionnaire et des Groupes d’apprentissage via D2L Standard CSV ne permettent pas les opérations suivantes :
- Créer de nouveaux comptes d'utilisateur.