Présentation du cadre SIE
Important
Des investissements dans les processus d'intégration SIS peuvent exister sur votre campus. Vous pouvez continuer à utiliser les processus d'intégration existants comme par le passé tout en évaluant l'adoption des types d'intégration du cadre d'intégration SIS. Il est toutefois important de comprendre qu'au fur et à mesure de l'évolution de Blackboard LMS, les processus d'intégration existants ne suivront probablement pas le rythme des nouveaux objets introduits pour prendre en charge les nouvelles caractéristiques et capacités de Blackboard LMS.
À propos de l'intégration du système d'informations pour les étudiants et du cadre d'intégration Blackboard LMS du système d'informations pour les étudiants
L'intégration du système d'information sur les étudiants (SIS) aide les administrateurs à intégrer les données relatives aux cours, aux utilisateurs et aux inscriptions à Blackboard LMS. Les données peuvent provenir de multiples sources et dans divers formats. L'intégration du SIS permet de passer facilement à Blackboard LMS à 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 flux de données généré par ces systèmes pour l'échange de données. L'intégration du SIS permet également de déléguer les mises à jour du système à d'autres administrateurs Blackboard LMS, ce qui permet d'intégrer de la flexibilité dans le système.
Le cadre d'intégration du SIS est un cadre extensible 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 l'administrateur Blackboard LMS. 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.
Une fonctionnalité supplémentaire disponible pour tous les types d'intégration #types-d-intégrations-sis est le mappage de données à la volée. Cela permet de personnaliser le mappage des objets de données entrants vers les objets de données Blackboard LMS. 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 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 Blackboard LMS. 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 des intégrations du système d'information sur les étudiants (SIS) pour transmettre des données à Blackboard LMS afin d'alimenter et de mettre à jour automatiquement votre système présente de nombreux avantages. Tout d'abord, la gestion des données relatives aux cours et aux utilisateurs peut être déléguée à un ou plusieurs administrateurs qui n'ont pas besoin d'un accès en ligne de commande aux serveurs Blackboard LMS. Un autre avantage est que les données peuvent être transférées rapidement et efficacement de votre système d'information vers Blackboard LMS.
Il est essentiel d'impliquer tous les intervenants dans le processus de planification de l'intégration. La contribution de votre SIS et de votre bureau d'enregistrement, ainsi que des équipes administratives de Blackboard LMS, garantira une intégration réussie.
Une intégration réussie nécessite la connaissance des options de configuration du SIS, la sélection du type d'intégration Blackboard LMS qui répond à vos besoins et une compréhension des exigences en matière de données 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
Un engagement de services avec Blackboard LMS Consulting peut vous aider à planifier, à mettre à l'échelle et à mettre à niveau vos intégrations. Blackboard LMS Consulting propose un programme d’intégration complet qui répond à vos besoins.
Mentorat dans le cadre d'intégration SIE
L'objectif du service de mentorat du cadre d'intégration du SIS est d'aider les clients à mettre en œuvre Blackboard LMS du cadre d'intégration du SIS. 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 LMS 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 l'outil SIE Integration Framework.
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 LMS.
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)
Blackboard LMS Matériel de référence et documentation sur les produits de base
Passez à l'étape suivante !
Contactez votre représentant Blackboard LMS pour prendre rendez-vous afin de discuter des options recommandées et des prochaines étapes. 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 Blackboard LMS Aide à la consultation.
Le service de mentorat Consulting Services SIS Integration Framework vous apportera le soutien dont vous avez besoin pour automatiser le transfert des informations relatives aux utilisateurs, aux cours et aux inscriptions depuis un système source (comme un SIS, un LMS, un système de RH, un ERP ou tout autre système d'enregistrement) vers Blackboard LMS. 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.
Comment fonctionne le cadre d'intégration du SIE
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 :
Format de données
Transfert de données
Propriété des données
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 Blackboard LMS 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 Blackboard LMS(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 de 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 considéré comme une bonne pratique 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 Blackboard LMS 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. Alors que les clés de source de données peuvent être utilisées pour regrouper les données en vue de leur gestion via l'interface utilisateur et les outils de soutien, les clés de source de données ne sont pas utilisées par le cadre d'intégration du SIS pour limiter les modifications apportées aux données associées. Ainsi, les objets Blackboard LMS appartiennent à 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.
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 :
La structure d'intégration SIS reçoit une demande sur un point d'arrêt propre à un type d'intégration.
En fonction de l'UID entrant, la configuration du type d'intégration est chargée.
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 Blackboard LMS cible.
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.
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 Blackboard LMS 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
Le cadre SIS Blackboard LMS prend en charge cinq types d'intégration dans une installation par défaut comprenant les normes et les types d'intégration conçus par Blackboard LMS. 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 Blackboard LMS type d'intégration fourni a Blackboard LMS exigences en matière de prise en charge des objets et du système d'information 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 des objets Blackboard LMS comme spécifié par le type d’intégration. Il n’y a pas de chevauchement à 100 % de la prise en charge des objets dans tous les types d’intégration. Il s’agit là d’un élément clé à prendre en compte lors de la sélection 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.
Au fur et à mesure que Blackboard LMS progresse dans la prise en charge de l’intégration du système d’information, nous nous concentrerons sur les types d’intégration LIS 2.0 et Snapshot Flat File; ceux-ci devraient ê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. Les types d’intégration Enterprise 1.1, Enterprise 1.1 Vista et Snapshot XML ne seront pas développés pour prendre en charge les nouveaux objets Blackboard LMS.
Enterprise 1.1 et Enterprise 1.1 Vista
Enterprise 1.1 : Enterprise 1.1 a été introduit en 2002 et était destiné à 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ée à l’échange de données au sein et entre les systèmes d’entreprise institutionnels, la norme a été adoptée par les principaux fournisseurs à des fins d’intégration — WebCT et Blackboard LMS ont tous deux adopté la 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 prises en charge par Blackboard LMS sont la version originale de Vista et une version d’Ellucian Banner qui contient des 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
Objet | Description |
|---|---|
Cours | Données destinées à la création et à la gestion des cours |
Utilisateurs | Données destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.) |
Inscriptions | Données destinées à la création et à la gestion des adhésions aux cours (inscriptions) |
Nœuds | Données destinées à la création et à la gestion des relations hiérarchiques |
Termes | Données destinées à la création et à la gestion |
Mise en commun de cours | Données destinées à la fusion des cours enfants et parents |
Rôles des établissements | Donné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. |
Communautés | Données destinées à la création et à la gestion des sites Communautés Blackboard LMS. Des communautés 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 communautés sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux communautés. |
Systèmes d'information
Versions de Peoplesoft :
Peoplesoft Campus Solutions 9, bundle 21 ou versions antérieures
Versions de 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
Collègue d'Ellucian
Nécessite des outils pour extraire et convertir les données avant de les envoyer à Blackboard LMS
Note
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.
LISTE 2.0
LIS 2.0 : Services d'information des élèves 2.0 doit être considéré comme le remplacement d'Enterprise 1.1 et comprend une solution basée sur les enseignements tirés des lacunes d'Enterprise 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
Objet | Description |
|---|---|
Cours | Données destinées à la création et à la gestion des cours |
Utilisateurs | Données destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.) |
Inscriptions | Données destinées à la création et à la gestion des adhésions aux cours (inscriptions) |
Termes | Données destinées à la création et à la gestion |
Rôles des établissements | Donné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. |
Communautés | Données destinées à la création et à la gestion des sites Communautés Blackboard LMS. Des communautés 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 communautés sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux communautés. |
Systèmes d'information
Versions de Peoplesoft :
Peoplesoft Campus Solutions 9, bundle 22 ou versions ultérieures
Versions de 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
Collègue d'Ellucian
Nécessite ILP version 3.5
Note
Avant de vous engager à prendre en charge LIS 2.0, confirmez la prise en charge des versions ultérieures de systèmes tiers.
Fichier plat Snapshot
Blackboard LMS prend également en charge notre approche de l'importation de données sous forme de fichiers plats instantanés (fichier plat instantané de type Snapshot). Snapshot a été la première intégration prise en charge par Blackboard LMS Enterprise et a connu un long succès grâce à la simplicité de son 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
Objet | Description |
|---|---|
Cours | Données destinées à la création et à la gestion des cours |
Utilisateurs | Données destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.) |
Inscriptions | Données destinées à la création et à la gestion des adhésions aux cours (inscriptions) |
Nœuds | Données destinées à la création et à la gestion des relations hiérarchiques |
Termes | Données destinées à la création et à la gestion |
Catégories du catalogue | Données destinées à la création et à la gestion du catalogue des cours Blackboard LMS |
Rôles des établissements | Donné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. |
Communautés | Données destinées à la création et à la gestion des sites Communautés Blackboard LMS. Des communautés 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 communautés sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux communautés. |
Cours communs | Données destinées à la fusion des cours enfants et parents |
Observateurs | Données destinées à la création et à la gestion des observateurs |
Thèmes | Données pour la création et la gestion des thèmes |
Les programmes | Données pour la création et la gestion de programmes |
Systèmes d'information
Versions de Peoplesoft :
Nécessite des outils pour extraire et convertir les données avant de les envoyer à Blackboard LMS
Versions de Ellucian Banner :
Nécessite des outils pour extraire et convertir les données avant de les envoyer à Blackboard LMS
Collègue d'Ellucian
Nécessite des outils pour extraire et convertir les données avant de les envoyer à Blackboard LMS
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.
Capture d'écran XML
L'intégration XML d'instantanés est étroitement liée à la spécification Enterprise 1.1 avec des ajouts propres à Blackboard LMS. À 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
Objet | Description |
|---|---|
Cours | Données destinées à la création et à la gestion des cours |
Utilisateurs | Données destinées à la création et à la gestion des utilisateurs système (étudiants, professeurs, personnel, etc.) |
Inscriptions | Données destinées à la création et à la gestion des adhésions aux cours (inscriptions) |
Catégories du catalogue | Données destinées à la création et à la gestion du catalogue des cours Blackboard LMS |
Rôles des établissements | Donné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. |
Communautés | Données destinées à la création et à la gestion des sites Communautés Blackboard LMS. Des communautés 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 communautés sont pleinement prises en charge peuvent comprendre des flux distincts dédiés aux communautés. |
Observateurs | Donné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 à Blackboard LMS
Versions de Ellucian Banner :
Nécessite des outils pour extraire et convertir les données avant de les envoyer à Blackboard LMS
Collègue d'Ellucian
Nécessite des outils pour extraire et convertir les données avant de les envoyer à Blackboard LMS
Note
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.
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 applicable si votre système d'information ne prend pas en charge l'un des Blackboard LMS types d'intégration fournis ou si vous avez des besoins d'intégration spécifiques en dehors du champ d'application des Blackboard LMS types d'intégration fournis. Dans ce cas, vous pouvez créer votre propre bloc d’intégration et contrôler les objets Blackboard LMS que votre intégration prend en charge ainsi que la logique d’intégration propre à votre système d’information.
Support général et configuration
Blackboard LMS Les services d'assistance fournissent une assistance pour les types d'intégration Blackboard LMS fournis. Si vous avez des questions ou rencontrez des problèmes avec votre configuration ou vos processus d'intégration, vous pouvez contacter l'assistance en soumettant un ticket d'assistance auprès de Anthology Support.
Vous configurez Blackboard LMS pour recevoir des données pour chacun des types d'intégration en utilisant les pages de configuration Blackboard LMS de l'intégration SIS de l'administrateur. 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 :
Créez une intégration en sélectionnant le type d'intégration dans le menu déroulant Créer.
Configurez votre nouvelle intégration.
Placez l'intégration en mode test.
Apportez les modifications voulues au mappage personnalisé.
Testez votre intégration (aucune modification n’est apportée aux données Blackboard LMS lorsqu’une intégration est en mode test).
Confirmez la configuration en visualisant les journaux d'intégration dans l'interface utilisateur
Répétez les étapes 4 à 6 jusqu'à ce que l'intégration fonctionne conformément à vos attentes.
Une fois les tests réussis, placez l'intégration en mode actif pour commencer.
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.
Note
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 LMS. 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= (DÉBOGAGE, AVERTISSEMENT, ERREUR, INFORMATIONS).Paramètres de radiomessagerie standard :
/learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10. Par défaut, la requête standard est limitée à 20 pages, sauf 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.