====== Plantillas de email ====== **Tecla rápida: -\\ Menú: Herramientas/Documentos/Plantillas de email** Cualquier informe en SmartOffice se puede enviar por email a través del botón //Mail PDF// desde la vista previa: {{ :usu:guia_de_usuario:vistapreviaiconos.png?300 |Íconos vista previa}} No obstante, al redactar el email siempre hay que empezar con un email vacío, obligando al usuario de confeccionar su envío cada vez desde cero. Para facilitar al usuario este trabajo repetitivo, existe en Smart el concepto de las //plantillas de email//. {{ :usu:guia_de_usuario:emailplantillageneral.png?500 |Plantilla de email}} {{ :usu:guia_de_usuario:emailplantillaprefijo.png?500 |Plantilla prefijo}} {{ :usu:guia_de_usuario:emailplantillacuerpo.png?500 |Plantilla cuerpo}} {{ :usu:guia_de_usuario:emailplantillafirma.png?500 |Plantilla firma}} Se puede definir una plantilla y asignarla a cualquier informe de Smart. Entonces, en el momento de enviar este informe por email, se preparará el email según la plantilla, con la opción de realizar cambios antes del envío. Una plantilla constiste de los siguientes campos. ^Pestaña/Detalle ^Campo ^Descripción ^Ejemplo ^ |Pestaña //General// |Código |El código de la plantilla, a libre elección. Máx. 10 carácteres. |OFERTAVTA | |Pestaña //General// |Descripción |La descripción de la plantilla. | | |Pestaña //General// |Asunto |El asunto que debe de tener el email. El texto introducido en este campo puede incluir referencias a cualquier columna de la rejilla de impresión. Estas //variables// las tenemos que incluir en llaves (''{...}''). Se explica el concepto de las //variables// en un párrafo más abajo. |Oferta de venta {Nro. oferta} | |Pestaña //General// |Guardar el envío |Si se pone ''S'' en este campo, cualquier envío se guarda en la base de datos, y se puede comprobar el envío en //Herramientas/Documentos/Documentos enviados//. | | |Pestaña //General// |Cód. informe |El código del informe al que se tiene que aplicar la plantilla. Ya existen dos códigos predefinidos en Smart, ''QRIMPRESOFERTAVENTA'' (Impresión ofertas de venta) y ''QRIMPRESPEDVTA'' (Impresión de pedidos de venta). Si se quiere definir una plantilla para otro informe, hay que ponerse en contacto con Smart para que se añade el código oportuno. | | |Pestaña //Prefijo// |Prefijo |En este campo se puede meter un texto en formato //html//, que va a aparecer al principio de cada email. No es obligatorio, pero si se mete algún text, en el envío del email no se puede modificar esta parte. Se permite el uso de //variables//. Se explica la creación de texto //html// más abajo. | | |Pestaña //Cuerpo// |Cuerpo |El //cuerpo// del mensaje, en texto //simple// (sin //html//), que luego puede ser modificado por el usuario en el momento de enviar el email. Se permite el uso de //variables//. | | |Pestaña //Firma// |Firma |Un campo para meter una firma en formato //html//, que va a aparecer al final de cada email. Tiene las mismas propiedades como el //Prefijo//. | | |Detalle //Destinatarios// |Destinatarios |Aquí se pueden añadir destinatarios, que siempre van a recibir una copia de cualquier email enviado según esta plantilla (hasta que el usuario los borra manualmente). Aquí también se permite el uso de //variables//. En la columna //Tipo dest.// se tiene que meter uno de los tipos ''TO'', ''CC'' o ''BCC''. |{S_CORREOE_TERCERO} | |Detalle //Adjuntos// |Adjuntos |Con ''F10'' se puede añadir un adjunto nuevo, o sustituir el adjunto actualmente seleccionado. Para añadir un nuevo adjunto se debería insertar una línea nueva con ''F3'' y luego dar en ''F10''.\\ En esta rejilla también aparecen automáticamente las imagenes que puede haber en los textos //html// de los campos //Prefijo// y //Firma//. | | ===== Nombre de los ficheros adjuntos ===== Por defecto, los adjuntos reciben como nombre el título del informe al que pertenecen, o sea, si enviamos una factura de venta el nombre del adjunto podría ser "Impresión de facturas.pdf". Si queremos darle al adjunto un nombre más apropiado, podemos abrir con ''F6'' desde el campo //Cód. informe// de la pestaña //General// la definición del informe. En esta tabla, al final de todo, encontramos el campo //Patrón fichero email//. Aquí podemos utilizar //variables//, como se explica más abajo. Si ponemos por ejemplo ''{NRO_FACTURA}'', el fichero va a llamarse igual que el número de factura, la extensión ''.pdf'' se añade automáticamente. ===== Requisitos ===== El envío de emails usando las plantillas solo funciona si se ha definido un servidor //smtp// en los datos de empresa. No funciona con la interfaz //mapi//, que utiliza el programa de email (Outlook etc.) instalado en el ordenador del usuario. El remitente de cada email va a ser la primera dirección de correo electrónico que se encuentra de los siguientes sitios: - La dirección de email del usuario actual, como está puesto en la tabla de los usuarios, menú //Configuración/General/Usuarios//, campo //Dirección electrónica//. - La dirección de email del empleado (//Configuración/General/Empleados//), que está enlazado con el usuario actual a través de los campos ''Usuario/Tipo tercero'' y ''Usuario/Cód. tercero''. - La dirección usada como //Usuario// en la definición del servidor smtp (ver abajo). **Si existe una dirección electrónica para el usuario actual (casos 1 y 2 del listado anterior), esta dirección va a recibir una copia del email enviado.** Para definir un servidor //smtp// abrimos los datos de empresa con //Configuración/Datos empresa//. En la pestaña //Comunicación// buscamos el campo //Serv. correo saliente// y seleccionamos o creamos el código ''SMTP''. Hay que rellenar por lo menos los siguientes campos: ^Campo ^Descripción ^Ejemplo ^ |Nombre host |El nombre del servidor smtp. |smtp.googlemail.com | |Cód. servicio |El puerto a usar en la conexión, SMTP (25) o SMTPS (465). |SMTPS | |Usuario |La cuenta de usuario. |nombre@gmail.com | |Clave |La contraseña de acceso. |xyz | **Todo el tráfico de salida desde Smart va a usar la misma cuenta, por lo cual, si sabemos que va a haber muchos emails a enviar, hay que asegurarse de que la cuenta //smtp// utilizada no tenga un límite de volumen de envío.** ===== Variables ===== En los campos //Asunto//, //Prefijo//, //Cuerpo//, //Firma// y //Destinatario// se pueden usar variables, que en el momento de crear el email a base de la plantilla se sustituyerán por el campo correspondiente del informe. {{ :usu:guia_de_usuario:emailplantillaimpresionoferta.png?600 |Impresión oferta}} En la imagen anterior vemos las tres columnas, que se han utilizado en la plantilla arriba. Se puede usar tanto el título de la columna (''{Cód. oferta}'') como el nombre interno de la columna (''{S_COD_OFERTA}''), que se puede ver con ''Ctrl+F8''. Una variable se marca con llaves (''{...}''). **Si se quiere usar una llave fuera del nombre de una variable, hay que poner delante una barra invertida: ''\{Este texto aparece con las llaves}''.** ===== HTML ===== Los campos //Prefijo// y //Firma// tienen que contener texto en formato //html//. Una forma fácil de crear este formato es el editor del programa de email //Thunderbird//. {{ :usu:guia_de_usuario:emailplantillaredactarhtml.png?600 |Thunderbird}} Redactamos en Thunderbird un mensaje nuevo, utilizando los botones para formatear el mensaje (//Negrita, Cursiva, Insertar imagen//, etc.). Si no vemos estos botones, hay que activar la edición html desde el menú //Opciones/Formato de entraga/Autodetectar//. Ponemos el prefijo (si lo necesitamos), el cuerpo de mensaje que va a ser editable, y por último la firma que queremos que tenga el email. Para copiar por ejemplo la firma en formato html a nuestra plantilla, marcamos la parte correspondiente en el mensaje que estamos editando (como se puede ver en la imagen de arriba), y entonces escogemos el menú //Insertar/Html//. Esto nos va a abrir otra ventana que contiene el código html de la parte seleccionada. Podemos seleccionar este código y copiar y pegarlo en la pestaña //Firma// de la plantilla en Smart. En el caso de que la firma contenga imágenes, es posible que éstas se representen en codificación BASE64, lo que impide que la selección realizada pueda pegarse directamente en la pestaña //Firma//. Para hacerlo correctamente, se puede seguir este procedimiento: - Guardar las imágenes en archivos en el disco duro. - Seleccionar el código HTML como se indica en párrafos anteriores. - Copiar este código a un editor de texto. - En los lugares en los que se hacer referencia a la imagen en formato BASE64, poner la referencia a la imagen dentro del disco duro en la forma src="file:///c:/Programas Delphi5/image001.jpg" - Por último, seleccionamos todo el texto, lo copiamos y lo pegamos en la pestaña //Firma//. De la misma forma copiamos la parte del prefijo, si lo necesitamos. La parte del cuerpo, como es texto normal, la podemos copiar y pegar directamente desde el mensaje que estamos editando (sin usar el menú //Insertar/Html//), o bien la metemos sin más en el campo correspondiente de la plantilla en Smart. Una vez que hayamos confeccionado la plantilla, la podemos probar con el menú //Plantilla email/Envío de prueba (F11)//. {{ :usu:guia_de_usuario:emailplantillaenvioprueba.png?600 |Envío de prueba}} ===== Plantillas por usuario ===== En el campo //Cód. informe// de la plantilla definimos el informe en el que se usa la plantilla por defecto. Si queremos usar otra plantilla para un usuario en concreto, podemos hacerlo desde la rejilla de los usuarios, menú //Configuración/General/Usuarios//. Allí escogemos el menú //Usuarios/Plantillas/Email// y metemos los usuarios, el código del informe y la plantilla a usar. ===== Plantillas por defecto ===== Es posible definir una plantilla por defecto para cada usuario. En primer lugar hay que definir un //Cód. informe// con código ''*'', y luego se asigna al usuario y al código de informe ''*'' la plantilla general para el usuario, que por ejemplo puede tener el mismo código como el usuario. Esta plantilla se usa entonces para todos los informes sin plantilla específica para el usuario. ===== Comprobación del envío ===== Para las plantillas, donde hemos puesto ''S'' en el campo //Guardar el envío//, podemos comprobar los emails desde el menú //Herramientas/Documentos/Documentos enviados//. Si filtramos en la descripción por el código de la plantilla, vemos todos los envíos de esta plantilla. Si filtramos por el código de una oferta, vemos los envíos de esta oferta. Con ''F11'' podemos abrir el documento enviado.