Exemples de cours Snapshot Flat File
Les exemples suivants illustrent la composition des flux de données COURSE et correspondent à un grand nombre de cas d'utilisation. Ces exemples utilisent le flux de données le plus simple qui soit requis pour répondre au cas d'utilisation. Il existe de nombreux autres en-têtes de fil de cours à utiliser pour créer des dossiers de cours. L'analyse du système d'information de votre établissement et des exigences des bureaux d'enregistrement ainsi que la planification vous aideront à déterminer la profondeur des données nécessaires pour remplir correctement Blackboard en respectant vos objectifs en matière de données et de cycle de vie des cours.
Note
Les exemples sont basés sur les paramètres par défaut de Blackboard, visibles dans l'interface utilisateur de configuration de l'intégration. La modification de ces éléments de configuration entraînera la modification des résultats de l'exemple. Des explications sur ces paramètres sont disponibles dans Présentation de SIS Framework et Configuration de l'intégration de Snapshot Flat File Integration. Par ailleurs, il est supposé, sauf indication contraire, que l'intégration est configurée pour utiliser la même source de données pour toutes les données entrantes.
Cours
Les données de cours constituent le principal ensemble d'informations qui décrit un cours dans Blackboard. Dans le contexte des objets de COURS de données SIS, on parle souvent de « SECTIONS », ce qui se répercute dans les normes existantes. Préexistant à bon nombre de ces normes, le fichier plat Blackboard Snapshot utilise le terme « COURSE » pour faire référence aux enregistrements liés aux cours en fonction du contexte.
Opérations
Les données peuvent être fournies à Blackboard, puis mises à jour, supprimées ou modifiées. Vous pouvez donc commencer par le jeu de données le plus simple et l'augmenter en fonction de l'évolution des besoins en données de votre établissement.
Note
Le seul champ COURSE immuable est COURSE_ID. Ce champ ne peut pas être modifié une fois qu'un enregistrement est créé et l'enregistrement doit être désactivé et supprimé si le COURSE_ID doit être modifié. Cela a des répercussions sur les enregistrements d'activité. Par conséquent, il est fortement recommandé d'utiliser un élément de données qui n'est pas susceptible de changer au cours du cycle de vie du cours.
Gestion des données Snapshot Flat File
Avertissement
Veuillez noter que le téléchargement d'un court fichier correctif avec l'opération Actualisation complète ou Actualisationcomplète par source de données peut entraîner par inadvertance la suppression ou la désactivation massive des données. Pour éviter cela, nous déconseillons l'utilisation manuelle des types d'opérations Actualisation complète ou Actualisation complète par source de données. Ces options ne sont pas disponibles par défaut sur la page Charger un fichier de flux. Toutefois, si vous activez les deux options, cochez la case Activer les options avancées sous Type d'opération.
Le système d'informations pour les étudiants Framework prend en charge le téléchargement de flux de données Snapshot Flat File via une interface utilisateur et via un ensemble d'URL fournies par le système Blackboard.
Accédez aux informations HTTP et téléchargez le fichier de flux à l'aide du menu d'intégration de l'interface utilisateur d'intégration des systèmes d'informations sur les étudiants de l'intégration de données d'administrateur système.
Dans les deux cas, le comportement de l'opération de données est piloté par la configuration de l'intégration et le type d'opération sélectionné. Le type d'opération de données sélectionné contrôle la façon dont les données du flux sont « interprétées » et chaque URL fournira des résultats différents pour répondre aux objectifs de votre intégration.
Opération | Description |
|---|---|
Stocker | Lors de l'utilisation de ce type d'opération, les données contenues dans le fichier source sont stockées ou mises à jour (selon les paramètres de configuration) dans toutes les sources de données qui sont détenues par l'intégration (consultez la présentation du cadre de système d'informations pour les étudiants pour les questions de « propriété » des données et de source des données). |
Actualisation complète | Cette opération permet de stocker ou de mettre à jour les données contenues dans le flux de données, tout en désactivant les données qui ne figurent pas dans le flux de données associé à l'intégration dans toutes les sources de données. Vous devez sélectionner Activer les options avancées pour que cette option soit disponible lorsque vous chargez un fichier manuellement. |
Supprimer | Cette opération désactive, selon les paramètres d'intégration, les enregistrements contenus dans le flux de données associé à l'intégration dans toutes les sources de données. |
Actualisation complète par source de données | Cette opération effectue une actualisation complète des données associées UNIQUEMENT à la source de données configurée pour l'intégration. Cette opération émule plus étroitement le processus d'instantané de ligne de commande pour l'actualisation des données. Vous devez sélectionner Activer les options avancées pour que cette option soit disponible lorsque vous chargez un fichier manuellement. |
Les objets associés aux opérations COURSE sont les suivants :
Avertissement
Veuillez noter que le téléchargement d'un court fichier correctif avec l'opération Actualisation complète ou Actualisationcomplète par source de données peut entraîner par inadvertance la suppression ou la désactivation massive des données. Pour éviter cela, nous déconseillons l'utilisation manuelle des types d'opérations Actualisation complète ou Actualisation complète par source de données. Ces options ne sont pas disponibles par défaut sur la page Charger un fichier de flux. Toutefois, si vous activez les deux options, cochez la case Activer les options avancées sous Type d'opération.
Objet | Opérations |
|---|---|
Cours | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Association de cours | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Association standard de cours | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Les exemples d'association de cours peuvent être trouvés dans la section Exemple de hiérarchie.
Les exemples fournis sont illustrés à l'aide de la fonctionnalité de chargement du fichier de source de données de l'interface utilisateur du cadre d'instantané. Pour en savoir plus sur l'automatisation ou l'utilisation d'autres opérations de programmation/ligne de commande, reportez-vous à Automatisation de fichier plat d'instantané.
Rappel concernant les clés de source de données
Tous les objets de données permettent de modifier la clé de source de données pour le regroupement de cet ensemble de données et peuvent être utilisés pour modifier la source de données associée. Remarque : ce champ n'est pas obligatoire dans les flux de données basés sur Framework et, sauf indication contraire, les exemples suivants supposent que l'intégration est configurée pour utiliser une source de données unique.
Reportez-vous à Gestion des clés de source de données et à la section sur la modification de la source de données d'un enregistrement de cours.
Remarque sur le mappage des champs
Le mappage des champs permet de modifier les données entrantes avant qu'elles ne soient stockées dans Blackboard. Cela vous permet d'avoir un contrôle total sur les données stockées et de respecter les règles spécifiques de Blackboard lorsque les données du système d'informations pour les étudiants qui vous sont fournies sont insuffisantes, par exemple lors de la création d'une entrée de nom de cours appropriée. Lorsqu'il est appliqué à un champ d'objet COURSE, le script associé est exécuté par enregistrement de cours, modifiant ou fournissant les données avant qu'elles ne soient stockées dans Blackboard. Pour en savoir plus sur le mappage des champs, reportez-vous à Mappage de champ personnalisé de fichier plat d'instantané.
Exemples de fonctionnement du cours
À un niveau avancé, vous pouvez identifier les modèles de flux de données d'intégration SIS qui peuvent être appliqués à toutes les opérations de données de cours et la sélection du modèle dépend des données que vous pouvez fournir.
À l'aide d'un fichier source unique, vous pouvez stocker et mettre à jour les enregistrements (Store) en utilisant un processus distinct pour désactiver (Delete) les enregistrements
À l'aide d'un fichier source unique, vous pouvez stocker, mettre à jour et désactiver (Complete Refresh) des enregistrements
Vous pouvez utiliser une combinaison de fichiers, l'un pour stocker, l'autre pour désactiver.
Enfin, et il ne s'agit pas d'un modèle de flux système d'informations pour les étudiants, mais il convient de le mentionner, vous pouvez également désactiver et supprimer en fonction de DSK uniquement à l'aide de l'outil de gestion des sources de données disponible dans l'interface utilisateur. Vous devez être très prudent lorsque vous gérez vos données SIS fournies de cette manière. Ceci est extrêmement utile lors de la suppression de données qui n'ont jamais été ou ne sont plus fournies via le système d'informations pour les étudiants ou qui résultent d'opérations de test.
Juste l'essentiel : cours
Tous les comptes de cours nécessitent un ensemble d'informations de base pour établir un compte. Pour en savoir plus, reportez-vous aux sections Format de données du fichier plat d'instantané et Descriptions des en-têtes de fichiers plats d'instantanés.
Note
Si vous utilisez actuellement les outils batch de l'interface utilisateur, passer au cadre SIS et à l'utilisation des données de cours minimales et des fonctionnalités de téléchargement d'interface utilisateur du cadre SIS vous permet de mieux consigner et rendre compte de vos données téléchargées sans modifier vos processus de collecte de données.
Données en bref
L'ensemble de données ou les en-têtes minimaux requis pour créer un compte de cours dans Blackboard sont les suivants :
EXTERNAL_COURSE_KEY : identificateur unique pour l'enregistrement de cours.
DATA_SOURCE_KEY : identificateur unique des données définies pour l'enregistrement. Remarque : cela est fourni soit dans le flux, soit via la configuration d'intégration)
COURSE_ID : le code utilisé comme identificateur d'affichage unique pour le cours. COURSE_NAME : le titre du cours.
La structure SIS pour une configuration d'intégration fournit des valeurs par défaut pour les champs non obligatoires ou les ignore. Deux champs utiles qui ne sont pas obligatoires pour un flux de cours sont AVAILABLE_IND et ROW_STATUS. Ceux-ci seront abordés dans le cas d'utilisation suivant.
Note
Chacun de ces en-têtes est décrit complètement dans Descriptions des en-têtes de fichier plat d'instantané.
Ajouter des informations sur les cours
Il existe deux cas d'ajout d'informations sur le cours (COURSE). La première consiste à stocker (STORE) les informations de cours (COURSE) de manière additive, ce qui entraîne l'ajout ou la mise à jour d'enregistrements, comme indiqué dans le flux de données. La seconde consiste à ACTUALISER les informations de COURS déjà présentes dans Blackboard, ce qui entraîne l'ajout de nouveaux enregistrements ou la mise à jour d'enregistrements existants tels qu'ils sont présentés dans le fichier de données, tout en désactivant les enregistrements Blackboard existants qui ne figurent pas dans le fichier de données COURSE.
Exemples d'opération de stockage
Exemple #1 : Création de cours
Vous souhaitez ajouter des cours à BLACKBOARD sans affecter les comptes existants. Votre intégration est configurée pour utiliser la même source de données pour toutes les données entrantes.
Prérequis
aucun.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
Solution
Créez un fichier de données COURSES.txt contenant les en-têtes requis et les données associées par cours que vous souhaitez ajouter au système. Par exemple :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1
testCourse2|Course.2.1.SP2013|Test Course 2
testCourse3|Course.3.1.FA2013|Test Course 3
Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données COURSE à l'aide de l'opération STORE. Les comptes de cours seront créés et vous pourrez les découvrir via les outils de cours de l'administrateur système.
État postérieur
Les enregistrements COURSE pour Course.1.1.SP2013, Course.2.1.sp2013 et Course.3.1.FA2014 sont créés.
Exemple #2 : Mettre à jour les cours
Vous avez créé des comptes de cours et devez les modifier. Par exemple. : l'exemple ci-dessus ne contenait pas le terme dans le nom du cours.
Prérequis
Aucun. Les cours existants seront mis à jour, toutes les nouvelles données de cours dans le flux créeront de nouveaux cours.
Solution
Créez un fichier de données COURS.txt contenant les en-têtes requis et les données associées par cours que vous souhaitez mettre à jour dans le système. Par exemple :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Note
Étant donné que STORE fonctionne uniquement sur les données contenues dans le fichier, l'enregistrement Course.3.1.fa2013 soumis précédemment n'est pas affecté.
Utilisez l'interface utilisateur pour télécharger ce fichier via le type de données COURSE à l'aide de l'opération STORE. Les enregistrements de cours du fichier seront mis à jour.
État postérieur
L'enregistrement COURSE pour Course.1.1.sp2013 et Course.2.1.sp2013est mis à jour pour inclure le terme dans le COURSE_NAME
L'enregistrement COURSE pour Course.3.1.fa2014 n'est pas affecté.
Cours : opération complète d'actualisation du cours
Avertissement
Veuillez noter que le téléchargement d'un court fichier correctif avec l'opération Actualisation complète ou Actualisationcomplète par source de données peut entraîner la désactivation inattendue de nombreux cours par inadvertance. Pour éviter cela, nous déconseillons l'utilisation manuelle des types d'opérations Actualisation complète ou Actualisation complète par source de données. Ces options ne sont pas disponibles par défaut sur la page Charger un fichier de flux. Toutefois, si vous activez les deux options, cochez la case Activer les options avancées sous Type d'opération.
COMPLETE REFRESH ne fonctionne pas de la même manière que STORE. COMPLETE REFRESH effectue deux opérations qui correspondent à une comparaison des données dans le fichier source et des enregistrements de LEARN détenues par l'intégration : stockage de nouveaux enregistrements, mise à jour d'enregistrements existants ou désactivation d'enregistrements dans LEARN qui ne sont pas dans le fichier de données.
Exemple : actualisation complète
Les données fournies par votre système d'informations pour les étudiants contiennent un aperçu complet des cours qui devraient exister dans BLACKBOARD. Ces données contiennent des enregistrements COURSE à ajouter, des enregistrements COURSE à mettre à jour et des enregistrements qui ont été supprimés depuis les précédentes opérations COMPLETE REFRESH qui doivent être gérés de manière appropriée par configuration (désactiver ou supprimer).
Prérequis
aucun.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
Solution
En commençant par les données de notre première opération de stockage COURSE, en ajoutant Course.1.2.sp2013 au flux de données et en supprimant Course.3.1.fa2013 :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Remarque que si d'autres enregistrements de COURS sont gérés par cette intégration, ils seront désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus.
État postérieur
L'enregistrement COURSE pour Course.1.1.SP2013 est conservé et mis à jour pour inclure la section dans le COURSE_NAME
L'enregistrement COURSE pour Course.1.2.sp2013 est ajouté à Blackboard
L'enregistrement COURSE pour Course.2.1.sp2013 est conservé et n'est pas affecté.
L'enregistrement COURSE pour Course.3.1.fa2013, car il est absent du flux de données, est marqué comme désactivé ou prêt à être supprimé par configuration d'intégration.
Cours : Actualisation complète par source de données
Avertissement
Veuillez noter que le téléchargement d'un court fichier correctif avec l'opération Actualisation complète ou Actualisationcomplète par source de données peut entraîner la désactivation inattendue de nombreux cours par inadvertance. Pour éviter cela, nous déconseillons l'utilisation manuelle des types d'opérations Actualisation complète ou Actualisation complète par source de données. Ces options ne sont pas disponibles par défaut sur la page Charger un fichier de flux. Toutefois, si vous activez les deux options, cochez la case Activer les options avancées sous Type d'opération.
COMPLETE REFRESH BY DATA SOURCE exécute une opération COMPLETE REFRESH mais limite les données concernées à celles qui sont uniquement associées à la source de données de l'intégration.
Exemple : actualisation complète par source de données
Les données fournies par votre système d'informations pour les étudiants contiennent un aperçu complet des cours qui devraient exister dans BLACKBOARD. Ces données contiennent des enregistrements COURSE à ajouter, des enregistrements COURSE à mettre à jour et des enregistrements qui ont été supprimés depuis les précédentes opérations COMPLETE REFRESH qui doivent être gérés de manière appropriée par configuration (désactiver ou supprimer). En outre, toutes les données de cette actualisation sont ciblées à l'aide de la même source de données que celle définie dans l'intégration et seules les données liées à cette clé de source de données seront affectées.
Prérequis
aucun.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
Solution
En utilisant les données de notre dernière opération de stockage et en supprimant Course.2.1.SP2013 du flux de données :
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
État postérieur
Les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.SP2013 sont conservés et ne sont pas affectés.
L'enregistrement COURSE pour Course.2.1.sp2013 est marqué comme désactivé ou prêt à être supprimé par configuration d'intégration.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration.
Disponibilité des cours
Avertissement
Veuillez noter que le téléchargement d'un court fichier correctif avec l'opération Actualisation complète ou Actualisationcomplète par source de données peut entraîner la désactivation inattendue de nombreux cours par inadvertance. Pour éviter cela, nous déconseillons l'utilisation manuelle des types d'opérations Actualisation complète ou Actualisation complète par source de données. Ces options ne sont pas disponibles par défaut sur la page Charger un fichier de flux. Toutefois, si vous activez les deux options, cochez la case Activer les options avancées sous Type d'opération.
Le paramètre disponibilité des enregistrements COURSE permet de paramétrer un compte dans LEARN pour qu'il soit visible (disponible) ou invisible (indisponible) pour les étudiants. Remarque que cela ne revient pas à désactiver un cours, ce qui non seulement le rend inaccessible aux étudiants et aux professeurs, mais signifie également qu'il n'est pas disponible pour des opérations supplémentaires telles que la gestion des membres. L'ajout de cet en-tête de flux des données n'a pas d'impact sur l'utilisation des opérations STORE, COMPLETE REFRESH, COMPLETE REFRESH BY DATA SOURCE décrites ci-dessus pour la création des enregistrements COURSE.
Notez que, par défaut, lorsque le paramètre AVAILABILITY (disponibilité) n'est pas configuré, l'intégration met à disposition l'objet lors des opérations de création/mise à jour.
Exemple : disponibilité du compte de cours
Votre système d'informations pour les étudiants contrôle la disponibilité des accès à LEARN et le flux de données indique le paramètre de disponibilité permettant aux utilisateurs de contrôler le moment où ils ont accès à Blackboard. Vous souhaitez contrôler ce paramètre d'accès lors de la création/mise à jour de PERSON.
Prérequis
aucun.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
AVAILABILITY_IND
Solution
Ajouter l'en-tête AVAILABLE_IND à votre flux de données et spécifier le caractère unique Y pour disponible et N pour non disponible.
État postérieur
STORE (STOCKER)
Seuls les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.sp2013sont mis à jour (ils ont été créés précédemment) et Course.5.1.fa2013 est créé.
COMPLETE REFRESH (actualisation complète)
Les enregistrements COURSE pour Course.1.1.sp2013 et Course.1.2.sp2013sont mis à jour (ils ont été créés précédemment) et Course.5.1.fa2013 est créé. Tous les autres enregistrements seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les enregistrements COURSE pour Course.1.1.SP2013 et Course.1.2.sp2013sont mis à jour (ils ont été créés précédemment) et Course.5.1.fa2013 est créé avec une disponibilité explicitement définie sur Y, ce qui rend les cours disponibles.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.
Désactivation des enregistrements de cours
La désactivation d'un enregistrement de COURS dans Blackboard le rend inaccessible à tous les utilisateurs (l'état désactivé remplace le paramètre de disponibilité) et rend également l'enregistrement inaccessible pour les opérations de l'interface utilisateur. Par exemple, vous ne pouvez pas gérer la plupart des propriétés d'un COURS désactivé via l'interface utilisateur. Les administrateurs système peuvent consulter et réactiver un cours désactivé dans le panneau d'administration système, sinon, il est généralement « invisible ». En outre, pour supprimer un enregistrement de Blackboard, cet enregistrement doit d'abord être désactivé.
Note
La désactivation d'un enregistrement puis sa suppression suppriment toutes les références à cet enregistrement de Blackboard. Il est recommandé de supprimer les enregistrements désactivés uniquement après une période déterminée par votre activité et/ou vos pratiques légales qui pourraient autrement nécessiter un enregistrement d'activité. De plus, étant donné qu'un cours pour personnes handicapées n'est pas accessible, si des personnes ont toujours besoin d'y accéder, elles se renseigneront auprès de votre centre d'assistance et le besoin persistant sera détecté avant qu'il ne soit trop tard.
La désactivation des enregistrements peut suivre deux modèles : la désactivation via l'exclusion des données de flux lors des opérations REFRESH, et la désactivation via l'en-tête de flux ROW_STATUS.
Important
Les opérations COURSE ci-dessus utilisant les opérations REFRESH démontrent une désactivation « implicite » par exclusion. Le cas et l'exemple suivants le montrent à l'aide de ROW_STATUS.
Exemple : désactivation des enregistrements de cours
La politique exige que vous supprimiez complètement les cours de Blackboard après une période de 5 ans. Pour vous y préparer, vous pouvez prévoir de désactiver explicitement le cours pendant un certain temps à l'aide de l'en-tête ROW_STATUS. Cela garantit que personne ne compte toujours sur le cours, car il ne pourra plus y accéder.
Prérequis
Le cours existe ou un cours sera créé et row_status défini comme indiqué dans le flux de données.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
ÉTAT DE LA LIGNE
Solution
Ajoutez l'en-tête ROW_STATUS à votre flux de données et indiquez ENABLED pour activé et DISABLED pour désactivé.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|ROW_STATUS
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|enabled
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|enabled
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|disabled
État postérieur
STORE (STOCKER)
Seuls les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.sp2013 et Course.5.1.FA2013sont créés ou mis à jour avec le ROW_STATUS explicitement mis à jour.
COMPLETE REFRESH (actualisation complète)
Les enregistrements COURSE pour Course.1.1.sp2013, Course.1.2.sp2013et Course.5.1.fa2013 sont créés ou mis à jour avec le ROW_STATUS explicitement mis à jour. Tous les autres enregistrements de cours détenus par cette intégration seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.sp2013et Course.5.1.fa2013 sont créés ou mis à jour, le ROW_STATUS étant explicitement mis à jour.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.
Fusion de cours
La fusion de cours permet de présenter plusieurs sections d'un cours sous la forme d'un seul cours dans Blackboard. Elle consiste à fusionner des cours ayant des relations parent-enfant. Le parent est présenté aux utilisateurs comme le cours dans lequel ils sont participants et les sections/cours enfants héritent de leurs adhésions, etc. Les professeurs n'ont alors qu'à fournir le contenu d'un seul cours et le système Blackboard entretient un couplage avec le système d'informations pour les étudiants en ce qui concerne les identifiants de cours, ce qui facilite la communication des informations relatives au cours entre Blackboard et le système d'informations pour les étudiants.
Exemple : fusion de cours
Le département anglais dispose de quatre cours niveau débutant qui nécessitent plusieurs sections pour respecter le ratio étudiant/professeur souhaité. Ce département souhaite fournir un seul cours pour faciliter le travail des professeurs.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
MASTER_COURSE_KEY
Solution
Ajoutez l'en-tête ROW_STATUS à votre flux de données et indiquez ENABLED pour activé et DISABLED pour désactivé.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|MASTER_COURSE_KEY
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|testCourse1
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Si vous laissez MASTER_COURSE_KEY vide, il n'y a pas de « parent » pour le cours, ou, pour le formuler autrement, le cours n'est pas fusionné avec un cours parent.
État postérieur
STORE (STOCKER)
Seuls les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.sp2013 et Course.5.1.fa2013sont créés ou mis à jour, établissant une relation parent-enfant entre Course.1.1.SP2013(parent) et Course.1.2.SP2013.
COMPLETE REFRESH (actualisation complète)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, établissant une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.1.2.SP2013. Tous les autres enregistrements de cours détenus par cette intégration seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour, établissant une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.1.2.SP2013.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés ou supprimés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.
Modèle de cours
Les modèles de cours sont utilisés au moment de la création d'un cours pour assurer la cohérence de l'apparence, des carnets de notes, de la structure du contenu, etc. Un cours créé à l'aide d'un modèle est un miroir de ce modèle, à l'exception des paramètres de cours spécifiques qui sont présentés dans le flux de données COURSE. Vous pouvez utiliser n'importe quel cours à cette fin.
Important
Les modèles ne sont utilisés que lors de la création d'un cours. Pour créer un cours puis fournir un modèle via un flux de mise à jour, vous pouvez le faire en configurant Administrateur système → Intégrations SIS → (votre intégration) → Configuration avancée → Cours → Cartographie des champs → Clé de copie du cours source et en cochant la case Modifier lors de la mise à jour (qui n'est pas cochée par défaut).
Exemple : modèle de cours
Avertissement
Veuillez noter que le téléchargement d'un court fichier correctif avec l'opération Actualisation complète ou Actualisationcomplète par source de données peut entraîner la désactivation inattendue de nombreux cours par inadvertance. Pour éviter cela, nous déconseillons l'utilisation manuelle des types d'opérations Actualisation complète ou Actualisation complète par source de données. Ces options ne sont pas disponibles par défaut sur la page Charger un fichier de flux. Toutefois, si vous activez les deux options, cochez la case Activer les options avancées sous Type d'opération.
Le département de mathématiques exige que tous les cours de mathématiques aient une apparence similaire, une mise en page du contenu similaire et un contenu de base.
Prérequis
Un squelette de cours a été créé. Il contient le contenu, la mise en page et les paramètres requis.
Exigences minimales en matière de flux de données
EXTERNAL_COURSE_KEY
IDENTIFIANT DU COURS
COURSE_NAME
TEMPLATE_COURSE_KEY
Solution
Ajoutez l'en-tête TEMPLATE_COURSE_KEY à votre flux de données et indiquez le external_course_key du cours représentant le modèle.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|TEMPLATE_COURSE_KEY
testCourse1|Course.6.1.SP2013|Test Course 1.1 (SP2013)|testCourseTemplate.SP2013
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Si vous laissez TEMPLATE_COURSE_KEY vide, cela signifie que le cours ne nécessite pas de modèle.
État postérieur
STORE (STOCKER)
Seul l'enregistrement COURSE pour Course.6.1.SP2013 et Course.5.1.FA2013 est créé ou mis à jour, Course.6.1.SP2013 étant créé à l'aide du modèle testCourseTemplate.SP2013.
COMPLETE REFRESH (actualisation complète)
Seul l'enregistrement COURSE pour Course.6.1.SP2013 et Course.5.1.FA2013 est créé ou mis à jour, Course.6.1.SP2013 étant créé à l'aide du modèle testCourseTemplate.SP2013. Tous les autres enregistrements seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données ci-dessus.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Seul l'enregistrement COURSE pour Course.6.1.SP2013 et Course.5.1.FA2013 est créé ou mis à jour, Course.6.1.SP2013 étant créé à l'aide du modèle testCourseTemplate.SP2013.
Si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.
Exemple complet
En combinant les en-têtes ci-dessus dans un seul fichier, nous pouvons aborder la plupart des cas d'utilisation à la fois.
Prérequis
Pour que l'opération de copie du modèle réussisse, testCourse8 ne doit pas avoir été créé précédemment.
Note
Pour maintenir la vitesse du serveur et éviter de charger inutilement la base de données, le nombre de tâches de copie pilotées par le système d'informations pour les étudiants qui peuvent être exécutées simultanément dans le groupe est limité. Vous pouvez consulter l'état de ces tâches dans Administrateur système → Journaux → État des tâches système
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|AVAILABLE_IND|ROW_STATUS|MASTER_COURSE_KEY|TEMPLATE_COURSE_KEY
testCourse8|Course.8.SP2013|Test Course 8 (SP2013)|Y|ENABLED||testCourseTemplate.SP2013
testCourse8.1|Course.8.1.SP2013|Test Course 8.1 (SP2013)|Y|ENABLED|testCourse8|
testCourse8.2|Course.8.2.SP2013|Test Course 8.2 (SP2013)|Y|ENABLED|testCourse8|
testCourse9.1|Course.9.1.FA2013|Test Course 5.2 (FA2013)|Y|DISABLED||
État postérieur
STORE (STOCKER)
Seuls les enregistrements COURSE pour Course.1.1.SP2013, Course.1.2.SP2013 et Course.5.1.FA2013 sont créés ou mis à jour avec les résultats suivants :
La disponibilité de tous les cours est réglée sur Y, ce qui indique qu'ils sont disponibles.
Course.1.1.SP2013 et Course.1.2.SP2013sont définis sur ENABLED, tandis que Course.5.1.FA2013est DÉSACTIVÉ.
Établissez une relation parent-enfant entre Course.1.1.SP2013 (parent) et Course.8.1.SP2013 et Course.8.2.SP2013.
Lors de la création de Course.8.SP2013, le contenu et les paramètres du modèle testCourseTemplate.SP2013 sont copiés dans Course.8.SP2013.
COMPLETE REFRESH (actualisation complète)
Les mêmes résultats que l'opération de stockage, à ceci près que tous les autres enregistrements seront désactivés ou marqués pour suppression en raison de leur absence dans le flux de données.
COMPLETE REFRESH BY DATA SOURCE (actualisation complète par source de données)
Les résultats sont identiques à ceux de l'opération de stockage, à ceci près que si d'autres enregistrements COURSE sont gérés par cette intégration, ils ne seront PAS désactivés en raison de leur absence dans le flux de données ci-dessus, sauf s'ils ont la même source de données que celle spécifiée par l'intégration. L'opération d'actualisation complète par source de données (COMPLETE REFRESH BY DATA SOURCE) ne s'applique que sur les enregistrements de la source de données d'intégration.