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 10:56] – 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 69: | Línea 97: | ||
{{ : | {{ : | ||
En la columna //Nombre campo dataset// vemos los nombres de las variables que podemos utilizar en el diseño de los emails, como se explica más abajo. | En la columna //Nombre campo dataset// vemos los nombres de las variables que podemos utilizar en el diseño de los emails, como se explica más abajo. | ||
+ | |||
+ | **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, | ||
Línea 95: | Línea 145: | ||
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 ===== | ===== Tareas ===== | ||
- | Las tareas definen el envío por email de los documentos. Los documentos a enviar se añaden en la rejilla de líneas, lo que se explica más adelante. | + | Las tareas definen el envío por email de los documentos. Los documentos a enviar se añaden en la rejilla de // |
{{ : | {{ : | ||
Línea 105: | Línea 157: | ||
|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//. | | |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. | | |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 | | + | |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.1535964968.txt.gz · Última modificación: 2018/09/03 10:56 por stefan