Acción
Una acción es el objeto de proyecto de aplicación que permite disparar un comando. Éste puede ser un comando en stock (preprogramado) o un comando programado que, en general, disparará objetos.
Como entrada puede no tener origen u origen lista y una tabla asociada.
La acción puede ser usada en opciones de menú, toolbars, botones en formularios, etc. Para crear un objeto de este tipo seleccionar la opción nuevo objeto/acción del menú objetos de Velneo vDevelop o a través de la galería de objetos.
Propiedades
Identificador
Etiqueta alfanumérica que identifica de forma unívoca un objeto dentro del proyecto de aplicación. Este identificador será el que usemos para referenciarlo en otras propiedades de otros objetos.
El identificador constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca un objeto no puede haber duplicidad.
Nombre
Etiqueta alfanumérica que servirá como descriptor del objeto. Se usará para presentar información del objeto en objetos y en los inspectores. Así mismo será el dato que mostrará la acción cuando se muestre en un menú (si se configura con texto) y en una toolbar.
Podemos definir una etiqueta por cada idioma presente en el proyecto.
Estilos
Podemos definir los estilos:
Privado
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Punto de inserción
Permitirá establecer una relación de herencia inversa con un objeto de un proyecto que hereda el proyecto actual. La activación de este estilo hará que el comando a disparar no pueda ser establecido ya que éste será definido en el proyecto heredado por éste. Ver el capítulo relativo a sub-objeto inserción para ampliar información al respecto. Una acción con este estilo activado se distinguirá visualmente en el panel de proyectos por usar una tipografía cursiva en su identificador. Las acciones con herencia inversa solamente podrán ser usadas en menús y toolbars.
En una acción definida como punto de inserción no solamente se puede insertar una única acción, sino que se pueden insertar n acciones, por lo tanto, este tipo de acciones solamente podrá ser usada en objetos que soporten multiplicidad, como pude ser una toolbar o un menú, por ejemplo.
Personalizable
Si activamos este estilo, el objeto podrá ser reemplazado por otro del mismo tipo en tiempo de ejecución mediante un objeto reemplazo.
Comentarios
Esta propiedad nos permite documentar el uso del objeto.
Tabla asociada
Tabla de un proyecto de datos que define la entrada de la acción.
Texto de estado
Texto que se presentará en la barra de estado cuando estemos sobre la acción o seleccionemos ésta.
Texto de tooltip
Texto que se presentará sobre la acción cuando estemos sobre ella con el ratón.
Texto de ayuda
Texto que se presentará al solicitar ayuda sobre la acción. Esta opción de mantiene por compatibilidad con sistemas operativos Windows más antiguos en los que, junto al botón de cerrar ventana [x] se incluye el botón what's this? [?] que al pulsarlo muestra la ayuda de un elemento concreto.
Texto de icono
Texto que se presentará junto con el icono cuando la acción se use en una toolbar. En caso de no estar definido se presentará el nombre de la acción.
Icono
Dibujo que se presentará como representación de la acción junto al texto de la acción.
Tecla aceleradora
Tecla que hace que se ejecute la acción.
Debemos de tener la precaución de no hacer coincidir dentro de un mismo contexto dos controles y/o subcontroles con la misma tecla aceleradora ya que, en el caso de suceder, no se disparará ninguno de ellos.
Los aceleradores de teclado no son funcionales cuando la acción está dentro de un menú arbolado.
Combinación de la tecla aceleradora
Combinación de teclas para que la tecla aceleradora ejecute la acción.
Comando
Comando que se disparará al ejecutar la acción. Los comandos posibles son:
Disparar objetos
Ejecuta una serie de objetos presentando el último en pantalla.
Disparar señal
Dispara una señal que puede ser usada en una conexión de evento para ejecutar un manejador de evento.
Ejecutar proceso 2º plano
Ejecuta un proceso declarado en el proyecto actual o en un proyecto heredado en 2º plano o multitarea.
Ficha: Formulario de alta
Presenta el formulario de alta seleccionado (no necesita origen). Si la acción la disparamos desde otro formulario que contenga una rejilla asociada al formulario declarada en dicha acción, al dispararla, el registro creado será añadido a la rejilla; pero solamente en el caso de que la rejilla esté visible en el momento de disparar la acción. Además, si el registro dado de alta es histórico (plural) de la ficha editada en el formulario desde el que disparamos la acción, se inducirá ese maestro en el momento del alta.
Ficha: Formulario de modificación
Presenta el formulario de modificación de la tabla a la que está asociada la acción.
Ficha: Formulario de baja
Presenta el formulario de baja de la tabla a la que está asociada la acción.
Ficha: Alta de maestro
Alta del maestro seleccionado de la tabla a la que está asociada la acción.
Ficha: Edición de maestro
Edición del maestro seleccionado de la tabla a la que está asociada la acción.
Ficha: Localizar maestro
Localizar maestro seleccionado de la tabla a la que está asociada la acción.
Lista: Invertir
Invertir el orden de la lista.
Lista: Filtrar
Solicita la fórmula con que se filtrará la lista seleccionada.
Lista: Ordenar...
Reordenar la lista según el campo seleccionado. Para realizar la ordenación, el sistema hace una indexación previa. El tamaño de las claves es de 24 caracteres para los campos alfabéticos menores que alfa256 y de 48 para campos alfa256 y superiores.
Este comando está optimizado ya que la ordenación ser hará en el servidor. No se hará la ordenación en el servidor si el campo por el que se ordena es fórmula, o si se trata de una fórmula compuesta en la columna.
Lista: Partir
Partir la lista por el elemento seleccionado.
Lista: Multipartir...
Multipartirá la lista según el campo seleccionado. Este tipo de comando no puede ser usado en menús de contexto o toolbars asociados a objetos de lista (rejilla, casillero, etc.).
Lista: Quitar de la lista el seleccionado
Quita de la lista el elemento seleccionado.
Lista: Campos duplicados...
Devuelve una lista con los elementos con campos con valores duplicados. Este tipo de comando no puede ser usado en menús de contexto o toolbars asociados a objetos de lista (rejilla, casillero, etc.).
Lista: Modificar campo...
Modificará el campo seleccionado con el dato que suministremos.
Lista: Modificar campo si...
Modificará el campo seleccionado con el dato que suministremos si se da la condición.
Lista: Generar lista con seleccionados
Genera una nueva vista con los registros seleccionados.
Lista: Generar vista con otro visor...
Este comando nos permite generar una nueva vista con los registros de la lista en curso usando otro visor de listas distinto al actual (rejilla, informe, ViewFlow. Al ejecutar esta opción el sistema mostrará una ventana con todos los objetos de lista públicos asociados a la tabla en curso para que el usuario seleccione el que quiera usar para generar la nueva vista. Solamente serán mostrados aquellos objetos de lista que no tengan activado el estilo privado. Aconsejamos por tanto el estilo privado en todos aquellos objetos cuyo origen sea lista que no se quiera estén disponibles al usuario final al usar este comando. Este tipo de comando no puede ser usado en menús de contexto o toolbars asociados a objetos de lista (rejilla, casillero, etc.).
Lista: Guardar lista virtual
Permite guardar en disco una lista virtual a partir de los registros contenidos en una vista de datos de lista. El archivo generado tendrá extensión v7v.
Lista: Recuperar de lista virtual
Permite recuperar en una vista de datos de lista una lista virtual generada, o bien con la acción en stock Lista: Guardar lista virtual, o bien con el comando Guardar del submenú Lista virtual del menú de lista extendida, o bien con el comando de instrucción de proceso guardar en lista virtual, o bien con la función saveToFile de la clase VRegisterList de la API de Velneo para Javascript. Por defecto buscará archivos con extensión v7v pero podremos cambiar el filtro en la ventana de selección del fichero.
Ver el capítulo listas virtuales para ampliar información sobre su funcionamiento.
Lista: Imprimir
Específica para rejillas avanzadas. Envía a impresora el contenido de la rejilla. Equivale al comando del mismo nombre existente en el menú por defecto de las rejilla avanzadas.
Lista: Exportar a pdf
Específica para rejillas avanzadas. Genera un pdf con contenido de la rejilla. Equivale al comando del mismo nombre existente en el menú por defecto de las rejilla avanzadas.
Lista: Exportar a xml
Genera un fichero XML con el contenido de una rejilla o de una rejilla avanzada. Equivale a la opción del mismo nombre del menú por defecto extendido de ambos objetos.
Filtros: Igual a seleccionados de la columna
Si seleccionamos varias filas de una misma columna, podremos dejar en la lista solamente aquellos registros que contengan los mismos valores que los registros seleccionados.
Filtros: Por columna
Filtrará la lista dejando solamente los registros cuyo valor coincida con el valor de la columna que tengamos seleccionada.
Filtros: Con una fórmula avanzada...
La condición a evaluar se establecerá por medio de una fórmula por lo que se abrirá el asistente para la edición de fórmulas. En él tendremos acceso a las Funciones estándar de fórmulas, a la lista de campos de la tabla y a las variables del sistema.
Filtros: Quitar de la lista los seleccionados
Como su propio nombre indica, permite quitar de la lista todos los registros que estén seleccionados.
Navegante: Navegar a plurales de uno...
Navega a los plurales del registro seleccionado solicitando el plural y el objeto con que se quiere mostrar.
Navegante: Navegar a plurales de todos...
Navega a los plurales de todos los registros de la lista solicitando el plural y el objeto con que se quiere mostrar.
Navegante: Navegar a maestros...
Navega a los maestros de los registros solicitando el campo enlazado a maestro y el objeto con que se quiere mostrar.
Archivo: Multitarea (Procesos colas y servicios)
Presenta los procesos, colas y servicios que se están ejecutando en multiarea.
Archivo: Cachés de fichas
Presenta una ventana que muestra la lista de tabla del proyecto junto con el número de fichas de las mismas que se encuentran en la caché local.
Archivo: Modificar contraseña usuario...
Permite cambiar la contraseña del usuario en el Velneo vServer con el que se ha conectado el cliente. Al ejecutarlo se presentará una ventana en la que el usuario tendrá que escribir la contraseña actual y la contraseña nueva con confirmación.
Archivo: Configurar impresoras lógicas...
Este comando abre el cuadro de diálogo que permite asociar impresoras lógicas a físicas.
Archivo: Salir
Cierra la aplicación.
Editar: Cortar
Corta el texto u objeto y lo deja en el portapapeles.
Editar: Copiar
Copia el texto u objeto y lo deja en el portapapeles.
Editar: Pegar
Pega el texto u objeto.
Ventana: Cerrar
Cierra la ventana en curso. Dado el funcionamiento del sistema de ventanas, no es posible usar esta acción dentro de una ventana para cerrarse a sí misma. Tendremos que, o bien incluir la acción fuera de la ventana, por ejemplo, en el menú principal del proyecto o, si se trata de un formulario, usar el comando de botón “cancelar” para provocar su cierre.
Ventana: Cerrar todas
Cierra todas las ventanas.
Ventana: Cascada
Visualiza todas las ventanas en cascada.
Ventana: Mosaico
Visualiza todas las ventanas en mosaico.
Ventana: Panel anterior
Visualiza el siguiente panel.
Ventana: Panel siguiente
Visualiza el panel anterior.
Ver: Pantalla completa
Presenta la ventana en pantalla completa.
Página web
Presenta una página web en un explorador web propio del sistema. La URL a ejecutar será resuelta por medio de una constante.
Página web con inspector
Este comando de acción está obsoleto.
Mensajes y alertas...
Presenta el gestor de mensajes que permitirá al usuario enviar y recibir mensajes a/de otros usuarios. Ver el capítulo mensajería para ampliar información sobre su funcionamiento.
Ayuda: Acerca de…
Presenta el cuadro de diálogo sobre la aplicación.
Rejilla avanzada: Mostrar/Ocultar caja para agrupar
Permite mostrar/ocultar la caja de agrupamientos de una rejilla avanzada. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Pie de grupo
Permite mostrar/ocultar pies de agrupamientos de una rejilla avanzada. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Pie de rejilla
Permite mostrar/ocultar el pie de una rejilla avanzada. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Aumentar zoom
Permite aumentar un 25% el tamaño de la fuente de la rejilla avanzada. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Disminuir zoom
Permite disminuir un 25% el tamaño de la fuente de la rejilla. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Expandir todo
Si la rejilla avanzada contiene agrupamientos, esta opción abrirá todos los nodos de las agrupaciones. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Contraer todo
Si la rejilla avanzada contiene agrupamientos, esta opción replegará todos los nodos de las agrupaciones. Funcional en cabeceras y cuerpo.
Rejilla avanzada: Guardar configuración
Permite guardar el estado de configuración de la rejilla avanzada, esto es: columnas, pies de rejilla, pies de grupo, cálculos configurados y los filtros combinados utilizados.
Rejilla avanzada: Filtro combinado...
Permite para quitar de una rejilla avanzada aquellos registros que no cumplan una determinada condición.
Rejilla avanzada: Buscar...
Permite destacar en la rejilla avanzada todas las columnas que contengan la cadena que escribamos en el campo de búsqueda.
Rejilla avanzada: Mejor ajuste
Ajusta el contenido de la rejilla avanzada de la mejor forma posible dentro del área donde se está mostrado.
Los comandos hacen uso de las siguientes propiedades para configurarlos:
Objeto 1…n
Objetos que se dispararán con el comando disparar objetos. El primer elemento tiene la misma entrada que la acción (Ninguno o lista de la tabla asociada) y los siguientes se encadenarán con la salida del objeto anterior, presentándose el último objeto de la lista. Debemos tener en cuenta que si un objeto no tiene salida, no podrá alimentar la entrada de otro.
Formulario
Formulario que se presentará al hacer uso del comando ficha: formulario de alta.
Campo
Campo que se editará al hacer uso de los comandos:
Objeto
Objeto que se dispara al hacer uso de los comandos:
Las opciones del menú principal del proyecto se disparan únicamente sobre los controles de vista de datos en vista, no hemos de usarlos para interactuar con docks en toolbar o en formularios.
