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 más cursos con el comando backup_course_files
  • Cambiar los directorios predeterminados de uno o más cursos con el comando update-course-directory
  • Cambiar los permisos para directorios de cursos individuales con el comando update-course-permission
  • Cambiar los permisos para el directorio /courses con el comando update-all-course-hd-permission
  • Trasladar el contenido de uno o más cursos a Archivos de curso con el comando MoveCourseContent

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

El comando backup_course_files permite que los administradores extraigan los Archivos de curso de un solo curso y los trasladen a un directorio exclusivo 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 siguiente directorio, 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, 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 más cursos.

  1. En una línea de comandos, cambie al siguiente directorio, 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ón Descripción
--c Proporcionar la ID de un curso.
--d Permite introducir la UID de lote origen de datos para obtener la lista de cursos.
--f Permite 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 a los administradores ejecutar 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.
--p Permite 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 que los administradores cambien los permisos para directorios de cursos individuales.

  1. En una línea de comandos, cambie al siguiente directorio, 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:
    • 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ón Descripción
    --c Proporcionar la ID de un curso.
    --d Permite introducir la UID de lote origen de datos para obtener la lista de cursos.
    --r Permite introducir el nombre del rol para que se cambie su permiso según lo definido en las operaciones --o y --p.
    --p Permite introducir los permisos que se agregarán, eliminarán o restablecerán 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 de lectura y escritura de un rol, utilice RW.
    --o Permite introducir la operación que se va a realizar:
    • add: agrega los permisos definidos en la operación --p.
    • remove: elimina los permisos definidos en la operación --p.
    • reset: restablece los permisos definidos en la operación --p.
    --f Permite 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 introducción de datos 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.
    --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-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 para el directorio /courses.

  1. En una línea de comandos, cambie al siguiente directorio, 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ón Descripción
    --r Permite introducir el nombre del rol para que se cambie su permiso según lo definido en las operaciones --o y --p.
    --p Permite introducir los permisos que se agregarán, eliminarán o restablecerán 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 de lectura y escritura de un rol, utilice RW.
    --o Permite introducir la operación que se va a realizar:
    • add: agrega los permisos definidos en la operación --p.
    • remove: elimina los permisos definidos en la operación --p.
    • reset: restablece los permisos definidos 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 que los administradores trasladen el contenido del curso por lotes a Archivos de curso. Todo el contenido que se traslada 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 siguiente directorio, 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:
    • 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ón Descripción
--c Proporcionar la ID de un curso.
--b Permite introducir la UID de lote para obtener la lista de cursos.
--d Permite 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.
--p Permite 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