usu:smartpdf:smartpdf_guia_de_iniciacion
Diferencias
Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anteriorRevisión previaPróxima revisión | Revisión previa | ||
usu:smartpdf:smartpdf_guia_de_iniciacion [2018/09/03 09:22] – stefan | usu:smartpdf:smartpdf_guia_de_iniciacion [2022/08/03 18:49] (actual) – stefan | ||
---|---|---|---|
Línea 5: | Línea 5: | ||
===== Instalación ===== | ===== Instalación ===== | ||
- | La instalación se hace con el programa | + | La instalación se realiza |
- | Los pasos de instalación | + | La clave de instalación |
- | {{ : | + | |
- | Luego, en el paso de las tareas adicionales, | + | Salvo casos especiales, solo tenemos |
- | {{ :usu:smartpdf: | + | |
+ | Los pasos del instalador | ||
===== Primeros pasos ===== | ===== Primeros pasos ===== | ||
Línea 21: | Línea 21: | ||
===== Conceptos ===== | ===== Conceptos ===== | ||
+ | El sistema de envío de emails automatizados se compone de dos programas principales: | ||
+ | - SmartPdf: Es el programa para definir los envíos, o sea, la interfaz al usuario. | ||
+ | - SmartServices: | ||
+ | |||
+ | El concepto principal del envío automatizado de documentos son las **listas de destinatarios**. Por ejemplo así: | ||
+ | ^Razón social ^Correo el. ^Nº factura ^ | ||
+ | |Pepe |pepe@gmail.com |P0001 | | ||
+ | |Goyo |goyo@gmail.com |G0001 | | ||
+ | |... | | | | ||
+ | |||
+ | Una lista de esta forma puede servir para enviar una factura a cada uno de los destinatarios en un email personalizado (//Estimado Pepe...//). | ||
+ | |||
+ | También es posible enviar varios documentos (facturas) al mismo destinatario, | ||
+ | ^Razón social ^Correo el. ^Nº factura ^ | ||
+ | |Pepe |pepe@gmail.com |P0001 | | ||
+ | |Pepe |pepe@gmail.com |P0002 | | ||
+ | |Goyo |goyo@gmail.com |G0001 | | ||
+ | |Goyo |goyo@gmail.com |G0002 | | ||
+ | |Goyo |goyo@gmail.com |G0003 | | ||
+ | |... | | | | ||
+ | |||
+ | En este caso Pepe recibiría dos facturas en un solo email, y Goyo 3. | ||
+ | |||
+ | El formato del email a enviar se define en las **tareas**, donde también se anota en que **lista de destinatarios** se basa el envío. | ||
+ | |||
+ | Los adjuntos del envío de una **tarea** se definen en los **documentos**. Normalmente es lo que en SmartOffice son los informes, que se envían en formato //PDF// a base de un diseño de informe. También pueden ser consultas de cualquier tipo, que se ejecutan y el resultado se adjunta al email en formato de hoja de cálculo o de texto. | ||
+ | |||
+ | Los **lotes** agrupan una o varias **tareas** y las ejecutan en un órden definido por el usuario. | ||
===== Lista de destinatarios ===== | ===== Lista de destinatarios ===== | ||
Línea 46: | Línea 74: | ||
Aquí unos ejemplos para una fecha de ejecución 31/07/2009: | Aquí unos ejemplos para una fecha de ejecución 31/07/2009: | ||
^Parámetro ^fecha resultante ^ | ^Parámetro ^fecha resultante ^ | ||
- | |FE(1) |' | + | |_FE(1) |' |
- | |FE(1/1) |' | + | |_FE(1/1) |' |
- | |FE(1/-1) |' | + | |_FE(1/-1) |' |
- | |FE(/-1) |' | + | |_FE(/-1) |' |
- | |FE(-40) |' | + | |_FE(-40) |' |
- | |FE(/ /-1) |' | + | |_FE(/ /-1) |' |
- | |FE(+10) |' | + | |_FE(+10) |' |
Una vez que salimos del campo // | Una vez que salimos del campo // | ||
Línea 68: | Línea 96: | ||
En cuanto confirmemos una lista de destinatarios con '' | En cuanto confirmemos una lista de destinatarios con '' | ||
{{ : | {{ : | ||
- | En la columna //Nombre campo dataset// vemos los nombres de las variables que podemos utilizar en el diseño de los emails, | + | En la columna //Nombre campo dataset// vemos los nombres de las variables que podemos utilizar en el diseño de los emails, |
+ | |||
+ | **Si desconfirmamos una lista de destinatarios, | ||
===== Lotes de tareas ===== | ===== Lotes de tareas ===== | ||
Línea 75: | Línea 105: | ||
Los lotes sirven para agrupar una serie de tareas y ejecutarlas en un orden específico. Además son los lotes que definen el momento (horario) de ejecutar las tareas. Añadimos un nuevo lote con código predefinido con F3 e '' | Los lotes sirven para agrupar una serie de tareas y ejecutarlas en un orden específico. Además son los lotes que definen el momento (horario) de ejecutar las tareas. Añadimos un nuevo lote con código predefinido con F3 e '' | ||
{{ : | {{ : | ||
+ | Los campos de la pestaña //General// son los siguientes: | ||
+ | ^Campo ^Descripción ^ | ||
+ | |Código |El código del lote, que se genera automáticamente si damos en '' | ||
+ | |Nombre |Un nombre descriptivo para el lote. | | ||
+ | |Suspendido |Si esta casilla está marcada, algún error ha ocurrido en la última ejecución del lote.\\ Lo podemos comprobar desde el menú // | ||
+ | |Cód. planificación |En la planificación se puede definir la agenda de ejecución del lote. Se accede a la lanificación desde este campo con '' | ||
+ | |Remitente email error |El servicio que ejecuta los lotes, // | ||
+ | |Destinatario email error |Se puede poner un destinatario o varios separados por coma. Ver explicación en el campo anterior. | | ||
+ | |Fecha última ejec. |Fecha de la última ejecución del lote. Para lotes que se ejecutan varas veces al día incluye la hora también. | | ||
- | En la pestaña | + | Desde el campo //Cód. planificación// podemos |
{{ : | {{ : | ||
+ | En la cabecera tenemos estos campos: | ||
+ | ^Campo ^Descripción ^ | ||
+ | |Código |El código de la planificación, | ||
+ | |Nombre |Un nombre descriptivo. | | ||
+ | |Cód. calendario |El calendario a usar cuando se quiere ejecutar un lote en días festivos o laborales. | | ||
+ | |Permitir saltar ejec. |Si se desmarca esta opción, el servicio que ejecuta los lotes, // | ||
+ | |Ejecutar siempre |Marcando esta opción se ejecuta el lote cada vez que se arranca el servicio // | ||
+ | |Autogenerado |Esta marcado si la planificación ha sido autogenerado al crear un lote nuevo. | | ||
+ | |||
+ | En la pestaña //General// en la parte de las líneas de la planificación podemos detallar la agenda de ejecución del lote. | ||
+ | |||
^Campo ^Descripción ^ | ^Campo ^Descripción ^ | ||
- | |Cada 2 minutos |Se ejecuta el lote cada 2 minutos. Este es el intervalo de ejecución del programa // | ||
|Fecha fija |Una fecha fija en la que se quiere ejecutar el lote. | | |Fecha fija |Una fecha fija en la que se quiere ejecutar el lote. | | ||
|Cada día de mes |Se puede definir el día del mes en que se quiere ejecutar el lote. **Si al mismo tiempo se marca el campo '' | |Cada día de mes |Se puede definir el día del mes en que se quiere ejecutar el lote. **Si al mismo tiempo se marca el campo '' | ||
- | |Desplazar días |Se puede desplazar la fecha de ejecución definida en los demás campos por los días introducidos en ese campo. Para ejecutar una tarea el último día de cada mes, se pone 1 en '' | + | |Días de mes |Igual que el campo anterior, con la diferencia que se puede introducir una lista de días separadas por coma. | |
|Cada lunes/ | |Cada lunes/ | ||
|Cada día laboral |Marcando este campo se ejecuta el lote todos los días laborales. Hace falta definir un calendario en '' | |Cada día laboral |Marcando este campo se ejecuta el lote todos los días laborales. Hace falta definir un calendario en '' | ||
|Cada día festivo |Ejecutar el lote cada día festivo. Hace falta definir un calendario en '' | |Cada día festivo |Ejecutar el lote cada día festivo. Hace falta definir un calendario en '' | ||
- | |Permitir saltar ejec. |**En general | + | |Ejec. cada x minutos |
- | |Planificación | + | |Ejec. desde |Si se pone una hora en este campo y en el siguiente, //Ejec. hasta//, se ejecutará |
+ | |Desplazar días |Se puede desplazar la fecha de ejecución definida en los demás campos por los días introducidos en ese campo. Para ejecutar una tarea el último día de cada mes, se pone 1 en '' | ||
Una vez definida la planificación, | Una vez definida la planificación, | ||
{{ : | {{ : | ||
- | {{: | + | {{: |
La edición detallada de cada tarea se debería hacer pinchando en el botón correspondiente {{: | La edición detallada de cada tarea se debería hacer pinchando en el botón correspondiente {{: | ||
+ | Con F11 podemos confirmar el lote. Una vez confirmado ya no serán posible cambios ni en el mismo lote ni en cualquier componente del lote (tareas y documentos). **Solo lotes confirmados serán ejecutados**. **Si un lote está suspendido, lo podemos arrancar otra vez si lo desconfirmamos y confirmamos con F11.** | ||
+ | |||
+ | ===== Tareas ===== | ||
+ | Las tareas definen el envío por email de los documentos. Los documentos a enviar se añaden en la rejilla de // | ||
+ | |||
+ | {{ : | ||
+ | ^Campo ^Descripción ^ | ||
+ | |Ejecutar siempre |Hay que marcar este campo si queremos que se ejecute la tarea incluso si alguna tarea anterior en el lote había terminado con un error.\\ Útil por ejemplo para el envío de un resultado de la tarea. | ||
+ | |Fallo de envío es error |Si lo marcamos, un error en el envío (por ejemplo por un fallo en la red) se trata igual que un error al ejecutar la tarea. | | ||
+ | |Parar lote al error |Si está marcada esta opción (valor por defecto), en caso de un error no se ejecutan las tareas restantes del lote, con la excepción de las tareas marcadas con //Ejecutar siempre//. | | ||
+ | |Suspender lote al error |Si la tarea da un error, se marca el lote como suspendido y no se vuelve a ejecutar hasta que se desconfirme el lote y se vuelve a confirmar. | | ||
+ | |Cód. lista destinatarios | La lista de destinatarios para esta tarea. | | ||
+ | |Usuario conexión |Por defecto, la tarea se ejecuta bajo con un usuario del sistema. En este campo se puede definir otro usuario a utilizar en la conexión a la base de datos. | | ||
+ | |Grupo conexión |El grupo para la conexión. Solo se toma en cuenta si se ha definido también el //Usuario conexión// | ||
+ | |Clave conexión |La contraseña para el //Usuario conexión// | ||
+ | |||
+ | ==== E-Mail ==== | ||
+ | En la pestaña //E-Mail// se define el formato y los destinatarios del email a enviar. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Un email consiste de los tres partes // | ||
+ | |||
+ | Un parámetro se define por las llaves, por ejemplo '' | ||
+ | |||
+ | Cualquier parámetro usado en estos campos aparece automáticamente en la pestaña // | ||
+ | {{ : | ||
+ | |||
+ | Cuando se crean los emails y se recorre la lista de los destinatarios, | ||
+ | |||
+ | Los partes //prefijo// y //firma// permiten el uso de //html//, para por ejemplo incluir imagenes en la firma o cambiar el tamaño de la letra. | ||
+ | {{ : | ||
+ | |||
+ | Cualquier imagen utilizado en estos dos campos se sube inmediatamente a la base de datos y se puede ver en la pestaña // | ||
+ | {{ : | ||
+ | |||
+ | La definición de los destinatarios se hace desde la pestaña correspondiente. | ||
+ | {{ : | ||
+ | |||
+ | Al igual que con los parámetros, | ||
+ | También es posible definir una dirección de email fija en el campo // | ||
+ | En cualquier caso hay que escoger el //Tipo dest.// para cada línea añadida. | ||
+ | |||
+ | ==== Plantillas ==== | ||
+ | Es posible guardar los campos //Asunto email//, //Email prefijo//, //Email cuerpo//, //Email firma// e // | ||
+ | |||
+ | ==== Documentos de tareas ==== | ||
+ | Los documentos a enviar se definen en la rejilla de la pestaña //General// de las tareas. | ||
+ | {{ : | ||
+ | |||
+ | Añadimos una línea para cada adjunto y le ponemos un nombre. Luego usamos el botón {{: | ||
+ | |||
+ | Los documentos no están ordenados, no se puede saber el órden de su generación. | ||
+ | |||
+ | ===== Documentos ===== | ||
+ | En el formulario de Documento, al que llegamos pinchando en el botón {{: | ||
+ | |||
+ | El caso más fácil es añadir un archivo fijo, como puede ser un folleto de promoción o un manual de una máquina. Estos adjuntos fijos se añaden con el botón //Sel. fichero//. | ||
+ | {{ : | ||
+ | |||
+ | Si por lo contrario queremos crear un adjunto basándonos en datos de Smart, podemos escoger el botón //Sel. informe// y escoger un procedimiento para sacar la información de la base de datos. Al escoger un procedimiento se crea automáticamente una instrucción //select// en el campo // | ||
+ | También se añaden automáticamente en la rejilla correspondiente los parámetros del comando (si los tiene). | ||
+ | {{ : | ||
+ | |||
+ | Podemos poner para cada parámetro un valor fijo en la columna //Valor//, o una referencia a la lista de destinatarios, | ||
+ | |||
+ | Si pinchamos en la pestaña //Datos//, el programa nos deja poner unos parámetros temporales para abrir la consulta. Esto es necesario si queremos crear el diseño del informe, desde el menú // | ||
+ | |||
+ | El diseñador es parecido al de SmartOffice, | ||
+ | {{ : | ||
+ | En el siguiente párrafo se explican algunas peculiaridades del diseñador de informes. | ||
+ | |||
+ | También es posible enviar los datos en formato de hoja de cálculo o de texto estructurado. En este caso no definimos ningún diseño, pero en su lugar escogemos el formato a exportar en el campo //Cód. formato export//. | ||
+ | El formato **SYLK** es para la exportación en hoja de cálculo, mientras los otros formatos son para la exportación de texto. | ||
+ | |||
+ | Si queremos quitar temporalmente un adjunto de un envío sin tener que borrar el documento por completo, podemos desmarcar el campo **Activo**. | ||
+ | |||
+ | **Una vez que hayamos definido todos los adjuntos, podemos volver al formulario del lote y confirmar el lote con F11.** A partir de este momento ya no se puede cambiar ningún componente del lote, ni las tareas, ni los documentos. | ||
+ | |||
+ | ===== Diseñador ===== | ||
+ | ==== Enlaces URL ==== | ||
+ | Es posible añadir enlaces URI a cualquier cuadro de texto que se posiciona en el diseño. Para que aparezca el enlace en el PDF solamente hay que rellenar la propiedad '' | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Hay que destacar que es posible usar una variable de la base de datos para determinar la propiedad '' | ||
+ | |||
+ | ==== Imagenes externos ==== | ||
+ | Se puede añadir imagenes al diseño que se llenan desde ficheros guardados en carpetas locales o compartidas. | ||
+ | |||
+ | Para que esto funcione tenemos que añadir un comando a la propiedad Memo: | ||
+ | load(LinDatos.ENLACE) | ||
+ | El campo ENLACE de la fuente de datos LinDatos tiene que contener el nombre del fichero a cargar en la imagen. Esto funciona seguro con imagenes de tipo .jpg y .png. Para otros tipos hay que probar. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Hay que tomar en cuenta que los ficheros sean accesibles desde el servidor donde funciona // | ||
+ | |||
+ | ==== Fuentes ==== | ||
+ | Si se instala // | ||
+ | |||
+ | Cuando se crea un diseño en Windows hay que restringirse a fuentes que también existen en Linux, como por ejemplo **Arial** y **Times New Roman**. | ||
+ | |||
+ | Con un tamaño pequeño puede haber problemas en Linux. Estos son las medidas probadas: | ||
+ | * Arial: mayor o igual a 7px. | ||
+ | * Times New Roman: mayor o igual a 6px. |
usu/smartpdf/smartpdf_guia_de_iniciacion.txt · Última modificación: 2022/08/03 18:49 por stefan