Tutor de grabación

Tutor de grabación
Página 1 de 7
Índice
Tutor de grabación .......................................................................................................................................................... 2
Objetivos del tutor .......................................................................................................................................................... 2
Configurando las opciones ............................................................................................................................................ 3
Grabando registros ........................................................................................................................................................ 4
¿Cómo está programado? ............................................................................................................................................. 6
Los interruptores son controles SVG ......................................................................................................................... 6
El control para la selección de senda donde guardar los ficheros PDF ..................................................................... 6
Dos botones Aceptar en el mismo formulario ............................................................................................................ 6
Un evento para aceptar y emular los procesos PRE y POST de Velneo 6.x ............................................................. 7
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción
Tutor de grabación
Página 2 de 7
Tutor de grabación
Objetivos del tutor
Este tutor muestra como podemos utilizar en nuestros formularios de grabación de datos las siguientes características:
1.
2.
3.
4.
5.
6.
Avanzar de campo o control con la tecla INTRO o la tecla TAB.
Aceptar los datos grabados pulsando la tecla INTRO sólo cuando el foco está en el botón Aceptar.
Aceptar los datos grabados pulsando el botón Aceptar con una tecla aceleradora.
Que el formulario se cierre al Aceptar o que tras pulsar el botón Aceptar aparezca un nuevo formulario vacío para seguir.
Cómo realizar una verificación antes de guardar los datos y en caso de error situar el cursor en el campo con error.
Equivalente al proceso previo del botón Aceptar en 6.x.
Cómo imprimir un informe generando un fichero PDF automáticamente tras guardar los datos. Equivalente al proceso
posterior del botón Aceptar en 6.x.
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción
Tutor de grabación
Página 3 de 7
Configurando las opciones
Para mostrar los diferentes objetivos de este tutor la solución cuenta con diferentes opciones de configuración que
permiten ejecutar las diferentes pruebas de forma sencilla y sin reprogramar.
Todas las opciones de configuración se guardan en variables globales en memoria, por lo que cada vez que se arranca
el tutor estarán con el valor por defecto.
Las configuraciones posibles son las siguientes:
Este interruptor cuando está activado provoca que en el
formulario de grabación la tecla INTRO avance de campo o
control. Cuando está desactivado la tecla INTRO equivale a
pulsar el botón Aceptar y guarda los datos grabados.
Con este interruptor apagado al pulsar el botón Aceptar con
ratón, INTRO o tecla aceleradora el formulario se cierra tras
guardar la información. Cuando este interruptor está
encendido al pulsar el botón Aceptar, tras guardar los datos, se muestra de nuevo el formulario de grabación inicializado,
listo para grabar un nuevo registro. Después del alta el nuevo formulario que aparece lanza el cálculo de los contenidos
iniciales, emite la señal de inicialización con la que se puede procesar un evento y sitúa el cursor en el primer campo con
tabulación.
Esta opción se desactiva cuando activamos el interruptor
Aceptar y seguir ya que sólo puede ser ejecutada si el botón
Aceptar guarda los datos y cierra el formulario. Cuando
activamos este interruptor, en el momento que se pulsa el botón Aceptar estamos forzando a que se realice la
verificación que hayamos programado en el evento que se ejecuta al pulsar el botón. En este tutor se verifica a modo de
ejemplo que el campo nombre no queda vacío, en caso de error se mostrará un mensaje de aviso, se situará el foco en
el campo nombre para su corrección y se paraliza el evento de grabación del registro.
Esta opción se desactiva cuando activamos el
interruptor Aceptar y seguir ya que sólo puede ser
ejecutada si el botón Aceptar guarda los datos y cierra
el formulario. Cuando activamos este interruptor, en el
momento en que se pulsa el botón Aceptar y tras
guardar los datos grabados se ejecutará la impresión de
un informe guardando el fichero en formato PDF en disco en la senda que puede configurarse en el edit debajo del
interruptor como se muestra en la imagen.
Para los usuarios de Velneo 6.x
El uso del nuevo comando de instrucción Interfaz: Guardar ficha en alta o modificación permite ejecutar procesos antes
y después de la grabación del registro de forma equivalente a lo que en Velneo 6.x se hacía con los procesos previo y
posterior que se configuraban en el botón Aceptar. La ventaja de este sistema es que todo el código a ejecutar antes y
después de la grabación del registro queda guardado en un evento del propio formulario evitando tener que crear 2
procesos externos al formulario.
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción
Tutor de grabación
Página 4 de 7
Grabando registros
Una vez que tenemos configurado el tutor para la prueba que queremos realizar, podemos probarlo
grabando registros de forma rápida con uno de los siguientes métodos:
1. Haciendo clic con el ratón en el botón.
2. Pulsando las teclas aceleradoras Ctrl+N.
3. Si ya hemos dado un alta, pulsando el
botón INTRO ya que el foco estará en el
botón Alta.
Cuando pulsamos el botón Alta se nos mostrará el siguiente formulario:
En función de la configuración seleccionada avanzaremos por los diferentes controles o bien con la tecla TAB o con la
tecla INTRO. Además, podremos pulsar en cualquier momento la tecla ESC para salir sin grabar.
El tutor ha sido programado con un único formulario que incluye 2 botones Aceptar, el que se puede ver en la imagen
superior que tiene configurada la tecla aceleradora (F12) y que al pulsarlo guarda el registro y se cierra el formulario y el
que podemos ver en la imagen inferior con el texto Aceptar y seguir (F11) que permite una grabación continua hasta que
se cancele. El motivo por el que se asignan dos teclas aceleradoras diferentes es doble: Primero porque al estar ambos
botones declarados en el mismo formulario existiría un conflicto, el segundo es que en muchos casos puede interesarnos
tener visibles y activos los 2 botones con el objetivo de que uno acepte y cierre (F12) y en caso de estar modificando un
registro nos permite aceptar y seguir en el formulario (F11) o lo que es lo mismo aplicar cambios y seguir.
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción
Tutor de grabación
Página 5 de 7
Truco
Los registros una vez grabados refrescan automáticamente la rejilla situada en la parte derecha del
formulario principal. Esto es así porque el botón Alta (Ctrl+N) ejecuta un evento con el comando de
instrucción Interfaz: formulario de alta lo que produce que el alta sea equivalente a seleccionar la opción
formulario de alta del menú contextual de la rejilla.
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción
Tutor de grabación
Página 6 de 7
¿Cómo está programado?
En este tutor hay varios aspectos que debemos destacar de forma específica.
Los interruptores son controles SVG
Son controles SVG cuyos objetos están definidos en la Velneo Open App
Controles SVG que puedes descargar desde su ficha.
Una vez instalada la Velneo Open App podrás heredarla y así encontrarás en la
opción Controles SVG de la toolbar de controles del editor de formularios los
diferentes botones, interruptores, switch y relojes que están definidos en la Open
App heredada.
El control para la selección de senda donde guardar los ficheros PDF
Se ha utilizado el control edición senda de directorios para permitir al usuario configurar
la senda de disco donde almacenar los informes en formato PDF que se generan
cuando el interruptor del proceso POST está activado.
Por defecto el valor de la senda se fija en el evento de inicialización del formulario
principal, que sólo se dispara cuando arranca el tutor. Aún así, se condiciona a que esté
vacío el valor de la variable global donde se guarda la senda para que asuma el valor de
la función estándar homePath().
Evento ONINIT del formulario PRINCIPAL
Dos botones Aceptar en el mismo
formulario
En el tutor sólo se utiliza un formulario de
grabación llamado NOTAS que contiene entre
otros controles dos botones Aceptar (F12) y
Aceptar y seguir (F11). Ambos botones están
condicionados, con condición opuesta, para que se vean uno u otro en función del estado del interruptor
"Aceptar sin cerrar" que modifica el valor de la variable global $ACEPTAR_SEGUIR.
El botón Aceptar y seguir (F11) ejecuta el comando de botón "Aceptar sin cerrar".
El botón Aceptar (F12) ejecuta el evento ACEPTAR_PRE_POST.
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción
Tutor de grabación
Página 7 de 7
Un evento para aceptar y emular los procesos PRE y POST de Velneo 6.x
El siguiente evento es lanzado al pulsar el botón Aceptar (F12).
El evento está documentado con comandos de instrucción REM donde se puede apreciar que el código está dividido en
4 grandes bloques:
Bloque PRE, condicionado a que esté activo el interruptor PRE (Verificación). Se encarga de verificar si está
grabado el nombre, en caso contrario fija el foco en el control edit del campo Nombre y finaliza el evento ya
que no se va a guardar la información.
2. Grabación del registro, utilizando el nuevo comando de instrucción Interfaz: Guardar ficha en alta o
modificación.
3. Bloque POST, condicionado a que esté activo el interruptor POST (Imprimir). Se encarga de imprimir la nota
grabada generando un fichero en disco en formato PDF. Para hacerlo se utiliza el nuevo comando de
instrucción Exportar informe a fichero que como necesita un origen Lista de NOTAS en este caso, utilizamos
las instrucciones de cesta para convertir nuestra ficha guardada en una lista de un registro con la que poder
ejecutar la instrucción. En la exportación se utiliza tanto la senda configurada para el directorio de destino del
fichero y el ID o código del registro para generar un informe diferente para cada NOTA. En caso de generar
siempre el mismo fichero se sobre-escribiría quedando sólo el último generado.
4. El último bloque es el que se encarga de Aceptar el formulario con lo que se cierra después de finalizar todos
los bloques anteriores. Este comando de instrucción es equivalente al comando de botón Aceptar.
1.
Pol. Ind. A Granxa, Edificio vCenter
Rúa D, esquina paralela 3
36400 Porriño (Pontevedra)
España
Telf. (+34) 902 36 63 82
[email protected]
velneo.es
Velneo, S.A. C.I.F. A-36494706. Inscrita en el Registro Mercantil de Pontevedra, al Tomo 3085, Libro 3085, Folio 90, Hoja PO-37578, primera inscripción