Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Herramientas de línea de comandos de Archivos de curso

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.

Cómo realizar una copia de seguridad del contenido de Archivos de curso de 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

Cómo cambiar directorios predeterminados

El comando update-course-directory permite a los administradores cambiar 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 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 el comando utilizando la operación adecuada:
    • Restablecer el directorio para un solo 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 el directorio para un grupo de cursos mediante un archivo de introducción de datos:
      update-course-directory.[sh|bat] --f FEED_FILE_NAME
Descripción de las operaciones
Operación Descripción
--c Indicar 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 introducción de datos. 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

Cómo cambiar permisos para 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, introduzca el comando utilizando la operación adecuada:
    • Cambiar los permisos para un solo 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 introducción de datos:
      update-course-permission.[sh|bat] --f FEED_FILE_NAME
    Comandos para cambiar permisos
    Operación Descripción
    --c Indicar 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 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.

    --o

    Permite introducir la operación que se va a realizar:

    • añadir: añade los permisos definidos en la operación --p.
    • eliminar: elimina los permisos definidos en la operación --p.
    • restablecer: restablece los permisos que se definen 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 y operación. Por ejemplo:
    courseId1|Instructor|RDM|add
    courseId2|Course Builder|RD|reset
    La opción Archivo de introducción de datos permite a los administradores especificar cualquier grupo de cursos en los que deseen ejecutar la operación dentro de un archivo que ellos mismos 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.

     

    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

Cómo cambiar permisos del directorio /courses

El comando update-all-course-hd-permission permite a los administradores cambiar 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 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 el comando utilizando 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 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.

    --o

    Permite introducir la operación que se va a realizar:

    • añadir: añade los permisos definidos en la operación --p.
    • eliminar: elimina los permisos definidos en la operación --p.
    • restablecer: restablece los permisos que se definen en la operación --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

Cómo mover el contenido de uno o varios 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, introduzca el comando utilizando la operación adecuada:
    • Mover los archivos de un solo curso:
      MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
    • Mover los archivos de un grupo de cursos utilizando un lote:
      MoveCourseContent.[sh|bat] --b BATCH_UID [--p Course Builder]
    • Mover los archivos de un grupo de cursos utilizando un origen de datos:
      MoveCourseContent.[sh|bat] --d DATA_SOURCE_BUID [--p Course Builder]
    • Mover los archivos de un grupo de cursos utilizando un origen de datos:
      MoveCourseContent.[sh|bat] --f FEED_FILE_NAME [--p Course Builder]
Comandos para mover contenido
Operación Descripción
--c Indicar 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 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.

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

 

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