Synchronisation OneRoster avec Smartschool

Smartschool prend en charge OneRoster 1.1. Partagez les données des élèves et des enseignants depuis Smartschool avec votre application.

OneRoster est une norme internationale pour l’échange de données liées aux élèves, aux classes et aux enseignants. Smartschool prend en charge l’API REST OneRoster 1.1, ce qui permet de partager facilement les informations issues de Smartschool avec d’autres plateformes compatibles avec OneRoster. Smartschool agit comme fournisseur des données.

L’utilisation de OneRoster est entièrement gratuite, tant pour l’école que pour la partie externe.

OneRoster – Questions et réponses

Qu’est-ce que OneRoster?

OneRoster est une spécification destinée à l’échange standardisé de données de classes et d’élèves entre différents systèmes.

Quelle version OneRoster est prise en charge par Smartschool?

Smartschool a implémenté la norme OneRoster 1.1. Smartschool agit en tant que fournisseur des données.

Où puis-je trouver plus d’informations techniques sur OneRoster?

https://www.imsglobal.org/oneroster-11-introduction

https://www.imsglobal.org/oneroster-v11-final-specification

Comment obtenir des identifiants OneRoster en tant que partenaire?

Un partenaire peut recevoir directement les identifiants OneRoster de l’école.

Une école peut créer des clients OneRoster au sein de sa plateforme et choisir librement quelles sources de données (plusieurs sont possibles) seront utilisées pour un client spécifique. L’école doit transmettre au partenaire le client_id, le client_secret et les URL générés.

Quelles données sont partagées via OneRoster?

Les sources suivantes sont disponibles:

Les charges de cours dans Skore: les charges de cours (carnets de cotes) de l’année en cours dans Skore sont partagées. De cette manière, la combinaison cours – enseignant – élèves est transmise telle qu’elle est définie dans les carnets de cotes de Skore. La classe ou le groupe recevra automatiquement une dénomination logique au format: « cours année-scolaire enseignant classe ». Par exemple : Néerlandais 22-23 Els Dendonker 3A.
Membres et enseignants des cours (espaces Cours): Chaque cours est partagé comme une classe/groupe. Chaque cours dans Smartschool devient donc une classe/groupe distinct(e). Tous les élèves inscrits à ce cours dans Smartschool sont partagés en tant qu’élèves. Toutes les personnes non‑élèves du cours dans Smartschool sont partagées en tant qu’enseignants. Le nom du cours provenant de Smartschool est conservé.
Groupes: Déterminez vous‑même quels groupes et classes sont partagés via le client avec l’outil externe. Chaque groupe dans Smartschool sera partagé comme une classe/groupe distinct(e). Les groupes dans Smartschool sont récupérés et partagés de manière récursive. Tous les élèves d’un groupe dans Smartschool seront partagés en tant qu’élèves de cette classe/groupe. Toutes les personnes non‑élèves de ce groupe dans Smartschool seront partagées en tant qu’enseignants. Le nom du groupe provenant de Smartschool est conservé.

IMPORTANT: Selon votre application, vous souhaiterez peut‑être vous baser sur une source spécifique. Il est essentiel que vous fournissiez à l’école les instructions adéquates concernant la source qu’elle doit utiliser pour votre intégration.

Quels élèves sont partagés?

Tous les élèves sélectionnés selon la source de données sont partagés, y compris les comptes administratifs et désactivés.

Quels enseignants sont partagés?

Tous les enseignants sélectionnés via la source de données sont partagés. Pour la source « Charges de cours Skore », il s’agit des enseignants qui donnent le cours. Pour la source « Groupes », les titulaires de classe sélectionnés sont également partagés.

Quelles classes sont partagées?

Les « classes » sélectionnées selon la source de données sont partagées. Pour la source « Charges de cours Skore », aucune classe réelle n’est partagée : c’est la charge (le carnet de cotes) qui est partagée. Pour la source « Appartenance aux cours », c’est l’appartenance à ce cours spécifique qui est partagée.

Quels endpoints sont prévus?

Les endpoints suivants sont disponibles, conformément à la spécification OneRoster. Remplacez {sourcedId} par la valeur sourcedId OneRoster de l’objet souhaité.

/ims/oneroster/v1p1/schools
/ims/oneroster/v1p1/schools/{sourcedId}
ims/oneroster/v1p1/classes
/ims/oneroster/v1p1/classes/{sourcedId}
/ims/oneroster/v1p1/schools/{sourcedId}/classes
/ims/oneroster/v1p1/users
/ims/oneroster/v1p1/students
/ims/oneroster/v1p1/students/{sourcedId}
/ims/oneroster/v1p1/schools/{sourcedId}/students
/ims/oneroster/v1p1/teachers
/ims/oneroster/v1p1/teachers/{sourcedId}
/ims/oneroster/v1p1/schools/{sourcedId}/teachers
/ims/oneroster/v1p1/schools/{sourcedId}/enrollments
/ims/oneroster/v1p1/academicSessions
/ims/oneroster/v1p1/academicSessions/{sourcedId}
/ims/oneroster/v1p1/terms/{sourcedId}

Quelle est la spécification OneRoster?

Pour simplifier le développement et les tests, nous mettons à disposition une spécification OneRoster validée sous la forme d’un fichier OpenAPI. Cette définition contient tous les endpoints disponibles, ainsi que les paramètres et modèles de réponse conformes à la norme OneRoster. Vous pouvez importer la spécification directement dans des outils tels que Postman, Insomnia ou Swagger Editor. Les étapes d’authentification nécessaires sont automatiquement reprises depuis le fichier.

Télécharger ici la spécification OpenAPI (YAML)

Comment obtenir un access_token pour envoyer OneRoster?

Envoyez une requête vers https://subdomain-platform.smartschool.be/ims/oneroster/token avec les paramètres corrects.

Voir https://www.imsglobal.org/oneroster-v11-final-specification#:~:text=3.6.2.%20OAuth%202%20Bearer%20Token%20Authorization pour plus d’informations.

Vous recevrez une réponse JSON contenant le access_token.

Quel scope dois-je demander?

https://purl.imsglobal.org/spec/or/v1p1/scope/roster-core.readonly

Comment authentifier les requêtes OneRoster?

Cela peut se faire via une authentification par Bearer token. Concrètement, cela signifie que vous devez ajouter un en-tête Authorization dont la valeur est : Bearer accesstokenvalue.
Exemple : Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwOi8vZXhhbXBsZ….

Synchronisation OneRoster avec Smartschool

OneRoster – Questions et réponses

Cible

Support

Produits

Respect de la vie privée

Dernières actualités

À propos de nous

BLOG ARCHIVES

Catégories

Contact