cpimail.ini para Envios por Email

Importante: La ubicacion de ficheros ini depende del modo/fecha de Setup Install Programas CPI.

El módulo de correo (e-mail, smtp/mapi) de CoPrint, cpiMail, cuenta con un ini especial, cpimail.ini, que generalmente reside en la carpeta %appdata%
Este fichero ini se puede ver o editar MEJOR con cpiInfo.exe (el programa amarillo).
Tambien accesible directamente desde as400 con paso 99 o INI en los menus de APIEXCEL o COPRINT.

IMPORTANTE
Hay que configurar un servidor de correo smtp, y tener claros al menos los siguientes datos:

  1. direccion IP o nombre DNS, tal como 192.168.2.123 o mail.midominio.com
  2. para login usuario/cuenta y password
  3. puerto (los normales son 25 o 26)
  4. nombre o texto con el que se envian los correos, tal como “Empresa Perez, Contabilidad” o algo así
  5. cuenta de correo con el que se envian los correos, tal como contabilidad@perezsa.es
  6. cuenta de correo a la que responderia un receptor, tal como la misma anterior o info@etc.etc

Veamos un ejemplo del formato de cpimail.ini:

  • Los datos mas importantes son mailMode, smtpServer, smtpUser, smtpPassword, smtpPort.
  • y para control de envios: smtpFromEmail, smtpFromName, smtpReplyTo
[Mail]
MailMode=SMTP
SmtpServer=nombre o IP del servidor de correo
SmtpPort=26 (o 25, son los usuales) o el puerto tcp/ip a usar, p.e. 587 para conexion segura (tal como smtp.office365.com).
SmtpUser=direcc email o usuario/cuenta para hacer login en el mail server

;....password del smtp server (ofuscar/cifrar con cpiconvert.exe) o bien usar la otra en claro
SmtpPassword2=091131313391456149507541365154714690793084508190806081908060793088408710117
;....password de la cuenta visible (usar una u otra, esta o la ofuscada)
SmtpPassword=EstaEsMiClave

SmtpFromName=texto/nombre de quien envia
SmtpFromEmail=direcc email que envia
SmtpReplyTo=direcc email que recibe las posibles respuestas, opcional


;....para autenticacion en servidor seguro (en este caso ver que puerto usar, tal como 587)
smtpType=SSL 

;....guarda una linea por cada envio en el file que se quiera (fichero con nombre variable)
Log=Y ... aunque el nombre lo crea fijo en carpeta TEMP

;....control (aprox) de la ventanita splash naranja mientras se envia el mail, 0=NoVisible 1=Si N=Minimizada 
Splash=N

;............para evitar algunos mensajes de error, mejor no usar al principio (deja log en la carpeta %temp%)
ErrorMail=IGNORE

En el cuerpo y asunto de cada email enviado se soportan algunas variables.

  • &vL se cambia por un salto de linea
  • &vd1 por la fecha real, formato dd-mmm-yyyy
  • &vdt por la fecha y la hora, formato dd-mmm-yyyy hh:mm
  • &vInfo por alguna info de ayuda debug
  • se soportan variables definidas en el ini
    • &vini1, &vini2, &vini3 se cambian por los valores definidos en el ini 1= 2= 3= dentro del grupo [Variables]
  • al final del cuerpo del email se puede adjuntar otro texto de “firma

cpimail ini particular

También puede usar un cpimail particular para que los envíos se hagan usando una cuenta de correo concreta de la persona o departamento que envía el email (firmante/SGN, ver firma).

Para esto tiene que crear un fichero .ini (mismo formato que cpimail.ini y en la misma carpeta) con el nombre del firmante, como

  • cpimail-firmante.ini
  • y admite valores clave como el generico cpimail.ini, tal como
    • smtpServer y smtpPort
    • smtpUser
    • smtpPassword
    • smtpFromEmail y smtpFromName

Otra version anterior permitia (firma.ini) y guardarlo en c:\cpi\user\ (ver firma).
⇒ pero se desaconseja usar la carpeta obsoleta c:\cpi.

IMPORTANTE:

LOG de cpiMail

En la carpeta TEMP (%TEMP%) se crea un fichero “LOG” con nombre tal como cpiMail_cpiMapi1_YYYY_MM_log.txt, que puede dejar pistas cuando existan problemas con el servidor de correo smtp, etc. Basicamente es un historico de procesos.
(siendo yyyy_nn el año y el mes, tal como 2018_11).

Se puede definir un LOG BASE ampliado (ocupa mucho por cada envio) en el cpimail.ini
Logbase=Y
(se crea en carpeta %TEMP% con nombre tal como cpiMail_cpimapi1_yyyymmdd_BLog.txt)

  • no dejar este log adicional como permanente, sólo para averiguar temas concretos :!:

La carpeta TEMP se puede abrir en el Explorador de Archivos haciendo

  • TeclaWin + R + teclear %temp% y pulsar intro
  • ordenar por fecha para ver primero los mas recientes

Evitar paradas en errores cpiMail

En el cpimail.ini se pueden evitar algunas paradas con
errorMail=IGNORE
dentro del grupo/seccion [Mail]

Si se usa el control de errores en ini, cada error interceptado genera tambien entradas al log especiales de errores, con nombre tal como cpiMail_cpiMapi1_AÑO_log_ERROR.txt, así que este fichero debe ser revisado periodicamente.

Algunos errores interceptados:

  • ERROR SMTP sendMail (aeSmtp)
    • generico, por ejemplo direcciones de correo malformados, errores de login de mailServer, etc

Un error común suele ser intentar un envío a una direccion incorrecta. Se recomienda antes de enviar un correo validar mínimamente el dato para que al menos tenga una arroba y un punto detrás de la arroba o cosas similares. Usuarios de RpgForWeb pueden usar el programa de validación básica @CHKMAIL.

PRUEBA, Probar cpiMail

Se puede hacer una prueba sencilla de envio de correo para ver si el cpimail.ini está correcto:

  • directamente con el pc: Pulsar Tecla Windows + R y teclear: cpiMapi1.exe *AUT *SMTP
  • o bien en el as400 con el comando COPMAIL y F4
  • si se tiene el modulo de pdf, SPOOLPDF y F4

Alias para destino email

Soporte de Alias para direcciones de email.

IMPORTANTE:

  • es una funciona especial de uso interno CPI
  • ninguna garantia se ofrece, sólo se soportan “unos cuantos alias”, no es para uso masivo.

Se soporta ALIAS para permitir direcciones de correo mas grandes de lo que pueden soportar los ficheros/programas, tal como el tope de 40x.

Por ejemplo, tenemos un campo de e-mail del cliente con 40 posiciones pero tenemos un cliente que tiene una direccion de correo mas larga.

  • el pobre hombre tiene un correo tal como francisco.fernandez.gonzalez@bancodelnoroestedemurcia.es

En lugar de cambiar ficheros y programas del host, se puede hacer simplemente con Coprint.

El caso es que si hay una direccion de correo mas larga se le asigna una direccion tal como FW-loquesea@algo.es

  • lo que hay a la derecha de FW- es el “id” asignado a ese usuario
  • la FW- inicial es obligatoria, es para que Coprint procese el alias

Añadir los alias en el cpimail.ini en el pc servidor de coprint:

  • editar el fichero CPIMAIL.INI usando cpiInfo.exe (el programa amarillo)
  • al final del fichero tener en una lista los usuarios con alias, tal como
  • la señal FW- solo debe ir en el email destino, no en el ini, ver bien el ejemplo
[ALIAS]
loquesea@algo.es=francisco.fernandez.gonzalez@bancodelnoroestedemurcia.es
otro...
otro...
 
/kunden/homepages/8/d674751560/htdocs/cpies/doc/data/pages/coprint/cpimail.txt · Última modificación: 23/04/2019 13:56 por admin
[unknown button type]
 
Excepto donde se indique lo contrario, el contenido de este wiki esta bajo la siguiente licencia: CC Attribution-Noncommercial-Share Alike 4.0 International
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki