Documentación de Velneo
21
21
  • Introducción
  • Velneo 21
    • ¿Qué es velneo?
    • Requerimientos de Velneo
    • Funcionalidades comunes a los componentes de Velneo
      • Conexión con Velneo vServer
      • Cambiar el estilo de visualización
      • Ver u ocultar barras de herramientas
      • Mensajería interna entre usuarios
      • Soporte de alta resolución (HighDPI)
      • Carpetas de trabajo de los componentes de Velneo
      • Numeración de versiones de Velneo
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Interfaz de Velneo vDevelop
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Proyectos objetos y editores
      • Objeto
      • Proyecto de datos
        • Tabla
          • Campo
          • Enlace
          • Indice
          • Plural
          • Actualización
          • Trigger
          • Traspaso de campo
        • Tabla estática
        • Indice complejo
        • Variable
      • Proyecto de aplicación
        • Marco
        • Acción
        • Menú
        • Toolbar
        • Rejilla
          • Propiedades de columna
        • Formulario
          • Controles de visualización
            • Texto estático
            • Nombre de campo
            • Visor HTML
            • Dibujo
            • Imagen SVG
            • Caja de grupo
            • Menú arbolado
            • Barra de progreso
            • Reloj
            • Manómetro
            • Termómetro
          • Controles de edición
            • Edición alfabética
            • Edición numérica
            • Data catcher edit
            • Objeto dibujo
            • Edición fecha/hora
            • Edición fecha
            • Edición hora
            • Caja de texto
            • Caja de texto enriquecido
            • Edición fórmula
            • Edición senda fichero
            • Edición senda directorio
          • Controles de entrada
            • Botón
            • Botón de radio
            • Botón de check
            • ComboBox
            • ListBox
            • Deslizador
            • Rueda
            • Dial
            • Calendario
          • Contenedores
            • Separador de formularios
            • Splitter
            • Pila de formularios
            • Caja de formularios
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Fichas de extensión
        • Búsqueda
        • Localizador
        • Lupa
        • Arbol visor de tablas
        • Casillero
        • Multivista
        • Bloc de formularios
        • Informe
          • Agrupamiento
          • Sección
          • Editor de informes
          • Cálculo
        • Informe personalizable
          • Diseñando un informe personalizable básico
          • Diseño avanzado
          • Diseñando un informe personalizable
          • Añadiendo orígenes de datos
          • Añadiendo elementos al informe
          • Características avanzadas
          • Etiquetas
          • Asistente de scripts
        • Impresora lógica
        • Cesta
        • Dispositivo serie
        • Imagen SVG
        • Control SVG
        • ViewFlow
        • Rejilla avanzada
        • Alternador de lista
        • ListView
        • ComboView
        • Formulario QML
        • Lista QML
        • Toolbar
        • Protocolo TCP-IP
        • Librería externa
        • Conexión de evento
        • Manejador de evento
        • Drop
        • Inserción
      • Objetos de proyectos de aplicación y datos
        • Dibujo
        • Constante
        • Proceso
          • Comandos de base de datos
            • API
            • Bases de datos externas
            • Búsquedas
            • Campos (grupo de comandos)
            • Cestas
            • Fichas
            • Fichas seleccionadas
            • Listas
            • Tablas
            • Tubos
          • Básicos
            • Controles de flujo
            • Debug
            • Ejecución
            • Salida/retornos
            • Scripts (grupo de comandos)
            • Transacciones (comandos)
            • Variables
          • Comunicación
            • Internet
            • Protocolo TCP
            • Puerto serie
            • SDV
          • Interfaz
            • Acciones (comandos)
            • Control
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Cola
        • Función
        • Variable local
        • Tubo de ficha
        • Tubo de lista
        • Esquema de tablas
        • Fichero adjunto
      • Editores
        • Editor de imágenes
        • Selector de fuentes
        • Asistente de fórmulas
          • Operadores
          • Funciones estándar
            • Funciones API
            • Funciones básicas
            • Funciones de cadenas
              • Expresiones regulares
            • Funciones científicas
            • Funciones de Cliente-servidor
            • Funciones de color
            • Funciones de códigos
            • Funciones de directorios
            • Funciones de fechas
            • Funciones de ficha en curso
            • Funciones de horas
            • Funciones de Internet
            • Funciones de juegos de caracteres
              • Codecs
            • Funciones numéricas
            • Funciones de sistema
            • Funciones de tiempo
            • Funciones trigonométricas
          • Funciones de dll
          • Funciones de proceso
          • Campos
          • Constantes
          • Variables globales
          • Variables locales
          • Variables del sistema
          • Verificador de fórmulas
          • Conversión automática de datos
          • Introducción de datos literales
          • Secuencias de escape en cadenas de caracteres
          • Funciones de campo
    • Inspectores
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataViewDialog
            • VDateEdit
            • VDateEditBrowser
            • VDateTimeEdit
            • VDateTimeEditBrowser
            • VDial
            • VDir
            • VExtension
            • VFile
            • VFileInfo
            • VFilePathEditBrowser
            • VFinder
            • VFont
            • VFormBlockListDataView
            • VFormDataView
            • VFormulaEditBrowser
            • VGaugeWidget
            • VGridListDataView
            • VGroupBox
            • VImage
            • VImageEdit
            • VImageWidget
            • VInstancesList
            • VInstance
            • VInstances
            • VItemRegisterPattern
            • VLabel
            • VLineEdit
            • VLineEditBrowser
            • VListBox
            • VListDataView
            • VLogin
            • VMainWindow
            • VMdiView
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VServerAdmin
            • VSettings
            • VSlider
            • VSlotListDataView
            • VSolutionInfo
            • VSplitter
            • VSqlDatabase
            • VSSLCertificate
            • VSSLInfo
            • VSSLSessionCipher
            • VStackedWidget
            • VSvgButton
            • VSvgSlideSwitch
            • VSvgToggleSwitch
            • VSvgWidget
            • VSysInfo
            • VTableInfo
            • VTabWidget
            • VTextEdit
            • VTextFile
            • VThermometerWidget
            • VThumbWheel
            • VTimeEdit
            • VTimeEditBrowser
            • VToolBox
            • VTreeItem
            • VTreeItemRegister
            • VTreeListDataView
            • VTreeMenu
            • VTreeMultiTableListDataView
            • VTreeWidget
            • VUser
            • VUserGroup
            • VUserGroupList
            • VUserList
            • VXmlReader
            • VXmlWriter
            • Widget
            • XMLHttpRequest
        • QML
          • Tipos QML
          • QML1 vs QML2
          • Migrar aplicaciones de QML 1 a QML 2
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Solución
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Diccionario de abreviaturas
        • No te olvides nunca. Escribes y mantienes código. Documenta bien
        • Diseña los formularios como si no existiesen los layouts
      • Buenas prácticas de rendimiento
        • Arquitectura
          • Listas de registros
          • Lista de resultados de una búsqueda
          • Las cestas
          • Las variables globales
          • La caché de fichas
          • Programa en cloud
        • Base de datos
          • Tablas en memoria vs tablas en disco
          • Optimizar migraciones de datos
          • Búsquedas en el servidor ¿Cuándo y Cómo?
          • Campos fórmula vs campos en disco
          • Reduce el número de índices
          • Indices condicionados vs búsquedas complejas
          • ¿Cuándo usar tablas de extensión?
          • Indices de trozos y palabras
          • ¿Cuándo usar cada tipo de campo alfa?
          • ¿Cúando usar índices complejos?
          • Actualizaciones vs triggers
          • Puntero indirecto real vs virtual
          • Campos alfa vs campos objeto texto
          • Uso de fórmulas JavaScript en campos
          • Evitar filtrar y ordenar
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Procesos
          • 1º, 2º y 3º plano ¿Cuándo usar cada uno?
          • Bloqueo blando vs bloqueo duro
          • Pasar información del cliente al servidor
          • ¿Cómo optimizar transacciones grandes?
          • ¿Cómo gestionar las transacciones?
          • Grabaciones optimizadas para el usuario
        • Rejillas
          • Campos punteros a singular
          • Totales
          • Condiciones de activo, visible y color en columna
          • Campos de tipo objeto
        • Conoce los límites
      • Buenas prácticas para el desarrollo en equipo
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
    • Tareas
    • Acceso directo
  • Velneo vClient
    • ¿Qué es Velneo vClient?
    • Movilidad
    • Funcionalidades de Velneo vClient
      • Accesos directos y VRL
      • Cambiar idioma
      • Panel de procesos en 2º plano
      • Manejo de rejillas
      • Manejo de cestas de la compra
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Uso de la rejilla avanzada
      • Ordenación de listas
      • Captura de imágenes desde cámara
  • Velneo vServer
    • ¿Qué es Velneo vServer?
    • Instalación y configuración
      • Activación de la licencia
      • Línea de comandos de Velneo vServer
      • Parámetros configurables de Velneo vServer
      • Estructura de directorios
    • Iniciar Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
      • Cómputo del consumo de puestos
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstall Builder?
    • Configurar una instalación
    • Probar una instalación
    • Crear el instalable
    • Accesos directos
  • Velneo vModApache
    • ¿Qué es Velneo vModApache?
    • Instalación y configuración
    • Nomenclatura de objetos en urls
    • Uso de ficheros adjuntos
  • Velneo vDataClient
    • ¿Qué es Velneo vDataClient?
    • Iniciar Velneo vDataClient
    • Interfaz de Velneo vDataClient
    • Procesos
    • Utilidades
    • Acceso directo a una instancia de datos
  • Velneo vTranslator
    • ¿Qué es Velneo vTranslator?
    • Importación y exportación basada en XLIFF
    • Acceso directo a una solución
  • Velneo ODBC Driver
    • ¿Qué es velneo ODBC Driver?
    • Referencia de comandos SQL
  • Velneo vVersion
    • ¿Qué es Velneo vVersion?
  • Velneo vERP
    • ¿Qué es Velneo vERP?
    • Manual del programador
    • Documentación del ApiRest
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de marcos
      • Tutor de formularios
      • Tutor de rejillas
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de informes
      • Tutor de cestas
      • Tutor de localizador básico
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de impresión de informes
      • Tutor de tubos de ficha y de lista
      • Tutor de grabación de fichas
      • Tutor de comboview
      • Tutor de eventos
      • Tutor de drag and drop
      • Tutor de TCP/IP
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de vistas de datos de lista
      • Tutor de visor html dinámico
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de procesos
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de comandos de interfaz y acciones
    • Tutores de scripts
      • QML: Hola mundo
      • QML: tutorial básico
      • QML: Tutor de vistas
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • SLA
Con tecnología de GitBook
En esta página
  • Marco, módulos, submódulos y nivel funcional)
  • Marco
  • Módulos
  • Submódulos
  • Nivel funcional
  • Interfaz, acciones y recuros
  • Interfaz
  • Acciones y menús
  • Recursos

¿Te fue útil?

  1. Velneo vDevelop
  2. Buenas prácticas
  3. Buenas prácticas de organización

Proyecto de aplicación

Última actualización hace 5 años

¿Te fue útil?

Marco, módulos, submódulos y nivel funcional)

Marco

Utiliza la carpeta "Marco".

Contendrá como primer objeto el marco principal "AUTOEXEC".

Contendrá las siguientes subcarpetas:

Arranque

Esta carpeta contendrá los objetos que son ejecutados por el marco AUTOEXEC y el ON_INIT_SERVER en el caso de que exista.

Barra de menú

Está carpeta contendrá subcarpetas con los nombres de las opciones de menú principal de la barra en el mismo orden de aparición en la aplicación. Por ejemplo: Principal, Archivo, Registros, Supervisor, Ayuda, etc. Dentro de cada subcarpeta se incluirá en primer lugar el objeto menú y a continuación las acciones que lo componen. Los objetos de tipo Acción que son lanzados en ese menú, estarán ordenados dentro de la carpeta, debajo del menú y en el mismo orden en el que son utilizados. Este mismo criterio será aplicado en el caso de que existan subniveles.

Menú general

Esta carpeta contendrá los objetos que se usarán para visualizar dicho menú. En el caso de que el menú está incrustado en un dock, aquí situaremos el formulario usado dentro de dicho dock.

Formulario principal

Esta carpeta contendrá el formulario principal que se usa en el marco AUTOEXEC, así como las acciones principales para que pueda ser abierto en el caso de que sea cerrado desde el menú principal.

Módulos

Cada módulo de la aplicación tendrá una carpeta principal: Gestión, Contabilidad, TPV, Maestros, Configuración, etc.

Para los módulos comunes (Gestión, Contabilidad, TPV ) utilizaremos "Carpeta 1".

Para los módulos específicos: Maestros "Objetos 3" y Configuración "Objetos 5".

Submódulos

Dentro de la carpeta de cada módulo se incluirán tantas subcarpetas como submódulos existan, y se pondrán en el mismo orden en el que están incluidos en el menú.

Dentro de cada carpeta de submódulo se incluirán carpetas específicas para cada funcionalidad. Por ejemplo, dentro de la carpeta Ventas, incluiremos subcarpetas para Presupuestos, Pedidos, Albaranes, Facturas, etc.

Nivel funcional

Continuando con el ejemplo de Presupuestos de Venta, contendrá dos carpetas que se llamarán igual una con objetos (utilizando la carpeta "Interfaz") y otra con la carpeta "Acciones y menús"

Adicionalmente incluiremos subcarpetas para tablas plurales, por ejemplo, Líneas de Presupuesto de Ventas, creando así una estructura jerárquica que nos permita copiar todos los objetos de interfaz de las tablas relacionadas con la principal. Estás subcarpetas seguirán los mismos criterios de organización.

Interfaz, acciones y recuros

Interfaz

En esta carpeta organizaremos los objetos en el siguiente orden:

Formularios

El primer formulario será el del alta que normalmente tendrá como identificador el nombre de la tabla asociada. A continuación se situarán todos los subformularios contenidos en separadores de pestañas, pilas o cajas de formularios, etc. Estos subformularios se ubicarán en el mismo orden en que están incluidos en los controles contenedores. Este mismo criterio será aplicado a los puntos de inserción utilizados en los contenedores. Los formularios que sean de tipo Punto de Inserción llevarán el sufijo _INS seguido de un ordinal en el caso de que haya más de uno. Especialmente se utilizará el sufijo _INS_INI y _INS_FIN en el caso de que existan para indicar que ese punto de inserción irá ubicado antes de la primera pestaña o después de la última respectivamente. Si hubiese formularios especiales para bajas o modificaciones, se ubicarán a continuación del último subformulario con el sufijo _BAJ para las bajas y _MOD para las modificaciones.

Alternadores

Por orden alfabético.

Rejillas

Por orden alfabético.

Rejillas avanzadas

Por orden alfabético.

Árboles visores de tablas arboladas

Por orden alfabético.

Blocs de formularios

Por orden alfabético.

Listas QML

Por orden alfabético.

Comboviews

Por orden alfabético.

Listview

Por orden alfabético.

Viewflows

Por orden alfabético.

Informes

Por orden alfabético.

Impresoras lógicas

Por orden alfabético.

Multivistas

Por orden alfabético.

Toolbars

Por orden alfabético.

Búsquedas

Por orden alfabético.

Localizadores

Por orden alfabético.

Cestas

Por orden alfabético.

Procesos

Por orden alfabético.

Funciones

Por orden alfabético.

Subcarpeta con el icono "Objetos 2" y título "Menús de botón ..." que contendrá otras subcarpetas con los menús de botón para cada campo puntero a maestro. Cada menú de botón tendrá un carpeta "Objetos 2" específica con el título de "Menú de botón de maestro" (siendo maestro la descripción del campo apuntado). Dentro de la carpeta se situará como primer objeto el menú y debajo las acciones incluidas en el menú en el mismo orden que tienen en el menú. El menú de botón más estándar contiene en el menú las opciones de Localizar (tecla aceleradora F5), Alta (tecla aceleradora F6) y Editar (tecla aceleradora F7) teniendo como identificador la tabla de origen seguido del campo apuntado donde se situará el menú de botón y como sufijo el asociado a la acción específica, en los ejemplos estándar comentados serían _LOC, _ALT y _MOD.

En el caso de que existan muchos objetos de un determinado tipo, por ejemplo procesos, conviene crear al final de los objetos una subcarpeta en la que organizaremos todos los procesos que tengan una relación funcional.

Acciones y menús

En esta carpeta organizaremos como su nombre indica los objetos de tipo acción, los objetos menú y sus opciones de menú.

Todas las acciones se organizarán por orden alfabético.

En caso de que existan menús, se creará una subcarpeta de tipo "Acciones y menús" dentro de la cual ubicaremos el objeto menú y todas las acciones o procesos que se incluyan en dicho menú en el mismo orden en el que aparecen en el menú.

En el caso de que la carpeta una opción a disparar desde el menú general, se creará una carpeta con el nombre "Menú" de tipo "Acciones y menús" que incluirá los objetos necesarios para la ejecución de dicha opción incluyendo, en el mayoría de los casos, el control de opción ya abierta para que no se vuelva a abrir una nueva pestaña de esa opción si ya existe otra abierta. Un menú estándar utiliza 4 objetos:

El primero es una acción cuyo nombre comienza por MEN_ seguido del nombre de la tabla de origen y termina con el sufijo _TAB. Este sufijo indica que esta acción se encargará de revisar si la opción que se ejecuta ya está abierta y en ese caso no se abre una nueva pestaña central sino que se activa directamente la que ya está abierta. Esta acción ejecuta un proceso con el mismo nombre que la acción.

El segundo objeto es el proceso que se encarga de ejecutar un proceso JavaScript que revisará si esa opción ya ha sido lanzada y en caso afirmativo la activa, en caso contrario el proceso de menú se encarga de ejecutar la acción correspondiente para lanzar la opción del menú

El tercer objeto es la acción que ejecuta el formulario de menú que tendrá el prefijo estándar del nombre de la tabla de origen y el sufijo _MEN.

El cuarto objeto es el formulario de menú que tendrá el mismo identificador que la acción que lo lanza.

Recursos

En esta carpeta, como su nombre indica, se incluirán aquellos objetos de uso general, objetos reutilizables y recursos utilizables en toda la aplicación. Dentro de la carpeta Recursos del tipo "Recursos" se crearán subcarpetas para cada tipo de recurso organizándose por orden alfabético. Habitualmente nos podremos encontrar con subcarpetas de los siguientes recursos:

Constantes

Dentro de la carpeta principal Constantes de tipo "Objeto 10" se suelen incluir subcarpetas del mismo tipo para organizar las constantes en función de su uso: Errores, Mensajes, Preguntas y Textos. Cuando el número de constantes a incluir en una subcarpeta sea muy elevado crearemos subcarpetas, por ejemplo por la primera letra del identificador de la constante o por grupos de letras "De la A a la D", etc. El objetivo de crear este desglose de subcarpetas es conseguir que las constantes incluidas en una carpeta puedan verse en el editor sin tener que realizar desplazamientos verticales. Los constantes dentro de cada carpeta se organizan por orden alfabético.

Dibujos

Dentro de la carpeta de tipo "Dibujos" crearemos diferentes subcarpetas, ordenadas por nombre, para organizar los objetos dibujo de la aplicación. Una organización sencilla de hacer y que ayude a localizar los dibujos puede ser agruparlos por el uso de ellos en la interfaz como por ejemplo (Dibujos de la interfaz, iconos de botones, iconos de menús, iconos de menús contexturales de vistas, etc.). Tanto las subcarpetas como los objetos contenidos en la mismas se organizan por orden alfabético.

Funciones generales

En este carpeta de tipo "Procesos" se incluirán todas las funciones y procesos de uso general en la aplicación. Los objetos se organizan por orden alfabético.

Impresoras lógicas

En esta carpeta de tipo "Informes" incluiremos los objetos de tipo impresora lógica que se usen en informes de la aplicación. Normalmente no hay muchas así que puede ser cómodo incluirlas todas en esta carpeta aunque se usan en módulos concretos, y en el caso de que sean muchas se pueden crear subcarpeta de tipo "Informe" para organizarlas por módulos o tipos de informes. Los objetos se organizan por orden alfabético.

Menús contextuales

En esta carpeta de tipo "Menús" se incluyen subcarpetas del mismo tipo para agrupar los menús que se usarán en modo contexto de los objetos de lista, por ejemplo (Menú contextual de vista y menú contextual de vista (señales), etc.). Dentro de las subcapetas se organizan los objetos poniendo primero los objetos de tipo menú, luego los del tipo toolbar y posteriormente todos los objetos de tipo acción usados en los correspondientes menús o toolbars. El orden de los objetos dentro de cada tipo será alfabético.

Otras

En cualquier aplicación existen otros objetos de uso general que se organizarán por orden alfabético y con el tipo de carpeta que corresponda. En el caso de tenemos carpetas como: Formulario pedir datos (genérico), Importador dinámico, Utilidades y vTools.

vERP