Resultados por e-mail no iAH

De Wiki.bireme.org/pt
Revisão de 17h39min de 10 de agosto de 2012 por Francisco.lopes (Discussão | contribs)

(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Visão Geral

Para enviar resultados do iAH por e-mail deve-se empreender entre um mínimo de 3 (três) e um máximo de 6 (seis) passos simples. Alguns deles exigirão informações técnicas referentes ao servidor onde a instalação está se dando, por isso é recomendável que as operações sejam realizadas, minimamente, com suporte técnico do administrador do servidor.


PassoLinuxWindows
1 Editar .def da base
2 Criar shell de envio de e-mail --
3 Corrigir link no formato descritores.pft
4 Personalizar mensagem de envio
5 Instalar sendEmail Instalar blat
6 Editar sendmail.conf

Quadro resumo de operações para permitir envio de resultados por e-mail no iAH.


A máquina onde o iAH foi instalado pode ou não contar com um servidor de e-mail, o impacto disto é sobre o passo cinco do quadro resumo acima.

Em ambiente Windows o passo dois poderá ser omitido, pois a solução empregando o blat não requer uma chamada para adaptação de parâmetros, o próprio comando dará conta do envio.

Já o passo quatro (4) é meramente opcional, em função do nível de personalização desejado na instalação.


Execução dos 6 passos

1.Editar o '.def' da base de dados

Com um editor de textos (utilizar um editor de texto como o nano, vi (Linux), notepad, editplus (Windows) não um processador de texto como LibreOffice (Linux), ou Word (Windows)) alterar o valor da diretiva SEND RESULT BY EMAIL de 

SEND RESULT BY EMAIL=OFF

para 

SEND RESULT BY EMAIL=ON

A localização dos ‘.def’ depende da versão do iAH conforme abaixo:

  • iAH versão 2 – htdocs/iah/<NOME_DA_BASE>.def ou wwwroot/iah/<NOME_DA_BASE>.def
  • iAH versão 3 – bases/par/<NOME_DA_BASE>.def


2.Criar o script responsável pelos procedimentos de envio de e-mail

É recomendável este script ser criado no diretório de documentos (ou páginas estáticas) do servidor web ou no diretório de CGI, com um editor de texto, e o nome sugerido para o script é email.sh, sendo que em ambiente Windows pode-se dispensar o script para esta finalidade que é assumida por um programa de terceiros.

Conteúdo de email.sh: 

Export TEMP_FILE=/var/tmp/$$.@@@
Cat $2 | sed ‘/Content-type: text\/html/d’ >> $TEMP_FILE
sendEmail –f <remetente> -t $1 –u “Assunto” –o message-file=$TEMP_FILE –s <servidor SMTP> -xu <login SMTP> -xp <senha SMTP>
rm –f $TEMP_FILE

Os parâmetros utilizados no comando sendEmail são: 

-f   - Endereço de e-mail do remetente. 
-t   - É o "target", ou seja, o e-mail de destino. 
-u   - Refere-se ao SUBJECT (assunto) e deve estar delimitado entre aspas para que o shell não o interprete. 
-o message-file=FILE - Envia o conteúdo de um arquivo como corpo da mensagem. 
-s   - É onde deve ser especificado o endereço do servidor SMTP. 
-xu  - O nome de login do servidor SMTP. 
-xp  - Senha do servidor SMTP.

Observação: O programa sendEmail é produto de terceiros.


3.Corrigir link no formato descritores.pft

Esta correção se motiva pelo fato de que na visualização online dos resultados, o domínio do servidor está implícito no destino do link, porém quando fora do sítio, como, por exemplo, em um e-mail, a informação de domínio não esta presente tornando-se o link, uma referência não resolvida a uma página inexistente.

Novamente utilizando um editor de texto, alterar o conteúdo do arquivo descritores.pft, como mostrado no modelo abaixo, com o http://dominio.bvs.br:

De 

,(if p(v87^d) then
  ,’<a href=”/cgi-bin/wxis.exe/iah/?IsisScript=iah/iah.xis&lang=P&base=’,v5003[1],’&nextAction=lnk&exprSearch=’,s(mpu,v87^d,|/|v87^s,mpl),’&indexSearch=MH”>’,v87^d,|/|v87^s,’</a>’,
	...

Para 

(if p(v87^d) then
   ’<a href=”http://dominio.bvs.br/cgi-bin/wxis.exe/iah/?IsisScript=iah/iah.xis&lang=P&base=’,v5003[1],’&nextAction=lnk&exprSearch=’,s(mpu,v87^d,|/|v87^s,mpl),’&indexSearch=MH”>’,v87^d,|/|v87^s,’</a>’,
 	...


4.Personalizar mensagem de envio

Para modificar a mensagem de envio, basta alterar o texto destacado em negrito nos seguintes arquivos, em função da versão do iAH, como mostrado abaixo:

iAH versão 2 – cgi-bin/iah/<lang>/ahlist.pft 

if v6112 = ‘print’ then ‘onLoad=”javascript:void(showPrintDialog())”’, fi,’>
 <center>
 <font face=”verdana” size=”1”>VHL – Virtual Health Library</font>
 <hr width=”600” align=”center”>

iAH versão 3 – htdocs/iah/scripts/<lang>/ahlist.pft 

if v6112 = ’print’ then ‘<body style=”background: #FFFFFF !important” onload=”javascript:void(showPrintDianlog())”>’
 else ‘<body style=”background: #FFFFFF !important”>’ fi,
 <div id=”contentList>
 	<div class=”contain”>
 	<div class=”copyright”>
 		BIREME/PAHO/WHO – Latin American and Caribbean Center on Health Sciences
 		<hr class=”ruler” />
 	</div>
 	...


5.Instalar programa de terceiros

As tarefas de instalação dos programas de terceiros (vide Programas de terceiros no final do documento) variam de programa para programa e de desenvolvedor para desenvolvedor, abaixo estão linhas gerais de instalação dos programas que apontamos como exemplos, não implicando em qualquer responsabilidade da BIREME no suporte a qualquer deles. Consulte o site dos desenvolvedores para obter informações sobre a instalação do programa que escolher para sua utilização.


Plataforma Linux (sendEMail)

Endereço de download: http://caspian.dotconf.net/menu/Software/SendEmail/

Após o download copie para o diretório /usr/local/bin (direitos de administrador podem ser necessários)


Plataforma Windows (blat)

Endereço de download: http://www.blat.net/

Descompacte o arquivo baixado na pasta c:\windows\system32, execute o comando de instalação como mostrado: 

blat –install <servidor SMTP> <remetente> - - - <login SMTP> <senha SMTP>

Servidor SMTP - É onde deve ser especificado o endereço do servidor SMTP. 
    remetente - Endereço de e-mail do remetente. 
   Login SMTP - O nome de login do servidor SMTP. 
   Senha SMTP - Senha do servidor SMTP.


6.Editar sendmail.conf

Usando um editor de texto, efetuar o ajuste do caminho de script email.sh no arquivo sendmail.conf localizado em htdocs/iah.

- Plataforma Linux: 

EXECUTE=/home/user/iah/cgi-bin/email.sh <mailto> <file>

- Plataforma Windows: 

EXECUTE=blat <file> -subject Results –to <mailto> -q -html


Programas de terceiros

Para enviar resultados por e-mail no iAH, é necessário haver um sistema ou programa de envio de e-mail a disposição. Nossa sugestão de solução é a instalação de um programa que supra as necessidades mínimas para envio de e-mail.

Dependendo da plataforma que está sendo utilizada (Linux ou Windows), diferentes programas deverão ser aplicados. Apontamos, a título de exemplo, programas de distribuição gratuita para as plataformas Linux e Windows, sendo que esta indicação não é obrigatória, não implica em suporte de nossa parte, e tão pouco pretende ser uma relação exaustiva de programas que servem a esta finalidade.


Particularidades no iAH do LILDBi-Web

No LILDBi-Web a única particularidade é a inexistência do arquivo sendmail.conf que deve, portanto, ser criado no diretório htdocs/lildbi/iah.

O restante dos procedimentos são idênticos e devem ser executados normalmente.

voltar à página do iAH na wiki BIREME em português

Disponível em "https://wiki.bireme.org/pt/index.php?title=Resultados_por_e-mail_no_iAH&oldid=7080"