Documentación de Velneo
30
30
  • Introducción
  • Velneo
    • Requerimientos de Velneo
    • Notas de la versión
    • Funcionalidades comunes a los componentes de Velneo
      • Instalación
      • 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
      • Certificado de firma digital para componentes de Windows
    • Tipos de archivo generados por Velneo
    • Velneo Web
      • Plataformas y navegadores compatibles
      • Acceso a recursos del sistema
      • Siempre https
      • Funcionamiento de vatp por websocket
      • CORS para llamadas xmlhttprequest
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Identificación de usuario
    • Interfaz de Velneo vDevelop
      • Menú Soluciones
      • Menú Proyectos
      • Menú Objetos
      • Menú Scripts
      • Menú Edición
      • Menú Ver
      • Menú Componentes
      • Menú Ayuda
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Inspectores
    • Proyectos objetos y editores
      • Proyecto de datos
      • Proyecto de aplicación
        • Crear CSS para aplicar a objetos en edición
      • Objeto
        • Refactorización automátca
      • Objetos de proyecto de datos
        • Indice complejo
        • Tabla
          • Actualización
          • Campo
          • Enlace
          • Indice
          • Plural
          • Traspaso de campo
          • Trigger
        • Tabla estática
        • Variable
      • Objetos de proyecto de aplicación
        • Acción
        • Alternador de lista
        • Arbol visor de tablas
        • Bloc de formularios
        • Casillero
        • Cesta
        • ComboView
        • Control SVG
        • Dispositivo serie
        • 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
            • Caja de texto
            • Caja de texto enriquecido
            • Data catcher edit
            • Edición alfabética
            • Edición fecha
            • Edición fecha/hora
            • Edición fórmula
            • Edición hora
            • Edición numérica
            • Edición senda fichero
            • Edición senda directorio
            • Objeto dibujo
          • Controles de entrada
            • Botón
            • Botón de check
            • Botón de radio
            • Calendario
            • ComboBox
            • Deslizador
            • Dial
            • ListBox
            • Rueda
          • Contenedores
            • Área de scroll
            • Caja de formularios
            • Pila de formularios
            • Separador de formularios
            • Splitter
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Extensión de ficha
        • Formulario QML
        • Gráfico
        • Imagen SVG
        • Impresora lógica
        • Informe
          • Editor de informes
          • Agrupamiento
          • Sección
          • 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
          • Impresión de gráficos
          • Opciones html
        • ListView
        • Lista QML
        • Localizador
        • Marco
        • Menú
        • Multivista
        • Protocolo TCP-IP
        • Reemplazo
        • Rejilla
          • Propiedades de columna de rejilla
        • Rejilla avanzada
          • Propiedades de columna de rejilla avanzada
        • Toolbar
        • ViewFlow
        • Sub-objetos de vistas de datos
          • Conexión de evento
          • Drop
          • Inserción
          • Manejador de evento
      • Objetos comunes a proyecto de datos y de aplicación
        • Búsqueda
        • Cola
        • Constante
        • Dibujo
        • Esquema de tablas
        • Fichero adjunto
        • Función
        • Librería externa
        • Lupa
        • Proceso
          • Indice de comandos de instrucción de 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
            • GPS
            • Internet
            • Protocolo TCP
            • Puerto serie
            • SDV
          • Interfaz
            • Acciones (comandos)
            • Control
              • Ejemplo de CSS
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Tubo de ficha
        • Tubo de lista
        • Variable local
      • Editores
        • 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 JSON
            • 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
          • Funciones de campo
          • 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
          • Composición de sendas en fórmulas
          • Operar con datos de tipo fecha, hora y tiempo
        • Editor de imágenes
        • Selector de fuentes
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
              • VApp: enumeraciones
              • VApp: ejemplos
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClipboard
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataView
            • VDataViewDialog
            • VDateEdit
            • VDateEditBrowser
            • VDateTimeEdit
            • VDateTimeEditBrowser
            • VDial
            • VDir
              • VDir: enumeraciones
            • VExtension
              • VExtension: enumeraciones
            • VFile
              • VFile: enumeraciones
            • VFileInfo
            • VFilePathEditBrowser
            • VFinder
            • VFont
              • VFont: enumeraciones
            • VFormBlockListDataView
            • VFormDataView
            • VFormulaEditBrowser
            • VGaugeWidget
            • VGPS
            • VGridListDataView
            • VGroupBox
            • VImage
            • VImageEdit
            • VImageWidget
            • VInstancesList
            • VInstance
            • VInstances
            • VItemRegisterPattern
            • VLabel
            • VLineEdit
            • VLineEditBrowser
            • VListBox
            • VListDataView
            • VLogin
            • VMainWindow
              • VMainWindow: enumeraciones
            • VMdiView
            • VMimeData
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
              • VObjectInfo: enumeraciones
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VScrollArea
            • VServerAdmin
            • VSettings
            • VSlider
            • VSlotListDataView
            • VSolutionInfo
            • VSplitter
            • VSqlDatabase
            • VSSLCertificate
            • VSSLInfo
            • VSSLSessionCipher
            • VStackedWidget
            • VSvgButton
            • VSvgSlideSwitch
            • VSvgToggleSwitch
            • VSvgWidget
            • VSysInfo
              • VSysInfo: enumeraciones
            • VTableInfo
              • VTableInfo: enumeraciones
            • 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
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
      • Monitor de vClient
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Proyectos
        • Organización de carpetas
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Identificadores
        • Teclas aceleradoras
        • Documenta
        • 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
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Base de datos
          • Campos
          • Indices
          • Actualizaciones
          • Eventos de tabla o triggers
          • Variables globales y constantes
          • 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
          • 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?
        • Procesos y funciones y eventos
          • 1º, 2º, 3º y 4º 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
        • Carga de registros en objetos de lista
          • Rejillas
            • Campos punteros a singular
            • Totales
            • Condiciones de activo, visible y color en columna
            • Campos de tipo objeto
        • Conoce los límites
      • Imágenes
      • Buenas prácticas para el desarrollo en equipo
      • Modo mantenimiento
    • Análisis de bases de datos para aplicaciones de Velneo
      • Un centro de enseñanza
      • Facturas de un cliente
      • Repartos de obras de teatro
      • Galería de arte
      • Gestión de un colegio
      • Instalación de lunas para vehículos
      • Libros y autores
      • Tienda de discos
      • Últimos pedidos de un proveedor
      • Existencias por almacén y precios por cliente
      • Generación de tickets para un quiosco
      • Navegación por facturas
  • Velneo vDevelop Web
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
      • Lista de comandos
    • Tareas
    • Acceso directo
    • Velneo vAdmin Web
  • 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
        • Submenú de filtros
      • Uso de la rejilla avanzada
      • Manejo de cestas
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Edición de campos de tipo fecha
      • Capturar imagen desde una cámara
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Ordenación de listas
  • 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 y detener Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Multi-hilo
      • Integridad referencial
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
    • Mensajes de log de sistema
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstallBuilder?
    • 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
    • Caché local de Velneo vModApache
  • Velneo vDataClient
    • ¿Qué es Velneo vDataClient?
    • Iniciar Velneo vDataClient
    • Interfaz de Velneo vDataClient
    • Procesos
    • Utilidades
    • Acceso directo a una instancia de datos
    • Velneo vDataClient Web
  • 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 de la ApiRest
    • Novedades de la versión
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de cestas
      • Tutor de formularios
      • Tutor de informes
      • Tutor de localizador básico
      • Tutor de marcos
      • Tutor de rejillas
      • Tutor de rejillas avanzadas
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de comboview
      • Tutor de drag and drop
      • Tutor de eventos
      • Tutor de tablas de extensión y extensiones de ficha
      • Tutor de tubos de ficha y de lista
      • Tutor de grabación de fichas
      • Tutor de gráficos
      • Tutor de impresión de informes
      • Tutor de lupas
      • Tutor de protocolo TCP/IP
      • Tutor de reemplazo
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de visor html dinámico
      • Tutor de vistas de datos de lista
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de cambio de marco
      • Tutor de comandos de interfaz y acciones
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de portapapeles
      • Tutor de procesos
      • Tutor de SDV
    • Tutores de scripts
      • QML: hola mundo
      • QML: tutor básico
      • QML: tutor de vistas
      • Tutor de XMLHttpRequest (webServices)
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Panel de control vServer cloud
      • URC
      • vServer
      • Apache
      • SFTP
      • Usuarios
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • Dominios de empresa y certificados
    • Velneo vModApache en cloud
    • SLA
    • Hora de los servidores en el cloud de Velneo
    • ¿Qué puedo hacer si tengo una incidencia en mi servidor cloud?
Con tecnología de GitBook
En esta página
  • Añadir ficha al objeto
  • Añadir lista al objeto
  • Crear manejador de objeto
  • Disparar objeto
  • Get ítem array de variable local de objeto
  • Get variable local de objeto
  • Set ítem array de variable local del objeto
  • Set variable local del objeto

¿Te fue útil?

  1. Velneo vDevelop
  2. Proyectos objetos y editores
  3. Objetos comunes a proyecto de datos y de aplicación
  4. Proceso
  5. Interfaz

Objeto - grupo de comandos

Última actualización hace 4 años

¿Te fue útil?

Se trata de un conjunto de comandos que nos permiten manipular objetos de interfaz, tanto de ficha como de lista, de un etc.

Añadir ficha al objeto

Comando de instrucción que añade la ficha en curso a un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: ficha de la tabla en curso.

Destino del subproceso: ninguno.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción

Funcionalidad

Permite añadir un registro.

El objeto tendrá que ser uno que maneje registros, como por ejemplo, un formulario.

Comentarios

El objeto tendrá que haber sido instanciado con anterioridad dentro del mismo proceso y el registro tendrá que ser de la misma tabla asociada al objeto.

Este comando lee el contenido que tiene la ficha en disco y sustituye lo que se tenga en memoria en el objeto al que se añada la ficha.

Por lo tanto, si queremos añadir una ficha creada en el mismo proceso, habría que guardarla en disco previamente antes de añadirla al objeto.

Ejemplo

Editamos el artículo con ID = 1 habiendo añadido previamente la ficha al manejador de objetos.

Crear manejador de objeto ( manejador_formulario, Formulario ARTICULO@ejemplo )
Cargar lista ( ARTICULOS@ejemplo, ID, 1, , ,  )
    Seleccionar ficha por posición ( 1 )
    Leer ficha seleccionada
        Añadir ficha al objeto ( manejador_formulario )
Disparar objeto ( manejador_formulario, No aplicable,  )
    Libre

Añadir lista al objeto

Comando de instrucción que añade la lista de registros en curso a un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: lista de la tabla en curso.

Destino del subproceso: ninguno.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción Crear manejador de objeto.

Funcionalidad

Permite añadir una lista de registros registro.

El objeto tendrá que ser uno que maneje registros, como por ejemplo, una rejilla.

Comentarios

El objeto tendrá que haber sido instanciado con anterioridad dentro del mismo proceso y la lista de registros tendrá que ser de la misma tabla asociada al objeto.

Ejemplo

Cargamos la lista de clientes añadiendo los registros a un manejador de objetos de tipo informe que es disparado..

Crear manejador de objeto ( informe_clientes, Informe INFORME_CLIENTES@ejemplo )
Cargar lista ( CLIENTES@ejemplo, ID, , , ,  )
    Añadir lista al objeto ( informe_clientes )
Rem ( Disparamos el informe de clientes )
Disparar objeto ( informe_clientes, No aplicable,  )
    Libre

Crear manejador de objeto

Comando de instrucción que genera un manejador del objeto que seleccionemos en sus parámetros. El resto de los comandos de objeto han de usar este manejador como referencia para la acción que realizan.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Manejador de objeto

Etiqueta alfanumérica que servirá para referenciar el objeto en el resto de los comandos de objeto que vayan a hacer uso del mismo.

Identificador de objeto

Objeto que se desea manipular. Se desplegará una lista de todos los objetos disponibles, agrupados por tipo. Seleccionaremos el deseado.

Modo de visualización

Diálogo: el objeto será abierto como cuadro de diálogo.

Vista: el objeto será abierto en modo vista.

A tener en cuenta:

En modo diálogo, para la interfaz y el proceso queda a la espera de que el usuario cierre el objeto para continuar.

En modo vista no para la interfaz y el proceso continúa su ejecución, no espera a que el objeto sea cerrado.

Título

Funcionalidad

Genera un manejador del objeto que seleccionemos en sus parámetro para su posterior manipulación dentro del proceso. El resto de los comandos de objeto han de usar este manejador como referencia para la acción que realizan.

Comentarios

Es posible instanciar un mismo objeto varias veces en un mismo proceso, o manejar distintos objetos al mismo tiempo.

El objeto no tendrá referencia alguna a registros, hasta que se los asignemos con el comando adecuado.

En un mismo proceso, no debemos crear varios objetos con el mismo manejador, ya que precisamente el manejador o handler es el que identifica al objeto por lo que, si tenemos manejadores duplicados, el sistema no podrá saber a cuál de los objetos ha de hacer referencia.

Ejemplo

Creamos un manejador de objetos del objeto Búsqueda ARTICULOS.

Crear manejador de objeto ( busqueda_articulos, Búsqueda ARTICULOS@ejemplo )

Disparar objeto

Comando de instrucción que permite hacer uso de un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: cualquiera.

Destino del subproceso: ficha/Lista de la tabla asociada al objeto o Ninguno, depende de si el objeto tiene o no salida.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción Crear manejador de objeto.

Modo de ejecución

En este parámetros especificaremos dónde y de qué modo va a ser disparado el objeto. Los valores posibles son:

1º plano: local

El objeto es disparado de forma local, bien sea en el cliente, bien sea en el servidor, y devuelve un retorno por el que espera el proceso. Por tanto, este parámetro es bloqueante del proceso llamador hasta que éste haya finalizado.

3º plano: servidor

El objeto es disparado en el servidor y devuelve un retorno por el que espera el proceso. Por tanto, este parámetro es bloqueante del proceso llamador hasta que la ejecución del objeto haya finalizado. Dado que el objeto será disparado en el servidor no podremos disparar objetos de interfaz en los que deba intervenir el usuario, como por ejemplo, formularios, pues éstos serían presentados en el servidor, no en el cliente.

4º plano: servidor (no espera retorno)

Identificador de variable local booleana de retorno de ok

Variable local.

Funcionalidad

Permite hacer uso de un objeto instanciado previamente en el mismo proceso por medio del comando de instrucción Crear manejador de objeto y atrapar su retorno. Pudiendo disparar el objeto tanto en local como en el servidor.

Comentarios

Este comando genera un subproceso cuyo origen será la salida del objeto disparado. Dicho subproceso solamente será ejecutado si el objeto disparado tiene salida.

Este comando no admite la ejecución de procesos en segundo plano (multitarea), ya que se trata de un comando de interfaz. Sí permite disparar los procesos en tercer o cuarto plano.

Si el objeto a disparar es un objeto de lista como, por ejemplo, una rejilla, al hacer sobre ella doble clic o intro se mostrará el formulario de modificación del ítem seleccionado y se cerrará la rejilla.

Cuando se utilizan los manejadores de objetos, si no tienen transacción a heredar, crean una transacción nueva independiente, sin embargo, si tienen una transacción a heredar incluyen sus operaciones en dicha transacción.

Por lo tanto, Si queremos forzar que diferentes procesos lanzados a través del manejador de objetos queden agrupadas en una sola transacción tan sólo hay que ejecutar el comando “Forzar transacción” antes de ejecutar los comandos “Disparar objeto”.

Debemos tener en cuenta que, si disparamos un proceso en tercer plano y una instrucción del mismo dura más de 10 minutos, hará que el proceso no pueda reportar al llamador que continúa ejecutándose, por lo que de desenganchará y se deshará.

Ejemplo

Creamos un manejador de objetos del objeto Búsqueda ARTICULOS, disparando el objeto y llevando los registros que nos devuelve la búsqueda a la salida.

Crear manejador de objeto ( busqueda_articulos, Búsqueda ARTICULOS@ejemplo )
Disparar objeto ( busqueda_articulos, No aplicable,  )
    Añadir lista a la salida

Get ítem array de variable local de objeto

Comando de instrucción que permite obtener el valor de un ítem de una variable local de tipo array declarada en un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción Crear manejador de objeto.

Identificador de la variable local del objeto

En este parámetro se desplegará una lista que contendrá todas las variables locales del objeto que sean de tipo array; seleccionaremos la deseada.

Fórmula de posición

Posición del array donde está el item. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.

Identificador de variable local de retorno

En este parámetro se declara una variable que retornará el valor del ítem leído del array.

Funcionalidad

Esta instrucción permite leer el valor de una posición variable local.

Comentarios

El objeto tendrá que haber sido instanciado con anterioridad a la lectura de sus variables, dentro del mismo proceso.

Ejemplo

Ejecutamos un proceso obtenido de él el valor de la posición 1 del array MAT_CONFIG guardando su valor en la variable local CONFIGURACION par mostrarla con un mensaje.

Crear manejador de objeto ( proceso_configuracion, Proceso PRO_CONFIG@ejemplo )
Disparar objeto ( proceso_configuracion, 1º plano: local (síncrono),  )
    Libre
Get ítem de variable local array de objeto ( proceso_configuracion, MAT_CONFIG, 1, CONFIGURACION )
Mensaje ( "Valor de la variable de configuración: " + CONFIGURACION, Información, ,  )

Get variable local de objeto

Comando de instrucción que permite obtener el valor de una variable local declarada en un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción Crear manejador de objeto.

Identificador de la variable local del objeto

En este parámetro se desplegará una lista que contendrá todas las variables locales del objeto; seleccionaremos aquella cuyo valor queramos obtener.

Identificador de variable local de retorno

En este parámetro se seleccionará o se creará la variable local del proceso donde se retornará el dato leído.

Funcionalidad

Este comando de instrucción permite leer el valor de una variable local.

Comentarios

El objeto tendrá que haber sido instanciado con anterioridad a la lectura de sus variables, dentro del mismo proceso.

Ejemplo

Ejecutamos un proceso en tercer plano que nos devolverá en la variable ESTA_FACTURADO el resultado de la ejecución del proceso de facturación.

Crear manejador de objeto ( proceso_facturacion, Proceso PRO_FACTU@ejemplo )
Disparar objeto ( proceso_facturacion, 3º plano: Servidor (síncrono),  )
    Libre
Get variable local de objeto ( proceso_facturacion, FACTURADO, ESTA_FACTURADO )
If ( ESTA_FACTURADO = 0 )
    Mensaje ( "El proceso de facturación no se ha realizado correctamente", Información, ,  )

Set ítem array de variable local del objeto

Comando de instrucción que permite asignar un valor a un ítem de una variable local de tipo array declarada en un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción Crear manejador de objeto.

Identificador de la variable local del objeto

En este parámetro se desplegará una lista que contendrá todas las variables locales del objeto que sean de tipo array; seleccionaremos la deseada.

Fórmula de posición

Posición del array donde está el item. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.

Fórmula de dato (opcional)

Valor a establecer al item indicado en el parámetro anterior. En este parámetro podrá especificar tanto una constante como una expresión fórmula.

Funcionalidad

Esta instrucción permite asignar valor a un item de una variable local.

Comentarios

El objeto tendrá que haber sido instanciado con anterioridad a la lectura de sus variables, dentro del mismo proceso.

Ejemplo

Disparamos el proceso creado en el manejador de objeto proceso_facturación asignando un valor al ítem 1 al array declarado.

Crear manejador de objeto ( proceso_configuracion, Proceso PRO_FACTU@ejemplo )
Set ítem de variable local array de objeto ( proceso_configuracion, MAT_CONFIG, 1, "VALOR=EJECUTAR" )
Disparar objeto ( proceso_configuracion, 1º plano: servidor (síncrono), OK )
    Libre

Set variable local del objeto

Comando de instrucción que permite obtener el valor de una una variable local declarada en un objeto instanciado previamente en el mismo proceso.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

Manejador del objeto

Identificador o manejador dado al objeto previamente en el proceso por medio del comando de instrucción Crear manejador de objeto.

Identificador de la variable local del objeto

En este parámetro se desplegará una lista que contendrá todas las variables locales del objeto; seleccionaremos aquella cuyo valor queramos modificar.

Fórmula de dato

En este parámetro se establecerá, por medio de una fórmula, el valor de la variable. Para facilitar su escritura podemos hacer uso del asistente para la edición de fórmulas.

Funcionalidad

Este comando de instrucción permite asignar un valor a una variable local.

Comentarios

El objeto tendrá que haber sido instanciado con anterioridad a la modificación de sus variables, dentro del mismo proceso.

En procesos ejecutados en 3er planoDocumentar como funciona en ambos casos.

Si disparamos un proceso en tercer plano y en éste se ejecuta el comando set retorno proceso NO.

En caso de proceso en tercer o cuarto plano, cuando hay un set retorno no, la información no viaja.

Entre otras cosas además el cliente no espera información ya que puede ser simplemente que el proceso no se ha podido ejecutar.

La opción es no retornar no y retornar una variable indicando el error.

Ejemplo

Creamos un manejador de objeto de un objeto búsqueda para que nos retorne los registros encontrados llevando el resultado a la salida. En el objeto búsqueda hay un índice que nos devolverá los registros dependiendo del valor de la variable TXT_BUS.

Crear manejador de objeto ( bus, Búsqueda PERS_TIP_REL_M@ejemplo )
Set variable local de objeto ( bus, TXT_BUS, TXT_BUS )
Disparar objeto ( bus, No aplicable,  )
    Añadir lista a la salida

Propiedad específica para objetos de interfaz de ficha o de lista (, , etc.) que nos permite configurar el modo en el que se visualizará el objeto. Los valores posibles son:

Si se trata de un formulario en modo vista y éste tiene activado el , respeta su comportamiento.

En modo vista soporta el comando pero no el comando . Esto es debido a que en modo vista el proceso abre el objeto y continúa su ejecución, no espera a que sea cerrado.

Propiedad específica para objetos de interfaz de ficha o de lista (, , etc.) que nos permite especificar un título a la ventana que contendrá el objeto.

Cuando creamos un objeto de ficha con este comando de instrucción se crea una ficha nueva y se rellenan sus contenidos iniciales, por lo que cuando usamos el comando la ficha está ya creada previamente por el otro comando y ya dispone de los valores inicializados en los contenidos iniciales.

Solamente podremos disparar en tercer plano objetos de tipo y .

Solamente válido para ejecutar . El subproceso será ejecutando en el servidor y su ejecución será paralela a la del proceso principal pues éste no esperará a que el subproceso finalice. Los procesos disparados en 4º plano son ejecutados en una cola de forma secuencial.

Para la ejecución de procesos en segundo plano debemos usar el comando

Si disparamos un proceso en tercer plano y en dicho proceso se usa el comando , no se retornará el valor de ninguna variable (en primer plano sí). En el caso de la ejecución en tercer plano, lo que podemos hacer es sustituir el por otra variable local, a la que asignaremos un 1 o un 0 y en el proceso llamador leer el valor de dicha variable.

formulario
rejilla
formulario
rejilla
proceso
búsqueda
procesos
Ejecutar proceso.
proyecto de aplicación,
Crear manejador de objeto.
set variable local del objeto
get variables local de objeto
Disparar objeto,
set retorno proceso = NO
set retorno proceso = NO
estilo vista única