Options de configuration de REST OneRoster

Vous travaillerez avec votre consultant de mise en œuvre Brightspace pour configurer votre système source REST OneRoster. Brightspace utilise automatiquement par défaut vos réglages les plus courants. Ces réglages peuvent toutefois être modifiés en tout temps si vous disposez des autorisations appropriées.

Avant de pouvoir configurer le système source, assurez-vous que les éléments suivants sont terminés :

Exigences générales

Contactez votre représentant OneRoster pour obtenir vos renseignements d'API. Ce qu'il vous faut :

  • URL du point d'extrémité
  • Point d'extrémité d'authentification
  • ID du client
  • Secret du client

Configuration

Suivant la configuration initiale, vous pouvez mettre à jour la configuration de votre système source REST OneRoster :

  1. Dans le menu Outils d'administration, sélectionnez Administration d'IPSIS, puis l'onglet Configurer.
  2. Les identifiants fournis lors de la configuration initiale s'affichent en premier; ils peuvent être modifiés si nécessaire.
  3. Champs du système source :
    • Nom du SIS Nom du SIS : le champ Nom du SIS est modifiable et il est recommandé de le tenir à jour.
    • Mises à jour planifiées Mises à jour planifiées : heure à laquelle Brightspace se synchronise automatiquement avec le SIS. Il est recommandé d'effectuer ce processus pendant la nuit.
    • Écrasement de changements apportés dans Brightspace Écrasement de changements apportés dans Brightspace :Choix granulaires permettant d'identifier les champs de Brightspace que votre SIS peut écraser après des changements.
  1. Utilisateurs
    • Mise en correspondance de rôles du SIS Mises en correspondance des rôles du SIS : Cette section contient le rôle propre à OneRoster pour faire correspondre les noms de rôles du SIS aux noms de rôles de Brightspace. Les rôles d'enseignant(e) et d'élève sont inclus par défaut, mais ils peuvent être supprimés. Les rôles suivants sont disponibles dans OneRoster :
    • Administrateur
    • Aidant
    • Tuteur légal
    • Parent
    • Surveillant
    • Apparenté
    • Élève
    • Enseignant
  2. Pour ajouter des noms de rôle propres au SIS et effectuer la mise en correspondance avec les rôles d'Environnement d'apprentissage de Brightspace, cliquez sur + Ajouter un rôle.

    Remarque : Remarque : Si le SIS envoie un rôle qui n'est pas configuré, cela entraîne une erreur et l'utilisateur ne peut pas être créé.

    • Mettre en correspondance les entrées SIS avec des utilisateurs existants Permet de mettre en correspondance des entrées de SIS basées sur un nom d'utilisateur ou un ID défini par l'organisation avec les utilisateurs existants créés à l'extérieur du SIS (manuellement, à l'aide des opérations en bloc, à l'aide d'API, etc.). Si les fonctions de mise en correspondance sont désactivées, des doublons peuvent être créés.

  1. Cours et sections
    • Cours et sections - mappages: Cours et sections – Mises en correspondance : Cette section contient les types d'unités organisationnelles propres à OneRoster pour faire correspondre les organisations du SIS aux noms d'organisations Brightspace.
    • Cliquez sur + Ajouter un type d'unité org. pour ajouter des noms d'unité organisationnelle propres au SIS. Les types d'unité organisationnelle suivants sont requis pour Synergy :
      • Organisation SIS
        • Arrondissement
        • École
        • Local, National, Province et Département sont facultatifs
      • Type de séance académique
        • Semester
        • Terme
        • Année scolaire
        • GradingPeriod
      • Groupe SIS
        • Offre de cours
        • Section de cours
        • Modèle de cours
        • Association de section
    • Suppression Suppression : Cette section explique l'incidence des deux options de l'état à supprimer sur une unité organisationnelle dans Environnement d'apprentissage de Brightspace.
      • Ne rien faire – La correspondance de l'unité organisationnelle est supprimée de la mise en correspondance d'IPSIS, mais l'unité organisationnelle demeure inchangée dans Brightspace.
      • Désactiver l'offre de cours – La correspondance de l'unité organisationnelle est supprimée de la mise en correspondance d'IPSIS et l'offre de cours est indiquée comme étant désactivée dans Brightspace, mais la section et les inscriptions restent telles quelles.
    • Mettre en correspondance les entrées de SIS avec des cours et des sections Permet d'effectuer la mise en correspondance des entrées de SIS basées sur un code avec les unités organisationnelles existantes créées à l'extérieur du SIS (manuellement, à l'aide des opérations en bloc, à l'aide d'API, etc.). Il n'est pas recommandé de les activer pour les unités organisationnelles créées par votre SIS, à moins que vous n'ayez vérifié que les codes sont uniques dans l'ensemble des écoles et des années scolaires.
    •  Contenu de cours Permet de copier du contenu de cours d'un cours principal ou d'un modèle de cours dans un cours nouvellement créé. Sélectionnez Oui, puis choisissez l'une des actions suivantes :
      • n'est pas sélectionnée, le contenu sera copié d'une offre de cours principale vers l'offre de cours fraternelle lorsque l'offre de cours principale et le modèle de cours portent le même code d'unité organisationnelle.
      • Si vous trouvez une unité organisationnelle à copier automatiquement d'après des critères précis? est sélectionné, vous pouvez choisir entre deux options :
        • Modèle de cours primaire du nouveau cours
          • Le contenu sera copié du modèle de cours primaire vers la nouvelle offre de cours secondaire.
          • L'offre de cours fraternelle pour laquelle le code d'unité organisationnelle correspond au modèle primaire. Le contenu est copié de l'offre de cours source primaire vers la nouvelle offre de cours secondaire d'après le cours source qui est ajouté manuellement à Brightspace avec le même code d'unité organisationnelle que celui du modèle primaire.
  1. Exportation de notes
    • Permet d'autoriser la synchronisation des notes de tous les éléments de note modifiés au moment de la mise à jour planifiée et d'autoriser l'exportation des notes initiée par l'enseignant à partir de l'offre de cours.
  1. Départements, semestres et autres
    Mettre en correspondance les entrées SIS avec des unités organisationnelles existantes Permet d'effectuer la mise en correspondance des entrées de SIS basées sur un code avec les unités organisationnelles existantes créées à l'extérieur du SIS (manuellement, à l'aide des opérations en bloc, à l'aide d'API, etc.). Il n'est pas recommandé de les activer pour les unités organisationnelles créées par votre SIS, à moins que vous n'ayez vérifié que les codes sont uniques dans l'ensemble des écoles et des années scolaires.
  2. Une fois l'opération terminée, sélectionnez Enregistrer la configuration.

 

Dépannage de

Le Tableau de bord indique l'état de traitement du dernier lot. Les pages Tableau de bord et Lots affichent un indicateur final si le lot a été entièrement traité (avec ou sans erreurs). Chaque lot comprend un lien rapide vers l'élément Journal de vérification et, si le traitement comprend des erreurs, vers l'élément Messages d'erreur.

Examinez tous les journaux pour vous assurer que tous les enregistrements sont traités comme prévu. Si des messages d'erreur ont été consignés, développez l'erreur pour examiner les métadonnées saisies et identifier la cause, corrigez les données dans votre SIS et attendez la mise à jour planifiée du jour suivant ou enregistrez une requête de mises à jour dans le Tableau de bord. L'objectif consiste à traiter les exécutions sans erreur.

Comment synchroniser les notes d'appréciation

Les notes d'appréciation peuvent être transmises tous les soirs avec la mise à jour quotidienne de la liste, sur demande par l'interface des notes d'appréciation, ou les deux. Ces options sont configurées dans Administration d'IPSIS > Configuration > Exporter les notes d'appréciation.

Pour envoyer des notes, une catégorie, un élément de note et une note sont requis. Reportez-vous à la section Exportation des notes pour connaître les règles générales d'envoi d'une note d'appréciation.

Category

Les catégories sont automatiquement créées par Synergy. Ces catégories sont indiquées dans l'IU Gérer les notes par une icône SIS.

Création d'un élément de a note

  1. Dans la zone Gérer les notes, cliquez sur Nouveau et sélectionnez Élément.
  2. Réglez les préférences et les options de la catégorie.
  3. Choisissez une séance académique dans le menu déroulant.
  4. Cochez la case Fin du cours si le travail doit être envoyé en tant que travail de fin de cours.
  5. Faites correspondre l'élément de note à la catégorie synchronisée avec le SIS.
  6. Cliquez sur Enregistrer et fermer.

Exporter vers un fichier SIS

Pour synchroniser manuellement les notes avec le SIS :

  1. À partir de la page d'accueil du cours, accédez à Notes d'appréciation > Saisir la note d'appréciation > Exporter vers le SIS.
  2. Dans l'interface utilisateur Exporter les notes d'appréciation, un sommaire des notes s'affiche incluant :
  • Section : menu déroulant qui vous permet de choisir entre différentes sections de cours (si plusieurs existent)
  • Séance académique : menu déroulant qui vous permet de choisir entre différentes années scolaires associées au cours (si plusieurs séances académiques sont utilisées)
  • Survol : Aperçu : Répertorie le nombre de catégories et le nombre de notes d’appréciation dans les catégories qui répondent aux critères sélectionnés précédemment dans Section et Séance académique et qui peuvent être exportées
  • Exportation planifiée : visible uniquement si la configuration de l'intégration du SIS est configurée et est modifiable dans l'onglet Configuration de l'Administration d'IPSIS
  1. Cliquez sur Exporter. La page est actualisée et vous permet d'accéder à la page Afficher toutes les exportations. Cette interface utilisateur fournit une vue d'ensemble de l'expéditeur des notes d'appréciation et du moment où elles ont été envoyées.
    • Une fois l'exportation terminée, cliquez sur le nom d'exportation pour afficher les détails qui comprennent : Le nom du cours, les dates de début et de fin de l'exportation et l'utilisateur qui a lancé l'exportation

Remarque : Remarque : Si les notes d'appréciation sont envoyées par la synchronisation de nuit, l'utilisateur du service IPSIS s'affiche

  1. Détails d'exportations réussies et échouées pour les catégories, les éléments de note et les résultats :
  • Vous pouvez revenir à l'historique des exportations à l'aide de Notes d'appréciation > Saisir la note d'appréciation > Exporter vers le SIS et Afficher l'historique des exportations en haut à droite.