Exporter, archiver et restaurer des cours

L'exportation et l'archivage de cours ont deux objectifs dans Blackboard Learn :

Exportez un cours lorsque le matériel pédagogique doit être réutilisé pour un nouveau groupe d'étudiants.
Archiver un cours pour en conserver un enregistrement.

En savoir plus sur la création de cours à partir de modèles et de paquets d'exportation (importation de cours)

L'exportation d'un cours crée un fichier ZIP du contenu du cours qui est appelé « paquet de cours ». Vous pouvez réimporter des paquets de cours dans Blackboard Learn pour créer un nouveau cours avec le même contenu. L'exportation d'un cours inclut uniquement le contenu du cours. Elle n'inclut pas les interactions des utilisateurs telles que les messages de blog ou les notes.

L'archivage d'un cours crée un fichier ZIP du contenu du cours et des interactions des utilisateurs qui est appelé « paquet d'archives ». Vous pouvez restaurer des paquets d'archives, mais ces derniers ne sont pas destinés à être réutilisés pour dispenser le cours, car toutes les interactions des utilisateurs sont également restaurées. Stockez les paquets d'archives à un emplacement sûr.

Ne décompressez et n'extrayez pas un paquet de cours ou d'archives. Ne supprimez pas les fichiers du paquet et n'essayez pas d'importer un fichier contenu dans le paquet. Vous ne pouvez importer ou restaurer le cours que si le paquet est intact. La modification du fichier ZIP suivie de l'importation ou de la restauration du paquet se traduit par un comportement instable et imprévisible dans le cours.

Vous pouvez importer des paquets de cours ou d'archives provenant de versions antérieures de Blackboard Learn dans la version actuelle. Toutefois, vous ne pouvez pas exporter les paquets provenant de versions récentes dans des versions antérieures.

Autorisations de l'utilisateur requises

Pour inclure des fichiers de cours dans un paquet de cours lors de l'exportation ou de l'archivage d'un cours, l'utilisateur qui crée le paquet doit disposer d'autorisations de gestion sur le dossier de cours.

Pour ajouter des fichiers de cours d'un paquet de cours à un dossier de destination lors de l'importation ou de la restauration d'un cours, un utilisateur effectuant l'opération doit disposer d'autorisations de gestion sur le dossier de cours.

Si votre établissement a accès à la gestion de contenu, les utilisateurs disposant d'une autorisation de lecture peuvent inclure des liens vers des fichiers de cours durant une opération d'importation/exportation ou d'archivage/de restauration. Les utilisateurs disposant de l'autorisation de gestion peuvent inclure eux-mêmes des liens vers des fichiers de cours et des copies des fichiers de cours.

Si un utilisateur qui importe ou restaure un cours ne dispose pas d'autorisations de gestion, il est possible qu'une partie du contenu du paquet ne soit pas téléchargée avec succès.

Les liens vers les fichiers qui ne sont pas inclus dans le paquet lors de la création du paquet ne fonctionneront pas lors de l'importation ou de la restauration du paquet. Par exemple, si un onglet de cours inclut un lien vers un test, mais que le paquet n'inclut pas les tests, les examens non notés et les pools, le lien ne fonctionnera pas dans le nouveau cours.

Tous les utilisateurs du cours disposent d'autorisations de lecture sur les fichiers de cours inclus dans le paquet. Les utilisateurs exerçant l'un des rôles suivants disposent d'une autorisation de gestion :

Professeurs
concepteurs de cours
Assistants

En savoir plus sur le contenu inclus lors de la création de paquets de cours.

Disponibilité des types de contenu

Dans les versions antérieures à Blackboard Learn 9.1 SP 4, seuls les éléments disponibles étaient inclus dans un paquet de cours lors de l'exportation ou de l'archivage d'un cours. Lors de l'importation d'un paquet de cours provenant d'un environnement antérieur à SP 4, il est possible que les éléments qui n'étaient pas disponibles le soient désormais, car le paquet ne contient pas les éléments indisponibles. Blackboard Learn ne peut pas différencier les outils pédagogiques indisponibles qui ont été omis durant l'exportation et les nouveaux éléments qui ne figuraient pas dans la version antérieure et qui sont définis comme disponibles par défaut. À partir de la version 9.1 SP4, les paramètres exacts définis au niveau du cours, tant disponibles qu'indisponibles, sont suivis et gérés dans le paquet d'exportation.

Archiver un cours

Les paquets d'archives ont la structure de nom de fichier suivante :

ArchiveFile_Course_ID_date/time_stamp.zip

Le format de paquet Blackboard Learn est conforme à la spécification de conditionnement de contenu IMS et dispose d'extensions permettant la prise en charge des types de contenu spécifiques de Blackboard Learn.

Dans le panneau de configuration de l'administrateur, dans la section Cours, sélectionnez Cours.
Pointez votre curseur sur Actions de sauvegarde, puis sélectionnez Archiver un cours.
Dans la zone Code cours source, saisissez un code cours valide. Si vous ne connaissez pas le code cours exact, sélectionnez Parcourir pour rechercher le cours. Pour en savoir plus, reportez-vous à Recherche de cours.
Pour inclure l'historique du centre de notes, cochez la case située sous le code cours. Ce choix augmente la taille du fichier et le temps de traitement.
Dans la section Fichiers joints, déterminez si vous souhaitez inclure uniquement les liens vers les fichiers de cours, ou les liens et les copies du contenu des fichiers de cours.
Si vous choisissez Copier les liens et les copies du contenu, sélectionnez Calculer la taille pour vous assurer que la taille du paquet ne dépasse pas la taille de paquet autorisée qui s'affiche. Pour supprimer des fichiers et des dossiers du paquet, sélectionnez Gérer le contenu du paquet.
Sélectionnez Soumettre. Blackboard Learn crée le paquet d'archives et envoie un e-mail à votre compte Blackboard Learn. Cet e-mail comporte un lien vers le contenu du fichier journal du paquet et confirme que le paquet d'archives est prêt.
Accédez à votre compte de messagerie Blackboard Learn et vérifiez que vous avez reçu l'e-mail de confirmation.
Dans le panneau de configuration de l'administrateur, dans la section Cours, sélectionnez Cours.
Recherchez le cours archivé.
Ouvrez le menu du cours et sélectionnez Exporter/Archiver. La page Exportation/Archive répertorie tous les paquets d'exportation ou d'archives pour ce cours qui n'ont pas été supprimés de Blackboard Learn, même si vous avez déjà téléchargé le paquet. Les noms des fichiers incluent la date et l'heure de création du paquet.
Ouvrez le menu d'un fichier .ZIP et sélectionnez Ouvrir.
Dans la boîte de dialogue Ouverture du fichier, sélectionnez Enregistrer le fichier, puis OK pour télécharger le paquet d'archives sur votre ordinateur.
Vous pouvez supprimer définitivement le paquet de Blackboard Learn en sélectionnant Supprimer dans le menu du fichier .ZIP.

Les devoirs SafeAssign ne sont pas inclus dans l'archive et ne peuvent pas être restaurés. Pour plus d'informations, reportez-vous à la section SafeAssign.

La méthode permettant d'archiver des cours faisant l'objet de références croisées consiste à archiver le cours parent. Seuls les cours parent disposent de contenu, et l'archivage du cours parent inclut les cours enfant. Il n'est pas nécessaire d'archiver un cours enfant car il ne contient que les inscriptions.

Les inscriptions et les inscriptions désactivées pour les ID utilisateur désactivés ne sont pas incluses dans les paquets d'archives. Les inscriptions ou utilisateurs non disponibles sont inclus.

Exporter un cours

Vous pouvez importer un cours exporté pour en créer un nouveau. Pour en savoir plus, reportez-vous à Création de cours à partir de modèles et de paquets d'exportation (importation de cours).

Dans le panneau de configuration de l'administrateur, dans la section Cours, sélectionnez Cours.
Pointez votre curseur sur Actions de sauvegarde, puis sélectionnez Exporter un cours.
Dans la zone Code cours source, saisissez un code cours valide. Si vous ne connaissez pas le code cours exact, sélectionnez Parcourir pour rechercher le cours. Pour en savoir plus, reportez-vous à Recherche de cours.
Sélectionnez Soumettre.
Sur la page Exporter un cours, déterminez si vous souhaitez inclure uniquement les liens vers les fichiers de cours, ou les liens et les copies du contenu des fichiers de cours.
Si vous choisissez Copier les liens et les copies du contenu, sélectionnez Calculer la taille pour vous assurer que la taille du paquet ne dépasse pas la taille de paquet autorisée qui s'affiche. Pour supprimer des fichiers et des dossiers du paquet, sélectionnez Gérer le contenu du paquet.
Dans la section Sélectionner le matériel pédagogique, cochez les cases correspondant à chaque onglet de cours et outil à exporter. Pour en savoir plus sur ce qu'inclut chaque élément, reportez-vous à Création de cours.
Sélectionnez Soumettre.

À propos de la restauration de cours

La fonctionnalité de restauration d'un cours permet de télécharger le paquet d'archives dans Blackboard Learn dans le même état que celui où il se trouvait au moment de l'archivage. Les paquets d'archives comprennent le contenu du cours, les données des utilisateurs et les interactions des utilisateurs.

Les paquets d'archives sont destinés à fournir un enregistrement permanent d'un cours. Pour enregistrer du matériel pédagogique destiné à être utilisé ultérieurement pour un autre groupe d'étudiants, exportez le cours au lieu de l'archiver. Pour en savoir plus, reportez-vous à Création de cours à partir de modèles et de paquets d'exportation (importation de cours).

Lorsque le cours est restauré, les paramètres et les options spécifiés dans le paquet d'archives remplacent les options du menu du cours et les paramètres par défaut, qui sont utilisés pour les nouveaux cours.

il est possible que les paquets de cours créés dans des versions antérieures de Blackboard Learn ne soient pas pris en charge. Consultez les notes de parution de la version que vous utilisez pour obtenir une liste des versions prises en charge.

Taille maximale pour la restauration d'un cours

La taille limite par défaut pour le chargement de contenu via l'interface utilisateur est de 2,5 Go. Lors d'une tentative de téléchargement de fichiers d'une taille supérieure à 2,5 Go à l'aide de l'interface, les utilisateurs reçoivent un message d'erreur. Cette limite ne s'applique pas aux téléchargements du dossier Web ou de l'emplacement partagé (WebDAV).

Pour télécharger des fichiers plus volumineux, l'administrateur peut utiliser la ligne de commande ou augmenter le paramètre de taille par défaut Tomcat.

Pour augmenter la limite de chargement maximale, ouvrez config/bb-config.properties et modifiez le paramètre de limite de chargement. La limite de chargement maximale du fichier est liée à Tomcat et ne concerne donc pas les chargements WebDAV. Ce paramètre étant lié à Tomcat, vous devez redémarrer les services pour que la modification soit validée.

Vous pouvez également augmenter la taille maximale du package de téléchargement à partir du panneau Administrateur système. Sélectionnez Paramètres du cours > Tailles limites du cours par défaut et saisissez une nouvelle taille ou sélectionnez Illimitée.

Restauration d'enregistrements d'utilisateur

Lorsque vous effectuez une restauration, Blackboard Learn vérifie si les utilisateurs se trouvent dans le système en validant les noms d'utilisateur par rapport aux adresses e-mail.

Si un nom d'utilisateur existe avec une adresse e-mail différente de celle indiquée dans le paquet d'archives, Blackboard Learn crée un nouveau compte utilisateur. Le nouveau compte possède le même nom d'utilisateur auquel vient s'ajouter une séquence de chiffres.

Si le nom d'utilisateur existe avec la même adresse e-mail, Blackboard Learn ne crée pas de nouvel utilisateur.

Si un compte utilisateur existe mais qu'il est désactivé, Blackboard Learn crée un compte utilisateur. Pour éviter qu'un autre utilisateur soit créé sur le système, le compte utilisateur d'origine doit être activé.

Exemple : un paquet d'archives est téléchargé avec un compte dont le nom d'utilisateur est bb_user. Le processus de restauration recherche les utilisateurs de Blackboard Learn présentant ce nom d'utilisateur. Si bb_utilisateur existe dans le système, le processus compare les adresses e-mail. Si elles correspondent, une nouvelle fiche d'inscription est créée dans course_users avec l'utilisateur existant (bb_utilisateur). Si elles sont différentes, un nouvel utilisateur est créé (bb_utilisateur1).

par précaution, tous les utilisateurs qui sont ajoutés durant une restauration sont créés avec leur rôle premier dans le système. Les rôles secondaires dans le système ne sont pas pris en compte.

Restaurer un cours

Dans le panneau de configuration de l'administrateur, dans la section Cours, sélectionnez Cours.
Recherchez un cours. Pour en savoir plus, reportez-vous à Recherche de cours.

Pointez votre curseur sur Créer un cours, puis sélectionnez Restaurer. Ce tableau décrit les champs disponibles. [r] indique un champ obligatoire.

Restaurer les champs disponibles pour un cours
Champ	Description
Code cours de destination	Indiquez un nouveau code cours. Blackboard Learn crée un cours avec les données et les paramètres contenus dans le paquet d'archives. Les codes cours peuvent contenir des chiffres, des lettres, des tirets (-), des caractères de soulignement (_) et des points (.). Tous les autres caractères, notamment les espaces, sont interdits. Les codes cours ne peuvent être modifiés une fois définis. Il est possible de faire porter une recherche sur ce champ.
Sélectionner un paquet	Saisissez l'emplacement exact du fichier correspondant au paquet d'archives ou sélectionnez Parcourir Mon ordinateur pour naviguer vers le fichier.
Dossier pour fichiers de la bibliothèque de contenus	Ce champ n'apparaît que si votre établissement a accès à la gestion de contenu. Pour exclure les fichiers de la bibliothèque de contenus de la restauration, sélectionnez Répertoire par défaut des fichiers de cours. Pour inclure les fichiers de la bibliothèque de contenus dans la restauration, sélectionnez Sélectionner un dossier. Sélectionnez Parcourir pour naviguer vers le dossier. Blackboard Learn crée un sous-dossier et y copie les fichiers de la bibliothèque de contenus.

Sélectionnez Soumettre.

Afficher les journaux d'exportation et d'archivage

Dans le panneau de configuration de l'administrateur, dans la section Cours, sélectionnez Cours.
Recherchez un cours. Pour en savoir plus, reportez-vous à Recherche de cours.
Ouvrez le menu du cours et sélectionnez Exporter/Archiver. La page Exporter/Archiver le cours répertorie tous les paquets d'archives ou d'exportation pour ce cours qui n'ont pas été supprimés de Blackboard Learn, même si vous avez déjà téléchargé le paquet. Les noms des fichiers incluent la date et l'heure de création du paquet.
Ouvrez le menu d'un fichier ZIP.
Pour afficher la date et l'heure de création du paquet, ainsi que son état, sélectionnez Afficher le journal simple.
Pour afficher la date et l'heure de création du paquet, son statut et la liste du matériel pédagogique inclus dans le paquet, sélectionnez Afficher le journal détaillé.

Exportation, archivage et restauration de cours en mode batch

Blackboard Learn inclut l'outil batch_ImportExport qui permet de gérer l'importation/l'exportation et l'archivage/la restauration de plusieurs cours à la fois, ainsi que l'importation/la restauration de fichiers qui excèdent la limite de chargement maximale par défaut.

Cet outil traite les fichiers batch comprenant le code cours et le chemin d'accès complet du paquet ZIP.

Limite de chargement maximale par défaut

Pour télécharger des fichiers plus volumineux, l'administrateur peut utiliser la ligne de commande ou augmenter le paramètre de taille par défaut Tomcat.

Création du fichier batch pour une opération d'exportation/d'archivage et d'importation/de restauration

Un fichier batch utilisé par l'outil batch_ImportExport comporte seulement deux valeurs sur chaque ligne : le code cours et le chemin d'accès complet du paquet ZIP.

Lors d'une opération d'exportation ou d'archivage, Blackboard Learn crée un paquet ZIP à l'aide du chemin d'accès et du nom de fichier spécifiés.
Lors d'une opération d'importation ou de restauration, le chemin d'accès et le nom de fichier indiqués pointent vers le paquet ZIP associé au code cours de destination.

Vous trouverez ci-dessous des exemples de contenu d'un fichier de lot à utiliser avec l'outil batch_ImportExport. Enregistrez les fichiers batch en tant que fichiers texte (TXT).

Exemple : exportation et archivage de fichiers batch

L'exportation et l'archivage de fichiers batch requièrent uniquement le chemin d'accès du répertoire dans lequel est stocké chaque paquet. N'incluez pas de nom de paquet. L'ajout d'un nom de paquet génère une erreur.

Il existe trois indicateurs booléens facultatifs pour indiquer les options de paquet.

1re option : spécifiez « vrai » ou « faux » pour indiquer si les fichiers de cours trouvés dans le répertoire d'origine du cours doivent être archivés/exportés. Si aucune valeur n'est spécifiée, la valeur par défaut est « vrai ».
2e option : Spécifiez « vrai » ou « faux » pour indiquer si l'historique des notes doit être archivé/exporté. Si aucune valeur n'est spécifiée, la valeur par défaut est « faux ».
3e option : Spécifiez « vrai » ou « faux » pour indiquer si les fichiers de cours trouvés en dehors du répertoire d'origine du cours doivent être archivés/exportés. Si aucune valeur n'est spécifiée, la valeur par défaut est « faux ».

HIST101, C:\Course_archives\,true,true,true
HIST201, C:\Course_archives\,true,,true
HIST301, C:\Course_archives\,true,false,true
HIST401, C:\Course_archives\

Exemple : importation et restauration de fichiers batch

L'importation et la restauration de fichiers batch requièrent le chemin d'accès exact du fichier, y compris le nom du paquet.

HIST101, C:\Course_archives\Archive_File_HIST101.zip
HIST201, C:\Course_archives\Archive_File_HIST201.zip
HIST301, C:\Course_archives\Archive_File_HIST301.zip
HIST401, C:\Course_archives\Archive_File_HIST401.zip
HIST331, C:\Course_archives\Archive_File_HIST331.zip

Exécution de l'outil batch

L'outil batch utilisé pour les fonctionnalités d'importation/exportation et d'archivage/de restauration doit être exécuté à partir de la ligne de commande. L'outil doit être exécuté à partir du serveur Web/d'applications. La syntaxe de la commande est présentée ci-dessous.

Syntaxe Windows :

C:\Blackboard\apps\content-exchange\bin\batch_ImportExport.bat -f chemin_accès_fichier -l séparateur -t opération -n nom_hôte_virtuel

Utilisez l'exécutable cmd.exe pour ouvrir une ligne de commande et exécuter l'outil. L'exécution de l'outil à partir de command.exe génère des erreurs.

Syntaxe UNIX :

/usr/local/blackboard/apps/content-exchange/bin/batch_ImportExport.sh -f chemin_accès_fichier -l séparateur -t opération -n nom_hôte_virtuel

Le chemin d'accès exact du répertoire Blackboard peut varier selon l'emplacement d'installation de Blackboard Learn.

Chemins d'accès au répertoire Blackboard
Argument	Description
chemin_du_fichier	Entrez le chemin d'accès complet menant au fichier de lot.
séparateur	Entrez l'une des valeurs suivantes : 1: identifie la virgule (,) comme séparateur. 2: identifie le point-virgule (;) comme séparateur. 3: identifie la tabulation comme séparateur.
opération	Entrez l'une des valeurs sensibles à la casse suivantes pour indiquer le type d'opération effectué : import export restore archive
nom_hôte_virtuel	Nom de l'installation virtuelle utilisée lors de l'exécution de l'outil. En l'absence d'installations virtuelles ou d'argument de ce type, l'outil s'exécute en fonction de l'installation virtuelle par défaut.

Un paramètre true/false facultatif dans la quatrième colonne du fichier source est disponible pour les opérations batch_ImportExport. Il n'est utilisé que pour les opérations d'archivage et détermine si l'historique du centre de notes sera inclus dans le paquet.

Personnaliser la taille de tas JVM pour l'outil batch_ImportExport

Ouvrez le fichier batch_ImportExport.bat ou batch_ImportExport.sh pour le modifier.
Ajoutez un paramètre $OPTS ou %OPTS pour inclure la taille du tas JVM personnalisée. La syntaxe est présentée ci-dessous. L'exemple suivant utilise une taille de tas JVM de 6 Go et doit être modifié de façon à respecter les exigences de votre établissement.

Syntaxe Windows :
OPTS="%OPTS -Xmx6g"

Syntaxe UNIX :

OPTS="$OPTS -Xmx6g"

Chemins d'accès pris en charge pour l'importation et la restauration de cours

Le tableau ci-dessous identifie les chemins d'accès pris en charge pour l'importation et la restauration de cours qui ont été exportés ou archivés à partir de systèmes de gestion de la formation antérieurs. Les chemins d'accès certifiés ont fait l'objet d'une vérification approfondie et sont pris en charge par Blackboard. Les chemins compatibles n'ont pas fait l'objet d'une telle vérification, mais doivent fonctionner correctement, étant donné les performances passées.

Les chemins d'accès pour l'importation et la restauration de cours ne sont pas compatibles avec les versions antérieures. Les cours peuvent être importés ou restaurés dans une nouvelle version, mais les cours d'une nouvelle version ne peuvent pas l'être dans une version antérieure.

Chemins d'accès pris en charge pour l'importation et la restauration de cours
Source	Assistance
Blackboard Learn version 9.1	Certifié
Blackboard Learn version 9.0	Certifié
Blackboard Academic Suite version 8	Certifié
Blackboard Academic Suite version 7	Certifié
Blackboard Academic Suite version 6	Certifié
Blackboard ML	Certifié
Blackboard 5.5*	Certifié
Blackboard 5.0*	compatible
CourseInfo 4	Non pris en charge
Blackboard Vista et CE version 8.0.5 ou ultérieure	Certifié
Blackboard Campus Edition 4.1.7	Certifié
ANGEL LMS 7.3	Non pris en charge
ANGEL LMS 7.4	Certifié
ANGEL LMS 8.0	Certifié

*Blackboard 5 et Blackboard 5.5 n'incluaient pas de fonction d'archivage et de restauration. Les cours de ces versions peuvent être importés, mais ils ne peuvent pas être restaurés avec les interactions et les données utilisateur intactes.

Langue