Los administradores pueden utilizar las herramientas de línea de comandos de Archivos de curso para:

  • Realizar copias de seguridad del contenido de Archivos de curso para uno o varios cursos mediante el comando backup_course_files.
  • Cambiar los directorios predeterminados de uno o varios cursos mediante el comando update-course-directory.
  • Cambiar permisos para directorios de curso individuales mediante el comando update-course-permission.
  • Cambiar permisos para el directorio /courses mediante el comando update-all-course-hd-permission.
  • Mover contenido de uno o más cursos a Archivos de curso mediante el comando MoveCourseContent.

Realizar copias de seguridad del contenido de Archivos de curso para un curso

El comando backup_course_files permite a los administradores extraer Archivos de curso de un único curso y pasarlo a un directorio seleccionado para realizar una copia de seguridad.

Si su institución dispone de licencia para la administración de contenido, los administradores solo pueden utilizar este comando si no se ha modificado el directorio predeterminado del curso. Los administradores pueden utilizar la búsqueda huérfana existente para ubicar los archivos asociados con los cursos eliminados. Para obtener más información, consulte Administración de contenido huérfano.

  1. En una línea de comandos, cambie al directorio siguiente, en el que BLACKBOARD es la ubicación de instalación de Blackboard Learn:

    Sintaxis de UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxis de Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Desde este directorio, introduzca los siguientes comandos y operaciones:

    backup_course_files.[sh|bat] COURSE_ID BACKUP_DIRECTORY

    Ejemplo en UNIX:

    backup_course_files.sh Course001 /backups

    Ejemplo en Windows:

    backup_course_files.bat Course001 c:\backups


Cambiar los directorios por defecto

El comando update-course-directory permite que los administradores cambien los directorios predeterminados de uno o varios cursos.

  1. En una línea de comandos, cambie al directorio siguiente, en el que BLACKBOARD es la ubicación de la instalación de Blackboard Learn:

    Sintaxis de UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxis de Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Desde este directorio, escriba el comando con la operación adecuada:
    • Restablecer el directorio para un único curso:
      update-course-directory.[sh|bat] --c COURSE_ID --p COURSE_DIRECTORY
    • Restablecer el directorio para un grupo de cursos mediante un origen de datos:
      update-course-directory.[sh|bat] --d DATA_SOURCE_BUID --p COURSE_DIRECTORY
    • Restablecer los directorios para un grupo de cursos mediante un archivo de fuente:
      update-course-directory.[sh|bat] --f FEED_FILE_NAME
Descripción de las operaciones
OperaciónDescripción
--cIndicar la ID de un curso.
--dPermite introducir la UID de lote origen de datos para obtener la lista de cursos.
--fPermite introducir el nombre del archivo de fuente que contiene una lista de cada ID de curso y su directorio de curso de destino. Por ejemplo: courseId1|/courses/Files
courseId2|/institution/Files
Esta opción permite que los administradores ejecuten la operación sobre un grupo de cursos especificados en un archivo de fuente. Este es, básicamente, un proceso de dos pasos:
  • Crear el archivo de introducción de datos utilizando la base de datos.
  • Ejecutar la línea de comandos en el archivo de introducción de datos.
La ventaja de utilizar un archivo de introducción de datos es que los administradores van a tener un registro de los cursos en los que se intentó realizar la operación.
--pPermite introducir el directorio de destino para mover el contenido a una ubicación que no sea el directorio de curso predeterminado.

Ejemplo:

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


Cambiar los permisos para los directorios de cursos individuales

El comando update-course-permission permite a los administradores cambiar permisos para directorios de cursos individuales.

  1. En una línea de comandos, cambie al directorio siguiente, en el que BLACKBOARD es la ubicación de instalación de Blackboard Learn:

    Sintaxis de UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxis de Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Desde este directorio, escriba el comando con la operación adecuada:
    • Cambiar los permisos para un único curso:
      update-course-permission.[sh|bat] --c COURSEID --r ROLE --p PERMISSIONS --o OPERATION --e RECURSIVEFLAG
    • Cambiar los permisos para un grupo de cursos mediante un origen de datos:
      update-course-permission.[sh|bat] --d DATA_SOURCE_BUID --r ROLE --p PERMISSIONS --o OPERATION
    • Cambiar los permisos para un grupo de cursos mediante un archivo de fuente:
      update-course-permission.[sh|bat] --f FEED_FILE_NAME
    Comandos para cambiar permisos
    OperaciónDescripción
    --cIndicar la ID de un curso.
    --dPermite introducir la UID de lote origen de datos para obtener la lista de cursos.
    --rPermite introducir el nombre del rol para que se cambie su permiso según lo definido en las operaciones --o y --p.
    --pPermite introducir los permisos que se van a añadir, eliminar o restablecer según lo definido en la operación --o. Valores válidos:
    • R: leer
    • W: escribir
    • D: eliminar
    • M: administrar

    Se pueden definir permisos múltiples mediante la combinación de los valores. Por ejemplo, para cambiar los permisos Leer y Escribir de un rol, utilice RW.

    --oPermite introducir la operación que se va a realizar:
    • add: añade los permisos definidos en la operación --p.
    • remove: elimina los permisos definidos en la operación --p.
    • reset: restablece los permisos que se definen en la operación --p.
    --fPermite introducir el nombre del archivo de introducción de datos que contiene una lista de cada ID de curso, rol, permiso, operación e indicador recursivo. Por ejemplo:
    courseId1|Instructor|RDM|add|y
    courseId2|Course Builder|RD|reset|n
    La opción de archivo de fuente permite que los administradores especifiquen cualquier grupo de cursos sobre los que deseen ejecutar la operación dentro de un archivo que generen. Este es, básicamente, un proceso de dos pasos:
    • Crear el archivo de introducción de datos utilizando la base de datos.
    • Ejecutar la línea de comandos en el archivo de introducción de datos.

    La ventaja de utilizar un archivo de introducción de datos es que los administradores van a tener un registro de los cursos en los que se intentó realizar la operación.

    --eIndicador recursivo "y" o "n"

    y = los cambios de permiso se realizan de manera recurrente en la carpeta principal del curso y en sus subcarpetas y archivos.

    n= los cambios de permiso se realizan únicamente en la carpeta principal del curso.

    Ejemplo:

    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


Cambiar los permisos para el directorio /courses

El comando update-all-course-hd-permission permite que los administradores cambien los permisos del directorio /courses.

  1. En una línea de comandos, cambie al directorio siguiente, en el que BLACKBOARD es la ubicación de la instalación de Blackboard Learn:

    Sintaxis de UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxis de Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Desde este directorio, escriba el comando con la operación adecuada:

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

    Comandos para cambiar los permisos en el directorio /courses
    OperaciónDescripción
    --rPermite introducir el nombre del rol para que se cambie su permiso según lo definido en las operaciones --o y --p.
    --pPermite introducir los permisos que se van a añadir, eliminar o restablecer según lo definido en la operación --o. Valores válidos:
    • R: leer
    • W: escribir
    • D: eliminar
    • M: administrar

    Se pueden definir permisos múltiples mediante la combinación de los valores. Por ejemplo, para cambiar los permisos Leer y Escribir de un rol, utilice RW.

    --oPermite introducir la operación que se va a realizar:
    • add: añade los permisos definidos en la operación --p.
    • remove: elimina los permisos definidos en la operación --p.
    • reset: restablece los permisos que se definen en la operación --p.
    --e

    Indicador recursivo "y" o "n"

    y = los cambios de permiso se realizan de manera recurrente en la carpeta principal del curso y en sus subcarpetas y archivos.

    n= los cambios de permiso se realizan únicamente en la carpeta principal del curso.

    Ejemplo:

    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


Mover el contenido de uno o más cursos

Al realizar la ampliación de la versión anterior a 9.1 de Blackboard Learn, los administradores pueden mover el contenido del curso existente al directorio de Archivos de curso para sacar partido de sus capacidades. El comando MoveCourseContent permite a los administradores efectuar un movimiento por lotes del contenido del curso a Archivos de curso. Todo el contenido trasladado a Archivos de curso se almacena en una subcarpeta del directorio /courses/CourseID. La subcarpeta se nombrará siguiendo el siguiente formato: Course_ ID_ImportedContent_DATETIMESTAMP.

Si su institución dispone de licencia para la administración de contenido, los administradores pueden definir una única carpeta de destino de Content Collection a la que se moverá el contenido. La subcarpeta se nombrará siguiendo el siguiente formato: Course_ID_ImportedContent_DATETIMESTAMP.

  1. En una línea de comandos, cambie al directorio siguiente, en el que BLACKBOARD es la ubicación de instalación de Blackboard Learn:

    Sintaxis de UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxis de Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Desde este directorio, escriba el comando con la operación adecuada:
    • Mover los archivos de un único curso:
      MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
    • Mover los archivos de un grupo de cursos mediante un lote:
      MoveCourseContent.[sh|bat] --b BATCH_UID [--p Course Builder]
    • Mover los archivos de un grupo de cursos mediante un origen de datos:
      MoveCourseContent.[sh|bat] --d DATA_SOURCE_BUID [--p Course Builder]
    • Mover los archivos de un grupo de cursos mediante un archivo de fuente:
      MoveCourseContent.[sh|bat] --f FEED_FILE_NAME [--p Course Builder]
Comandos para mover contenido
OperaciónDescripción
--cProporcionar la ID de un curso.
--bPermite introducir la UID de lote para obtener la lista de cursos.
--dPermite introducir la UID de lote origen de datos para obtener la lista de cursos.
--f

Permite introducir el nombre del archivo de introducción de datos que contiene una lista de cada ID de curso o UID de lote y su directorio de curso de destino. El archivo de introducción de datos no utiliza un delimitador. En su lugar, debe especificarse el encabezado, el cual detalla la columna que se va a proporcionar para course_id o batch_uid. Por ejemplo:

batch_uid
crs_batch-UID

o

course_id
crs_course-ID

o

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


La opción de archivo de fuente permite que los administradores especifiquen cualquier grupo de cursos sobre los que deseen ejecutar la operación dentro de un archivo que generen. Este es, básicamente, un proceso de dos pasos:

  • Crear el archivo de introducción de datos utilizando la base de datos.
  • Ejecutar la línea de comandos en el archivo de introducción de datos.

La ventaja de utilizar un archivo de introducción de datos es que los administradores van a tener un registro de los cursos en los que se intentó realizar la operación.

--pPermite introducir el directorio de destino para mover el contenido a una ubicación que no sea el directorio de curso predeterminado.

Ejemplo:

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