Mudanças entre as edições de "TEDE"

De IBICT
Ir para: navegação, pesquisa
(Criou página com '== Introdução == O [http://www.ibict.br/ Instituto Brasileiro de Informação em Ciência e Tecnologia (Ibict)], no âmbito de sua missão, lançou em 2002, a [http://bdtd...')
 
 
(15 edições intermediárias de 2 usuários não apresentadas)
Linha 1: Linha 1:
== Introdução ==
+
O Sistema de Publicação Eletrônica de Teses e Dissertações (TEDE), desenvolvido e mantido pelo Ibict, tem por objetivo proporcionar a implantação de bibliotecas digitais de teses e dissertações nas instituições de ensino pesquisa e, com isso, a sua integração à Biblioteca Digital Brasileira de Teses e Dissertações (BDTD). Após dez anos de desenvolvido, o TEDE foi totalmente atualizado. A nova versão do sistema, chamada aqui de TEDE2, está configurado no software livre DSpace, a mesma plataforma utilizada para a criação de Repositórios Digitais de Acesso Aberto. O TEDE2 já está configurado de acordo com o Novo Padrão de Metadados da BDTD estando totalmente interoperável com outros sistemas. Ainda, é possível fazer as customizações na interface e definições do fluxo de trabalho dentro do sistema. As instituições que utilizam o antigo TEDE podem migrar diretamente as suas teses e dissertações para o TEDE2. Para isso, o IBICT desenvolveu uma ferramenta que possibilita a migração das informações sem a sua perda e sem trabalho duplicado. Entre em contato com a Equipe BDTD e obtenha mais informações sobre esse processo.
 +
A execução do projeto do TEDE 2 toma como base o Software DSpace, com a interface JSPUI, e possui customizações específicas (configurações, modificações de layout e itens de desenvolvimento) para adaptação às características das teses e dissertações. Muitas dessas customizações apresentam-se úteis não só para essa tipologia documental restrita, mas para a comunidade geral de usuários do DSpace. Para tanto, definiu-se que as novas funcionalidades seriam organizadas em grupos que poderiam dar origens a plugins do projeto original do DSpace.
  
O [http://www.ibict.br/ Instituto Brasileiro de Informação em Ciência e Tecnologia (Ibict)], no âmbito
+
== [[TEDE/TEDE2]] ==
de sua missão, lançou em 2002, a [http://bdtd.ibict.br/ Biblioteca Digital Brasileira de Teses e Dissertações (BDTD)], um serviço inovador, que distribuiu o aplicativo TEDE (teses e dissertações
+
eletrônicas), visando à criação de bibliotecas digitais de teses e dissertações nas
+
Instituições de Ensino Superior (BDTD-Local).  Com isso, visou a formação de uma rede,
+
que  possibilitasse a interoperabilidade de metadados entre seus participantes. Dez
+
anos depois, em 2012, a BDTD conta com mais de 200 mil registros, oriundos de 97
+
instituições brasileiras.
+
Houve ainda uma outra iniciativa de acesso aberto à informação científica que objetivou fomento à implantação de repositórios institucionais (RI), e viabilizou a preservação e
+
disseminação da produção intelectual de uma instituição. Nesse caso, o software
+
escolhido para transferência às instituições interessadas foi o DSpace, por ser aceito  e
+
utilizado amplamente no mundo, principalmente, nas instituições de ensino e
+
pesquisa.
+
O que hoje se observa é que em algumas instituições, a manutenção de uma
+
BDTD-Local e um repositório institucional revelou-se redundante, visto que, há
+
interesse de que as teses e dissertações, também, constituam coleções no repositório
+
institucional. Para tanto, necessitam de uma facilidade que exporte os registros do
+
sistema TEDE para um formato que possam ser importado em sistemas DSpace.
+
Nesse contexto, o Plug-in de  exportação TEDE-DSpace visa apoiar as
+
instituições que utilizam o sistema TEDE e pretendem constituir uma coleção de teses
+
e dissertações no repositório institucional. Dessa forma, o Ibict renova o compromisso
+
de atualizar as tecnologias associadas aos seus serviços, mantendo as instituições
+
integradas à Rede BDTD, ao mesmo tempo em que, possibilita a consolidação dos
+
repositórios institucionais implementados com o DSpace.
+
  
== Descrição e funcionamento do Plug-in ==
+
==[[Instalação, migração e configuração - TEDE2]]==
  
O Plug-in exportador foi desenvolvido conforme a tecnologia utilizada no
+
== [[Matriz de novas funcionalidades implementadas na customização DSpace/TEDE2]] ==
desenvolvimento do sistema TEDE, assim, integra-se  totalmente, de forma
+
transparente,  e sem  grandes necessidades de modificações no sistema. Por esse
+
motivo, não possui um instalador,  basta  apenas copiar alguns  arquivos e sobrescrever
+
outros, para a sua total instalação.
+
Ao adicionar uma  nova opção no menu do administrador,  o plug-in de
+
exportação, promove  maior segurança  ao processo de exportação.  Assim, só quem
+
tem  permissão pode executá-lo.  O Plug-in  executa uma exportação, tanto dos
+
metadados, quanto dos arquivos das teses e dissertações, em um formato de
+
importação no DSpace, de forma automática.
+
Da mesma forma que, apresenta uma tela com os  resultados  do processo  de
+
exportação, permitindo  verificar o processo  de exportação,  levantar  os erros  e  a ver a
+
quantidade de registros processados.    Desse modo permite realizar ações para
+
correções de problemas que porventura possa ter.
+
Todo o processo  é  executado na interface do sistema TEDE, como
+
administrador, não requerendo a intervenção da equipe de TI.  Somente para a copia e
+
transferência dos arquivos exportados para o servidor do DSpace será necessária o
+
apoio da equipe de TI. Deve-se ressaltar que o processo de exportação pode ser re-executado quantas vezes forem necessárias, para correção de possíveis erros.
+
  
== Instalação do Plug-in ==
+
== [[Manual de usuário do TEDE2]]==
  
A instalação do Plug-in dá-se por meio de cópia de arquivos em diretórios específicos,
+
== [[Configurações básicas/avançadas]] ==
não existindo um instalador. Assim, a seguir, o passo-a-passo  para a instalação:
+
  
=== Passo 1: Obter o Plugin ===
+
== [[Problema/Solução (Troubleshooting) - TEDE2]] ==
  
O Plugin está disponível, em formato compactado,  com extensão .rar, para ser
+
== [http://tedesite.ibict.br TEDE versão antiga] ==
baixado em [http://devds-01.ibict.br/Dwiki/images/c/c6/Exportador.rar exportador.rar]. Ele pode ser baixado diretamente no servidor do
+
sistema Tede ou em um desktop e transferido para o servidor.
+
 
+
=== Passo 2: Fazer cópia de segurança do sistema TEDE ===
+
 
+
O Plug-in de exportação não faz grandes alterações no sistema TEDE,  que modifique os
+
dados das teses e dissertações contidos no sistema, mas por precaução, é altamente
+
recomendável que se faça uma cópia de segurança em todo procedimento de manutenção de
+
sistemas informatizados. Assim, fazer uma cópia de segurança, tanto dos programas quanto
+
das bases de dados, alinha-se aos procedimentos padrão de manutenção do sistema TEDE.
+
Com essa diretriz, assegura-se a integridade original de todo o
+
sistema TEDE. Caso venha ocorrer  algum problema, basta retornar a copia de segurança para
+
ter o sistema no estado original.
+
Para os programas e arquivos, basta copiar o sistema de
+
diretório do sistema TEDE desde o diretório raiz (diretório inicial do sistema, em que está
+
contido todo o sistema). Geralmente, se instalado na forma padrão, por ser um sistema
+
PHP/Apache, ele fica no diretório '''/var/www/[nome-do-diretório-tede]'''. Para copiar, pode-se
+
utilizar o comando de sistema operacional '''cp –R''' que copia recursivamente os diretórios:
+
<pre> cp –R /var/www/[nome-do-diretório-tede] /var/www/[nome-do-backup] </pre>
+
Para as bases de dados (o sistema TEDE possui duas bases de dados, '''TDE''' e
+
'''TDE_SUBMISSÃO''' em um programa gerenciador de banco de dados MySql, e é importante que a  cópia de segurança contemple as duas) pode-se fazer uso
+
das facilidades de backup de banco de dados do MySql, da seguinte forma:
+
<pre> mysqldump -u [nomedousuario] -p [nomeBanco] > [nomeBackUp] </pre>
+
 
+
=== Passo 3: Descompactar o Plug-in de exportação ===
+
 
+
O Plug-in de exportação deve ser descompactado ou copiado para o diretório  raiz  do
+
sistema TEDE, o que sobrescreverá alguns arquivos. Por isso, é importante a copia de segurança.
+
Ele criará, entre outras, uma nova pasta chamada '''arquivo-exportacao''' e sobrescreverá, também, arquivos na pasta '''tde-admin'''. A questão crítica é a de que o plugin deve 
+
manter as funcionalidades existentes, e apenas copiar ou sobrescrever código para implementar a nova ferramenta de exportação.
+
A estrutura do Plug-in é a seguinte:
+
 
+
*  '''arquivo-exportacao''' (pasta vazia em que as  teses e dissertações serão exportadas, pasta destino dos dados exportados)
+
*  '''tde-admin''' (pasta existente no sistema TEDE, com os programas novos e alterados)
+
**  '''biblioteca''' (pasta existente no sistema, com novos programas)
+
*  '''export.php''' (programa exportador)
+
** '''detalhar_export.php''' (página de detalhamento da exportação)
+
** '''exportar.php''' (página de detalhamento da exportação)
+
** '''tde_admin.php'''  (página de administração do sistema TEDE,  único programa a ser sobrescrito, para que se adicione a opção de menu ''exportação'')
+
** '''tela_export.php''' (página de exportação)
+
*  '''log-export.sql'''  (script para alteração da base de dados TDE para criar a tabela que armazenará logs da exportação).
+
 
+
=== Passo 4: Verificar permissões ===
+
 
+
Como o Plug-in  precisará criar pastas e arquivos no diretório “arquivos_exportacao”, o
+
sistema TEDE requer permissão de escrita neste diretório.  Para tanto, use o comando de
+
sistema operacional '''chmod''' com o argumento  '''–R''' (recursivo a todos os subdiretórios) e  '''755'''
+
(7=permissão total para o dono do sistema, 5=leitura e execução para os membros do grupo
+
do dono do sistema, e 5= leitura e execução para os demais usuários). Assim, de forma padrão,
+
o comando ficaria assim:
+
 
+
<pre> chmod  –R 755 [usuário-Apache:grupo-Apache] arquivo-exportacao </pre>
+
 
+
Salvo configurações diferentes da padrão no servidor Apache, o '''usuário-Apache''' e o '''grupo-Apache''' são ambos '''www-data'''. Para se verificar essa informação, pode-se dar o comando:
+
 
+
<pre> ps – ef | grep apache </pre>
+
 
+
Uma lista é apresentada, e na primeira coluna aparece sempre o usuário do sistema Apache.
+
 
+
=== Passo 5: Criar tabela para registros de log da exportação ===
+
 
+
Como o Plug-in de exportação contempla o registro e visualização do procedimento de
+
exportação, diretamente na interface do sistema TEDE, uma tabela de banco de dados deve
+
ser criada para esse fim. Para tanto, o arquivo '''log_export.sql''' é um script MySql que cria essa tabela. O que pode ser feito manualmente com o seguinte comando SQL (Structured
+
Query Language) no SGBD (Sistema Gerenciador de Banco de Dados) do MySql:
+
 
+
<pre>CREATE TABLE `log_export` (
+
`le_data` datetime NOT NULL,
+
`tsIdentificador` int(11) NOT NULL,
+
`le_metadados` text,
+
`le_arquivos` text
+
) ENGINE=MyISAM DEFAULT CHARSET=latin1;</pre>
+
 
+
Esse procedimento deve ser feito na base de dados '''TDE''' (lembrando que o sistema TEDE
+
possui duas bases de dados). Para executar o procedimento, pode-se utilizar as facilidades
+
ofertadas pelo SGBD do MySql, conforme o exemplo abaixo:
+
 
+
<pre>mysql -u [nome-do-usuario] -p [nome-do-banco] < log_export.sql</pre>
+
 
+
Caso não esteja na pasta onde o '''log_export.sql''' resida, coloque todo o
+
caminho do arquivo, por exemplo: '''"/var/www/tede..../log_export.sql"''', com
+
a descrição do caminho entre aspas duplas.
+
 
+
== Execução da exportação ==
+
 
+
A execução da exportação das teses e dissertações do sistema TEDE, no formato
+
DSpace, dá-se na página de administrador. Para tanto o usuário deve ter acesso (usuário e
+
senha) para executá-lo.  Ao entrar na página do administrador, surge à
+
esquerda, uma nova opção no menu '''Exportador DSPACE''', como mostra a figura abaixo:
+
 
+
 
+
[[Arquivo:Menu-dspace.jpg|center|500px]]
+
 
+
 
+
Ao clicar na opção de menu '''Exportador DSPACE''',  uma nova tela será apresentada
+
com um menu com duas opções '''Exportar''' e '''Visualizar''',  como mostra a próxima figura.    Esta é a página de histórico e mantém as informações da última exportação. Para exportar as
+
teses e dissertações, clique em exportar, para visualizar o resultado da exportação, clique em
+
'''Visualizar'''.
+
 
+
 
+
[[Arquivo:Exportar.png|center|700px]]
+
 
+
 
+
Na tela de visualização, há a opção de detalhar o processo de exportação, clique em
+
'''detalhar'''. Assim, o sistema  apresenta uma lista de todas as teses e dissertações
+
exportadas e o status final do processo. Pode-se verificar os registros que
+
sofreram erro na exportação para que seja possível fazer as devidas correções visando uma nova tentativa.
+
 
+
 
+
[[Arquivo:Relatorio.png|center|700px]]
+
 
+
 
+
Ao clicar na opção de menu '''Exportar''' uma tela de confirmação será apresentada. Esse procedimento pode ser feito várias vezes, pois o programa  cria uma estrutura
+
para cada exportação das teses e dissertações.  Assim, ao
+
verificar, pelo detalhamento, algum problema, pode-se corrigir e reexecutar a exportação. A
+
exportação pode demorar alguns segundos, pois precisar criar, para cada tese ou dissertação,
+
um sistema de diretórios com arquivos.
+
Ao término da exportação, a tela de resumo do processo será apresentada. Nessa página, pode-se verificar as condições de termino da exportação, quantidade de itens exportados e erros.
+
 
+
 
+
[[Arquivo:Final.png|center|700px]]
+
 
+
 
+
Ao executar a exportação, o Plug-in cria um sistema  de identificação da exportação na
+
pasta '''arquivo_exportacao''', conforme a data e hora de execução. Assim, para cada
+
exportação um diretório exclusivo será criado. Cada item (tese ou dissertação) estará contido em uma pasta  numerada sequencialmente, que conterá os
+
seguintes arquivos:
+
*  '''content''' (arquivo texto com o conteúdo da pasta, pois uma tese ou dissertação pode ter mais que um arquivo de texto completo, e estar dividida em volumes;
+
*  '''dublin_core.xml''' (arquivo contendo os metadados  da tese ou dissertação, no formato QDC, para o DSpace);
+
*  arquivos da tese ou dissertação (os arquivos em texto completo).
+

Edição atual tal como às 10h58min de 6 de março de 2015

O Sistema de Publicação Eletrônica de Teses e Dissertações (TEDE), desenvolvido e mantido pelo Ibict, tem por objetivo proporcionar a implantação de bibliotecas digitais de teses e dissertações nas instituições de ensino pesquisa e, com isso, a sua integração à Biblioteca Digital Brasileira de Teses e Dissertações (BDTD). Após dez anos de desenvolvido, o TEDE foi totalmente atualizado. A nova versão do sistema, chamada aqui de TEDE2, está configurado no software livre DSpace, a mesma plataforma utilizada para a criação de Repositórios Digitais de Acesso Aberto. O TEDE2 já está configurado de acordo com o Novo Padrão de Metadados da BDTD estando totalmente interoperável com outros sistemas. Ainda, é possível fazer as customizações na interface e definições do fluxo de trabalho dentro do sistema. As instituições que utilizam o antigo TEDE podem migrar diretamente as suas teses e dissertações para o TEDE2. Para isso, o IBICT desenvolveu uma ferramenta que possibilita a migração das informações sem a sua perda e sem trabalho duplicado. Entre em contato com a Equipe BDTD e obtenha mais informações sobre esse processo. A execução do projeto do TEDE 2 toma como base o Software DSpace, com a interface JSPUI, e possui customizações específicas (configurações, modificações de layout e itens de desenvolvimento) para adaptação às características das teses e dissertações. Muitas dessas customizações apresentam-se úteis não só para essa tipologia documental restrita, mas para a comunidade geral de usuários do DSpace. Para tanto, definiu-se que as novas funcionalidades seriam organizadas em grupos que poderiam dar origens a plugins do projeto original do DSpace.

Índice

TEDE/TEDE2

Instalação, migração e configuração - TEDE2

Matriz de novas funcionalidades implementadas na customização DSpace/TEDE2

Manual de usuário do TEDE2

Configurações básicas/avançadas

Problema/Solução (Troubleshooting) - TEDE2

TEDE versão antiga