Manual de usuario de iah apéndice envío de resultados por mail Ernesto Spinak v.1.0 provisional noviembre 2011

Transcripción

1 Manual de usuari de iah apéndice enví de resultads pr mail Ernest Spinak v.1.0 prvisinal nviembre 2011 Intrducción La interfaz pr defect para las cnsultas de las bases de dats Isis tant en ABCD cm en la BVS, es la aplicación iah de Bireme, que usa el sftware wxis.exe y el lenguaje IsisScript. Este dcument amplía la infrmación sbre la cnfiguración de la pción SEND RESULT BY que se intrduce en la Sección Preferencias del manual ficial publicad pr BIREME. Las explicacines aplican indistintamente a las versines 2.x y 3.x de iah. 1 Cada base de dats accesible desde la interfaz iah debe tener un archiv de definición de parámetrs llamad <name_base>.def. Si la versión de iah en us es 2.x, entnces este archiv estará aljad en el directri../htdcs/iah, en cambi si la versión es 3.x (cas de ABCD), entnces estará aljad en../www/bases/par. En las líneas finales del archiv <name_base>.def, en la sección de preferencias, aparece una pción que permite activar n esa funcinalidad. Usualmente la pción está desactivada debid a que ls usuaris n han advertid la función n han sabid implementarla. [PREFERENCES] AVAILABLE FORMS=F,A SEND RESULT BY =OFF NAVIGATION BAR=ON DOCUMENTS PER PAGE=20 FEATURES=XML La explicación que está en el manual ficial n ha resultad suficientemente clara para usuaris n experts, pr l cual explicarems más detalladamente cóm se implementa ese servici. Cnsideracines previas Primer veams la diferencia entre dispner n este servici en las figuras que siguen, que muestra la secuencia de peracines necesarias para enviar el resultad de una cnsulta, para las ds versines de iah Versión 2.x - BVS Versión 3.x - ABCD resultad de una cnsulta, se seleccina en el checkbx y se slicita enviar resultad 1 v.3.x: v.2.x: p.1

2 Versión 2.x - BVS Versión 3.x - ABCD Opción enví de resultads: permite enviar a la impresra, exprtar el archiv en HTML ISO2709, sin embarg, cuand SEND RESULT BY MAIL=OFF n aparece la pción de Opción enví de resultads: cuand SEND RESULT BY MAIL=ON aparece una nueva pción página de cnfirmación del enví del resultad El usuari indicad en la pción de enví recibirá en su crre un mensaje cn la presentación que sigue. Nte que el cabezal pr defect cntiene el nmbre de BIREME, per est puede cambiarse cm verems más abaj. Versión 2.x - BVS Versión 3.x - ABCD p.2

3 Persnalización del mensaje de enví Para adaptar el cabezal del mensaje de enví de resultads debe mdificar el archiv ahlist.pft, que se encuentra en: v.3.x /www/htdcs/iah/scripts/<lang>/ahlist.pft v.2.x../<rt>/cgi-bin/iah/<lang>/ahlist.pft script a mdificar en v.2.x if v6212 = 'print' then 'nlad="javascript:vid(shwprintdialg())"' fi,'> <center> <fnt face="verdana" size="1">vhl - Virtual Health Library</fnt> <hr width="600" align="center"> script a mdificar en v.3.x if v6212 = 'print' then '<bdy style="backgrund: #FFFFFF!imprtant" nlad="javascript:vid(shwprintdialg())">' else '<bdy style="backgrund: #FFFFFF!imprtant">' fi, '<div id="cntentlist"> <div class="cntain"> <div class="cpyright"> BIREME/PAHO/WHO - Latin American and Caribbean Center n Health Sciences <hr class="ruler" /> </div> Mensaje que recibirá el usuari cn el cabezal mdificad de acuerd a la bibliteca Versión 2.x - BVS Versión 3.x - ABCD Es psible usar diferentes encabezamients dependiend de la base de dats de la que prcede el resultad. Para es deberá mdificar el archiv ahlist.pft cn instruccines similares a: <fnt face="verdana" size="1">, If s(mhu,v5003^*) = BASE1 then mpl, BASE1 frm MyLibrary, else mpl, VHL Virtual Health Library, fi, </fnt> p.3

4 Instalación del prgrama de enví de mail en diferentes sistemas perativs La aplicación iah en sí misma n hace el enví de ls resultads pr mail, sin que genera una salida que es interpretada pr un archiv extern llamad sendmail.cnf y éste a su vez l encamina a un prgrama SMTP 2 previamente instalad y adecuad al sistema perativ. El archiv sendmail.cnf entregará ds valres parámetrs al prgrama de enví de crres, (SMTP), que es accinad mediante la instrucción EXECUTE adecuada al prgrama específic que está perativ en esa instalación. Ess valres sn: mailt y file El archiv sendmail.cnf se encuentra en /htdcs/iah/sendmail.cnf en tdas las versines de iah. Archiv sendmail.cnf (default) # Put the cmmand line fr sending thrugh yur server SMTP. # Use the literals <mailt> and <file> t specify where these fields will be # inserted in the cmmand by IAH. Als specify the cmplete path fr the "mailer", # in case this is nt cnfigured in "path" f the server. Ejempl Windws: EXECUTE=blat <file> -subject Results -t <mailt> Ejempl Linux: EXECUTE=/hme/user/iah/cgi-bin/ .sh <mailt> <file> Según sea la distribución instalada (Windws Linux) el archiv sendmail.cnf indicará una de las las ds líneas que cmienzan cn la instrucción EXECUTE=. Para el cas de la versión Windws viene cn ls parámetrs mínims bligatris para el prgrama blat 3, y para el cas de Linux asume que está instalada una versión MTA 4 de la familia RedHat. Ntas: La aplicación de SMTP para envi de n frma parte del paquete IAH, deberá ser instalad previamente. Ls dats entre < > sn prprcinads pr IAH, per pueden usarse parámetrs adicinales, l que será respnsabilidad del administradr. En las siguientes seccines se darán ejempls de cnfiguración de una aplicación de SMTP para Windws y tres diferentes MTA de Linux: Línea Redhat usand sendmail Cualquier Linux usand qmail Cualquier Linux usand send Nta: send n es un MTA, sin que es un prgrama cm el Blat de Windws, per para Linux que usa cualquier MTA 2 Simple Mail Transfer Prtcl (SMTP) Prtcl Simple de Transferencia de Crre, es un Prtcl de red basad en texts utilizads para el intercambi de mensajes de crre electrónic entre cmputadras u trs dispsitivs (PDA's, teléfns móviles, etc.). SMTP se basa en el mdel cliente-servidr, dnde un cliente envía un mensaje a un varis receptres. La cmunicación entre el cliente y el servidr cnsiste enteramente en líneas de text cmpuestas pr caracteres ASCII. 3 Blat is a Public Dmain Windws cnsle utility that sends the cntents f a file in an message using the SMTP prtcl. Blat is useful fr creating scripts where mail has t be sent autmatically (CGI, backups, etc.), r just as a quick way t send a file r message quickly frm the cmmand line. 4 Agente de Transferencia de Crre (del inglés Mail Transprt Agent MTA; también Message Transprt Agent, Agente de Transprte de Mensajes) es un de ls prgramas que ejecutan ls servidres de crre, y tiene cm fin transferir un cnjunt de dats de una cmputadra a tra. p.4

5 SMTP en ambiente Windws El sistema perativ Windws n incluye pr defect un prgrama nativ de enví de crres, pr l que deberems instalar una aplicación externa. Blat ( es un prgrama cliente de crre (estil prxy) en distribución FOSS muy eficiente, simple de instalar y usar. El paquete viene cn un manual cmplet cn tds ls parámetrs que pueden usarse. Descargue del siti la última versión dispnible: Blat v2.7.5 build:aug , descmprima y tendrá tres archivs: blat.dll; blat.exe; blat.lib. Cpie ls tres archivs en c:\windws\system32 Instale el prgrama blat La instalación del prgrama se hace pr única vez desde la línea de cmands del MS-DOS, y requiere infrmar siete parámetrs de ls cuales sól cuatr sn bligatris. La sintaxis de la instalación es: Blat -install <server addr> <sender's addr> [<try>[<prt>[<prfile>]]] [-q] Ejempl (valres inventads) blat -install nbdy@xxx.rg.uy espinak 666.!!! Ls tres guines - significa que hay tres parámetrs pcinales en blanc Ls ds últims parámetrs sn el nmbre del usuari de la cuenta y su passwrd. Ests parámetrs quedarán registrads y encriptads en el Register del equip Servidr dnde está instalad el iah, en la clave: HKEY_LOCAL_MACHINE\SOFTWARE\PUBLIC DOMAIN\BLAT Siempre será psible cambiar ls valres crriend nuevamente la instrucción de instalación. Observe que puede usar cm servidr de crre cualquier servidr dnde usted se encuentre registrad cn una cuenta, pr ejempl en una cuenta de gmail de htmail. El archiv sendmail.cnf que viene cn la versión 3.x trae la línea siguiente: EXECUTE=blat <file> -subject Results -t <mailt> -q html Per sería psible insertar una línea de cmands más ambicisa (vea el manual de blat) EXECUTE=blat <file> -subject Resultads -t <mailt> -sender mylibrary@smething.cm -frm mylibrary@smething.cm -embed sme.gif -embed sme.jpg -html -q -lg lg.txt Nta: tds ls parámetrs deben escribirse en la misma línea, se ls separa en renglnes slamente pr claridad. p.5

6 SMTP en ambiente Linux El sistema perativ Linux puede dispner de prgramas de enví de mail pr SMTP, llamads genéricamente MTA. Algunas distribucines ya traen incluid un MTA, en su defect es psible instalar un si es necesari. Este manual n explica cóm se instala un MTA, per se explica cóm preparar el script que requiere iah para enviar ls resultads. Se asume que ls MTA están inlcuids en el PATH y tienen ls permiss de ejecución necesaris El archiv sendmail.cnf vist más arriba, en la ditribución de iah para Linux cntiene la siguiente linea pr defect EXECUTE=/hme/user/iah/cgi-bin/ .sh <mailt> <file> En la instrucción vems que hay ds parámetrs que sn enviads a un script.sh que está en la carpeta /cgi-bin indicada cn la ruta absluta. El script se llama .sh y es este archiv el que deberá ser cnfigurad para la versión del MTA perativa en el sistema Linux. Se dan a cntinuación tres ejempls del archiv .sh Sendmail típic en versines de la línea Redhat .sh exprt TEMP_FILE=/var/tmp/$$.@@@ ech "Frm: salerta@dn.edu.uy" > $TEMP_FILE ech "T: $1" >> $TEMP_FILE ech "Subject: Resultads " >> $TEMP_FILE ech "Mime-Versin: 1.0" >> $TEMP_FILE ech "Cntent-type: text/html" >> $TEMP_FILE cat $2 >> $TEMP_FILE #ech "</bdy>" >> $TEMP_FILE #ech "</html>" >> $TEMP_FILE /usr/lib/sendmail -t -i < $TEMP_FILE rm $TEMP_FILE send cualquier Linux Requiere el us del prgrama send ( Descargue la aplicación y l cpia en /usr/lcal/bin .sh exprt TEMP_FILE=/var/tmp/$$.@@@ cat $2 sed '/Cntent-type/d' > $TEMP_FILE cat $TEMP_FILE send -f bvsbcu@bvrie.gub.uy -t $1 -u "Resultads" rm $TEMP_FILE exit 0 Nta: la línea marcada en amarill se debe a un bug del iah que deberá ser crregid p.6

7 Qmail .sh exprt ech "Frm: > $TEMP_FILE ech "T: $1" >> $TEMP_FILE ech "Subject: Resultad cnsultas " >> $TEMP_FILE ech "Mime-Versin: 1.0" >> $TEMP_FILE ech "Cntent-type:text/html" >> $TEMP_FILE cat $2 >> $TEMP_FILE /var/qmail/bin/qmail-inject < $TEMP_FILE rm $TEMP_FILE Agradecimient Quier agradecer al expert en infraestructura infrmática, Ing. Dieg Muses, pr la ayuda y cperación para reslver este prblema. p.7