Les intégrations OneRoster 1.1 REST vous permettent de planifier l'extraction de données de votre organisation du SIS pour générer les données d'inscription requises (y compris les données liées aux écoles, classes, utilisateurs, inscriptions, etc.) dans Brightspace. L'interface utilisateur Administration IPSIS comprend un calendrier qui vous permet de configurer l'heure de l'extraction des données.
Points d'extrémité REST utilisés :
Type
|
URL
|
Organisations
|
ims/oneroster/v1p1/orgs
|
Séances académiques
|
ims/oneroster/v1p1/academicSessions
|
Cours
|
ims/oneroster/v1p1/courses
|
Classes
|
ims/oneroster/v1p1/classes
|
Utilisateurs
|
ims/oneroster/v1p1/users
|
Inscriptions
|
ims/oneroster/v1p1/enrollments
|
Avant de pouvoir utiliser l'intégration OneRoster REST 1.1 pour importer des données de votre SIS dans Brightspace, vous devez effectuer les étapes de configuration initiales suivantes :
Activer les outils Administration d'IPSIS et Plateforme IPSIS
Vous devez activer les outils Administration d'IPSIS et Plateforme IPSIS avant de pouvoir attribuer des autorisations relatives aux rôles IPSIS et accéder aux fonctionnalités d'administration d'IPSIS.
Marche à suivre pour activer les outils requis
- Dans le menu Outils d'administration, cliquez sur Outils de l'organisation.
- À la page Disponibilité de l'outil, activez Administration d'IPSIS et Plateforme IPSIS.
Définir un rôle d'utilisateur et accorder des autorisations pour l'outil Administration d'IPSIS
Une fois que vous avez activé Administration IPSIS et la plateforme IPSIS, vous devez définir votre rôle d'utilisateur (ou d'autres rôles) et attribuer des autorisations pour vous assurer de pouvoir gérer IPSIS dans Brightspace.
|
Conseil : Vous pouvez modifier les autorisations en fonction des rôles. Par exemple, vous pourriez autoriser un rôle donné à exécuter toutes les opérations sauf la gestion des options de configuration de l'administration d'IPSIS. Pour en savoir plus sur la création de rôles, consultez la rubrique Gestion des rôles et des autorisations. |
Marche à suivre pour configurer les rôles d'utilisateur pour Administration IPSIS
- Dans le menu Outils d'administration, cliquez sur Rôles et autorisations.
- Créez ou sélectionnez un rôle pour l'administration d'IPSIS.
- À la page Modifier les autorisations, accordez les autorisations Administration IPSIS suivantes au rôle :
- Accéder à la console Administration d'IPSIS : Cette autorisation permet à un utilisateur de voir Administration IPSIS dans le menu Outils d'administration, sous la section Intégration du SIS.
- Gérer les opérations d'IPSIS en bloc : cette autorisation permet à un utilisateur de téléverser des fichiers aux fins de traitement et de consulter les journaux des dépannages antérieurs.
- Afficher les options de configuration d'IPSIS : cette autorisation permet à un utilisateur d'accéder à l'onglet Configuration de la page Administration d'IPSIS.
- Gérer les options de configuration d'IPSIS : cette autorisation permet à un utilisateur de modifier les paramètres de l'onglet Configuration, y compris la gestion du compte IPSISSFTP
- S'abonner aux notifications de tâches en lot : cette autorisation permet à un utilisateur de s'abonner afin de recevoir une notification à la fin du traitement d'un lot.
- Accordez les autorisations supplémentaires suivantes :
- Confidentialité de l'information de l'utilisateur – Afficher les noms d'utilisateur
- Confidentialité de l'information de l'utilisateur – Afficher les ID définis par l'organisation
- Éditeur d'unité organisationnelle > Peut créer et modifier des unités organisationnelles
- Sécurité > Afficher les rôles et autorisations
Configurer des notifications par courriel pour les tâches de traitement de OneRoster REST
Vous pouvez configurer une notification par courriel pour vous aviser chaque fois que l'intégration OneRoster REST traite une tâche du SIS.
|
Remarque :
- D2L recommande d'utiliser les notifications par courriel plutôt que par texto puisque les courriels comprennent plus de détails sur l'exécution du SIS (réussites, échecs et sommaire). Les textos indiquent uniquement qu’une exécution a été effectuée.
- Les courriels sont envoyés au moyen de la configuration NotificationEmail (Courriel de notification) de votre environnement. Si vous éprouvez des difficultés à recevoir un courriel et que vous avez vérifié que votre adresse de courriel est exacte, D2L vous recommande de communiquer avec l'équipe de soutien de D2L pour vérifier que votre environnement est adéquatement configuré pour les notifications par courriel. Vous devrez peut-être vérifier votre dossier de courriels indésirables, selon votre fournisseur de service de messagerie.
|
Pour configurer les notifications par courriel
- Dans la barre de navigation, cliquez sur votre icône de profil d'utilisateur, puis sélectionnez Notifications.
- Sous Méthodes de communication > Adresse courriel, assurez-vous que votre adresse de courriel est répertoriée.
- Sous Notifications instantanées > Plateforme IPSIS – Sommaire d'achèvement du lot, cochez la case Courriel.
Options de filtrage d'exportation des notes d'appréciation durant la configuration de l'intégration OneRoster REST
Lorsque vous configurez une intégration OneRoster 1.1 REST pour inclure les notes d'appréciation dans une mise à jour quotidienne planifiée, vous pouvez :
-
Exporter uniquement les notes d'appréciation des cours actifs. Tous les cours dont le statut est inactif sont ignorés et les modifications apportées aux notes d'appréciation des cours inactifs sont exclues.
-
Limiter la source d'exportation des notes d'appréciation aux cours qui ont commencé et qui ne sont pas terminés. Vous pouvez inclure des cours synchronisés ne figurant pas dans la plage de dates de début et de fin. Cette option permet aux administrateurs de commencer la synchronisation des notes d'appréciation avant le début du cours et de continuer l'exportation après la date de fin d'un cours pour s'assurer que les modifications apportées tardivement aux notes d'appréciation sont incluses dans l'exportation.
Marche à suivre pour limiter la source d'exportation des notes d'appréciation aux cours actifs seulement
- Cliquez sur Outils d'administration.
- Sous Intégration du SIS, cliquez sur Administration IPSIS.
- Pour ajouter une nouvelle intégration OneRoster REST, cliquez sur Ajouter un SIS.
- Sous Sélectionner le type de système, sélectionnez OneRoster 1.1 - REST.
- Sélectionnez un fournisseur de SIS et cliquez sur Suivant.
- À la page Configurer votre intégration, faites défiler l'écran jusqu'à la section Exporter les notes d'appréciation.
- Pour limiter la d'exportation des notes d'appréciation aux cours actifs seulement, procédez comme suit
- Sélectionnez Exporter toutes les notes d'appréciation dans le SIS lors de la mise à jour quotidienne planifiée.
- Sélectionnez Exporter uniquement les notes d'appréciation des cours actifs.
Figure : Sélectionnez Exporter uniquement les notes d'appréciation des cours actifs pour limiter l'exportation des notes d'appréciation au SIS.
- Pour terminer la configuration de votre intégration, cliquez sur Créer un système source.
|
Remarque : Tous les cours définis comme inactifs sont ignorés et les modifications apportées aux notes d'appréciation des cours inactifs sont exclues.
|
Votre intégration One Roster 1.1 - REST est configurée de sorte à n'exporter que les notes d'appréciation des cours actifs dans le SIS.
Marche à suivre pour exporter uniquement les notes d'appréciation des cours qui ont commencé et qui ne sont pas terminés
- À la page Configurer votre intégration, faites défiler l'écran jusqu'à la section Exporter les notes d'appréciation.
- Sélectionnez Exporter toutes les notes d'appréciation dans le SIS lors de la mise à jour quotidienne planifiée.
- Sélectionnez Exporter uniquement les notes des cours qui ont commencé et qui ne sont pas terminés, puis faites ce qui suit, si désiré :
- Définissez le nombre de jours, avant ou après le début du cours, pour commencer l'exportation des notes d'appréciation.
- Définissez le nombre de jours, avant ou après la fin du cours, pour commencer l'exportation des notes d'appréciation.
Figure : Saisissez le nombre de jours, puis sélectionnez Avant ou Après.
- Pour terminer la configuration de votre intégration, cliquez sur Créer un système source.
Votre intégration One Roster 1.1 - REST est configurée de sorte à n'exporter que les notes des cours qui ont commencé et qui ne sont pas terminés.