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.
Las propiedades de una acción son:
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.
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.
Podemos definir los estilos:
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
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.
Si activamos este estilo, el objeto podrá ser reemplazado por otro del mismo tipo en tiempo de ejecución mediante un objeto reemplazo.
Esta propiedad nos permite documentar el uso del objeto.
Tabla de un proyecto de datos que define la entrada de la acción.
Texto que se presentará en la barra de estado cuando estemos sobre la acción o seleccionemos ésta.
Texto que se presentará sobre la acción cuando estemos sobre ella con el ratón.
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 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.
Objeto Dibujo que se presentará como representación de la acción junto al texto de icono.
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 teclas para que la tecla aceleradora ejecute la acción.
Comando que se disparará al ejecutar la acción. Los comandos posibles son:
Ejecuta una serie de objetos presentando el último en pantalla.
Dispara una señal que puede ser usada en una conexión de evento para ejecutar un manejador de evento.
Ejecuta un proceso declarado en el proyecto actual o en un proyecto heredado en 2º plano o multitarea.
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.
Presenta el formulario de modificación de la tabla a la que está asociada la acción.
Presenta el formulario de baja de la tabla a la que está asociada la acción.
Alta del maestro seleccionado de la tabla a la que está asociada la acción.
Edición del maestro seleccionado de la tabla a la que está asociada la acción.
Localizar maestro seleccionado de la tabla a la que está asociada la acción.
Invertir el orden de la lista.
Solicita la fórmula con que se filtrará la lista seleccionada.
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.
Partir la lista por el elemento seleccionado.
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.).
Quita de la lista el elemento seleccionado.
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.).
Modificará el campo seleccionado con el dato que suministremos.
Modificará el campo seleccionado con el dato que suministremos si se da la condición.
Genera una nueva vista con los registros seleccionados.
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.).
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.
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.
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.
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.
Filtrará la lista dejando solamente los registros cuyo valor coincida con el valor de la columna que tengamos seleccionada.
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.
Como su propio nombre indica, permite quitar de la lista todos los registros que estén seleccionados.
Nos permitirá deshacer el último filtro aplicado.
Navega a los plurales del registro seleccionado solicitando el plural y el objeto con que se quiere mostrar.
Navega a los plurales de todos los registros de la lista solicitando el plural y el objeto con que se quiere mostrar.
Navega a los maestros de los registros solicitando el campo enlazado a maestro y el objeto con que se quiere mostrar.
Presenta los procesos, colas y servicios que se están ejecutando en multiarea.
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.
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.
Este comando abre el cuadro de diálogo que permite asociar impresoras lógicas a físicas.
Cierra la aplicación.
Corta el texto u objeto y lo deja en el portapapeles.
Copia el texto u objeto y lo deja en el portapapeles.
Pega el texto u objeto.
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.
Cierra todas las ventanas.
Visualiza todas las ventanas en cascada.
Visualiza todas las ventanas en mosaico.
Visualiza el siguiente panel.
Visualiza el panel anterior.
Presenta la ventana en pantalla completa.
Presenta una página web en un explorador web propio del sistema. La URL a ejecutar será resuelta por medio de una constante.
Este comando de acción está obsoleto.
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.
Presenta el cuadro de diálogo sobre la aplicación.
Permite mostrar/ocultar la caja de agrupamientos de una rejilla avanzada. Funcional en cabeceras y cuerpo.
Permite mostrar/ocultar pies de agrupamientos de una rejilla avanzada. Funcional en cabeceras y cuerpo.
Permite mostrar/ocultar el pie de una rejilla avanzada. Funcional en cabeceras y cuerpo.
Permite aumentar un 25% el tamaño de la fuente de la rejilla avanzada. Funcional en cabeceras y cuerpo.
Permite disminuir un 25% el tamaño de la fuente de la rejilla. Funcional en cabeceras y cuerpo.
Si la rejilla avanzada contiene agrupamientos, esta opción abrirá todos los nodos de las agrupaciones. Funcional en cabeceras y cuerpo.
Si la rejilla avanzada contiene agrupamientos, esta opción replegará todos los nodos de las agrupaciones. Funcional en cabeceras y cuerpo.
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.
Permite para quitar de una rejilla avanzada aquellos registros que no cumplan una determinada condición.
Permite destacar en la rejilla avanzada todas las columnas que contengan la cadena que escribamos en el campo de búsqueda.
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:
Objetos que se dispararán con el comando.
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 que se presentará al hacer uso del comando ficha: formulario de alta.
Campo que se editará al hacer uso de los comandos:
Ficha: alta de maestro.
Ficha: edición de maestro.
Ficha: localizar maestro.
Objeto que se dispara al hacer uso de los comandos:
Ficha: alta de maestro.
Ficha: edición de maestro.
Ficha: localizar maestro.
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.
