Les administrateurs peuvent utiliser les outils de ligne de commande de Fichiers de cours pour :

  • sauvegarder le contenu de Fichiers de cours pour un ou plusieurs cours à l'aide de la commande backup_course_files ;
  • modifier les répertoires par défaut pour un ou plusieurs cours à l'aide de la commande update-course-directory ;
  • modifier les autorisations relatives aux répertoires de cours individuels à l'aide de la commande update-course-permission ;
  • modifier les autorisations relatives au répertoire /cours à l'aide de la commande update-all-course-hd-permission ; et
  • déplacer le contenu d'un ou de plusieurs cours vers Fichiers de cours à l'aide de la commande MoveCourseContent.

Sauvegarder le contenu de Fichiers de cours pour un cours

La commande backup_course_files permet aux administrateurs d'extraire les fichiers de cours d'un cours unique vers un répertoire donné en vue de leur sauvegarde.

Si votre établissement dispose d'une licence de gestion de contenu, les administrateurs ne peuvent utiliser cette commande que si le répertoire par défaut du cours n'a pas été modifié. Ces administrateurs peuvent utiliser la recherche orpheline existante pour rechercher les fichiers associés aux cours supprimés. Pour en savoir plus, reportez-vous à Gestion du contenu orphelin.

  1. À partir d'une ligne de commande, modifiez le répertoire suivant, où BLACKBOARD correspond à l'emplacement d'installation de Blackboard Learn :

    Syntaxe UNIX : cd $BLACKBOARD_HOME/apps/bbcms/bin

    Syntaxe Windows : cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Dans ce répertoire, tapez la commande et les opérations suivantes :

    backup_course_files.[sh|bat] COURSE_ID BACKUP_DIRECTORY

    Exemple sous UNIX :

    backup_course_files.sh Course001 /backups

    Exemple sous Windows :

    backup_course_files.bat Course001 c:\backups


Modifier les répertoires par défaut

La commande update-course-directory permet aux administrateurs de modifier les répertoires par défaut d'un ou de plusieurs cours.

  1. À partir d'une ligne de commande, modifiez le répertoire suivant, où BLACKBOARD correspond à l'emplacement d'installation de Blackboard Learn :

    Syntaxe UNIX : cd $BLACKBOARD_HOME/apps/bbcms/bin

    Syntaxe Windows : cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Dans ce répertoire, saisissez la commande suivante selon l'opération désirée :
    • Réinitialiser le répertoire d'un cours unique :
      update-course-directory.[sh|bat] --c COURSE_ID --p COURSE_DIRECTORY
    • Réinitialiser le répertoire d'un groupe de cours à l'aide d'une source de données :
      update-course-directory.[sh|bat] --d DATA_SOURCE_BUID --p COURSE_DIRECTORY
    • Réinitialiser les répertoires d'un groupe de cours en utilisant un fichier source :
      update-course-directory.[sh|bat] --f FEED_FILE_NAME
Description des opérations
OpérationDescription
--cEntrez le code d'un cours.
--dEntrez le code unique de lot des données source pour afficher la liste des cours.
--fEntrez le nom du fichier source contenant une liste de chaque code cours et son répertoire Cours cible. Par exemple : courseId1|/courses/Files
courseId2|/institution/Files
Grâce à cette option, les administrateurs peuvent exécuter l'opération dans un groupe de cours qu'ils spécifient dans le fichier source. Ce processus s'articule essentiellement en deux étapes :
  • Création du fichier source à l'aide de la base de données.
  • Exécution de la ligne de commande dans le fichier source.
L'utilisation d'un fichier source permet aux administrateurs d'avoir un enregistrement des cours dans lesquels l'opération a été effectuée.
--pPour déplacer le contenu vers un emplacement autre que le répertoire Cours par défaut, entrez le répertoire Cours cible.

Exemple :

update-course-directory.sh --c Course001 --p /courses/Files
update-course-directory.sh --d DATA_SOURCE_BUID --p /institution/Files
update-course-directory.bat --f c:\feedfile.txt


Modification des autorisations relatives aux répertoires de cours individuels

La commande update-course-permission permet aux administrateurs de modifier les autorisations relatives à des répertoires de cours individuels.

  1. À partir d'une ligne de commande, modifiez le répertoire suivant, où BLACKBOARD correspond à l'emplacement d'installation de Blackboard Learn :

    Syntaxe UNIX : cd $BLACKBOARD_HOME/apps/bbcms/bin

    Syntaxe Windows : cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Dans ce répertoire, saisissez la commande suivante selon l'opération désirée :
    • Modifier les autorisations d'un cours unique :
      update-course-permission.[sh|bat] --c COURSEID --r ROLE --p PERMISSIONS --o OPERATION --e RECURSIVEFLAG
    • Modifier les autorisations d'un groupe de cours à l'aide d'une source de données :
      update-course-permission.[sh|bat] --d DATA_SOURCE_BUID --r ROLE --p PERMISSIONS --o OPERATION
    • Modifier les autorisations d'un groupe de cours à l'aide d'un fichier source :
      update-course-permission.[sh|bat] --f FEED_FILE_NAME
    Commandes de modification des autorisations
    OpérationDescription
    --cEntrez le code d'un cours.
    --dEntrez le code unique de lot des données source pour afficher la liste des cours.
    --rEntrez le nom du rôle pour modifier son autorisation comme défini dans les opérations --o et --p.
    --pIndiquez les autorisations à ajouter, supprimer ou réinitialiser comme défini dans l'opération --o. Valeurs valides :
    • R : lire
    • W : écrire
    • D : supprimer
    • M : gérer

    Vous pouvez définir plusieurs autorisations en combinant ces valeurs. Par exemple, pour modifier les autorisations de lecture et d'écriture d'un rôle, utilisez RW.

    --oIndiquez l'opération à effectuer :
    • add: ajoute les autorisations définies dans l'opération --p.
    • remove: supprime les autorisations définies dans l'opération --p.
    • reset: réinitialise les autorisations définies dans l'opération --p.
    --fEntrez le nom du fichier source contenant la liste de chaque code cours, rôle, autorisation, opération et indicateur récursif. Par exemple :
    courseId1|Instructor|RDM|add|y
    courseId2|Course Builder|RD|reset|n
    L'option Fichier source permet aux administrateurs de spécifier un groupe de cours dans lequel ils souhaitent effectuer l'opération dans un fichier qu'ils génèrent. Ce processus s'articule essentiellement en deux étapes :
    • Création du fichier source à l'aide de la base de données.
    • Exécution de la ligne de commande dans le fichier source.

    L'utilisation d'un fichier source permet aux administrateurs d'avoir un enregistrement des cours dans lesquels l'opération a été effectuée.

    --eIndicateur récursif « y » ou « n »

    y = les modifications d'autorisation sont apportées récursivement au dossier d'origine du cours, ainsi qu'aux sous-dossiers et aux fichiers.

    n= les modifications d'autorisation sont apportées uniquement au dossier d'origine du cours.

    Exemple :

    update-course-permission.bat --c Test001 --r Instructor --p RWD --o add
    update-course-permission.sh --c Test002 --r Course Builder --p RWDM --o reset
    update-course-permission.bat --c Test003 --r Student --p RW --o remove
    update-course-permission.sh --d DATA_SOURCE_BUID --r Instructor --p RDM --o reset
    update-course-permission.bat --f c:\feedfile.txt


Modification des autorisations du répertoire /courses

La commande update-all-course-hd-permission permet aux administrateurs de modifier les autorisations relatives au répertoire /courses.

  1. À partir d'une ligne de commande, modifiez le répertoire suivant, où BLACKBOARD correspond à l'emplacement d'installation de Blackboard Learn :

    Syntaxe UNIX : cd $BLACKBOARD_HOME/apps/bbcms/bin

    Syntaxe Windows : cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Dans ce répertoire, saisissez la commande suivante selon l'opération désirée :

    update-all-course-hd-permission.[sh|bat] --r ROLE --p PERMISSIONS --o OPERATION

    Commandes de modification des autorisations dans le répertoire /cours
    OpérationDescription
    --rEntrez le nom du rôle pour modifier son autorisation comme défini dans les opérations --o et --p.
    --pIndiquez les autorisations à ajouter, supprimer ou réinitialiser comme défini dans l'opération --o. Valeurs valides :
    • R : lire
    • W : écrire
    • D : supprimer
    • M : gérer

    Vous pouvez définir plusieurs autorisations en combinant ces valeurs. Par exemple, pour modifier les autorisations de lecture et d'écriture d'un rôle, utilisez RW.

    --oIndiquez l'opération à effectuer :
    • add: ajoute les autorisations définies dans l'opération --p.
    • remove: supprime les autorisations définies dans l'opération --p.
    • reset: réinitialise les autorisations définies dans l'opération --p.
    --e

    Indicateur récursif « y » ou « n »

    y = les modifications d'autorisation sont apportées récursivement au dossier d'origine du cours, ainsi qu'aux sous-dossiers et aux fichiers.

    n= les modifications d'autorisation sont apportées uniquement au dossier d'origine du cours.

    Exemple :

    update-all-course-hd-permission.bat --r Instructor --p RWD --e n --o add
    update-all-course-hd-permission.sh --r Course Builder --p RWDM --e y --o reset
    update-all-course-hd-permission.bat --r Student --p RW --e y --o remove


Déplacement du contenu d'un ou de plusieurs cours

Lors d'une mise à niveau d'une version de Blackboard Learn antérieure à 9.1, les administrateurs peuvent déplacer le contenu de cours existant vers le répertoire Fichiers de cours pour tirer parti de ses fonctionnalités. La commande MoveCourseContent permet aux administrateurs de déplacer en lot le contenu du cours vers Fichiers de cours. Tout le contenu déplacé vers Fichiers de cours est stocké dans un sous-dossier du répertoire /courses/CourseID. Le sous-dossier est nommé comme suit : Course_ ID_ImportedContent_DATETIMESTAMP.

Si votre établissement dispose d'une licence de gestion de contenu, les administrateurs peuvent définir un dossier de destination unique dans la bibliothèque de contenus, vers lequel déplacer tout le contenu. Le sous-dossier est nommé comme suit : Course_ID_ImportedContent_DATETIMESTAMP.

  1. À partir d'une ligne de commande, modifiez le répertoire suivant, où BLACKBOARD correspond à l'emplacement d'installation de Blackboard Learn :

    Syntaxe UNIX : cd $BLACKBOARD_HOME/apps/bbcms/bin

    Syntaxe Windows : cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Dans ce répertoire, saisissez la commande suivante selon l'opération désirée :
    • Déplacer les fichiers d'un cours unique :
      MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
    • Déplacer les fichiers d'un groupe de cours à l'aide d'un batch :
      MoveCourseContent.[sh|bat] --b BATCH_UID [--p Course Builder]
    • Déplacer les fichiers d'un groupe de cours à l'aide d'une source de données :
      MoveCourseContent.[sh|bat] --d DATA_SOURCE_BUID [--p Course Builder]
    • Déplacer les fichiers d'un groupe de cours à l'aide d'un fichier source :
      MoveCourseContent.[sh|bat] --f FEED_FILE_NAME [--p Course Builder]
Commandes de déplacement de contenu
OpérationDescription
--cEntrez le code d'un cours.
--bEntrez le code unique de lot pour afficher la liste des cours.
--dEntrez le code unique de lot des données source pour afficher la liste des cours.
--f

Entrez le nom du fichier source contenant une liste de chaque code cours ou code unique de lot et son répertoire Cours cible. Le fichier source n'utilise pas de séparateur. En revanche, l'en-tête, qui indique la colonne réservée au code_cours ou au code_unique_batch, doit être spécifiée. Par exemple :

batch_uid
crs_batch-UID

ou

course_id
crs_course-ID

ou

***FileHeader
course_id
crs_course-ID
***FileFooter


L'option Fichier source permet aux administrateurs de spécifier un groupe de cours pour lequel ils souhaitent exécuter l'opération dans un fichier qu'ils génèrent. Ce processus s'articule essentiellement en deux étapes :

  • Création du fichier source à l'aide de la base de données.
  • Exécution de la ligne de commande dans le fichier source.

L'utilisation d'un fichier source permet aux administrateurs d'avoir un enregistrement des cours dans lesquels l'opération a été effectuée.

--pPour déplacer le contenu vers un emplacement autre que le répertoire Cours par défaut, entrez le répertoire cible.

Par exemple,

MoveCourseContent.sh --c Course001
MoveCourseContent.sh --c Course002 --p /institution/Course002<
MoveCourseContent.bat --b BATCH_UID
MoveCourseContent.bat --d DATA_SOURCE_BUID
MoveCourseContent.bat --f c:\feedfile.txt --p c:\institution\All