Hypothèses et limites

Hypothèses

D2L peut fonctionner avec n'importe quel SIS prenant en charge l'API REST OneRoster 1.1 et étant certifiée par IMS Global ou travaillant à obtenir leur certification.

Processus REST

  • Les exécutions planifiées s'exécutent à partir de la date d'exécution précédente de l'extraction de données jusqu'à la date de début de l'extraction de données en cours. S'il s'agit de la première exécution, elle agit comme une opération de synchronisation et s'exécute sans date de début dans la plage de dates.
  • Il existe une option permettant de déclencher manuellement une exécution à partir de la date d'exécution précédente, d'une date spécifique ou pour tous les dossiers du système.
  • Ordre d'appel : L'ordre dans lequel les différents points d'extrémité ou la consommation des différents fichiers sont appelés.
    • Séances académiques

    • Organisations

    • Écoles
    • Cours

    • Classes

    • Utilisateurs

    • Inscriptions

  • Ordre dans lequel les données sont renvoyées à Skyward
    • Catégories (requises sur demande dans le carnet de notes Brightspace)
    • LineItems (« articles de ligne » envoyés à la demande ou chaque nuit en fonction des autorisations d'exportation des notes)
    • Résultats (envoyés à la demande ou chaque nuit en fonction des autorisations d'exportation des notes)

Exportation de notes

Pour qu'une note soit exportée, le cours doit avoir été créé par l'intégration SIS OneRoster et l'exportation des notes d'appréciation doit être activée pour le système source OneRoster d'IPSIS. Le cours ne peut être mis en correspondance qu'avec un seul système source actif avec des notes d'appréciation. Les notes d'appréciation doivent appartenir à des catégories de notes récupérées du SIS et pour lesquelles une séance académique est sélectionnée.

Séances académiques

Le menu déroulant Séance académique (trimestre) est visible à la création d'un nouvel élément de note. Le menu est généré en recherchant toutes les unités organisationnelles créées par le même SIS que le cours où la mise en correspondance du SIS sert à la séance académique. La séance académique doit être un nœud primaire à l'offre de cours.

Catégories

Des catégories sont requises pour l'intégration. L'option Exporter vers le SIS doit être sélectionnée pour les catégories créées par Skyward. Cette catégorie sert à lier les éléments de note de sorte que l'Environnement d'apprentissage de Brightspace sait quels éléments de note doivent ou ne doivent pas être envoyés.

Fonctionnement de la synchronisation des notes d'appréciation

Les catégories de notes d'appréciation sont synchronisées à partir de Skyward sur demande dans le carnet de notes de Brightspace. Pour synchroniser les notes d'appréciation, naviguez jusqu'à Gérer les notes > Plus d'actions > Synchroniser les catégories du SIS. Les catégories de note d'appréciation du SIS ne sont pas mises en correspondance avec les catégories créées manuellement. Si une catégorie doit être supprimée, elle doit être supprimée dans Skyward, puis la synchronisation doit être lancée de nouveau dans le carnet de notes de Brightspace.

Les éléments de note (éléments de liste) sont synchronisés s'ils remplissent l'une des conditions suivantes :

  • L'élément n'a jamais été envoyé
  • L'élément a été mis à jour depuis son dernier envoi (cela comprend le nom, la séance académique, les points, les suppressions, la restauration d'éléments supprimés)
  • L'élément n'a pas pu être envoyé lors de la dernière exportation
  • Un travail et une date d'échéance sont envoyés avec l'élément en ligne. Voici la logique utilisée par Brightspace pour l'envoi de dates :

    • La date de travail de l'élément de ligne (Note d'appréciation) est déterminée comme suit :
      • Utilisez la date de début de l'activité, si elle existe, sinon
      • Utilisez la date d'échéance de l'activité, si elle existe, sinon
      • Utilisez la date de fin de l'activité, si elle existe, sinon
      • Utilisez la date de fin de la séance académique
    • La date d'échéance de l'élément de ligne (Note d'appréciation) est déterminée comme suit :
      • Utilisez la date d'échéance de l'activité, si elle existe, sinon
      • Utilisez la date de fin de l'activité, si elle existe, sinon
      • Utilisez la date de fin de la séance académique

Remarque : L'identifiant source de l'élément envoyé est spécifique à la classe et est généré comme suit : {lineItemSourcedId}_{classSourcedId}

Les notes d'appréciation (résultats) sont synchronisées si elles remplissent l'une des conditions suivantes :

  • Le résultat n'a jamais été envoyé
  • Le résultat a été mis à jour depuis son dernier envoi
  • Le résultat n'a pas pu être envoyé lors de la dernière exportation
  • L'élément primaire a été modifié depuis la dernière exportation

Remarque : L'identifiant source de l'élément envoyé est spécifique à la classe et est généré comme suit : {lineItemSourcedId}_{classSourcedId}

Les notes d'appréciation (résultats) sont synchronisées si elles remplissent l'une des conditions suivantes :

  • Le résultat n'a jamais été envoyé
  • Le résultat a été mis à jour depuis son dernier envoi
  • Le résultat n'a pas pu être envoyé lors de la dernière exportation
  • L'élément primaire a été modifié depuis la dernière exportation

Limites

  • Les enregistrements dont l'état est à supprimer ne sont supprimés que si son élément secondaire est supprimé
  • Les inscriptions effectuées par le biais de la propriété de l'organisation de l'utilisateur ne peuvent être annulées dans l'intégration OneRoster pour le moment.
  • Caractères non pris en charge : plusieurs caractères ne sont pas pris en charge dans le code de l'unité organisationnelle Brightspace. Ces caractères sont remplacés par un trait de soulignement ( _ ). Caractères non pris en charge : \ : * ? “ ” < > | ' # % &
  • Troncatures : La longueur maximale du code de l'unité organisationnelle dans Brightspace est de 50 caractères. Si cette longueur est excédée, le code est tronqué dans l'interface utilisateur.
  • OneRoster permet plusieurs ScoreStatus : l'Environnement d'apprentissage de Brightspace n'envoie que les éléments entièrement notés ou qui sont exemptés.