Tabla de Contenidos
Configuración de SmartPdf para el envío inmediato de documentos
Tipos de tareas
Menú Configuración/Tipos de tareas
Para cada documento que queremos imprimir tenemos que definir un tipo de tarea distinto, como indica la siguiente imagen. Además del nombre de cada tipo tenemos que definir la longitud de cada campo principal (clave primaria) que pueda tener la tabla detrás de cada tipo.
Lista de destinatarios
Hay que definir una lista de destinatarios. Lo más fácil es usar una lista estática activando la opción correspondiente. No hace falta añadir ningún registro a esta lista, los registro se añaden automáticamente, por ejemplo al confirmar un contrato.
Información avanzada:
Cada registro que se añade a esta lista tiene que tener asignado un Tipo tarea en el campo correspondiente. El programa de servidor SmartServicesPdf escoge todos los registros de esta lista y del tipo de tarea, crea y envía el documento, y marca el registro como enviado en el campo Fecha enviado.
La ventaja de una lista estática es que sirve para varios tipos de tareas, porque es genérica. Para cada documento a enviar se pueden poner hasta 4 códigos, el código y razón social de un tercero, y lógicamente el correo el. de destino.
Si estos campos no son suficientes, por ejemplo porque queremos usar la dirección del cliente en la plantilla del email, entonces tenemos que definir una lista de destinatario dinámica.
Para el envío inmediato, la instrucción de selección siempre tiene que basarse en
select ID, CORREO_E from SS_LISTA_DEST_LIN where COD_LIST = 'El código de la lista' and TIPO_TAREA = 'El código del tipo de la tarea' and FECAH_ENVIADO is null order by ID
Un ejemplo sería:
SELECT A.ID, A.CORREO_E AS EMAIL_DEST, B.COD_OFERTA, B.RAZON_SOCIAL, B.DESC_OBRA, B.ATENCION_DE, C.DENOMINACION AS DENOMINACION_EMP, C.TELEFONO AS TELEFONO_EMP, C.CORREO_E AS EMAIL_EMP FROM SS_LISTA_DEST_LIN A JOIN CAB_OFERTA_VENTA B ON A.VALOR_1 = B.COD_OFERTA LEFT JOIN TERCERO C ON C.TIPO = B.TIPO_TERCERO_EMP AND C.CODIGO = B.COD_TERCERO_EMP WHERE A.COD_LISTA = 'ENV_INMED' AND A.TIPO_TAREA = 'OV' AND A.FECHA_ENVIADO IS NULL ORDER BY A.ID
Para las listas dinámicas también hay que rellenar la pestaña de actualización como se ve en la siguiente imagen. La instrucción de esta pestaña se ejecuta después del envío de cada registro sacado con la selección de la lista de destinatarios.
Hay que tomar en cuenta que normalmente es necesario crear una lista de destinatarios dinámica por cada tipo de tarea que queremos enviar.
Lote
Hay que crear un lote para el envío inmediato de documentos.
Este lote, en el formulario de Planificación, que se abre con Mayús.+F6
desde el campo Cód. palnificación
, tiene que ejecutarse cada 2 minutos.
Para cada tipo de documento que queremos enviar, añadimos una tarea nueva, y luego editamos estas tareas.
Tareas
En cada tarea hay que poner los siguientes datos:
- Cód. lista destinatarios: la lista de destinatarios definida anteriormente.
- Tipo tarea: el tipo de esta tarea.
- Parar lote al error: desactivar.
- Suspender lote al error: desactivar.
En cualquier momento puede haber solo una tarea de cada tipo de tarea en un lote confirmado.
La pestaña E-Mail se configura igual que cualquier lote normal, según las necesidades de la empresa.
Recuerda que se pueden usar los campos de la lista de destinatarios para asignarlos a los parámetros de la plantilla.
Documentos
Los documentos se definen de la misma manera como en cualquier lote normal, y como explica la guía de iniciación.
Normalmente el documento se va a basar en el procedimiento de impresión del documento de SmartOffice, por ejemplo IMPRES_OFERTA_VENTA
, y los parámetros serán los valores de la lista estática (VALOR_1
, VALOR_2
, etc.). Si se ha usado una lista dinámica, lógicamente habrá que usar los campos que devuelve su selección. Ver ejemplo en la imagen arriba.
Adaptación base de datos
Este paso se realiza en el mantenimiento o bajo presupuesto.
Información avanzada:
Hay que llamar al procedimiento SS_GEN_ENVIO_ESTANDAR
, con los siguientes parámetros:
Parámetro | Descripción | Obligatorio |
---|---|---|
P_TIPO_TAREA | El tipo de tarea. | Si |
P_TIPO_TERCERO | El tipo de tercero principal del documento. | No |
P_COD_TERCERO | El código de tercero principal del documento. | No |
P_CORREO_E | El destinatario del envío. | Si |
P_VALOR_1 | El código de la primera clave principal del documento. Se levanta una excepción si la longitud excede la longitud definida en SS_TIPO_TAREA para el tipo actual. Para las ofertas de venta sería el número de la oferta, por ejemplo. | No |
P_VALOR_2 | (igual que P_VALOR1 para la segunda clave, si el documento la tiene) | No |
P_VALOR_3 | (igual que P_VALOR1 para la tercera clave, si el documento la tiene) | No |
P_VALOR_4 | (igual que P_VALOR1 para la cuarta clave, si el documento la tiene) | No |
P_EX_ON_ERROR | Si ponemos el valor N y hay algún error, no se levanta ninguna excepción, pero solo se envía un mensaje al usuario. | No |
También es posible llamar el procedimiento directamente desde el formulario, por ejemplo al dar en un botón Enviar, como sucede en la unidad UnitOfertasClientes.pas
.