Des investissements dans les processus d'intégration SIS peuvent exister sur votre campus. Vous pouvez continuer à utiliser ces processus d'intégration comme vous l'avez fait par le passé tout en évaluant l'adoption des types d'intégration de la structure d'intégration SIS. Toutefois, il est important de comprendre qu'au fur et à mesure que Learn évolue, les processus d'intégration hérités risquent de ne pas suivre le rythme des nouveaux objets qui sont introduits pour prendre en charge les nouvelles fonctionnalités et capacités de Learn.


À propos de l'intégration SIS et de la structure d'intégration SIS Learn

Avec l'intégration du système d'informations étudiants (SIS), les administrateurs peuvent intégrer des données de cours, utilisateur et d'inscription à Blackboard Learn. Les données peuvent provenir de multiples sources et dans divers formats. L'intégration SIS facilite la mise à niveau vers Blackboard Learn à partir d'un autre système de gestion de l'apprentissage (LMS), tel que CE ou Vista, en prenant en charge le même format de source de données généré par ces systèmes pour l'échange de données. L'intégration SIS permet également de déléguer des mises à jour du système à d'autres administrateurs Blackboard, créant ainsi une certaine flexibilité dans le système.

La structure d'intégration SIS est un cadre extensible composé de Building Blocks qui fournit des fonctionnalités communes à toutes les intégrations tout en facilitant la création, la configuration et la gestion de l'intégration dans l'interface utilisateur du panneau de configuration de l'administrateur de Blackboard Learn. Le principe repose sur une séparation fonctionnelle. La structure SIS fournit les capacités de création, de configuration et d'exploitation/maintenance basées sur l'interface utilisateur, ainsi que les types d'intégration (basés sur des Building Blocks) pour fournir la logique propre à chaque type d'intégration SIS. La structure SIS peut ainsi prendre en charge une approche d'intégration mixte et plusieurs instances de type d'intégration. Il en résulte une grande flexibilité dans la mise en place des solutions d'intégration SIS, car il est alors possible de répondre aux besoins d'intégration, des plus simples aux plus complexes.

En savoir plus sur les types d'intégration SIS

Une capacité supplémentaire disponible pour tous les types d'intégration est le mappage des données à la volée. Cette capacité permet d'établir un mappage personnalisé entre les objets de données entrants et les objets de données Blackboard Learn. Cette capacité de mappage vous permet d'appliquer des scripts personnalisés javascript aux données entrantes. Dans le cas du type d'intégration de fichier plat d'instantané, vous pouvez appliquer des mappages d'en-tête personnalisés pour faire correspondre les formats de données existants aux formats de Blackboard. Vous pouvez en savoir plus sur le mappage personnalisé qui se rapporte à chaque type d'intégration dans la section Exemples de chacun d'entre eux.


Planification

L'utilisation d'intégrations du système d'informations étudiants (SIS) vous permet de profiter de quelques avantages clés concernant le transfert de données vers Blackboard Learn pour insérer automatiquement des éléments dans votre système et les mettre à jour. Le premier avantage consiste à pouvoir déléguer la gestion des cours et des données utilisateur à un ou plusieurs administrateurs qui ne nécessitent pas d'accès de ligne de commande aux serveurs Blackboard. Un autre avantage consiste à pouvoir transférer des données rapidement et efficacement de votre système d'informations à Learn.

Il est essentiel d'impliquer toutes les parties prenantes dans le processus de planification de l'intégration. L'exploitation des contributions de votre SIS et du bureau des inscriptions, ainsi que des équipes d'administration Learn, assurera la réussite de l'intégration.

Pour réussir une intégration, il faut connaître les options de configuration du SIS, sélectionner le type d'intégration Learn qui répond à vos besoins et comprendre les données requises pour le type d'intégration. Dans le cas des types d'intégration de fichier plat et Enterprise 1.1, il est également nécessaire de comprendre les scripts côté serveur pour faciliter le transfert des données vers les points d'arrêt d'intégration.

En savoir plus sur la planification des intégrations SIS


Services de mentorat

Grâce à un engagement de services avec Blackboard Consulting, vous pouvez planifier, mettre à l'échelle et mettre à niveau vos intégrations. Blackboard Consulting offre un programme d'intégration complet qui répond à vos besoins.

Mentorat de la structure d'intégration SIS

Le service de mentorat de la structure d'intégration SIS a pour objectif d'aider les clients à mettre en œuvre la structure d'intégration SIS Blackboard Learn. Ce service entièrement à distance fournira à votre district des conseils sur les éléments de données de base, la configuration, le nettoyage des données, les techniques de script et le dépannage.

Activités du projet

  • Affecter un consultant à distance à votre établissement pour la durée du projet.
  • Identifier les éléments de données de base, les comportements et les règles d'affaires pour automatiser les processus de création de compte utilisateur et de création de cours, d'inscription des utilisateurs et d'affectation du corps enseignant/personnel aux cours.
  • Documenter les décisions concernant les éléments de données clés dans un classeur de planification des données pour une utilisation ultérieure par le client.
  • Fournir des conseils sur la configuration de la structure d'intégration SIS afin de répondre aux exigences documentées en matière de données.
  • Aider au nettoyage des données des comptes utilisateurs existants dans l'environnement Blackboard Learn afin d'assurer la compatibilité avec un environnement automatisé et intégré.
  • Fournir un aperçu des techniques de script de base à utiliser pour la transformation des données dans la structure d'intégration SIS.
  • Revoir les techniques de dépannage des problèmes de données et d'intégration.
  • Revoir la gestion du cycle de vie des données et obtenir un aperçu des meilleures pratiques d'archivage et de purge des données Blackboard.
  • Configurer les artefacts du programme de la structure d'intégration SIS :
    • Documentation sur les exigences des processus métier (Classeur de planification des données)
    • Documentation sur la configuration de l'intégration (Classeurs d'exploitation)
    • Matériel de référence et documentation du produit Blackboard Learn Core

Passez à l'étape suivante !

Contactez le représentant commercial de Blackboard pour planifier un rendez-vous en vue de discuter des options recommandées et des prochaines étapes à suivre. Mettez l'accent sur la participation et l'évaluation des apprenants, et non sur la navigation dans une intégration de données complexe. Laissez-vous guider par l'équipe Blackboard Consulting.

Le service de mentorat de la structure d'intégration SIS des services Consulting vous fournira le soutien dont vous avez besoin pour automatiser le transfert vers Blackboard Learn des informations sur les utilisateurs, les cours et les inscriptions à partir d'un système source (tel que SIS, LMS, RH, ERP ou un autre système d'enregistrement). Le service Consulting travaillera à vos côtés pour identifier les éléments de données clés, les comportements et les règles d'affaires.


Fonctionnement de la structure d'intégration SIS

Parallèlement aux options de configuration et aux types de données d'intégration (couverts dans des sections propres aux différents types d'intégration), la structure d'intégration SIS repose sur quatre concepts clés :

  1. Format des données
  2. Transfert de données
  3. Propriété des données
  4. Traitement des données

En résumé, chaque type d'intégration et chaque instance configurée reçoit des données correctement formatées selon les exigences applicables à l'intégration(1) en vue du transfert dans Learn via un ensemble de services d'intégration spécifiques(2) en utilisant un identificateur unique par instance d'intégration configurée qui contrôle la propriété des données(3) pour le traitement par la structure SIS Learn(4).

Chacun de ces points renvoie à des concepts importants pour comprendre le fonctionnement non seulement de la structure d'intégration SIS, mais également la meilleure façon de déterminer votre configuration d'intégration et de construire votre infrastructure d'intégration à l'appui de la structure d'intégration SIS.

Format des données

Chaque type d'intégration de données prend en charge un format de données propre. Ainsi, les données destinées à Enterprise 1.1 sont différentes de celles d'Enterprise 1.1 Vista qui sont aussi différentes de celles des fichiers plats d'instantanés et de LIS. La connaissance de ces formats de données renseigne non seulement sur les types d'objets pris en charge par l'intégration associée, mais également sur la syntaxe du mappage personnalisé correspondant au type d'intégration.

Les formats de données d'intégration sont abordés de façon approfondie dans les rubriques consacrées à chaque type d'intégration.

Transfert de données

Chaque type d'intégration de données prend en charge le transfert de données via les points d'arrêt de services HTTP propres au type d'intégration en termes de méthode et de format. Dans tous les cas, il est recommandé de transmettre des données via une connexion HTTPS.

Des détails sur le modèle de transfert de données de chaque type d'intégration et sur les paramètres Learn sont fournis dans les rubriques propres à chaque type d'intégration.

Tous les types d'intégration peuvent recevoir des données par câble en dirigeant les données vers l'URL d'intégration. Ceci est utile pour les types d'intégration Enterprise 1.1 et d'instantanés, puisqu'il est désormais possible de transférer des données sur le réseau et de publier des données à partir de fichiers.

Propriété des données

La structure d'intégration SIS permet de gérer les données en utilisant plusieurs types d'intégration. Chaque configuration d'intégration déployée gère les données propres à l'intégration en question et d'aucune autre. Bien qu'elles puissent être utilisées pour regrouper les données à des fins de gestion par l'intermédiaire de l'interface utilisateur et d'outils connexes, les clés de source de données ne sont pas utilisées par la structure d'intégration SIS pour limiter les changements apportés aux données connexes. Les objets Learn appartiennent en effet à l'intégration qui les a créés et non aux clés de source de données associées. Cela signifie qu'une intégration peut agir sur tous les points de données qu'elle possède, indépendamment des clés de source de données associées.

En savoir plus sur les clés de source de données

Les différentes instances d'un même type d'intégration sont identifiées de manière unique par un UID généré par le système qui est affiché sur la page de configuration de l'intégration. Dans le cas de LIS, cet UID peut être utilisé pour la configuration du SIS ou, dans le cas des types d'intégration Enterprise ou d'instantané, pour des services fournis par le client qui transmettent les données d'intégration au point d'arrêt. Pour en savoir plus sur la configuration de LIS ou du service client, reportez-vous aux rubriques consacrées à la configuration et à l'automatisation pour chaque type d'intégration.

Traitement des données

Quel que soit le type d'intégration ou le format de données, tous les traitements s'effectuent de la même manière :

  1. La structure d'intégration SIS reçoit une demande sur un point d'arrêt propre à un type d'intégration.
  2. En fonction de l'UID entrant, la configuration du type d'intégration est chargée.
  3. En cas de prétraitement réussi des données à valider, la tâche est négociée par ActiveMQ pour être exécutée sur un serveur d'application Learn cible.
  4. Les données sont traitées en fonction des paramètres de configuration, des en-têtes personnalisés et du mappage personnalisé si l'intégration les utilise.
  5. Toutes les opérations de traitement d'objets sont enregistrées par objet, écrites dans un fichier journal et stockées dans la base de données Learn pour être extraites par la visionneuse du journal de l'interface utilisateur.

La structure d'intégration SIS ne traite pas les données en parallèle, car cela introduirait un risque élevé de conditions de course aux données. Au lieu de cela, les données sont traitées sur le modèle du « premier entré, premier sorti », ce qui permet d'être certain qu'elles sont traitées dans l'ordre requis. Vous devez donc toujours attendre que le traitement d'un ensemble de données soit terminé avant d'envoyer un autre ensemble de données.


Types d'intégration, prise en charge des objets et exigences

La structure SIS Learn prend en charge cinq types d'intégration dans une installation par défaut composée de types d'intégration standard et Blackboard. D'autres types personnalisés peuvent être développés et ajoutés via Building Block Manager. Cette capacité de compléter les types pris en charge par des types supplémentaires élargit considérablement la valeur de la structure SIS dans l'entreprise, et nous permet, le cas échéant, de mettre à jour les types d'intégration prêts à l'emploi basés sur des Building Blocks.

Chaque type d'intégration fournie par Learn prend en charge les objets Learn et les exigences du système d'informations propres au type d'intégration. Vous trouverez ci-dessous une description générale des types d'intégration, des objets pris en charge et des exigences du système d'informations dans le cadre de la prise en charge de l'intégration.

Notez que les types d'intégration prennent en charge les objets Learn comme spécifié par le type d'intégration. Il n'existe pas de chevauchement à 100 % dans la prise en charge des objets pour tous les types d'intégration. Il s'agit là d'un critère majeur pour le choix de votre type d'intégration. Une autre considération clé est la capacité du système d'informations à prendre en charge le type d'intégration et le format des données. Pour en savoir plus sur un type d'intégration, le format et les moyens de transport des données, reportez-vous aux sections relatives aux différents types d'intégration.

Comme Learn progresse dans la prise en charge de l'intégration du système d'informations, nous nous concentrerons sur les types d'intégration LIS 2.0 et de fichier plat d'instantané. Ceux-ci doivent donc être considérés comme des cibles prioritaires pour l'intégration. Les trois autres types d'intégration sont fournis pour aider les clients dont les intégrations existantes utilisent ces intégrations et pour lesquels l'utilisation de la structure SIS présente un intérêt. Notez que les types d'intégration Enterprise 1.1, Enterprise 1.1 Vista et XML d'instantanés ne feront l'objet d'aucun développement ultérieur concernant la prise en charge des nouveaux objets Learn.

Enterprise 1.1 et Enterprise 1.1 Vista

Enterprise 1.1 : Enterprise 1.1 a été introduit en 2002 et devait remplacer Enterprise 1.0 (1999). Ce type d'intégration a fourni une description de données basée sur XML pour transmettre des informations sur les personnes, le groupe et l'adhésion à un groupe. Destiné à l'échange de données au sein des systèmes Enterprise d'établissement et entre eux, les principaux fournisseurs ont adopté la norme à des fins d'intégration : WebCT et Learn ont adopté cette norme.

Enterprise 1.1 est souvent considéré dans le contexte d'intégrations « événementielles », bien qu'il ait également été utilisé pour générer des fichiers de données plats. Les deux « versions » d'Enterprise 1.1 que Learn prend en charge sont la version Vista d'origine et une version d'Ellucian Banner qui contient les extensions de la spécification pour les clients Banner. Il s'agit des types d'intégration Enterprise 1.1 Vista et Enterprise 1.1 dans la structure SIS.

Objets pris en charge

Conçu pour les établissements qui :

  • fournissent une présentation du processus métier ;
  • fournissent des directives de configuration de la structure d'intégration SIS ;
  • fournissent un examen des techniques de script de base ;
  • fournissent des techniques de dépannage en cas de problèmes de données et d'intégration.
  • Documenter les décisions relatives aux éléments de données clés
Objets pris en charge - Enterprise 1.1
ObjetDescription
CoursDonnées destinées à la création et à la gestion des cours
UtilisateursDonnées destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.)
InscriptionsDonnées destinées à la création et à la gestion des adhésions aux cours (inscriptions)
NœudsDonnées destinées à la création et à la gestion des relations hiérarchiques
ConditionsDonnées destinées à la création et à la gestion
Mise en commun de coursDonnées destinées à la fusion des cours enfants et parents
Rôles dans l'établissementDonnées destinées à la gestion des relations des rôles utilisateur.

Seul le rôle principal dans l'établissement peut être un objet Utilisateur dans cette intégration à l'aide d'un mappage de champs personnalisé. Les intégrations où le rôle dans l’établissement est pleinement prise en charge soutiennent les rôles principaux ET secondaires dans l'établissement.

AssociationsDonnées destinées à la création et à la gestion des sites Associations Learn.

Des associations peuvent être créées dans cette intégration à l'aide d'un mappage de champs personnalisé portant sur les objets Cours. Les intégrations dans lesquelles les associations sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux associations.

Systèmes d'information

Versions de Peoplesoft :

Peoplesoft Campus Solutions 9, bundle 21 ou versions antérieures

Versions d'Ellucian Banner :

Banner version générale

- 8.0 ou versions ultérieures pour Intcomp 8.0.1

- 8.1 ou versions ultérieures pour Intcomp 8.0.2

Banner version pour étudiants

- 8.0 ou versions ultérieures pour Intcomp 8.0.1

- 8.1 ou versions ultérieures pour Intcomp 8.0.2

Banner Intcomp - 8.0.1 ou versions ultérieures

Banner Financial Aid - 8.x

Banner Integration for eLearning - 8.0

Ellucian Colleague

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Avant de vous engager à prendre en charge Enterprise 1.1, confirmez la prise en charge sur les versions ultérieures des systèmes tiers.

Reportez-vous à la section Type d'intégration Enterprise 1.1 pour obtenir une description détaillée du type d'intégration. Notez que le format de données est légèrement différent entre les deux versions d'Enterprise 1.1 (standard et Vista) prises en charge.

LIS 2.0

LIS 2.0 : Learner Information Services 2.0 doit être considéré comme le substitut d'Entreprise 1.1 et comprend une solution basée sur les leçons tirées des insuffisances d'Entreprise 1.1. LIS 2.0 décrit non seulement les données, mais aussi les méthodes de transport et de publication/consommation de ces données. Cela permet d'établir un mappage 1:1 entre les données du système LIS d'origine et les processus qui autorisent la consommation de ces données. Ce point est intéressant pour les intégrations plug and play. LIS 2.0 est basé sur des services Web. Des systèmes compatibles transmettent les données sur la base de services connus et, en fournissant simplement les points d'arrêt du système, deux systèmes peuvent échanger des données.

LIS 2.0 est un modèle « événementiel », bien que des fichiers plats adhérant à la description de données XML LIS2.0 puissent être générés pour un téléchargement manuel.

Objets pris en charge

Objets pris en charge - LIS 2.0
ObjetDescription
CoursDonnées destinées à la création et à la gestion des cours
UtilisateursDonnées destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.)
InscriptionsDonnées destinées à la création et à la gestion des adhésions aux cours (inscriptions)
ConditionsDonnées destinées à la création et à la gestion
Rôles dans l'établissementDonnées destinées à la gestion des relations des rôles utilisateur.

Seul le rôle principal dans l'établissement peut être un objet Utilisateur dans cette intégration à l'aide d'un mappage de champs personnalisé. Les intégrations où le rôle dans l’établissement est pleinement prise en charge soutiennent les rôles principaux ET secondaires dans l'établissement.

AssociationsDonnées destinées à la création et à la gestion des sites Associations Learn.

Des associations peuvent être créées dans cette intégration à l'aide d'un mappage de champs personnalisé portant sur les objets Cours. Les intégrations dans lesquelles les associations sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux associations.

Systèmes d'information

Versions de Peoplesoft :

Peoplesoft Campus Solutions 9, bundle 22 ou versions ultérieures

http://www.oracle.com/us/industries/education-and-research/056908.pdf

Versions d'Ellucian Banner :

Banner version générale

- 8.1 ou version ultérieure requis

Banner version pour étudiants

- 8.1 ou version ultérieure requis

Banner Intcomp

- 8.0.2 ou version ultérieure requis

Banner Financial Aid

- 8.11

Pour Oracle Application Server

- 10.1.3

Ellucian Colleague

Nécessite ILP version 3.5

Avant de vous engager à prendre en charge Enterprise 1.1, confirmez la prise en charge sur les versions ultérieures des systèmes tiers.

En savoir plus sur LIS - IMS Learning Information Services

Fichier plat d'instantané

Learn prend également en charge notre approche de fichier plat d'instantané pour l'importation de données. L'intégration d'instantanés a été la première à être prise en charge au sein de Learn Enterprise, et connaît un succès depuis longtemps grâce à sa simplicité de fonctionnement. À l'origine, les instantanés prenaient en charge les fichiers XML et CSV (un fichier créé par tâche de gestion des données pour les utilisateurs, les cours, les inscriptions et les affectations du personnel). La structure SIS prend en charge la consommation de fichiers d'instantanés à l'aide des types d'intégration XML d'instantanés ou fichier plat d'instantané. Notez cependant que le fichier plat d'instantané est le seul format à pouvoir désormais recevoir les mises à jour de prise en charge des « nouveaux » objets de données. Le format XML d'instantanés a été gelé à cet égard et est susceptible de ne pas répondre aux exigences d'intégration futures.

Objets pris en charge

Objets pris en charge - Fichier plat d'instantané
ObjetDescription
CoursDonnées destinées à la création et à la gestion des cours et de la vue des cours
UtilisateursDonnées destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.)
InscriptionsDonnées destinées à la création et à la gestion des adhésions aux cours (inscriptions)
NœudsDonnées destinées à la création et à la gestion des relations hiérarchiques
ConditionsDonnées destinées à la création et à la gestion
Catégories du catalogueDonnées destinées à la création et à la gestion du catalogue des cours Learn
Rôles dans l'établissementDonnées destinées à la gestion des relations des rôles utilisateur.

Seul le rôle principal dans l'établissement peut être un objet Utilisateur dans cette intégration à l'aide d'un mappage de champs personnalisé. Les intégrations où le rôle dans l’établissement est pleinement prise en charge soutiennent les rôles principaux ET secondaires dans l'établissement.

AssociationsDonnées destinées à la création et à la gestion des sites Associations Learn.

Des associations peuvent être créées dans cette intégration à l'aide d'un mappage de champs personnalisé portant sur les objets Cours. Les intégrations dans lesquelles les associations sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux associations.

Cours communsDonnées destinées à la fusion des cours enfants et parents
ObservateursDonnées destinées à la création et à la gestion des observateurs

Systèmes d'information

Versions de Peoplesoft :

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Versions d'Ellucian Banner :

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Ellucian Colleague

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Avant de vous engager à prendre en charge les fichiers plats d'instantanés, confirmez la prise en charge de l'extraction des données sur les versions installées des systèmes tiers.

En savoir plus sur les fichiers plats d'instantanés

XML d'instantanés

L'intégration XML d'instantanés est étroitement liée à la spécification Enterprise 1.1 avec des ajouts propres à Learn. À l'instar d'Enterprise 1.1, l'intégration XML d'instantanés est plus flexible dans le sens où les fichiers XML peuvent contenir un type de données, ou combiner plusieurs types de données à traiter simultanément.

Il est important de rappeler que le format de données XML d'instantanés ne doit pas être la première option d'intégration à retenir, car il ne reçoit que des mises à jour de maintenance et non la prise en charge de nouveaux objets ou le développement de fonctionnalités. Chacun s'attend à ce qu'une annonce soit faite prochainement concernant l'arrêt de la prise en charge. Les clients disposeront de suffisamment de temps pour s'adapter.

Objets pris en charge

Objets pris en charge - XML d'instantanés
ObjetDescription
CoursDonnées destinées à la création et à la gestion des cours
UtilisateursDonnées destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.)
InscriptionsDonnées destinées à la création et à la gestion des adhésions aux cours (inscriptions)
Catégories du catalogueDonnées destinées à la création et à la gestion du catalogue des cours Learn
Rôles dans l'établissementDonnées destinées à la gestion des relations des rôles utilisateur.

Seul le rôle principal dans l'établissement peut être un objet Utilisateur dans cette intégration à l'aide d'un mappage de champs personnalisé. Les intégrations où le rôle dans l’établissement est pleinement prise en charge soutiennent les rôles principaux ET secondaires dans l'établissement.

AssociationsDonnées destinées à la création et à la gestion des sites Associations Learn.

Des associations peuvent être créées dans cette intégration à l'aide d'un mappage de champs personnalisé portant sur les objets Cours. Les intégrations dans lesquelles les associations sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux associations.

ObservateursDonnées destinées à la création et à la gestion des observateurs

Systèmes d'information

Versions de Peoplesoft :

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Versions d'Ellucian Banner :

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Ellucian Colleague

Nécessite des outils pour extraire et convertir les données avant de les envoyer à Learn

Avant de vous engager à prendre en charge le format XML d'instantanés, confirmez la prise en charge de l'extraction des données sur les versions installées des systèmes tiers.

En savoir plus sur le format XML d'instantanés

Intégrations personnalisées

Comme la structure d'intégration SIS est extensible grâce aux Building Blocks, vous pouvez utiliser les API de cette structure pour créer des types d'intégration personnalisés qui répondent à vos besoins métier. Ceci est valable si votre système d'information ne prend pas en charge l'un des types d'intégration fournis par Learn ou si vous avez des besoins d'intégration spécifiques en dehors du cadre des types d'intégration fournis par Learn. Dans ces cas, vous pouvez construire votre propre Building Block d'intégration, et contrôler les objets Learn pris en charge par votre intégration et la logique d'intégration propre à votre système d'informations.


Prise en charge et configuration générales

Les services d'assistance Blackboard prennent en charge les types d'intégration fournis par Learn. Si vous avez des questions ou si vous rencontrez des problèmes avec vos processus de configuration ou d'intégration, vous pouvez contacter l'assistance en remplissant un ticket de support sur la page Behind the Blackboard.

Vous configurez Learn pour recevoir des données pour chaque type d'intégration à l'aide des pages de configuration de l'intégration SIS de l'administrateur Learn. Pour mettre en place une intégration, une fois que vous avez déterminé le type le plus adapté à vos objectifs commerciaux et à vos capacités d'information, vous devez effectuer neuf étapes sur la page principale de configuration SIS :

  1. Créez une intégration en sélectionnant le type d'intégration dans le menu déroulant Créer.
  2. Configurez votre nouvelle intégration.
  3. Placez l'intégration en mode test.
  4. Apportez les modifications voulues au mappage personnalisé.
  5. Testez l'intégration (aucune modification n'est apportée aux données Learn lorsqu'une intégration est en mode test).
  6. Confirmez la configuration en visualisant les journaux d'intégration dans l'interface utilisateur
  7. Répétez les étapes 4 à 6 jusqu'à ce que l'intégration fonctionne conformément à vos attentes.
  8. Une fois les tests réussis, placez l'intégration en mode actif pour commencer.
  9. Surveillez votre intégration en observant les journaux d'intégration.

Pour en savoir plus, consultez les rubriques de configuration de chaque type d'intégration.


Journalisation de l'intégration

La journalisation est disponible pour tous les types d'intégration via l'interface de journalisation de la structure d'intégration SIS. Dans l'interface utilisateur, vous pouvez accéder aux journaux contenant l'état des intégrations configurées au niveau de l'objet et des niveaux de journalisation pris en charge, pour rester informé des opérations d'intégration.

La page de journalisation permet de trier les messages de journal en fonction du type et de l'intégration.

En plus de l'accès à l'interface utilisateur, des journaux sont également écrits sur le disque pour l'archivage, l'analyse à long terme et le triage.

L'horodatage affiché dans la dernière entrée de journal (sur la page de journalisation) et dans le dernier événement (sur la page des intégrations) représentent les événements tels qu'ils ont été journalisés d'après les niveaux de journalisation sélectionnés.

Vous pouvez également utiliser les services Web REST pour accéder aux journaux et aux erreurs rencontrées lors du traitement des données.

Pour accéder aux journaux, ajoutez /learn/api/v1/logs/sis/{dataSetUid} à votre domaine Blackboard Learn. Le système fournit un code de référence, dataSetUid, chaque fois qu'un fichier source est traité. Ce paramètre est nécessaire pour renvoyer les résultats. Les messages d'erreur et de réussite sont enregistrés dans la table DATA_INTGR_LOG.

D'autres paramètres sont disponibles pour segmenter les données : 

  • Paramètre logLevel : /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION)
  • Paramètres standard de pagination : /learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. Par défaut, la demande standard est limitée à 20 pages, excepté si vous modifiez cette valeur.  

Le processus de dépannage des erreurs d'enregistrement dans les services Web n'a pas changé par rapport au processus permettant de corriger les journaux d'erreurs trouvés dans l'interface utilisateur. Si vous rencontrez un message d'erreur « introuvable », il est possible que la valeur dataSetUid n'existe pas dans le système ou que le fichier source soit toujours en cours de traitement.