Passer au contenu principal
pdf?stylesheet=default
Blackboard Help

Outils de ligne de commande de Fichiers cours

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.

Comment sauvegarder le contenu des 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 Content Management, 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 à la section Gestion de 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

Comment 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 pour un seul cours :
      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 à l'aide d'un fichier source :
      update-course-directory.[sh|bat] --f FEED_FILE_NAME
Description des opérations
Opération Description
--c Entrez le code d'un cours.
--d Entrez 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 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 un 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.
--p Pour 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

Comment modifier les autorisations des 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 pour un seul cours :
      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ération Description
    --c Entrez le code d'un cours.
    --d Entrez le code unique de lot des données source pour afficher la liste des cours.
    --r Entrez le nom de la fonction pour modifier son autorisation comme défini dans les opérations --o et --p.
    --p

    Indiquez 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'une fonction, utilisez RW.

    --o

    Indiquez l'opération à effectuer :

    • ajouter : ajoute les autorisations définies dans l'opération --p.
    • supprimer : supprime les autorisations définies dans l'opération --p.
    • réinitialiser : réinitialise les autorisations définies dans l'opération --p.
    --f Entrez le nom du fichier source contenant une liste de chaque code cours, fonction, autorisation et opération. Par exemple :
    courseId1|Instructor|RDM|add
    courseId2|Course Builder|RD|reset
    L'option Fichier source permet aux administrateurs de spécifier tout 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.

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

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

     

    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

Comment modifier les autorisations du répertoire /cours ?

La commande update-all-course-hd-permission permet aux administrateurs de modifier les autorisations du répertoire /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 :

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

    Commandes de modification des autorisations dans le répertoire /cours
    Opération Description
    --r Entrez le nom de la fonction pour modifier son autorisation comme défini dans les opérations --o et --p.
    --p Indiquez 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'une fonction, utilisez RW.

    --o

    Indiquez l'opération à effectuer :

    • ajouter : ajoute les autorisations définies dans l'opération --p.
    • supprimer : supprime les autorisations définies dans l'opération --p.
    • réinitialiser : réinitialise les autorisations définies dans l'opération --p.

     

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

Comment déplacer le 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 Content Management, les administrateurs peuvent définir un dossier de destination unique dans Content Collection, 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 pour un seul cours :
      MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
    • Déplacer les fichiers d'un groupe de cours à l'aide d'un code unique de lot :
      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ération Description
--c Entrez le code d'un cours.
--b Entrez le code unique de lot pour afficher la liste des cours.
--d Entrez 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.

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

 

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