Skip to main content

Configuration de l'intégration de fichier plat d'instantané

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 de Snapshot Flat File

Pour créer et configurer les informations de base d'une intégration de 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. Passez la souris sur Créer une intégration et sélectionnez Snapshot Flat File.

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

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

Nom de l'intégration

Obligatoire

Entrez 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'information étudiants (SIS).

Description

Facultatif

Entrez une description pour votre intégration. Utile pour l'identification ultérieure des intégrations.

Nom d'utilisateur partagé

Obligatoire

Le 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é

Obligatoire

Entrez le mot de passe généré à partir du système SIS.

Délimiteur de fichiers d'alimentation

Obligatoire

Sé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égration

Obligatoire

Options d'état d'intégration :

  • Inactif : le système ne traitera pas les demandes et ne mettra pas à jour les données de la base de données.

  • Actif : le système traitera les demandes, mettra à jour les données de la base de données et sera visible pour les utilisateurs.

  • Tests : les données ne sont pas intégrées dans le système en direct.

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, une intégration doit être réglée sur le statut Test ou Active.

Verbosité du journal

Obligatoire

L'option Verbosité du journal détermine les éléments qui sont visibles sur l'écran Journaux de système d'information étudiants pour cette intégration.

  • Erreurs uniquement : tout problème fatal, tout problème empêchant les opérations de création, de mise à jour, de désactivation ou de purge.

  • Erreurs et avertissements : tout problème non fatal, tout problème lié à un enregistrement individuel ou toute opération réussie nécessitant une modification de l'enregistrement.

  • Tous les messages de diagnostic : toute activité réussie, y compris les types et le nombre d'enregistrements, le calendrier et les données.

  • Tous les messages de diagnostic et de débogage : tous les enregistrements individuels et les tentatives 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

Découvrez la source de données

Obligatoire

Déterminez la source de données utilisée lors de l'intégration avec Blackboard.

  • Utiliser la source de données Learn définie dans les données entrantes

  • Utilisez la même source de données Learn pour toutes les nouvelles données entrantes. Sélectionnez Nouvelle source de données dans la liste déroulante et entrez la nouvelle clé de source de données dans la zone de texte.

  • Utilisez 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 : Les clés de source de données doivent être définies au préalable à l'aide de l'outil de gestion des sources de données (voir Présentation des clés de source de données)

Préfixe d'identifiant du lot

Facultatif

É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.

Nœud de hiérarchie parent

Obligatoire

Cette 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

  • Créez une hiérarchie sous le nœud spécifié. Sélectionnez Rechercher un nœud si des nœuds peuvent être sélectionnés.

À ce stade, la configuration de l'intégration d'un fichier instantané plat par défaut est terminée et vous pouvez la tester en réglant l'état de l'intégration sur Test et en téléchargeant manuellement un fichier de données Snapshot Flat File (voir Format de données de fichier instantané pour 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. Dans certains cas, l'alignement entre les objectifs souhaités pour la gestion des données Blackboard et la gestion des données du système d'informations pour les étudiants peut ne pas être possible. Les paramètres avancés permettent une gestion intégrée des données entrantes afin de respecter les objectifs de Blackboard en matière de données.

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 champs personnalisé du fichier plat d'instantané et Descriptions des en-têtes 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 ni mettre à jour  : Ignorez les données entrantes pour cet objet.

  • Insérer uniquement  : ajoutez uniquement de nouveaux objets ; ne faites rien s'il existe un objet correspondant à cette clé externe de données.

  • Mises à jour uniquement  : ne met à jour que les objets existants ; ne rien faire s'il n'existe pas d'objet

  • Insertions ou mises à jour intelligentes (par défaut)  : s'il n'y a aucun objet correspondant dans Blackboard, ajoutez-le en tant que nouvel objet ; s'il existe un objet correspondant dans Blackboard, mettez-le à 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 :

Note

Les options ne sont pas toutes disponibles pour tous les types de données.

  • Ne pas désactiver ni purger  : ne supprimez ni ne marquez pour suppression aucun objet du système en fonction du fichier source.

  • Désactiver  : Marquez pour suppression, mais ne supprimez aucun objet du système en fonction du fichier d'alimentation.

  • Purge  : Supprime l'objet du système en fonction du fichier d'alimentation.

  • Suppression intelligente  : désactive en mode Actualisation complète (ou Actualisation complète par DSK). Supprimer en mode Supprimer.

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