Resultados por e-mail no iAH
Índice
- 1 Visão Geral
- 2 Execução dos 6 passos
- 3 Programas de terceiros
- 4 Particularidades no iAH do LILDBi-Web
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.
Passo | Linux | Windows |
---|---|---|
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.
- sendEmail (http://caspian.dotconf.net/menu/Software/SendEmail/) para a plataforma Linux
- blat (http://www.blat.net/) para plataforma Windows.
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.