

Documentación del módulo de PowerEmail

Este módulo no está integrado en el código del ERP, pero está disponible en GitHub/gisce/PowerEmail.

Instalación

Este módulo no está integrado en el código de GISCE-ERP, por lo que hace falta descargarlo como un repositorio aparte. Desde GISCE-TI tenemos un FORK en GitHub dónde mantenemos la rama v5_backport, ya que este módulo está pensado para Odoo y nosotros utilizamos la versión 5 de OpenERP.

Como todos los módulos externos, hace falta realizar los vínculos en la carpeta de OpenERP server/bin/addons.

Como se ha cambiado el código, hará falta reiniciar el servidor (o iniciarlo en otro puerto) y proceder con la instalación como cualquier módulo de OpenERP.

Una vez instalado el módulo, ya dispondremos de distintas vistas nuevas en un nuevo menú:

Configuración de Cuentas PowerEmail

Creación de una cuenta PowerEmail

PowerEmail funciona con cuentas smtp. Tanto si queremos enviar como si queremos recibir correos, se necesita añadir una cuenta PowerEmail.

En una misma cuenta se puede configurar la entrada o salida de correo.

Para añadir una cuenta, hace falta acceder al menú "Menú OpenERP → PowerEmail → Configuración → Todas las cuentas" y hacer click al botón NEW.

Independientemente del tipo de cuenta a crear, siempre hace falta inicializar el nombre de la cuenta. Este debe ser único entre las cuentas de PowerEmail.

Cuenta para el envío de correo electrónico

Cuando creamos (o editamos) una nueva cuenta de PowerEmail, nos mostrará un formulario con los campos necesarios para la conexión con un servidor smtp.

Se dispone de los campos:

Nombre del Campo	Descripción
Servidor	Nombre del servidor de correo
Puerto SMTP	Puerto SMTP utilizado por el servidor de correo
Utilizar TLS	Si se desea utilizar transmisión segura mediante claves
ID correo electrónico	Nombre del correo electrónico a utilizar en el servidor
Nombre de usuario	Nombre de usuario a utilizar en el servidor (Por defecto el correo electrónico)
Contraseña	Contraseña a utilizar en el servidor
Usuario Relacionado	Usuario del OpenERP relacionado con esta cuenta de PowerEmail
Cuenta de correo de la compañía	Si se desea configurar como cuenta de la compañía
Formato del correo electrónico	Formato a utilizar para construir el "body" del correo

Una vez entrados los valores, se puede comprobar la conexión con el servidor smtp con el botón comprobar conexión de salida.

Cuenta para el envío de correo de la compañía

Creando una cuenta normal para el envío de correo electrónico, hará falta seleccionar el campo Cuenta de correo de la compañía con el valor Si.

Esto hará que nos aparezca una pestaña seguridad en la vista de la cuenta.

Para poder utilizar una cuenta de compañía se necesita asignar un grupo de usuarios a la cuenta. En la pestaña seguridad se puede seleccionar que grupos pueden utilizar esta cuenta que estamos creando.

Ejemplo

Podemos hacer una cuenta genérica añadiedo el grupo Employee.

Cuenta para la recepción de correo electrónico

Este tipo de cuentas extienden las cuentas de envío de correo electrónico. Por este motivo hace falta realizar previamente las configuraciones para cuentas de envío.

Accediendo a la pestaña entrada podemos configurar la recepción de correo mediante PowerEmail. En esta pestaña se muestran los campos necesarios para la conexión y obtención de correos para una cuenta.

Nota

Si el campo servidor de entrada está vacío, no se configura como cuenta de recepción y por tanto la resta de campos no son obligatorios.

Nota

Para la recepción de correos para la compañía, hace falta inicializar la cuenta como una cuenta para el envío de la compañía.

De la misma forma que con la configuración de cuentas de salida. Una vez introducidos los datos necesarios, se puede comprobar la conexión mediante el botón comprobar la conexión de entrada.

Aprobar una cuenta PowerEmail

Después de la creación de una cuenta PowerEmail o de la reactivación de una cuenta PowerEmail, se puede aprobar una cuenta PowerEmail.

Si todos los campos están llenos, se puede aprobar la cuenta utilizando el botón Aprobar la cuenta.

Cuando la cuenta está aprobada se puede utilizar la funcionalidad enviar/recibir para enviar y recibir todos los correos pendientes en la cuenta

Alternativamente se puede utilizar la funcionalidad enviar este correo desde un poweremail_mailbox.

Suspensión de una cuenta de PowerEmail

Si se desea dejar de enviar o de recibir correos por una cuenta PowerEmail aprobada, podemos suspenderla para que quede en el estado suspendida.

Reactivación de una cuenta PowerEmail

Cuando una cuenta está suspendida, se puede reactivar mediante el botón solicitar reactivación haciendo que pase al estado borrador volviendo a habilitar el botón Aprobar la cuenta

Gestión de Buzones de correo

Según la configuración utilizada en la creación de una cuenta PowerEmail, los correos enviados o recibidos se encontrarán en el menú de buzones "Personal", cuando la cuenta está asignada a nuestro usuario, o "Compañía", cuando nuestro usuario está asignado a la misma compañía que la cuenta de correo (por el usuario que tiene asignado) y la cuenta es una "Cuenta de la compañía".

Los buzones funcionan de forma intuitiva:

Tipo de Buzón	Descripción
Conversaciones	(Solo personal) Contiene los correos relacionados por el asunto
Entrada	Correos recibidos
Borrador	Correos que escribe un usuario, pero aún no se quieren enviar
Enviados	Correos ya enviados
Seguimento	Correos donde estamos como observadores
Salida	Correos pendientes de enviar
Papelera	Correos borrados

Nota

Los buzones no distinguen entre las distintas cuentas configuradas por el usuario y compañía del usuario.

Correos PowerEmail

En abrir un correo de un buzón o creando un nuevo correo dentro de un buzón, nos encontraremos distintos campos.

Como podemos ver, el ERP nos desglosa todos los campos típicos del correo electrónico.

En esta página únicamente hace falta destacar los siguientes campos:

Campo	Descripción
Fecha de recepción/Envio	Fecha en que se ha recibido o enviado el correo en el servidor de correo
Recibido el	Fecha en que el ERP importó el correo electrónico
Prioridad	Parámetro utilizado en el ERP para filtros en los buzones

También hace falta destacar el botón Enviar Correo que permite el reenvío del correo.

En la pestaña Adjuntos se pueden encontrar los distintos ficheros adjuntos que se han enviado o recibido en el correo electrónico.

En la pestaña Raw Content se encuentra todo el correo electrónico en formato de texto simple.

En la pestaña Avanzado podemos encontrar las configuraciones relacionadas con la cuenta de PowerEmail y con las tareas realizadas con este correo en el historial (veces enviadas, recibido o movido de buzón).

Nota

Esta pestaña contiene los datos relacionados con el tipo de mensaje a enviar, la cuenta a utilizar y las referencias del servidor de correo. Por este motivo, aunque se puedan editar los campos, no es aconsejable cambiarlos.

Conversaciones PowerEmail

El módulo poweremail permite mantener conversaciones de correo electrónico, es decir, detecta cuando un correo es una respuesta a uno de los correos enviados o si un correo enviado es la respuesta de uno recibido.

Estos correos se encuentran en un buzón especial en la carpeta "Personal".

Simplemente se muestra una lista de las conversaciones que se han tenido, con que usuario y cuantos correos hay en la conversacion

Si entramos en una conversación únicamente se muestra una lista de correos que son los que están relacionados con la conversación.

Gestión de Plantillas PowerEmail

Podemos encontrar todas las plantillas en el menú "Menú OpenERP → PowerEmail → Plantillas de PowerEmail".

Todas las plantillas tienen las mismas configuraciones esenciales, excluyendo las típicas configuraciones de un correo:

Nombre del Campo	Descripción
Nombre de la plantilla	Referencia a utilizar para esta plantilla.
Modelo	Modelo relacionado con esta plantilla. Permite el uso de campos de este modelo.
Idioma de la plantilla	Lenguaje utilizado en la generación del correo desde los datos de la plantilla

Hace falta rellenar estos campos para utilizarlos en las plantillas, juntamente con los campos referentes al correo a enviar, como para quien sería el correo, el asunto o el cuerpo del mensaje.

Consejo

Se puede utilizar el asistente de expresiones para generar el código para obtener el valor de un campo del modelo de la plantilla.

Todos los campos referentes a la generación del correo (direcciones y cuerpo del mensaje) son analizados por si son del lenguaje de la plantilla, es decir, se pueden utilizar las expresiones generadas en el asistente.

La pestaña de seguridad, permite definir qué usuarios pueden utilizar esta plantilla para enviar correos.

Por otro lado, en la pestaña Avanzado, podemos encontrar diversas funciones útiles.

En la primera sección, podemos configurar automatismos para el envío de correo:

Nombre del Campo	Descripción
Forzar desde la cuenta	Utilizas siempre una cuenta de PowerEmail cuando se genere un correo electrónico desde la plantilla actual.
Correo electrónico automático.	Cada vez que se actualiza un registro del modelo mediante un Flujo de trabajo, generará un correo electrónico utilizando esta plantilla (requiere Forzar desde la cuenta, Flujo de trabajo y Actividad)
Flujo de trabajo	Cuando el Correo automático está activado, hace falta asignarle un flujo
Actividad	Estado del Flujo de Trabajo donde se activará el correo automático
Enviar al crear	Permite el envío automático de los correos generados para la plantilla
Guardar en borradores	Guarda los correos generados en la carpeta borradores en lugar de la carpeta salida
Enviar al actualizar	Cada vez que se modifica un registro del modelo se genera un nuevo correo mediante esta plantilla
Filtro activo	Permite utilizar un filtro con python para evitar la creación de correos mediante la plantilla

En la segunda sección, podemos configurar la creación de acciones o asistentes para el envío de correos electrónicos utilizando esta plantilla.

Como se puede observar, los campos de referencia en esta sección son únicamente de lectura. Esto es para generar una acción o asistente únicamente mediante los botones que se proporcionan:

• Create action and value: Añade un asistente mediante acción en el modelo asignado.
• Crear acceso directo: Añade un acceso directo a los correos/plantillas que utilizan el modelo seleccionado.

Finalmente existe una sección para añadir informes generados por una acción del ERP. En esta sección se puede forzar estos informes como ficheros adjuntos.

Por un lado se puede añadir un único informe relacionado con el modelo de la plantilla y cambiarle o asignarle un nombre por defecto. Por otro lado se puede utilizar la tabla inferior para añadir todos los informes deseados con el nombre por defecto que se quiera y añadirle parámetros de búsqueda.