OneRoster CSV
Description
ManageBac+ permet aux administrateurs d'importer et d'exporter les utilisateurs, les classes, les inscriptions et les données associées grâce à une version personnalisée du standard OneRoster 1.2 . Cette fonctionnalité est accessible via Paramètres > Échange de données et inclut des rapports de validation pour garantir l'exactitude des données avant importation.
La norme OneRoster est développée et maintenue par IMS Global Learning Consortium et fournit un cadre pour cet échange de données. La ressource décrivant la mise en œuvre technique est disponible ici :
Spécifications personnalisées CSV ManageBac+ OneRoster 1.2
Exporter
Dans ManageBac+ une exportation désigne le processus de transfert de données du système vers un format externe, permettant aux utilisateurs de partager, de sauvegarder ou d'intégrer des informations avec d'autres systèmes.
Pour lancer l'exportation, accédez à l'onglet Exporter dans le Gestionnaire d'échange de données.
Si l'étape 2 – Options du mode (BULK et DELTA) s'affiche, cela signifie qu'un autre administrateur a déjà effectué une exportation. Sélectionnez la méthode d'exportation souhaitée et cliquez sur « Procéder à l'exportation ».
L'exportation en masse et l'exportation delta dans ManageBac+ servent des objectifs différents en matière de gestion des données :
- Exportation en masse : Ce processus exporte tous les enregistrements pertinents en une seule opération. Il est généralement utilisé lorsqu’un ensemble de données complet est nécessaire, par exemple lors d’une configuration initiale ou lors d’une migration vers un nouveau système. Cette méthode garantit la capture et le transfert de toutes les données existantes.
- Exportation delta : ce processus exporte uniquement les enregistrements modifiés depuis la dernière exportation, tels que les entrées nouvellement créées, mises à jour ou supprimées. Il permet de maintenir les données à jour sans transférer l’intégralité du jeu de données, ce qui optimise la synchronisation continue. L’exportation delta ne peut être effectuée qu’après une exportation en bloc.
Une fois que vous aurez cliqué sur « Procéder à l’exportation », la tâche d’exportation démarrera en arrière-plan et redirigera l’utilisateur vers l’onglet « Historique Exchange » .
Une fois l'opération terminée, localisez votre dernière exportation et cliquez sur le bouton Télécharger (flèche pointant vers le bas) pour récupérer le fichier ZIP.
Veuillez consulter le fichier téléchargé. Son contenu comprendra toutes les entités et leur représentation dans la spécification personnalisée de ManageBac+ .
Importer
Pour démarrer le processus d'importation via le Gestionnaire d'échange de données , sélectionnez votre fichier ZIP dans l'onglet Importer .
Sélectionnez le fichier ZIP OneRoster sur votre ordinateur et téléchargez-le en cliquant sur Enregistrer .
Veuillez saisir les champs obligatoires :
Si votre fichier manifest.csv ne contient pas les champs source.systemname et source.systemcode, deux champs supplémentaires apparaîtront sous la zone de téléchargement. Pour plus d'informations, consultez la section « Spécifications du fichier > manifest.csv » .
Si ces valeurs figurent déjà dans le fichier manifest.csv , les champs seront préremplis et vous ne pourrez pas les saisir.
Une fois la configuration terminée, cliquez sur le bouton « Procéder à la validation » en bas de la page. Cela lance l’importation, qui exécute les validations OneRoster et ManageBac+ en arrière-plan.
Une seule importation OneRoster peut être effectuée à la fois.
Vérifiez l'état de l'importation via l'onglet Historique des échanges en haut de la page. Une fois l'importation terminée, localisez votre dernière importation et vérifiez les validations.
La page Rapport d'échange s'ouvrira, affichant un résumé et tous les fichiers CSV téléchargés depuis votre fichier ZIP OneRoster.
Dans chaque onglet CSV, les erreurs et les avertissements seront mis en évidence par les couleurs respectives dans les cellules où les problèmes existent.
Il y a trois onglets, l'onglet Invalide étant sélectionné par défaut au départ :
Valide — contient toutes les lignes sans avertissement ni erreur de validation
Avertissement — contient toutes les lignes comportant au moins un avertissement
Invalide — contient toutes les lignes comportant au moins une valeur invalide
Pour comprendre le message associé à l'avertissement ou à l'invalidation, cliquez pour développer les informations de la ligne :
Les avertissements signalent des problèmes potentiels qui n'empêchent pas l'importation. Les administrateurs peuvent choisir de les ignorer ou d'apporter des modifications, selon le contexte.
Les enregistrements invalides ne répondent pas aux exigences fonctionnelles et l'importation ne peut pas se poursuivre.
Après avoir résolu tous les problèmes ayant entraîné une invalidation, effectuez une nouvelle importation en utilisant le fichier ZIP mis à jour.
Entités de données
Le tableau ci-dessous illustre comment les différentes entités ManageBac+ correspondent aux entités OneRoster 1.2 et aux fichiers CSV, assurant un échange de données transparent tout en tenant compte des variations dans les modèles de données.
| OneRoster 1.2 Entité(s) | Entité ManageBac+ | Fichier(s) CSV OneRoster |
| Organisations -> District | n / A | organisations |
| Organisations -> École | École | organisations |
| Organisations -> Programme Ext | Programmes | organisations |
| Sessions académiques -> Année scolaire | Années académiques | Sessions académiques |
| Cours | Groupes de matières | cours |
| Cours -> Matières | Sujets | cours |
| Cours | Cours | classes |
| Utilisateurs, Rôles -> Étudiant, Données démographiques | Étudiants | utilisateurs, rôles, données démographiques |
| Utilisateurs, Rôles -> Enseignant | Enseignants | utilisateurs, rôles |
| Utilisateurs, Rôles -> Parent | Parents | utilisateurs, rôles |
| Utilisateurs, Rôles -> Administrateur | Administrateurs | utilisateurs, rôles |
| Utilisateurs -> Agents | Relation parent/enfant | utilisateurs |
| Inscriptions | Adhésions à des classes | inscriptions |
Par exemple, un étudiant ManageBac+ correspond à un utilisateur OneRoster ayant le rôle « Étudiant ». Dans OneRoster, les utilisateurs et les rôles sont définis respectivement dans les fichiers users.csv et roles.csv .
Le gestionnaire d'échange de données met uniquement à jour les enregistrements énumérés ci-dessus et ne modifie aucune autre donnée.
Importation delta vs importation en vrac
Une distinction clé dans le processus d'échange de données réside dans la différence entre une importation delta et une importation en masse .
- Importation Delta :
- Correspond aux enregistrements ManageBac+ existants et les met à jour .
- Crée de nouveaux enregistrements s'ils n'existent pas déjà.
- Laisse inchangés les enregistrements non inclus dans les données sources .
- Importation en vrac :
- Effectue les mêmes actions qu'une importation delta (correspondance, mise à jour et création d'enregistrements).
- De plus, archive tous les enregistrements actifs dans ManageBac+ qui ne sont pas présents dans les données sources.
- Par exemple, si un cours comme « Biologie IB » est actif dans ManageBac+ mais absent des données sources, il sera archivé après le traitement de l'importation.
En résumé, une importation en masse permet non seulement de créer et de mettre à jour les enregistrements à partir des données sources, mais aussi d'archiver les enregistrements manquants.
Si vous effectuez une importation en masse lors d'une transition d'année scolaire , veuillez noter que OneRoster n'inclut pas les groupes d'années , ceux-ci doivent donc être gérés séparément.
Correspondance des enregistrements à l'importation
Lors des importations delta et en masse, ManageBac+ utilise deux stratégies principales pour faire correspondre les enregistrements des données sources avec ceux du système :
- Si un sourcedId a déjà été utilisé, il correspond directement à l'enregistrement correspondant en utilisant la méthode de correspondance décrite au point suivant.
- Si la correspondance par sourcedIds n'est pas disponible ou s'il s'agit de la première rencontre, le tableau suivant décrit la stratégie de correspondance pour chaque entité :
| Entité | Colonne source (OU) | Correspond à (MB) |
| École | orgs.types == "école" | Correspond à l'établissement scolaire actuel (un seul enregistrement) |
| Programme | orgs.sourcedId , correspondance sur le suffixe après le premier trait de soulignement | Correspond au code du programme (c'est-à-dire que abc-dedf_diploma est le diplôme de l'IB ) |
| Sessions académiques | academicSessions.startDate , academicSessions.endDate | Correspond aux dates de début/fin d'année/de semestre |
| Cours | cours.titre | Correspond au titre du groupe de sujets |
| Sujets | cours.matières[] | Chaque chaîne de caractères du tableau est associée à un titre de sujet |
| Cours | classes.classCode | Correspond à l'identifiant de classe |
| Utilisateurs | utilisateurs.nom_utilisateur | Correspondance avec l'adresse e-mail de l'élève / de l'enseignant / du parent |
Foire aux questions
Question : Qu'est-ce que OneRoster et pourquoi ManageBac+ utilise-t-il une spécification personnalisée de celui-ci ?
OneRoster est une spécification largement adoptée, développée par l'IMS Global Learning Consortium, afin de standardiser l'échange de données éducatives (informations sur les étudiants, données de cours, inscriptions, etc.) entre différents systèmes. L'implémentation de OneRoster 1.2 par ManageBac+ utilise une spécification personnalisée, appelée « dialecte ManageBac+ OneRoster » (dialecte MB OR), car le modèle de données de la spécification OneRoster de base diffère des exigences fonctionnelles de ManageBac+ . Cette personnalisation permet à ManageBac+ d'importer et d'exporter des enregistrements en respectant sa structure de données et ses fonctionnalités internes.
Question : Quels fichiers sont inclus dans une opération d'import/export ManageBac+ OneRoster et lesquels sont obligatoires ?
Les données ManageBac+ OneRoster sont échangées sous forme d'archive ZIP contenant des fichiers CSV. Le fichier manifest.csv est obligatoire. Les fichiers suivants sont facultatifs, mais doivent être présents dans l'archive si les entités correspondantes y sont incluses : academicSessions.csv, orgs.csv, courses.csv, classes.csv, roles.csv, users.csv, enrollments.csv et demographics.csv. Veuillez noter que les fichiers facultatifs vides doivent contenir les en-têtes de colonnes requis.
Question : De quelles colonnes chaque fichier a-t-il besoin, et quelles sont les valeurs autorisées ?
Ces détails sont fournis dans la ressource qui décrit la mise en œuvre technique, que l'on peut consulter ici :
Spécifications personnalisées CSV ManageBac+ OneRoster 1.2
Question : Quelles sont les règles de validation pour l'importation des données OneRoster dans ManageBac+ ?
ManageBac+ applique plusieurs validations universelles à tous les fichiers CSV importés. Les résultats de ces validations sont consultables dans l'onglet « Historique des échanges de données ». Chaque entité fait l'objet d'un ensemble de validations, dont les détails sont fournis dans la documentation technique, accessible ici :
Spécifications personnalisées CSV ManageBac+ OneRoster 1.2
Question : Quelles sont les différences et les incompatibilités potentielles lors de l'échange de données entre ManageBac+ et d'autres systèmes compatibles OneRoster 1.2 ?
Lors de l'exportation de données de ManageBac+ vers un système tiers utilisant la norme OneRoster 1.2, la compatibilité est généralement assurée. ManageBac+ inclut des colonnes de métadonnées supplémentaires dans les fichiers, telles que Utilisateurs, Cours et Classes, qui peuvent généralement être ignorées par le système destinataire.
Toutefois, lors de l'importation de données depuis un système tiers vers ManageBac+ , certaines exigences doivent être respectées en raison des spécifications propres ManageBac+ . Par exemple, les classes et les cours doivent être associés à des organisations d'un type spécifique (ext:program), et des colonnes de métadonnées supplémentaires peuvent être requises dans les fichiers Utilisateur, Cours et Classe. Les sessions académiques sont également partiellement conformes lors de l'importation.
Question : Quelle est la différence entre une exportation « en bloc » et une exportation « différentielle » dans ManageBac+ Data Exchange Manager ? Une exportation en bloc est une exportation complète des données sélectionnées, offrant un instantané complet des informations actuelles dans ManageBac+ . Elle est généralement effectuée lors de la première exportation. Une exportation différentielle, quant à elle, n’exporte que les modifications (ajouts, modifications et suppressions) survenues depuis la dernière exportation en bloc réussie. Pour effectuer une exportation différentielle, vous devez avoir préalablement effectué au moins une exportation en bloc.
Question : Où dois-je spécifier le nom et le code du système source lors de l'importation d'un fichier ZIP OneRoster dans ManageBac+ ?
ManageBac+ requiert les champs source.systemname et source.systemcode pour identifier l'origine des données OneRoster, notamment lors de l'importation de données provenant de plusieurs systèmes d'information scolaire. Si ces champs ne figurent pas dans votre fichier manifest.csv, vous serez invité à les saisir manuellement après le chargement du fichier ZIP dans le Gestionnaire d'échange de données. Ces valeurs doivent être identiques pour toutes les importations provenant d'un même système source.
Question : Pourquoi ne puis-je pas sélectionner la méthode Delta pour mon exportation ?
Réponse : Pour activer la méthode Delta, vous devez effectuer votre première exportation groupée. Une fois cette exportation initiale réalisée, la méthode Delta sera disponible. La méthode Delta exporte les modifications effectuées depuis la dernière exportation groupée complète.
Question : Où dois-je indiquer les groupes d’années dans la spécification OneRoster personnalisée de ManageBac+ ?
Réponse : La gestion des groupes d’année n’est pas prise en charge pour le moment. Nous étudions cependant la possibilité de collaborer avec OneRoster afin de développer les extensions nécessaires pour répondre aux exigences fonctionnelles de ManagaBac. Il est recommandé de gérer les adhésions par groupe d’année via Paramètres > Effectif > Adhésions.
Question : Que signifie le statut affiché sur la page Historique des échanges ?
Réponse : ManageBac+ possède quatre statuts différents, dont voici les explications :
Planifié : cela signifie que le système a bien planifié l’importation et l’a mise en file d’attente pour un démarrage ultérieur. Une fois démarrée, elle passera à l’état de traitement.
En cours de traitement : le système traite actuellement votre exportation ou importation en arrière-plan. Ce traitement est temporaire et évoluera vers l’un des statuts ci-dessous.
Échec – Si ce statut apparaît, cela signifie que la tâche en arrière-plan n'a pas pu être effectuée. Pour les erreurs d'exportation, veuillez contacter l'équipe d'assistance ManageBac+ ( Soumettre une demande ). Pour les erreurs d'importation, cliquez sur l'icône en forme d'œil pour ouvrir la page Vue du rapport, vérifiez les erreurs de validation et corrigez-les pour votre prochaine importation.
Réussi – Cela signifie que la tâche a été accomplie sans aucune erreur.