Exportar, arquivar e restaurar cursos

Exportação e arquivamento de cursos têm duas finalidades distintas no Blackboard Learn:

Exporte um curso quando os materiais forem ser reutilizados posteriormente para lecionar a um novo grupo de alunos.
Arquive um curso para manter um registro de um curso.

Saiba mais sobre como criar cursos a partir de modelos e exportas pacotes (importação de cursos)

Exportação de um curso cria um arquivo ZIP do conteúdo do curso, chamado de pacote do curso. Você pode importar pacotes do curso de volta ao Blackboard Learn para criar um novo curso com o mesmo conteúdo. Exportação de um curso inclui apenas o conteúdo do curso. A exportação não inclui nenhuma interação do usuário, como publicações de blog ou notas.

O arquivamento de um curso cria um arquivo ZIP do conteúdo do curso e interações de usuário, chamado de pacote de arquivamento. Você pode restaurar pacotes de arquivamento, mas eles não têm como finalidade ensinar o curso novamente, pois todas as interações do usuário também são restauradas. Armazene os pacotes de arquivamento em um local seguro.

Não descompacte ou extraia um curso ou pacote de arquivamento. Não remova arquivos do pacote e nem tente importar um arquivo contido no pacote. Você pode importar ou restaurar o curso apenas se o pacote estiver intacto. A edição do arquivo ZIP e em seguida importar ou restaurar o pacote resulta em um comportamento instável e imprevisível no curso.

Você pode importar pacotes de curso ou arquivamento de versões mais antigas do Blackboard Learn para a versão atual. No entanto, você não pode importar pacotes exportados de versões mais novas para versões mais antigas.

Permissões de usuário exigidas

Para incluir arquivos do curso em um pacote do curso ao exportar ou arquivar um curso, o usuário que está criando o pacote deve ter permissão de gerenciamento na pasta do curso.

Para adicionar arquivos de curso de um pacote do curso a uma pasta de destino ao importar ou restaurar um curso, o usuário que está executando a operação deve ter privilégios de gerenciamento na pasta do curso.

Se a sua instituição tiver acesso ao gerenciamento de conteúdo, os usuários com permissão de leitura poderão incluir links aos arquivos do curso durante uma operação de importação/exportação ou arquivamento/restauração. Usuários com permissão de gerenciamento podem incluir links para arquivos de curso e cópias dos arquivos propriamente ditos.

Se o usuário que está importando ou restaurando um curso não tiver permissão de gerenciamento, alguns dos conteúdos de pacote podem não carregar com sucesso.

Links para arquivos que não são incluídos quando o pacote é criado não funcionam quando o pacote é importado ou restaurado. Por exemplo, se uma área do curso for vinculada a um teste, mas o pacote não incluir testes, pesquisas e banco de testes, o link para o teste não funcionará no novo curso.

Todos os usuários do curso têm permissão de leitura nos arquivos de curso incluídos no pacote. Os usuários com as seguintes funções de curso têm permissão de gerenciamento:

Instrutores
criadores do curso
Assistentes de ensino

Saiba mais sobre o conteúdo incluído ao criar pacotes do curso

Disponibilidade do tipo de conteúdo

Antes do Blackboard Learn 9.1 SP 4, apenas os itens disponíveis eram incluídos em um pacote do curso ao exportar ou arquivar um curso. Ao importar um pacote de curso de um ambiente pré-SP 4, os itens que estavam indisponíveis podem estar agora não disponíveis porque o pacote não contém os itens indisponíveis. O Blackboard Learn não consegue diferenciar entre ferramentas do curso indisponíveis omitidas durante a exportação e quaisquer novos itens que não estavam presentes na versão mais antiga e que são configurados como disponíveis por padrão. Em versões como 9.1 SP 4, as configurações exatas feitas no nível do curso, disponível e não disponível, são rastreadas e mantidas no pacote de exportação.

Arquivar um curso

Os pacotes de arquivamento têm a seguinte estrutura de nomeação de arquivos:

ArchiveFile_Course_ID_date/time_stamp.zip

O formato de pacotes no Blackboard Learn segue a Especificação do pacote de conteúdo IMS, com extensões para dar suporte a tipos de conteúdo específicos do Blackboard Learn.

No Painel do administrador, na seção Cursos, selecione Cursos.
Aponte para Ações de backup e selecione Arquivar curso.
Na caixa Código do curso de origem, digite um código de curso válido. Se você não souber o código do curso, selecione Pesquisar para pesquisar o curso. Para saber mais, consulte Pesquisar cursos.
Para Incluir o histórico do Centro de Notas, marque a caixa de seleção embaixo do código do curso. Selecionar essa opção aumenta o tamanho do arquivo e o tempo de processamento.
Na página Anexos do arquivo, escolha se somente os links para os arquivos de curso devem ser incluídos ou se os links e cópias do conteúdo dos arquivos de curso também devem ser incluídos.
Caso selecione Copiar links e incluir cópias do conteúdo, selecione Calcular tamanho para garantir que o tamanho do pacote não ultrapasse o Tamanho de pacote permitido que é exibido. Para remover arquivos e pastas do pacote, selecione Gerenciar conteúdos de pacote.
Selecione Enviar. O Blackboard Learn cria o pacote de arquivamento e envia um e-mail para a sua conta do Blackboard Learn. Este e-mail contém um link para o conteúdo do arquivo de log do pacote e confirma se o pacote de arquivamento está pronto.
Vá para a sua conta de e-mail do Blackboard Learn e verifique se você recebeu o e-mail de confirmação.
No Painel do administrador, na seção Cursos, selecione Cursos.
Pesquise o curso que você arquivou.
Abra o menu do curso e selecione Exportar/Arquivar. A página Exportar/arquivar lista todos os pacotes de exportação ou arquivamento para este curso que não foram excluídos do Blackboard Learn, mesmo se você já tenha baixado o pacote. Os nomes de arquivo incluem a data e hora em que o pacote foi criado.
Abra o menu do arquivo ZIP e selecione Abrir.
No diálogo Abrindo arquivo, selecione Salvar arquivo e selecione OK para fazer o download do pacote de arquivamento para seu computador.
Como opção, exclua permanentemente o pacote do Blackboard Learn abrindo o menu do arquivo ZIP e selecionando Excluir.

Os exercícios do SafeAssign não estão incluídos no arquivamento nem podem ser restaurados. Para saber mais, consulte SafeAssign.

O método para arquivar cursos de lista cruzada é arquivar o curso pai. Somente cursos pai têm conteúdo e arquivar o curso pai inclui os cursos filhos. Não é necessário arquivar um curso filho, pois ele contém apenas matrículas.

Matrículas desativadas e matrículas para identificações de usuários desativadas, não estão incluídas nos pacotes de Arquivamento. Matrículas ou usuários não disponíveis são incluídos.

Exportar um curso

Você pode importar um curso exportado para criar um novo curso. Para saber mais, consulte Criação de cursos de modelos e pacotes de exportação (importação de cursos).

O formato de pacotes no Blackboard Learn segue a Especificação do pacote de conteúdo IMS, com extensões para dar suporte a tipos de conteúdo específicos do Blackboard Learn.

No Painel do administrador, na seção Cursos, selecione Cursos.
Aponte para Ações de backup e selecione Exportar curso.
Na caixa Código do curso de origem, digite um código de curso válido. Se você não souber o código do curso, selecione Pesquisar para pesquisar o curso. Para saber mais, consulte Pesquisar cursos.
Selecione Enviar.
Na página Exportar curso, escolha se somente os links para os arquivos de curso devem ser incluídos ou se os links e cópias do conteúdo dos arquivos de curso também devem ser incluídos.
Caso selecione Copiar links e incluir cópias do conteúdo, selecione Calcular tamanho para garantir que o tamanho do pacote não ultrapasse o Tamanho de pacote permitido que é exibido. Para remover arquivos e pastas do pacote, selecione Gerenciar conteúdos de pacote.
Na seção Selecionar materiais de curso, marque as caixas de seleção de cada área de curso e ferramenta a serem exportadas. Para saber mais sobre o que está incluído em cada item, consulte Criação de cursos.
Selecione Enviar.

Sobre a restauração de cursos

A restauração de um curso carrega o pacote de arquivamento no Blackboard Learn no mesmo estado em que ele estava na ocasião em que foi arquivado. Os pacotes de arquivos incluem o conteúdo, dados do usuário e as interações do usuário do curso.

Os pacotes de arquivamento foram projetados para fornecer um registro permanente de um curso. Para salvar os materiais do curso para ensinar a outro grupo de alunos posteriormente, exporte o curso em vez de arquivá-lo. Para saber mais, consulte Criação de cursos de modelos e pacotes de exportação (importação de cursos).

Quando um curso é restaurado, as configurações e opções especificadas no pacote de arquivamento substituem as configurações padrão e opções do Menu curso que estão em vigor para novos cursos.

Os pacotes do curso criados em versões anteriores do Blackboard Learn podem não ser suportados. Verifique as notas da versão que você está utilizando, para obter uma lista das versões suportadas.

Limite de tamanho para a restauração de um curso

O limite de tamanho padrão para o conteúdo carregado através da interface de usuário é 2.5 GB. Quando tentarem carregar arquivos maiores que 2.5 GB usando a interface, os usuários receberão um erro. Este limite não se aplica a carregamentos na pasta da web ou localização compartilhada (WebDAV).

Para carregar arquivos maiores, os administradores podem carregar os arquivos usando a linha de comando ou podem aumentar a configuração de tamanho padrão do Tomcat.

Para aumentar o limite máximo de upload, abra config/bb-config.properties e modifique o parâmetro de limite de upload. O limite de tamanho do carregamento de arquivo é vinculado ao Tomcat e não é encontrado nos carregamentos do webDAV. Uma vez que a configuração é vinculada ao Tomcat, os serviços devem ser reiniciados para a alteração entrar em vigor.

Você também pode aumentar o tamanho máximo de pacote de upload no painel do administrador do Sistema. Selecione Configurações do curso > Limites de tamanho padrão do curso e digite um novo tamanho ou selecione Ilimitado.

Restauração de registros de usuário

Ao executar uma restauração, o Blackboard Learn verifica se os usuários estão no sistema, validando os nomes de usuários em relação aos endereços de e-mail.

Se um nome de usuário existir com um endereço de e-mail diferente do que foi incluído no pacote de arquivamento, o Blackboard Learn cria uma nova conta de usuário. A nova conta tem o mesmo nome de usuário com um número de sequência anexado.

Se existir um nome de usuário com o mesmo endereço de e-mail, o Blackboard Learn não cria um novo usuário.

Se uma conta de usuário existir, mas estiver desativada, o Blackboard Learn criará uma nova conta de usuário. Para evitar que outro usuário seja criado no sistema, a conta de usuário original precisa estar habilitada.

Exemplo: um pacote de arquivamento é carregado com uma conta que tem o nome de usuário bb_user. O processo de restauração procura usuários com este nome de usuário no Blackboard Learn. Se bb_user existir no sistema, o processo vai comparar os endereços de e-mail. Se os endereços de e-mail combinarem, o processo criará um novo registro de matrícula em course_users com o usuário atual (bb_user). Se os endereços de e-mail forem diferentes, o processo criará um novo usuário (bb_user1).

Como precaução de segurança, qualquer usuário adicionado durante uma restauração é criado apenas com suas funções de sistema primárias. As funções de sistema secundárias não são incluídas.

Restaurar um curso

No Painel do administrador, na seção Cursos, selecione Cursos.
Pesquise um curso. Para saber mais, consulte Pesquisar cursos.

Aponte para Criar curso e selecione Restaurar. Esta tabela descreve os campos disponíveis. [r] indica um campo obrigatório.

Restaurar campos de curso disponível
Campo	Descrição
Código do curso de destino	Digite um novo código do curso. O Blackboard Learn cria um curso com os dados e as configurações do pacote de arquivos. IDs de curso podem conter números, letras, hifens (-), sublinhados (_) e pontos (.). Todos os outros caracteres, incluindo espaços, são proibidos. Você não pode alterar os IDs de curso depois que eles foram configurados. Este campo é pesquisável.
Selecione um pacote	Forneça o local exato do arquivo do pacote de arquivamento ou selecione Pesquisar meu computador para navegar até o arquivo.
Pasta para arquivos da Coleção de conteúdo	Esse campo somente aparece se a sua instituição tiver acesso ao gerenciamento de conteúdo. Para excluir arquivos de coleção de conteúdo da restauração, selecione Diretório padrão dos arquivos do curso. Para incluir arquivos da coleção de conteúdo na restauração, selecione Selecionar pasta. Selecione Pesquisar para navegar até a pasta. O Blackboard Learn cria uma subpasta e copia os arquivos da Content Collection para ela.

Selecione Enviar.

Exibir os logs de exportação e de arquivamento

No Painel do administrador, na seção Cursos, selecione Cursos.
Pesquise um curso. Para saber mais, consulte Pesquisar cursos.
Abra o menu do curso e selecione Exportar/Arquivar. A página Exportar/arquivar curso lista todos os pacotes de exportação ou arquivamento para este curso que não foram excluídos do Blackboard Learn, mesmo se você já tenha baixado o pacote. Os nomes de arquivo incluem a data e hora em que o pacote foi criado.
Abra o menu do arquivo ZIP.
Para exibir a data de criação de pacote e a hora e o status, selecione Visualizar log básico.
Para exibir a data e hora de criação do pacote, status e uma lista dos materiais do curso incluídos no pacote, selecione Visualizar log detalhado.

Exportar, arquivar e restaurar cursos em lote

O Blackboard Learn inclui a ferramenta batch_ImportExport para manipular a importação/exportação e arquivamento/restauração de vários cursos de uma vez, bem como a importação/restauração de arquivos que excedem o limite padrão máximo de carregamento.

Esta ferramenta processa arquivos de lote que incluem o código do curso e o caminho completo para o pacote ZIP.

Limite padrão máximo de carregamento

Para carregar arquivos maiores, os administradores podem carregar os arquivos usando a linha de comando ou podem aumentar a configuração de tamanho padrão do Tomcat.

Criar o arquivo de lote para exportar/arquivar e importar/restaurar

Um arquivo de lote usado apenas com a ferramenta batch_ImportExport tem dois valores em cada linha: o código do curso e o caminho completo para o pacote ZIP.

Ao executar uma ação de exportação ou arquivamento, o Blackboard Learn cria um pacote ZIP usando o caminho e o nome de arquivo especificados.
Ao executar uma ação de importação ou restauração, o caminho e o nome de arquivo especificados apontam para o pacote ZIP associado ao código do curso de destino.

A seguir estão exemplos dos conteúdos de um arquivo de lote para usar com a ferramenta batch_ImportExport. Salvar arquivos de lote como arquivos de texto (TXT).

Exemplo: exportar e arquivar arquivos de lote

Exportar e arquivar arquivos de lote exige apenas o caminho para o diretório em que cada pacote será armazenado. Não inclua um nome de pacote. Adicionar um nome de pacote resulta em um erro.

Existem três marcadores boolianos para especificar as opções de pacote.

Opção 1: Especifique verdadeiro ou falso para indicar se é para arquivar/exportar os arquivos do curso encontrados no diretório inicial do curso. Se nenhum valor for especificado, o padrão será verdadeiro.
Opção 2: Especifique verdadeiro ou falso para indicar se é para arquivar/exportar o histórico de notas. Se nenhum valor for especificado, o padrão será falso.
Opção 3: Especifique verdadeiro ou falso para indicar se é para arquivar/exportar os arquivos do curso encontrados fora do diretório inicial do curso. Se nenhum valor for especificado, o padrão será falso.

HIST101, C:\Course_archives\,true,true,true
HIST201, C:\Course_archives\,true,,true
HIST301, C:\Course_archives\,true,false,true
HIST401, C:\Course_archives\

Exemplo: importar e restaurar arquivos de lote

Importar e restaurar arquivos de lote exige o caminho exato do arquivo, incluindo o nome do pacote.

HIST101, C:\Course_archives\Archive_File_HIST101.zip
HIST201, C:\Course_archives\Archive_File_HIST201.zip
HIST301, C:\Course_archives\Archive_File_HIST301.zip
HIST401, C:\Course_archives\Archive_File_HIST401.zip
HIST331, C:\Course_archives\Archive_File_HIST331.zip

Executar a ferramenta de lote

A ferramenta de lote para executar funções de importação/exportação e arquivamento/restauração deve ser executada a partir da linha de comando. A ferramenta deve ser executada do servidor web/aplicativos. A sintaxe do comando é mostrada abaixo.

Sintaxe do Windows:

C:\Blackboard\apps\content-exchange\bin\batch_ImportExport.bat -f path_to_file -l delimiter -t operation -n virtual_hostname

Use cmd.exe para abrir uma linha de comando para executar a ferramenta. Executar a ferramenta a partir de command.exe resulta em erros.

Sintaxe do UNIX:

/usr/local/blackboard/apps/content-exchange/bin/batch_ImportExport.sh -f path_to_file -l delimiter -t operation -n virtual_hostname

O caminho exato para o diretório do Blackboard pode ser diferente, dependendo de onde o Blackboard Learn foi instalado.

Caminhos para o diretório Blackboard
Argumento	Descrição
path_to_file	Forneça o caminho completo para o arquivo de lote.
delimitador	Forneça um dos valores a seguir: 1: Identifica a vírgula (,) como o delimitador. 2: Identifica o ponto e vírgula (;) como o delimitador. 3: Identifica TAB como o delimitador.
operação	Forneça um dos valores (que diferenciam minúsculas de maiúsculas) a seguir para indicar a operação que é executada: import export restore archive
virtual_hostname	O nome da instalação virtual em relação a qual a ferramenta executará. Se não houver nenhuma instalação virtual ou se este argumento não for determinado, a ferramenta executará em relação à instalação virtual padrão.

Um parâmetro opcional verdadeiro/falso na quarta coluna do arquivo de feed está disponível para operações batch_ImportExport. Ele é usado apenas em ações de arquivamento e controla se o histórico do Centro de Notas será incluído no pacote.

Personalizar o tamanho de heap de JVM para a ferramenta batch_ImportExport

Abra o arquivo batch_ImportExport.bat ou batch_ImportExport.sh para edição.
Adicione um parâmetro $OPTS ou %OPTS para incluir o tamanho do heap do JVM personalizado. A sintaxe é mostrada abaixo. O exemplo a seguir usa um JVM Heap de 6 GB e deve ser alterado para cumprir os requisitos de sua instituição.

Sintaxe do Windows:
OPTS="%OPTS -Xmx6g"

Sintaxe do UNIX:

OPTS="$OPTS -Xmx6g"

Caminhos suportados para importação e restauração de cursos

A tabela a seguir identifica os caminhos suportados para importação ou restauração de um curso que foi exportado ou arquivado de sistemas de gerenciamento de aprendizado mais antigos. Os caminhos certificados são completamente testados e suportados pela Blackboard. Os caminhos compatíveis não são testados completamente, mas devem funcionar corretamente com base no desempenho prévio.

Caminhos para importar e restaurar cursos não são compatíveis com versões mais antigas. Os cursos podem ser importados ou restaurados para uma versão mais nova, mas os cursos de uma versão mais nova não podem ser importados ou restaurados para uma versão mais antiga.

Caminhos suportados para importação e restauração de cursos
Fonte	Suporte
Blackboard Learn versão 9.1	Certificado
Blackboard Learn Release 9.0	Certificado
Blackboard Academic Suite Release 8	Certificado
Blackboard Academic Suite versão 7	Certificado
Blackboard Academic Suite versão 6	Certificado
Blackboard ML	Certificado
Blackboard 5.5*	Certificado
Blackboard 5.0*	Compatível
CourseInfo 4	Não compatível
Blackboard Vista e CE 8.0.5 ou acima	Certificado
Blackboard Campus Edition 4.1.7	Certificado
ANGEL LMS 7.3	Não compatível
ANGEL LMS 7.4	Certificado
ANGEL LMS 8.0	Certificado

*Blackboard 5 e Blackboard 5.5 não incluíam a função de arquivamento e restauração. Os cursos dessas versões podem ser importados, mas não restaurados com dados de usuário e interações intactos.

Idioma