Os administradores podem usar as ferramentas de linha de comando dos arquivos de curso para:

  • Fazer o backup do conteúdo dos arquivos de curso de um ou mais cursos usando o comando backup_course_files.
  • Mudar os diretórios padrão de um ou mais cursos usando o comando update-course-directory.
  • Mudar permissões para os diretórios individuais do curso usando o comando update-course-permission.
  • Mudar permissões para o diretório /courses usando o comando update-all-course-hd-permission.
  • Mover conteúdo de um ou mais cursos para Arquivos de curso usando o comando MoveCourseContent.

Fazer backup do conteúdo dos Arquivos do curso de um curso

O comando backup_course_files permite que os administradores extraiam os arquivos de curso de um único curso para um diretório selecionado para backup.

Se o gerenciamento de conteúdo for licenciado pela sua instituição, os administradores poderão usar esse comando apenas se o diretório padrão do curso não tiver sido alterado. Os administradores podem usar a pesquisa órfã existente para pesquisar arquivos associados aos cursos excluídos. Para saber mais, consulte Gerenciamento de conteúdo órfão.

  1. Em uma linha de comando, mude para o seguinte diretório, em que BLACKBOARD é o local de instalação do Blackboard Learn:

    Sintaxe do UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxe do Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Neste diretório, digite o comando e operações a seguir:

    backup_course_files.[sh|bat] COURSE_ID BACKUP_DIRECTORY

    Exemplo do UNIX:

    backup_course_files.sh Course001 /backups

    Exemplo do Windows:

    backup_course_files.bat Course001 c:\backups

Alterar os diretórios padrão

O comando update-course-directory permite que os administradores mudem os diretórios padrão de um ou mais cursos.

  1. Em uma linha de comando, mude para o seguinte diretório, em que BLACKBOARD é o local de instalação do Blackboard Learn:

    Sintaxe do UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxe do Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Neste diretório, digite o comando usando a operação apropriada:
    • Redefinir o diretório para um único curso:
      update-course-directory.[sh|bat] --c COURSE_ID --p COURSE_DIRECTORY
    • Redefinir o diretório para um grupo de cursos usando uma fonte de dados:
      update-course-directory.[sh|bat] --d DATA_SOURCE_BUID --p COURSE_DIRECTORY
    • Redefinir os diretórios para um grupo de cursos usando um arquivo de feed:
      update-course-directory.[sh|bat] --f FEED_FILE_NAME
Descrições da operação
Operação Descrição
--c Forneça o código do curso.
--d Forneça o UID do lote da fonte de dados para obter a lista de cursos.
--f Forneça o nome do arquivo de feed que contém uma lista de cado código do curso e seu diretório de destino. Por exemplo: courseId1|/courses/Files
courseId2|/institution/Files
Esta opção permite que os administradores executem a operação com base em um grupo de cursos especificados em um arquivo de feed. Este é essencialmente um processo de duas etapas:
  • Crie o arquivo de feed usando o banco de dados.
  • Execute a linha de comando em relação ao arquivo de feed.
O benefício de usar um arquivo de feed é que os administradores terão um registro dos cursos em relação aos quais houve tentativa de operação.
--p Para mover o conteúdo para um local diferente do diretório do curso padrão, forneça o diretório do curso de destino.

Exemplo:

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

Alterar permissões para diretórios de curso individuais

O comando update-course-permission permite que os administradores mudem as permissões para os diretórios individuais do curso.

  1. Em uma linha de comando, mude para o seguinte diretório, em que BLACKBOARD é o local de instalação do Blackboard Learn:

    Sintaxe do UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxe do Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Neste diretório, digite o comando usando a operação apropriada:
    • Alterar as permissões para um único curso:
      update-course-permission.[sh|bat] --c COURSEID --r ROLE --p PERMISSIONS --o OPERATION --e RECURSIVEFLAG
    • Alterar as permissões para um grupo de cursos usando uma fonte de dados:
      update-course-permission.[sh|bat] --d DATA_SOURCE_BUID --r ROLE --p PERMISSIONS --o OPERATION
    • Alterar as permissões para um grupo de cursos usando um arquivo de feed:
      update-course-permission.[sh|bat] --f FEED_FILE_NAME
    Alterar comandos de permissões
    Operação Descrição
    --c Forneça o código do curso.
    --d Forneça o UID do lote da fonte de dados para obter a lista de cursos.
    --r Forneça o nome da função para ter a permissão alterada conforme definido nas operações --o e --p.
    --p Forneça as permissões que serão adicionadas, removidas ou redefinidas conforme definido na operação --o. Valores válidos:
    • R: ler
    • W: gravar
    • D: excluir
    • M: gerenciar

    Várias permissões podem ser definidas combinando os valores. Por exemplo, para mudar as permissões Ler e Gravar para uma função, use RW.
    --o Forneça a operação a ser executada:
    • add: Adiciona as permissões definidas na operação --p.
    • remove: Remove as permissões definidas na operação --p.
    • reset: Redefine as permissões definidas na operação --p.
    --f Forneça o nome do arquivo de feed que contém uma lista de cado código do curso, função, permissão, operação e o sinalizador recursivo. Por exemplo:
    courseId1|Instructor|RDM|add|y
    courseId2|Course Builder|RD|reset|n
    A opção Arquivo de feed permite que os administradores especifiquem qualquer grupo de cursos em relação ao qual eles desejam executar a operação, dentro de um arquivo gerado por eles. Este é essencialmente um processo de duas etapas:
    • Crie o arquivo de feed usando o banco de dados.
    • Execute a linha de comando em relação ao arquivo de feed.

    O benefício de usar um arquivo de feed é que os administradores terão um registro dos cursos em relação aos quais houve tentativa de operação.
    --e Sinalizador recursivo "s" ou "n"

    y = as alterações de permissão são feitas recursivamente na pasta inicial do curso e suas subpastas e arquivos.

    n = as alterações de permissão são feitas apenas na pasta inicial do curso.

    Exemplo:

    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

Alterar permissões para o diretório /courses

O comando update-all-course-hd-permission permite que os administradores mudem as permissões para o diretório /courses.

  1. Em uma linha de comando, mude para o seguinte diretório, em que BLACKBOARD é o local de instalação do Blackboard Learn:

    Sintaxe do UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxe do Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Neste diretório, digite o comando usando a operação apropriada:

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

    Alterar permissões nos comandos do diretório /courses
    Operação Descrição
    --r Forneça o nome da função para ter a permissão alterada conforme definido nas operações --o e --p.
    --p Forneça as permissões que serão adicionadas, removidas ou redefinidas conforme definido na operação --o. Valores válidos:
    • R: ler
    • W: gravar
    • D: excluir
    • M: gerenciar

    Várias permissões podem ser definidas combinando os valores. Por exemplo, para mudar as permissões Ler e Gravar para uma função, use RW.
    --o Forneça a operação a ser executada:
    • add: Adiciona as permissões definidas na operação --p.
    • remove: Remove as permissões definidas na operação --p.
    • reset: Redefine as permissões definidas na operação --p.
    --e

    Sinalizador recursivo "s" ou "n"

    y = as alterações de permissão são feitas recursivamente na pasta inicial do curso e suas subpastas e arquivos.

    n = as alterações de permissão são feitas apenas na pasta inicial do curso.

    Exemplo:

    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 o conteúdo de um ou mais cursos

Ao atualizar a partir de uma versão do Blackboard Learn anterior ao 9.1, os administradores podem mover o conteúdo existente do curso para o diretório Arquivos de curso a fim de aproveitar suas capacidades. O comando MoveCourseContent permite que os administradores movam em lote o conteúdo do curso para os arquivos de curso. Todo o conteúdo movido para os arquivos de curso é armazenado em uma subpasta do diretório /courses/CourseID. A subpasta é nomeada usando o formato a seguir: Course_ ID_ImportedContent_DATETIMESTAMP.

Se a sua instituição licenciar o gerenciamento de conteúdo, os administradores poderão definir uma única pasta de destino na Coleção de conteúdo para a qual todo o conteúdo será movido. A subpasta é nomeada usando o formato a seguir: Course_ID_ImportedContent_DATETIMESTAMP.

  1. Em uma linha de comando, mude para o seguinte diretório, em que BLACKBOARD é o local de instalação do Blackboard Learn:

    Sintaxe do UNIX: cd $BLACKBOARD_HOME/apps/bbcms/bin

    Sintaxe do Windows: cd C:\%BLACKBOARD_HOME%\apps\bbcms\bin

  2. Neste diretório, digite o comando usando a operação apropriada:
    • Mover os arquivos para um único curso:
      MoveCourseContent.[sh|bat] --c COURSE_ID [--p COURSE_DIRECTORY]
    • Mover os arquivos para um grupo de cursos usando um lote:
      MoveCourseContent.[sh|bat] --b BATCH_UID [--p Course Builder]
    • Mover os arquivos para um grupo de cursos usando uma fonte de dados:
      MoveCourseContent.[sh|bat] --d DATA_SOURCE_BUID [--p Course Builder]
    • Mover os arquivos para um grupo de cursos usando um arquivo de feed:
      MoveCourseContent.[sh|bat] --f FEED_FILE_NAME [--p Course Builder]
Comandos para mover conteúdo
Operação Descrição
--c Forneça o código do curso.
--b Forneça o UID do lote para obter a lista de cursos.
--d Forneça o UID do lote da fonte de dados para obter a lista de cursos.
--f

Forneça o nome do arquivo de feed que contém uma lista de cado código do curso ou UID do lote e seu diretório de destino. O arquivo de feed não usa um delimitador, mas o cabeçalho deve ser especificado, que por sua vez detalha qual coluna está sendo fornecida para o course_id ou batch_uid. Por exemplo:

batch_uid
crs_batch-UID

ou

course_id
crs_course-ID

ou

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


A opção de arquivo de feed permite que os administradores especifiquem qualquer grupo de cursos no qual desejam executar a operação, dentro de um arquivo que eles geram. Este é essencialmente um processo de duas etapas:

  • Crie o arquivo de feed usando o banco de dados.
  • Execute a linha de comando em relação ao arquivo de feed.

O benefício de usar um arquivo de feed é que os administradores terão um registro dos cursos em relação aos quais houve tentativa de operação.
--p Para mover o conteúdo para um local diferente do diretório do curso padrão, forneça o diretório de destino.

Exemplo:

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