OneRoster CSV
L'intégration OneRoster CSV accepte les données présentées comme un ensemble de fichiers aux valeurs séparées par des virgules (CSV), téléversé au format .zip.
Les formats de fichiers avec lesquels vous travaillerez sont les suivants, et seront traités dans cet ordre :
- manifest.csv
- academicsessions.csv
- orgs.csv
- courses.csv
- classes.csv
- users.csv
- enrollments.csv
Valeurs de correspondance
Le tableau de correspondances ci-dessous présente la relation entre les types d'objet OneRoster et l'environnement Brightspace de D2L.
OneRoster
|
Brightspace de D2L
|
Séances académiques |
Unités organisationnelles*
|
Organisations |
Unités organisationnelles* |
Cours |
Modèles de cours |
Classes |
Offre de cours et section de cours |
Utilisateurs |
Utilisateur |
Inscriptions |
Inscription |
*Le type d'UO auquel chaque objet est mis en correspondance dépend de la configuration de l'intégration SIS par D2L dans la section de mise en correspondance de l'IU Administration d'IPSIS.
L'intégration OneRoster CSV est en mesure d'effectuer la création et la mise à jour aux niveaux indiqués ci-dessus. Tout élément qui ne fait pas partie de cette liste devra être géré à l'extérieur de cette intégration.
Les conventions d'appellation des unités organisationnelles (nom/code) doivent respecter celles décrites dans votre SIS. Brightspace peut accepter le nombre d'UO qu'il vous faut; les noms d'UO et les codes 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.
- Fichier Manifest
- Le fichier Manifest doit être inclus dans chaque progiciel. Ce fichier contient la version et la liste des fichiers envoyés à Brightspace. Il précise également le mode utilisé : Delta ou Bloc.
- Academic Sessions, Orgs, Schools, Courses, Classes (sessions scolaires, organisations, écoles, cours, classes)
Ces éléments doivent être transmis au moins une fois pour indiquer à la plateforme IPSIS l'UO qu'elle pourra contrôler.
Vous ne devriez renvoyer les fichiers d'UO lorsqu'elles doivent être ajoutées ou mises à jour dans la structure organisationnelle de l'environnement d'apprentissage.
OneRoster CSV peut :
- Créer une unité organisationnelle
- Effectuer la mise en correspondance avec une UO existante si elle a été créée par une source différente vers OneRoster
- Mettre à jour le nom ou le code d'une UO qu'elle contrôle
- Modèle de cours : Attribuer et mettre à jour des écoles primaires en fonction du code d'école
- Offre de cours : Attribuer et mettre à jour des écoles primaires en fonction du code d'école
- 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 de l'offre de cours
- Mettre à jour les codes d'unité organisationnelle
- Copier le contenu d'un cours vers un nouveau cours
- Supprimer une unité organisationnelle si le fichier delta est envoyé avec l'état tobedeleted (à supprimer) et qu'elle ne comprend aucune inscription
OneRoster CSV ne peut pas :
- Supprimer les UO créées de façon manuelle, à moins qu'elles n'aient été mises en correspondance avec OneRoster CSV
- Supprimer une unité organisationnelle qui comprend des liens vers des UO secondaires (les UO secondaires doivent être supprimées en premier)
- Tenir à jour les dates de début ou de fin pour tout type d'UO
- Utilisateurs
Le traitement du type d'utilisateur crée, actualise ou désactive des utilisateurs dans Brightspace. Les utilisateurs doivent être transmis au moins une fois pour indiquer à IPSIS les profils d'utilisateur qui peuvent être créés ou mis à jour, ainsi que les inscriptions qui peuvent être gérées. Les utilisateurs sont automatiquement inscrits à l'école.
OneRoster CSV peut :
- Créer un nouvel utilisateur
- Si un utilisateur existant a le même nom d'utilisateur ou « OrgDefinedID », il peut être mis en correspondance avec l'utilisateur existant
- Mettre à jour le prénom, le nom de famille, le mot de passe et l'adresse courriel
- Mettre à jour le rôle de niveau d'organisation
- Activer ou désactiver un utilisateur
- Mettre à jour l'ID défini par l'organisation ou le nom d'utilisateur
- Inscrire ou désinscrire des utilisateurs des unités organisationnelles supérieures
OneRoster CSV ne peut pas :
- Supprimer des utilisateurs
Inscriptions
Le traitement des types d'inscription inscrit ou désinscrit des utilisateurs dans Brightspace au niveau de la section de cours. Les inscriptions devraient être transmises lorsque des modifications sont apportées au système d'information pour bien refléter ces changements dans Brightspace. Une désinscription ne devrait être transmise qu'une seule fois. Le renvoi d'une désinscription entraînera l'affichage d'un avertissement dans votre journal IPSIS.
OneRoster CSV peut :
- Inscrire des utilisateurs dans des offres et des sections de cours
- Désinscrire des utilisateurs d'offres et de sections de cours
OneRoster CSV ne peut pas :
- Inscrire des utilisateurs à d'autres niveaux organisationnels
Limites et hypothèses
Désinscription des unités organisationnelles supérieures
- À la page Administration IPSIS, vous devez activer l'option Désinscrire les utilisateurs des organisations du SIS s'ils n'y sont plus associés dans le SIS afin d'autoriser les désinscriptions au moyen de l'intégration de OneRoster.
- Les inscriptions aux unités organisationnelles supérieures créées avant la version de juin 2024/20.24.6 ne peuvent être désinscrites au moyen de l'intégration de OneRoster.
- Les inscriptions créées manuellement dans Brightspace ne peuvent pas être désinscrites au moyen de l'intégration de OneRoster.
- Un utilisateur détenant un rôle en cascade qui est désinscrit d'une unité organisationnelle supérieure peut perdre l'accès à de nombreuses unités organisationnelles secondaires.
Caractères non pris en charge :
- Le code d'unité organisationnelle ne peut contenir les caractères suivants : \ : * ? “ ” < > | ‘ # , % &
- Le code de l'unité organisationnelle peut provenir des champs CSV suivants :
- Séances académiques : Titre
- Cours : Titre ou CourseCode (code de cours)
- Classes : Titre ou ClassCode (code de classe)
- Organisations : Nom ou Identifiant
Troncature des champs :
- Tous les codes d'unité organisationnelles sont tronqués afin d'avoir un maximum de 50 caractères.