OneRoster correspond à la spécification standard d’IMS Global conçue pour le partage sécurisé des listes de présences au cours et autres données connexes entre un système informatique de renseignements sur les élèves (SIS) et tout autre système. La mise en œuvre Brightspace de OneRoster prend en charge l'importation de feuille de calcul (CSV) ainsi que les échanges directs entre les systèmes à l'aide des API REST.
La mise en œuvre Brightspace de la spécification OneRoster v1.1 permet aux administrateurs de planifier l'extraction des données de leur SIS afin de générer les données de liste requises (comme les écoles, classes, utilisateurs et inscriptions) dans Brightspace.
L'interface utilisateur OneRoster REST dans IPSIS comprend un calendrier qui permet aux administrateurs de configurer l'heure de l'extraction des données. S'il s'agit d'un SIS qui prend en charge le transfert des notes d'appréciation, les administrateurs peuvent définir les notes d'appréciation à renvoyer avec la synchronisation quotidienne des données ou autoriser un membre du corps enseignant à lancer une synchronisation manuelle.
Avant de configurer votre intégration OneRoster dans la zone Administration d'IPSIS, passez en revue les informations sur les réglages, la mise en correspondance et la configuration de base communiquées dans cette rubrique.
Configuration des rôles
Avant de configurer votre intégration OneRoster dans la zone Administration d'IPSIS, vous devez configurer les rôles que vous prévoyez utiliser. Les rôles suivants sont disponibles dans OneRoster :
- Administrateur
- Aidant
- Tuteur légal
- Primaire
- Surveillant
- Relative
- Étudiant
- Personnel enseignant
- Passez en revue les rôles configurés dans votre SIS.
- Voici la marche à suivre pour envoyer des rôles dans la plateforme Brightspace :
- Confirmez l'existence des rôles que vous souhaitez inclure dans votre plateforme Brightspace.
- Si certains d'entre eux n'existent pas dans Brightspace, créez-les dans l'outil Rôles et autorisations avant de configurer votre système SIS. Pour en savoir plus, consultez la rubrique Gérer les rôles et les autorisations.
Configuration de types d’unité organisationnelle
Lorsque vous créez l'intégration du SIS, Vous devez faire correspondre les types d'unités organisationnelles du SIS avec celles de Brightspace. Voici les types d'unités organisationnelles offertes dans OneRoster :
- National
- Provincial
- Locale
- Arrondissement
- École (obligatoire)
- Department
- Passez en revue les types d'unités organisationnelles configurés dans votre SIS.
- Voici la marche à suivre pour envoyer des unités organisationnelles dans la plateforme Brightspace :
- Confirmez l'existence des unités organisationnelles que vous souhaitez inclure dans votre plateforme Brightspace.
- Si certaines d'entre elles n'existent pas dans Brightspace, créez-les dans l'outil Éditeur d'unité organisationnelle avant de configurer votre système SIS. Pour en savoir plus, consultez la rubrique Créer et supprimer des types d'unités organisationnelles.
Mise en correspondance des types de données de OneRoster et de Brightspace
Les types d'objet de OneRoster ne correspondent pas exactement à ceux de Brightspace. Le tableau suivant illustre la relation de mise en correspondance entre les types d'objets de OneRoster et de Brightspace.
|
Remarque : Configurez les types d'unités organisationnelles dans Brightspace avant de configurer votre intégration OneRoster. Pour en savoir plus, consultez la rubrique Créer et supprimer des types d'unités organisationnelles.
Les types d'unités organisationnelles sont généralement des types d'unités organisationnelles personnalisés pouvant être mis en correspondance pendant le processus de configuration.
|
| Type de données OneRoster |
Type de données D2L Brightspace |
|---|
| Sessions académiques |
Unités organisationnelles |
| Org |
Unités organisationnelles |
| École |
Unités organisationnelles |
| Cours |
Modèle de cours |
| Classer |
Offre de cours, section de cours |
| Utilisateur |
Utilisateur |
| Inscription |
Inscription |
| Catégories d'éléments |
Catégories de note |
| Éléments |
Éléments de note |
| Résultats |
Notes d'appréciation, résultats |
|
Remarque : Les types d'unités organisationnelles sont généralement des types d'unités organisationnelles personnalisés pouvant être mis en correspondance pendant le processus de configuration.
|
Responsabilités relatives aux relations parent-tuteur
|
Remarque : Cette information est destinée aux clients K-12 désirant utiliser Brightspace pour les parents et les tuteurs. |
Votre établissement est responsable du maintien de l’exactitude des relations utilisateurs dans votre système informatique de renseignements sur les élèves (SIS). Communiquez avec vos conseillers afin de vous assurer de respecter les politiques de sécurité et de confidentialité de votre établissement. Par exemple, votre établissement ou juridiction pourrait comprendre une politique ou une règle qui stipule qu’un parent dont l’enfant a atteint la majorité ne devrait plus avoir accès au contenu de son enfant sans son consentement. Ce genre de situation doit être traité en créant et en envoyant les relations parent/tuteur-enfant à Brightspace.
Aperçu des intégrations de OneRoster
Il existe deux types d'intégration OneRoster : OneRoster Rest et OneRoster CSV. Cette section fournit des renseignements de base sur ces deux intégrations. Pour en savoir plus, reportez-vous aux rubriques À propos de l'intégration de OneRoster REST et À propos de l'intégration de OneRoster CSV.
Intégration de OneRoster REST : flux de travail de base
Les étapes suivantes décrivent la séquence de haut niveau qui vous aidera à comprendre l'intégration de OneRoster REST. Pour en savoir plus sur le flux de travail, consultez la rubrique À propos de l'intégration de OneRoster REST.
- Dans le Système d'information sur les élèves (SIS) de votre organisation, vous générez un Consommateur OneRoster pour Brightspace que vous utiliserez pour communiquer avec votre SIS à partir de Brightspace.
| Remarque : Le processus de création de ce rôle varie selon votre SIS. Pour en savoir plus, consultez votre représentant du SIS. |
- Consignez les données d'accès OAuth de votre SIS ainsi que le point d'extrémité de son adresse URL. Par exemple, https://www.sis.com/school/api.
| Remarque : N'ajoutez pas ims/oneroster/v1p1 à la fin de l'URL. D2L exécute cette tâche dans le service d’IPSIS. |
- Effectuez la configuration dans la zone Administration d'IPSIS de Brightspace. Pour associer des dossiers existants aux données de OneRoster, sélectionnez les options appropriées pour associer les données de Brightspace aux équivalents aux données équivalentes du SIS.
- Créez un horaire pour que votre intégration REST se synchronise avec votre SIS.
Après avoir enregistré votre intégration, vous pouvez attendre jusqu'à la prochaine mise à jour planifiée ou exécuter votre intégration immédiatement en utilisant le bouton Exécuter la mise à jour maintenant de la page Lots.
Intégration de OneRoster CSV : flux de travail de base
Les étapes suivantes décrivent la séquence de haut niveau qui vous aidera à comprendre l'intégration de OneRoster CSV. Pour en savoir plus sur le flux de travail, consultez la rubrique À propos des intégrations de OneRoster CSV.
- Créer un fichier CSV contenant vos informations connexes.
- Effectuez la configuration dans la zone Administration d'IPSIS de l'Environnement d'apprentissage de Brightspace. Pour associer des dossiers existants aux données de OneRoster, sélectionnez les options appropriées pour associer les données de Brightspace aux équivalents aux données équivalentes du SIS.
- À la page Lots, accédez au fichier ZIP contenant le fichier CSV de vos données connexes ou glissez-déposez le.
Le traitement de l’intégration débute automatiquement.
Vérifier une intégration OneRoster
Il existe plusieurs façons de vérifier une intégration OneRoster :
- Pour déterminer si l'intégration de REST est terminée, accédez à Administration d'IPSIS > Journal de vérification. Actualisez la page pour vérifier si tous les types de dossiers attendus (comme Utilisateur, Unité organisationnelle, etc.) ont été traités.
- Voici la marche à suivre pour déterminer si l'intégration d'un fichier CSV est terminée :
Page Lots : Après avoir téléversé un fichier CSV compressé, l'indicateur de traitement s'affiche à la page Lots du système source. Actualisez la page pour confirmer que l'indicateur indique l'état Terminé.
Journal de vérification : Actualisez le Journal de vérification pour vérifier si tous les types de dossiers prévus ont été traités.
- Voici la marche à suivre pour déterminer si l'un ou l'autre des types est terminé :
- Unités organisationnelles : Utilisez l'Éditeur d'unité organisationnelle pour passer en revue toutes les unités organisationnelles créées et les mettre à jour, au besoin.
- Utilisateurs : Utilisez l'outil Utilisateurs pour passer en revue tous les utilisateurs créés et les mettre à jour, au besoin.
<<<<<<<<<<<<<<<<< LE BROUILLON COMMENCE ICI
Dépannage d’une intégration OneRoster
Si une erreur survient lors de la première exécution de l’un ou l’autre type de d’intégration de OneRoster, essayez de traiter l’intégration de nouveau.
Pour traiter un fichier d’intégration CSV :
- À la page Lots, faites glisser-déposez votre fichier CSV ZIP dans la zone désignée.
- Si le fichier CSV ZIP est corrompu, générez-en un nouveau à partir de votre SIS et faites-le glisser dans l’interface pour le traiter de nouveau.
Pour traiter de nouveau un fichier d’intégration REST :
- Sur la page Lots à l’aide du bouton Mettre à jour maintenant, sélectionnez l’une ou l’autre des options suivantes :
- Resynchroniser mises à jour – vous pouvez sélectionner la date la plus récente à partir de laquelle vous désirez synchroniser uniquement les mises à jour des données effectuées. Cliquez ensuite sur Resynchroniser.
- Resynchroniser tous les dossiers SIS – vous pouvez extraire toutes les données de votre SIS à nouveau, sans contrainte de temps.
<<<<<<<LE BROUILLON DU CONTENU SOURCE COMMENCE ICI
Valeurs de correspondance REST
Valeurs de correspondance CSV
Séances académiques
| OneRoster |
Valeurs prises en charge |
Correspondances dans Brightspace |
Requise |
Remarques |
|---|
|
SourcedId
|
|
|
O |
|
|
État
|
actif, tobedeleted
|
|
N |
Champ requis pour les fichiers en mode delta.
|
|
Date de modification la plus récente
|
|
|
N |
Champ requis pour les fichiers en mode delta.
Format de date AAAA-MM-DDTHH:MM:SS.sssZ
|
|
Titre
|
|
Nom et code de l'UO
|
O |
|
|
Type
|
|
|
O |
Type d’unité organisationnelle
|
|
StartDate
|
|
|
O |
AAAA-MM-JJ
|
|
EndDate
|
|
|
O |
AAAA-MM-JJ
|
|
ParentSourcedId
|
|
|
N |
Inutilisée
|
|
Année scolaire
|
|
|
N |
Inutilisée
|
Organisations
| OneRoster |
Valeurs prises en charge |
Correspondances dans Brightspace |
Requise |
Remarques |
|---|
|
SourcedId
|
|
|
O
|
|
|
État
|
actif, tobedeleted
|
|
N
|
Champ requis pour les fichiers en mode delta. |
|
Date de modification la plus récente
|
|
|
N
|
Champ requis pour les fichiers en mode delta. Format de date AAAA-MM-DDTHH:MM:SS.sssZ |
|
Nom
|
|
Nom et code de l'UO
|
O
|
Si le champ d’identifiant est vide, le nom est copié dans le code d’unité organisationnelle dans Brightspace |
|
Type
|
national, state, local, district, school, department
|
|
O
|
Définit le type d’UO dans Brightspace.
http://www.imsglobal.org/oneroster-v11-final-specification#_Toc480452024
|
|
Identifiant
|
|
Code de l’UO (si fourni)
|
N
|
|
|
ParentSourcedId
|
|
|
N
|
Ce champ indique l’unité organisationnelle primaire. |
Cours
| OneRoster |
Valeurs prises en charge |
Correspondances dans Brightspace |
Requise |
Remarques |
|---|
|
SourcedId
|
|
|
O
|
|
|
État
|
actif, tobedeleted
|
|
N
|
Champ requis pour les fichiers en mode delta. |
|
Date de modification la plus récente
|
|
|
N
|
Champ requis pour les fichiers en mode delta. Format de date AAAA-MM-DDTHH:MM:SS.sssZ |
|
SchoolYearSourcedId
|
|
|
N
|
Non utilisé |
|
Titre
|
|
Nom et code de l'UO
|
O
|
Crée un modèle de cours Brightspace. Si le champ CourseCode est vide, le titre est copié dans le code d’unité organisationnelle. |
|
CourseCode
|
|
Code de l’unité org.
|
N
|
Si fourni |
|
Notes d'appréciation
|
|
|
N
|
Non utilisé |
|
OrgSourcedId
|
|
|
O
|
Ce champ indique l’unité organisationnelle primaire. |
|
Objets
|
|
|
N
|
Non utilisé |
|
SubjectCodes
|
|
|
N
|
Non utilisé |
Classes
| OneRoster |
Valeurs prises en charge |
Correspondances dans Brightspace |
Requise |
Remarques |
|---|
|
SourcedId
|
|
|
O
|
|
|
État
|
actif, tobedeleted
|
|
N
|
Champ requis pour les fichiers en mode delta. |
|
Date de modification la plus récente
|
|
|
N
|
Champ requis pour les fichiers en mode delta.
Format de date AAAA-MM-DDTHH:MM:SS.sssZ
|
|
Titre
|
|
Nom et code de l'UO
|
O
|
Crée une section et une offre de cours Brightspace. Si le champ ClassCode est vide, le titre est copié dans le code d’unité organisationnelle. |
|
Notes d'appréciation
|
|
|
N
|
Non utilisé |
|
CourseSourcedId
|
|
|
O
|
Ce champ indique l’unité organisationnelle primaire. |
|
ClassCode
|
|
Code de l’UO (si fourni)
|
N
|
Si fourni |
|
ClassType
|
|
|
O
|
Non utilisé |
|
Emplacement
|
|
|
N
|
Non utilisé |
|
SchoolSourcedId
|
|
|
O
|
Non utilisé |
|
TermsSourcedIds
|
|
|
N
|
Non utilisé |
|
Objets
|
|
|
N
|
Non utilisé |
|
SubjectCodes
|
|
|
N
|
Non utilisé |
|
Periods
|
|
|
N
|
Non utilisé |
Utilisateurs
| OneRoster |
Valeurs prises en charge |
Correspondances dans Brightspace |
Requise |
Remarques |
|---|
|
SourcedId
|
|
OrgDefinedId
|
O
|
Si le champ d’identifiant est vide, la valeur du champ SourcedId est copiée dans le champ OrgDefinedId. |
|
État
|
actif, tobedeleted
|
|
N
|
Champ requis pour les fichiers en mode delta. |
|
Date de modification la plus récente
|
|
|
N
|
Champ requis pour les fichiers en mode delta.
Format de date AAAA-MM-DDTHH:MM:SS.sssZ
|
|
EnabledUser
|
|
|
O
|
Non utilisé |
|
OrgSourcedIds
|
|
Inscriptions à une UO supérieure (avec son rôle dans l’UO).
|
O |
Inscription dans les unités organisationnelles de l’établissement |
| Rôle |
administrator, aide, guardian, parent, proctor, relative, student, teacher (administrateur, aide, tuteur, parent, surveillant, parenté, apprenant, enseignant) |
|
O |
Rôle dans l’UO |
|
Nom d’utilisateur
|
|
Nom d’utilisateur
|
O
|
|
|
UserIds
|
|
|
N
|
Non utilisé |
|
GivenName
|
|
FirstName
|
O
|
|
|
FamilyName
|
|
LastName
|
O
|
|
|
MiddleName
|
|
MiddleName
|
N
|
|
|
Identifiant
|
|
OrgDefinedId
|
N
|
Si fourni |
|
Courriel
|
|
ExternalEmail
|
N
|
|
|
SMS
|
|
MobilePhone
|
N
|
|
|
Phone
|
|
HomePhone
|
N
|
|
|
AgentSourcedIds
|
|
|
N
|
Utilisé pour Brightspace pour les parents et les tuteurs. Ce champ affirme la relation parent-enfant. Les rangées parent et enfant doivent faire mutuellement référence aux valeurs sourcedId de l’autre. |
|
Notes d'appréciation
|
|
|
N
|
Non utilisé |
|
Mot de passe
|
|
Mot de passe
|
N
|
|
Inscriptions
| OneRoster |
Valeurs prises en charge |
Correspondances dans Brightspace |
Requise |
Remarques |
|---|
|
SourcedId
|
|
|
O
|
|
|
État
|
actif, tobedeleted
|
|
N
|
Champ requis pour les fichiers en mode delta. |
|
Date de modification la plus récente
|
|
|
N
|
Champ requis pour les fichiers en mode delta.
Format de date AAAA-MM-DDTHH:MM:SS.sssZ
|
|
UserSourcedId
|
|
|
O
|
Utilisateur à inscrire |
|
ClassSourcedId
|
AAAA-MM-JJ
|
|
O
|
Inscription Brightspace |
|
SchoolSourcedId
|
|
|
N
|
Non utilisé |
|
Rôle
|
administrator, aide, guardian, parent, proctor, relative, student, teacher (administrateur, aide, tuteur, parent, surveillant, parenté, apprenant, enseignant)
|
Rôle
|
O
|
|
|
Primaire
|
|
|
N
|
Non utilisé |
|
BeginDate
|
|
|
N
|
AAAA-MM-JJ |
|
EndDate
|
|
|
N
|
AAAA-MM-JJ |