COBEMAIL - Tools for COBOL Programmers
Contents
1. La variable EMAIL VAR VALUE tiene un picture X 250 si deseamos mandar un valor numerico es recomendable formatearlo antes con una variable con mascara En nuestro template indicaremos la variable a cambiar encerrada entre lt variable gt Para el ejemplo deberiamos indicarla como lt nombre gt Podemos definir tantas variables como necesitemos en nuestro Template Si por alguna razon indicamos una variable dentro del template pero no le asignamos valor desde nuestro programa no mostrara ningun valor es decir el template tendra un valor vacio o espacio El programa TEST3 CBL de los ejemplos de uso de COBEMAIL tiene una muestra de c mo pasar valores a las variables del template www cobtools com P gina 18 Manual del usuario de COBEMAIL MEMOS Estos registros son para manejar informacion en multiples lineas Este tipo de MEMOS son unicamente para incluir el texto del Contenido y no pueden ser utilizados en contenido donde se usan Templates HTML Son varios registros que se deben de utilizar para este fin Ejemplo WRITE LINEA FROM EMAIL START MEMO MOVE LINE 1 TO EMAIL DAT MEMO WRITE R EMAIL FROMEMAIL MEMO MOVE LINE 2 TO EMAIL DAT MEMO WRITE R EMAIL FROMEMAIL MEMO WRITE LINEA FROM EMAIL END MEMO El registro EMAIL START MEMO si2. TEXT Este registro se usa para especificar que el email ser enviado en formato TEXT No es necesario especificar ning n dato en alguna variable en especial Ejemplo WRITE R EMAIL FROM EMAIL TYPE TEXT Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt EMAIL TYPE TEXT gt Cuando se env a un email en formato TEXTO el contenido del mensaje es nicamente en formato Texto El texto se puede indicar con el registro EMAIL MESSAGE y no se puede usar el registro EMAIL TEMPLATE para indicar un archivo de Template HTML www cobtools com P gina 14 Manual del usuario de COBEMAIL EMAIL TYPE HTML Este registro es para especificar que el email a enviar ser en formato HTML No se necesita indicar alg n dato especial en alguna variable Ejemplo WRITE R EMA L FROM EMA L TYP E H TML Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt EMA TYPE HTML Cuando se env a un email en formato HTML el cuerpo del mensaje que se registra en el registro EMAIL MESSAGE puede ser tanto en formato Texto como en Formato HTML Aunque lo mas recomendable es utilizar un Template HTML generado con alg n editor de Paginas Web www cobtools com P gina 15 Manual del usuario de COBEMAIL EMAIL CO
3. directorio actual donde se esta llamando el programa COBSENDM EXE Una vez que la encuentra se inserta la imagen en el cuerpo del email en forma autom tica de tal manera que cuando llega el email al destinatario todas las im genes ser n vistas de manera transparente Ejemplo MOVE XHTMLXEMAIL1 HTM TO FILE TEMPLATE TO FILE TEMPLATE WRITE R EMAIL FROM EMAIL TEMPLATE Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt TEMPLATE FILE HTML EMAIL1 HTM gt En este ejemplo se indica que el archive de template se encuentra en el subdirectorio HTML con el nombre EMAIL1 HTM www cobtools com P gina 17 Manual del usuario de COBEMAIL EMAIL VAR Sirve para indicarle un valor a una variable que se especifico en el Template En muchas ocasiones deseamos escribir un Template HTML pero con una parte variable en donde nuestro programa COBOL pudiera especificar que texto deberia de ir en esa parte Por ejemplo si escribieramos el template de una Carta para una lista de CLIENTES podriamos poner como variable el Nombre del cliente para que en lugar de un texto fijo escribiera el Nombre de cada cliente y asi personalizar la carta Ejemplo MOVE NOMBRE TO EMAIL VAR NAME MOVE WSS NOMBRE TO EMAIL VAR VALUE WRITE R EMAIL FROM EMAIL VAR
4. ME JUAN PEREZ EMAIL 3jpereztdominio com gt Podemos especificar varias veces este mismo registro si dese ramos enviar el mismo email a diferentes cuentas de correo como destinatario www cobtools com P gina 9 Manual del usuario de COBEMAIL EMAIL CC Este registro se utiliza para enviar copias del mismo email Las cuentas de email que se registren con este registro ser n reportadas en el dato Con copia para Al momento de enviar un email no hay diferencia entre usar un EMAIL TO y un EMAIL CC para enviar copias del mismo email a diferentes personas lo nico es que a todos les llegara el email y las cuentas adicionales ser n reportadas en el dato Con copia para Los datos que se necesitan son los siguientes CC NAME Es el nombre de la persona a quien va dirigida la copia del email CC EMAIL Es la cuenta de correo para quien va dirigida la copia del mismo email Ejemplo MOVE MIGUEL HERNANDEZ TO CC NAME MOVE mhernandezfdominio com TO CC EMAIL WRITE R EMAIL FROM EMAIL CC Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt CC NAME MIGUEL HERNANDEZ EMAIL mhernandezk dominio com gt www cobtools com P gina 10 Manual del usuario de COBEMAIL EMAIL SUBJECT Este registro es utilizado para enviar el Asunto del em
5. ML que puede ser dise ado con cualquier editor de Paginas Web como por ejemplo Front Page aunque podemos utilizar el editor de html de nuestra preferencia Tambi n gracias a el formato de HTML podemos incluir im genes incrustadas en el email y estas im genes son enviadas de manera autom tica al indicar el archivo HTML de Template ya que COBEMAIL analiza el archivo de Template y todos los v nculos hacia im genes son incluidas tambi n en el correo sin la necesidad de tener que especificar dichos archivos El formato de nuestro archivo de email es muy similar al c digo HTML el cual tambi n es muy com n en otros programas de COBTOOLS como por ejemplo COBVIEW Para enviar un email entonces solo debemos de saber como generar dicho archivo texto con las instrucciones para el env o del email si podemos crear un archivo texto desde COBOL podremos enviar correos sin meternos en complicaciones de tener que conocer alg n API especial www cobtools com P gina 3 Manual del usuario de COBEMAIL Instalaci n La instalaci n es de lo m s sencillo ya que solo hay que ejecutar el programa de instalaci n de COBEMAIL y seguir las instrucciones del asistente Una vez instalado el programa en la carpeta donde nosotros hayamos especificado obtendremos los siguientes archivos cfeCobEmail EXE Programa de configuraci n de COBEMAIL CobSendM EXE Programa que se encarga de el Env o de Emails CobEmail DAT Archivo que almacena la conf
6. Manual del usuario de COBEMAIL COBEMAIL Versi n 2 04 Manual del usuario www cobtools com P gina 1 Manual del usuario de COBEMAIL INDICE daa Jo Luto ote a O AP UA an 3 a 4 PATAMEtOS que ACP adi ala 6 Instrucciones para generar en el archivo de Email ooooccnncciccconccnocacocononononccononanonnnccnnc cnn nonnnos 7 Registros de CGOBEMATIL W SS ria id 8 EMAU FROM siii ts 8 EMAU Out ia 9 EMMA it ana 10 EMAN SUBJECT sissserescississniegerinoea ai aourai e Ea oE EAA EEEa A a SEREGEK aa 11 EMAM MESSAGE sp a eei aaie e Ea Easa aai Si 12 EMATE ATTACEMEN Essen ica 13 ENMAIE TIYPE TE Ni 14 EMAIE TYPE O ML anio 15 EMA IL CONFIRM ani oca 16 ENATE TEMIPLATE sn 17 EMATEVAR nino iia 18 MEMOS ai cin 19 MEMOS EN VARIABLES p neen ol ad 20 EMA IL BLOCK condo odias 21 Registro de Licencia para COBENIAT Ea ie 22 www cobtools com P gina 2 Manual del usuario de COBEMAIL Introducci n COBEMAIL es un programa que nos auxilia en el env o de correos electr nicos Email desde nuestras aplicaciones COBOL Unicamente hay que hacer una peque a configuraci n para indicarle a COBEMAIL por que v a ser n enviados los correos una vez echo esto solo hay que crea un peque o archivo con nuestro programa COBOL para enviar un email a otra cuenta de correo COBEMAIL puede enviar tanto correos en formato Texto como correos en formato HTML gracias al manejo f cil y sencillo de Templates Un Template es un archivo en formato HT
7. NFIRM Con este registro podemos especificar que deseamos recibir una confirmacion de email recibido cuando el cliente de correo lea el email en su servidor de correos La confirmacion del correo recibido nos llegara a la cuenta de correo que usemos para enviar el email ya sea la de la configuracion global o bien la especificada en el registro EMAIL FROM Si el cliente de correo no soporta esta caracteristica de confirmar el email recibido nunca recibiremos nuestra confirmacion asi que estaremos sujetos a la configuracion del cliente Ejemplo WRITE R EMAIL FROM EMAIL CONF IRM Este registro ya tiene todo configurado para que al momento en que lo escribamos se configure la peticion de confirmacion asi que no es necesario especificar ningun parametro adicional La escritura de este registro puede ser encualquier parte del email www cobtools com P gina 16 Manual del usuario de COBEMAIL EMAIL TEMPLATE Sirve para especificar el archivo de Template HTML a utilizar Este archivo de Template va en formato HTML todas las im genes que se le incluyan en la p gina Web ser n incluidas en el email para enviarse de manera autom tica en el Email Las im genes que est n en la p gina Web ser n incluidas en los siguientes directorios y en el siguiente orden 1 En la ruta de la imagen tal y como viene incluida en el archivo HTML 2 En el directorio donde esta el Template 3 En el
8. TENT OTRA LINEA DE MENSAJE gt www cobtools com P gina 12 Manual del usuario de COBEMAIL EMAIL ATTACHMENT Este registro es uno de los beneficios mas importantes de COBEMALL con este registro podemos indicar un archivo adicional que deseamos adjuntar con nuestro Email Podemos especificar diferentes archivos en un mismo email realmente la limitante en cuanto a cantidad de archivos y tama o de estos depender de la capacidad de memoria del equipo que se encargara de enviar el email as como el ancho de banda de la conexi n de Internet Lo nico que hay que hacer es especificar el archivo a adjuntar a la variable FILE ATTACH Podemos especificar una ruta completa o una relativa siempre dependiendo de en que directorio se encuentra ubicado al momento de mandar a llamar el programa COBSENDM EXE Ejemplo MOVE C ATEMPADATOS ZIP TO FILE ATTACH WRITE R EMAIL FROM EMAIL ATTACHMENT MOVE F ADATOSAENVIO DAT TO FILE ATTACH WRITE R EMAIL FROM EMAIL ATTACHMENT Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt ATTACHMENT FILE C IATEMPADATOS ZIP gt lt ATTACHMENT FILE F IADATOSXMENVIO DAT gt www cobtools com P gina 13 Manual del usuario de COBEMAIL EMAIL TYPE
9. ail es un solo registro el que se env a y si env a varios de estos registros solo el ltimo ser el que se quede como Asunto Para usar este registro solo hay que mover el titulo del Asunto a la variable SUBJECT Ejemplo MOVE REPORTE DE VENTAS DE ENERO 2006 TO SUBJECT WRITE R EMAIL FROM EMAIL SUBJECT Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt SUBJECT CONTENT REPORTE DE VENTAS DE ENERO 2006 gt www cobtools com P gina 11 Manual del usuario de COBEMAIL EMAIL MESSAGE Este registro se utiliza para escribir el cuerpo del mensaje a enviar en el email Cada l nea que se agregue con un registro de estos ser una l nea nueva en el cuerpo del mensaje Este registro se utiliza solamente cuando el tipo de Email es Texto Para usar este registro solo mueva el dato con la l nea a insertar en la variable MESSAGE Ejemplo MOVE LINEA EN EL CUERPO DE MENSAJE TO MESSAGE WRITE R EMAIL FROM EMAIL MESSAGE MOVE OTRA LINEA DE MENSAJE TO MESSAGE WRITE R EMAIL FROM EMAIL MESSAGE Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt MESSAGE CONTENT LINEA EN EL CUERPO DE MENSAJE gt lt MESSAGE CON
10. email siga existiendo despu s de que sea enviado el email Por default el archivo de email es eliminado despu s de que el correo es enviado Si deseamos que este archivo siga existiendo solo incluimos el par metro NODEL en la lista de opciones nicamente el archivo del envi del email es eliminado en forma autom tica cualquier otro archivo que se adjunte NO ser eliminado tampoco se eliminan los templates usados ni tampoco las im genes que necesite un template de HTML Ejemplos de ejecuci n 1 COBSENDM ENVIO TXT 2 COBSENDM EXE EMAIL TXT NODEL 3 COBSENDM EXE CATEMPAEMAIL TXT En el ejemplo 1 el email es enviado con las instrucciones indicadas en el archivo ENVIO TXT este archive ser eliminado despu s de enviado el email En el ejemplo 2 el email se env a con las instrucciones en el archivo EMAIL TXT y este archivo no es eliminado despu s de enviar el correo Por ultimo el ejemplo 3 nos sirve para ejemplificar que tambi n podemos enviar un email con un archivo que este en alg n directorio en espec fico podemos colocar nuestro archivo de email en cualquier directorio de nuestro disco duro www cobtools com P gina 6 Manual del usuario de COBEMAIL Instrucciones para generar en el archivo de Email Nuestro archivo de email como se dijo anteriormente no es m s que un archivo texto generado desde nuestro programa COBOL Para generar un archivo de este tipo en COBOL 85 primero declarar amos una i
11. iguraci n del programa Para los ejemplos plasmados en este manual as como los ejemplos que descargue de Internet asumiremos que el directorio de Instalaci n es CACOBEMAIL gt Antes de utilizar COBEMAIL deberemos de configurarlo de lo contrario no podremos enviar correos de ninguna manera Deberemos de ejecutar primero el programa cfgCobEmail el cual nos sirve para realizar esta tarea Al ejecutarlo nos aparecer una ventana como la siguiente cobEmail Configuration Email Data SMTP Host consis com mkx SMTP Port smtp Default From Email alberto consis com mx Authentification smtp uthLogin v Auth Usemame alberto Auth Password pa www cobtools com P gina 4 Manual del usuario de COBEMAIL Los datos que necesitamos configurar son los siguientes SMTP Host Esta puede ser un nombre de dominio o la direcci n IP del servidor de SMTP que se utilizara para el env o de nuestro email Regularmente se registra el de nuestro proveedor de Internet a menos de que la empresa donde vayamos a instalar este software cuente con el suyo propio SMTP Port Es el puerto TCP donde se encuentra nuestro servidor SMTP escuchando las peticiones por default podemos usar el puerto smtp a menos de que nuestro servidor escuche en alguno diferente From Email Aqu podemos especificar la cuenta de email desde la cual ser n enviados los correos sirve adem s para que las respuestas a nuestros emails sean enviad
12. itamos enviar dos valores en las siguientes variables FROM NAME Nos sirve para especificar el nombre de la persona a quien pertenece la cuenta desde donde se env a el email FROM EMAIL es la cuenta de correo desde donde se env a el email Ejemplo MOVE ALBERTO ORTEGA TO FROM NAME MOVE aortegalcobtools com TO FROM EMATL WRITE R EMAIL FROM EMAITL FROM Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt FROM NAME ALBERTO ORTEGA EMAIL aortegaflcobtools com gt www cobtools com P gina 8 Manual del usuario de COBEMAIL EMAIL TO Con este registro podemos especificar a que persona deseamos enviar el correo electr nico Necesitamos especificar el nombre de la persona as como la cuenta de Email hacia donde debe llegar el correo Los datos que debemos de mandar as como las variables que debemos de utilizar son las siguientes TO NAME Aqu especificamos el nombre de la persona a quien va dirigido el email TO EMAIL Es la cuenta de correo electr nica a donde debe de llegar el correo Ejemplo MOVE JUAN PEREZ TO TO NAME MOVE 3jperezfdominio com TO TO EMAIL WRITE R EMAIL FROM EMAIL TO Con estas instrucciones en nuestro archive de email generar amos la siguiente marca lt TO NA
13. nstrucci n SELECT de la siguiente manera SELECT EMAILDATA ASSIGN TO PRINT EMATL TXT FILE STATUS IS STAT EMAIL Esta declaraci n es similar a declarar un archive de impresi n con la diferencia de que en lugar de enviarlo a una impresora lo enviamos a un archivo el cual es generado como texto Y para nuestro FD podr amos declarar algo como lo siguiente FD EMAILDATA LABEL RECORDS ARE OMITTED 01 R EMAIL PIC X 500 Ahora bien junto con COBEMATIL va una pieza importante de c digo este es un archivo llamado COBEMAIL WSS Este archivo contiene la declaraci n de todas las variables para generar las diferentes Marcas con las que podemos especificar todos los datos necesarios para enviar un email Este archivo tambi n lo podemos obtener junto con los ejemplos de COBEMATIL dichos ejemplos tambi n aplican todo lo que se explica en este manual www cobtools com P gina 7 Manual del usuario de COBEMAIL Registros de COBEMAIL WSS EMAIL FROM Este registro sirve para especificar el nombre de la persona y la cuenta desde donde se esta enviando el Email Este marca tambi n sustituye la cuenta FROM desde que se indica en la configuraci n global del programa Esta marca es opcional ya que si no se especifica nada en cada correo que quisi ramos mandar utilizar a la del programa Para utilizar esta marca neces
14. o por la marca FACT PASTE Ahora bien dentro del template HTML que estamos usando los bloques los definimos de la siguiente manera lt paste fact_paste gt lt block factura gt lt tr gt lt td gt lt fecha gt lt td gt lt td gt lt concepto gt lt td gt lt td gt lt importe gt lt td gt lt tr gt lt endblock factura gt Es importante definir los nombres que usaremos en el registro EMAIL BLOCK si usamos otros nombres nuestro template no funcionara como lo deseamos La unica manera de escribir estas marcas es dentro de los simbolos lt gt ya que estos son tomados como comentarios por el editor de HTML FrontPage o el que sea de nuestra preferencia Tambi n es muy importante que si dentro del block usamos variables indiquemos los valores para estas variables en nuestro programa antes de escribir el registro EMAIL BLOCK En el programa TEST4 CBL de los ejemplos de uso de COBEMAIL tenemos una muestra clara de c mo podemos utilizar este metodo www cobtools com P gina 21 Manual del usuario de COBEMAIL Registro de Licencia para COBEMAIL Una vez que adquiera la licencia para COBEMALL esta le ser entregada en forma de archivo Dicho archivo es necesario copiarlo al directorio donde se encuentra su instalaci n de COBEMAIL para que sea activada al instante Si desea adquirir su licencia para uso de COBEMALIL visite el sitio www cobtool
15. os hacia esta cuenta La cuenta FROM tambi n puede ser especificada desde el archivo de env o del email si esto sucede entonces no ser usada la cuenta FROM de la configuraci n del programa si no la especificada en el archivo de email Authentification Sirve para indicar si el servidor SMTP por el cual ser enviado el correo necesita Autenticaci n de ser as deberemos de escoger el tipo de autenticaci n que utiliza las opciones son e smtpAuthNone e smtpAuthPlain e smtpAuthLogin e smtpAuthCramMD5 La opci n que debemos de seleccionar depender de nuestro servidor SMTP al que nos conectaremos Auth Username Es el nombre de usuario que ser usado para hacer la autenticaci n Auth Password El password del usuario con el que ser autenticado en el servidor SMTP Save Log File Este parametro es nuevo incluido en desde la version1 10 si lo marcamos le indicamos que nos lleve un registro de los emails que se han enviado a travez de COBEMALIL con fines de llevar un monitoreo Para guardar nuestros cambios solo damos clic en el bot n OK y podremos empezar a usar nuestro programa para enviar correos www cobtools com P gina 5 Manual del usuario de COBEMAIL Par metros que acepta El programa que se encarga del env o de EMAILS es COBSENDM EXE El formato para ejecutarlo es el siguiente COBSENDM archivo de email opciones NODEL Este par metro sirve para indicar que el archivo de
16. rve para indicar el inicio del contenido MEMO El registro EMAIL END MEMO se utiliza al finalizar el MEMO La variable EMAIL DAT MEMO es donde iremos colocando el contenido a imprimir en varias lineas En algunos compiladores puede tener contenido con los caracteres de Enter incluidos y podemos moverlo tal cual La variable EMAIL DATA tiene un tama o de 1024 caracteres Si quisieramos manejar manualmente caracteres de Enter en compiladores donde no se guarda este codigo podemos utilizar la secuencia inn para insertar saltos de linea www cobtools com P gina 19 Manual del usuario de COBEMAIL MEMOS EN VARIABLES Estos registros son para manejar informacion en multiples lineas Y almacenar el contenido en una Variable Estos MEMOS los podemos utilizar en Templates HTML y se manejan iguales que las variables de una sola linea Son varios registros que se deben de utilizar para este fin Ejemplo MOVE NOM VAR TO EMAITL VAR MEMO WRITE LINEA FROM EMAIL START VAR MEMO MOVE LINE 1 TO EMAIL DAT MEMO WRITE R EMAIL FROMEMAIL MEMO MOVE LINE 2 TO EMAIL DAT MEMO WRITE R EMAIL FROMEMAIL MEMO WRITE LINEA FROM EMAIL END VAR MEMO El registro EMAIL START VAR MEMO sirve para indicar el inicio del contenido MEMO Antes de imprimirlo debemos de pasar el nombre de la
17. s com donde podr encontrar m s informaci n www cobtools com P gina 22
18. variable en el Template en este ejemplo fue NOM VAR El registro EMAIL END VAR MEMO se utiliza al finalizar el MEMO La variable EMAIL DAT MEMO es donde iremos colocando el contenido a imprimir en varias lineas En algunos compiladores puede tener contenido con los caracteres de Enter incluidos y podemos moverlo tal cual La variable EMAIL DATA tiene un tama o de 1024 caracteres Si quisieramos manejar manualmente caracteres de Enter en compiladores donde no se guarda este codigo podemos utilizar la secuencia nn para insertar saltos de linea En HTML un salto de linea se debe indicar como la marca lt BR gt www cobtools com P gina 20 Manual del usuario de COBEMAIL EMAIL BLOCK Este registro sirve para crear bloques repetidos de codigo HTML en nuestro template Por ejemplo para cuando deseamos enviar un estado de cuenta de un cliente con una lista de todas las facturas pendientes de pago La lista de facturas es una lista de renglones en donde vamos a repetir N veces los datos de las facturas En algun cliente tendra X numero de facturas y otro cliente tendra un n mero de facturas diferentes Ejemplo MOVE FACTURA TO EMAIL BLOCK NAME MOVE FACT_PASTE TO EMAIL BLOCK PASTE WRITE R EMAIL FROM EMAIL BLOCK Con esto indicamos que deseamos escribir un BLOCK llamado FACTURA que se encuentra definido en el template y que lo deseamos pegar en el lugar indicad
Download Pdf Manuals
Related Search