La configuration d'une intégration Fichier plat d'instantané est simple à condition que vous compreniez certains principes de base de la structure SIS et vos objectifs d'intégration, qui sont en rapport avec le cycle de vie des données. Les informations suivantes présentent une configuration de base avec des valeurs par défaut suivie d'une description de la façon dont la personnalisation des paramètres individuels peut affecter la fonction d'intégration.


Configuration des fichiers plats d'instantanés

Pour créer et configurer les informations de base d'une intégration Fichier plat d'instantané par défaut, procédez comme suit :

  1. Dans le panneau de configuration de l'administrateur, sous Intégrations, sélectionnez Intégration de données.
  2. Sélectionnez Intégrations des systèmes d'informations étudiants.
  3. Pointez votre curseur sur Créer une intégration.
  4. Sélectionnez Fichier plat d'instantané.

L'écran suivant vous présente les options modifiables pour la configuration.

Étape 1 : Propriétés d'intégration

Nom de l'intégrationObligatoireEntrez un nom unique pour l'intégration : il s'agit du nom qui apparaît dans la liste des intégrations configurées sur la page Intégration du système d'informations étudiants (SIS).
DescriptionFacultatifEntrez une description pour votre intégration. Utile pour l'identification ultérieure des intégrations.
Nom d'utilisateur partagéObligatoireLe nom d'utilisateur partagé est automatiquement généré à partir du système SIS et renseigné dans cette zone de texte. Ceci est utilisé pour les opérations de publication de données avec le mot de passe partagé.
Mot de passe partagéObligatoireEntrez le mot de passe généré à partir du système SIS.
Séparateur du fichier sourceObligatoireSélectionnez le type de séparateur utilisé dans le fichier source actuel. Le séparateur est le caractère utilisé pour séparer les champs dans le fichier de données. Options de séparateur :
  • Virgule
  • Deux-points
  • Barre verticale
  • Tabulation
  • Autre
État de l'intégrationObligatoireOptions d'état d'intégration :
  • Inactif : le système ne traitera pas les demandes ou ne mettra pas les données à jour dans la base de données.
  • Actif : le système traitera les demandes, mettra à jour les données dans la base de données et sera visible par les utilisateurs.
  • Test : les données ne sont pas intégrées dans le système opérationnel.

Blackboard recommande de commencer les intégrations à l'état Test. La sélection de cet état vous permettra de tester l'intégration et de résoudre les problèmes pouvant se poser avant de valider l'intégration. Une fois le test terminé, l'état doit avoir la valeur Inactif ou Actif.

Pour effectuer une configuration avancée, l'état d'une intégration doit avoir la valeur Test ou Actif.

Verbosité du journalObligatoireL'option Verbosité du journal détermine les éléments qui sont visibles sur l'écran Journaux de système d'informations étudiants pour cette intégration.
  • Erreurs uniquement : toute erreur fatale ou empêchant de créer, mettre à jour, désactiver ou purger des opérations.
  • Erreurs et avertissements : toutes les erreurs non fatales, ainsi que les erreurs rencontrées avec un enregistrement individuel ou toute opération réussie qui a nécessité une modification de l'enregistrement.
  • Tous les messages de diagnostic : toute activité réussie, y compris les types et les nombres d'enregistrements, la fréquence et les données.
  • Tous les messages de diagnostic et de débogage : tout enregistrement individuel et toute tentative de transformation des données.

La sélection d'un niveau de journalisation de verbosité entraîne également celle du niveau de journalisation de verbosité inférieure ou celle des niveaux précédant le niveau de journalisation sélectionné. Par exemple, la sélection du niveau de journalisation Messages entraînera la journalisation des erreurs, des avertissements et des messages.

Étape 2 : Propriétés d'intégration

Learn Data Source (Source de données Learn)ObligatoireDétermine la source de données utilisée lors de l'intégration à Blackboard Learn.
  • Utiliser la source de données Learn définie dans les données entrantes
  • Use the same Learn Data Source for all new inbound data (Utiliser la même source de données Learn pour toutes les nouvelles données entrantes). Sélectionnez New Data Source (Nouvelle source de données) dans la liste déroulante, puis entrez la nouvelle clé de source de données dans la zone de texte.
  • Use the same Learn Data Source for all new inbound data (Utiliser la même source de données Learn pour toutes les nouvelles données entrantes). Sélectionnez une clé de source de données existante dans la liste déroulante.

Remarque : vous devez avoir déjà défini les clés de source de données en utilisant l'outil de gestion des sources de données (voir Présentation de la clé de source de données).

Préfixe du code unique de lotFacultatifÉvitez les conflits de codes en ajoutant un préfixe aux identificateurs des objets créés pendant l'intégration. Blackboard recommande de ne pas modifier ce paramètre après que les données ont été créées pour l'intégration.
Parent Hierarchy Node (Nœud hiérarchique parent)ObligatoireCette option est uniquement disponible pour les intégrations IMS Enterprise 1.1, IMS Enterprise 1.1 - Vista et les intégrations de fichier plat d'instantané.
  • Créer une hiérarchie sous le niveau supérieur
  • Create hierarchy under the specified node (Créer une hiérarchie sous le nœud spécifié). Sélectionnez Rechercher un nœud s'il en existe plusieurs.

À ce stade, la configuration d'une intégration par défaut de fichier plat d'instantané est terminée. Vous pouvez donc tester l'intégration en paramétrant son état sur Test et en téléchargeant manuellement un fichier de données d'un fichier plat d'instantané (reportez-vous à la section Format de données du fichier plat d'instantané pour obtenir des exemples de démarrage).

Paramètres d'intégration avancés

Même si les paramètres par défaut conviendront dans la plupart des cas, vous pouvez être amené à modifier votre configuration pour atteindre des objectifs d'intégration particuliers. Il arrive parfois que les objectifs de gestion des données Learn et des données SIS ne soient pas compatibles. Les paramètres avancés permettent de gérer des données entrantes dans la structure pour mener à bien les objectifs des données Learn.

Les paramètres avancés d'une intégration sont possibles grâce à trois points dans l'interface administrateur de l'intégration des systèmes d'informations étudiants :

  1. Création de mappages de champs personnalisés.
  2. Création d'en-têtes personnalisés.
  3. Paramètres d'intégration avancés à l'étape 3 d'une configuration d'intégration.

Pour en savoir plus sur la création de mappages de champs et de mappages d'en-têtes personnalisés, reportez-vous aux sections Mappage de champ personnalisé du fichier plat d'instantané et Descriptions de l'en-tête du fichier plat d'instantané.

Les paramètres d'intégration avancés disponibles pour les insertions et les mises à jour sont :

  • Ne pas insérer ou mettre à jour : ignore les données entrantes pour cet objet.
  • Insertions uniquement : ajoute uniquement de nouveaux objets ; ne fait rien si un objet correspondant à cette clé externe existe.
  • Mises à jour uniquement : met uniquement à jour les objets existants ; ne fait rien si un objet n'existe pas.
  • Insertions ou mises à jour intelligentes (par défaut) : Si l'objet ne correspond à aucun autre dans Learn, il est ajouté en tant que nouvel objet ; s'il correspond à un objet existant dans Learn, celui-ci est mis à jour avec les données entrantes.

Vous pouvez également déterminer ce qui se passe lors de l'exécution d'un processus de suppression :

  • Ne pas désactiver ou purger : ne supprime, ni ne marque pour suppression, les objets du système basés sur le fichier source.
  • Désactiver : marque pour suppression, mais ne supprime pas réellement les objets du système basés sur le fichier source.
  • Purger : supprime les objets du système basés sur le fichier source.

Les paramètres ci-dessus peuvent être appliqués à chaque objet pris en charge par le fichier plat d'instantané (comme indiqué dans l'interface utilisateur). Les modifications apportées à ces paramètres par rapport aux valeurs par défaut permettront d'affiner l'intégration pour assurer la gestion des objets au-delà de ce qui est fourni uniquement par les données des flux SIS disponibles.


En savoir plus

Planification des intégrations SIS

Présentation de la clé de source de données

Présentation du framework SIS

Présentation des intégrations de fichier plat d'instantané et XML d'instantanés