Exibir código-fonte para Plug-in de exportação do aplicativo TEDE para DSpace

== 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.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 ==

O Plug-in exportador foi desenvolvido conforme a tecnologia utilizada no 
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 ==

A instalação do Plug-in dá-se por meio de cópia de arquivos em diretórios específicos, 
não existindo um instalador. Assim, a seguir, o passo-a-passo  para a instalação:

=== Passo 1: Obter o Plugin ===

O Plugin está disponível, em formato compactado,  com extensão .rar, para ser 
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).