# Variable local La Variable local definible dentro de un objeto. Se trata de una variable local al objeto en el que ha sido declarada, y solamente será accesible desde ese objeto o desde otros sub-objetos del mismo. La persistencia de este tipo de variables es en memoria. ## Propiedades ### Identificador Etiqueta alfanumérica que identifica de forma unívoca a la variable. Este identificador será el que usemos en fórmulas y para referenciarlo en otras propiedades. Constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca una variable no puede haber duplicidad. {% hint style="warning" %} Dado que en las fórmulas las variables locales no llevan una marca inicial que las identifique, su identificador nunca podrá comenzar por un número, ya que el intérprete de fórmulas tomaría ese primer carácter como un número y no como parte del identificador de una variable local. {% endhint %} {% hint style="danger" %} No podemos dar a una variable local el nombre de una [variable del sistema](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/variables-del-sistema) ya que las variables de sistema son como variables locales y sus nombres son reservados, así que no se pueden usar para nombrar variables locales propias. {% endhint %} ### Nombre Etiqueta alfanumérica que servirá como descriptor de la variable. Se usará para presentar información de la misma en objetos e inspectores. Podemos definir una etiqueta por cada idioma presente en el proyecto. ### Estilos Podemos definir el estilo siguiente: #### Privado Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo. ### Comentarios Esta propiedad nos permite documentar el uso de la variable local. ### Tipo Permite definir el tipo de dato que va a manejar la variable local. Los tipos disponibles son: #### **Alfabético** Usado para datos alfanuméricos. #### **Numérico** Usado para datos numéricos. Se mantiene la precisión numérica hasta el sexto decimal. #### **Fecha** Usado para datos de tipo fecha. Por defecto admite el formato de fecha ISO 8601. El carácter de separación puede ser el guión o la barra. #### Usado para introducir horas en formato HH:MM:SS. No almacena milisegundos. #### **Tiempo** Usado para introducir tiempos que son la unión de una fecha y una hora con el formato DD:MM:AA HH:MM:SS.sss #### **Booleano** Es un tipo lógico que permite definir el contenido como 1 ó 0 (Sí o No). {% hint style="info" %} Debemos asegurarnos de que el tipo de dato seleccionado se corresponda con el tipo de valor a almacenar. Por ejemplo, si vamos a manejar datos alfabéticos, la variable tendremos que definirla como alfabética ya que, si la definimos como numérica, al asignarle una cadena, no guardaría nada. {% endhint %} ### Array Esta propiedad nos permite hacer que la variable local sea un array unidimensional. ### Dimensiones Esta propiedad solamente estará activa cuando el valor de la propiedad [array](#array) sea **verdadero**. Nos permite declarar el número de posiciones que tendrá el array inicialmente. Este dato no es limitante. Es decir, este número es una reserva inicial de espacio, ya que posteriormente podremos añadir más posiciones a la misma. Para conocer cómo podemos leer una posición concreta de una variable local de array, consultar el capítulo de la ayuda del asistente de fórmulas dedicado a las [variables locales](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas/variables-locales). Para conocer cómo podremos añadir, insertar o eliminar ítems de una variable local de array, consultar el capítulo dedicado al grupo de comandos de instrucción de procesos de [variables](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/proceso/basicos/variables). #### Decimales Esta propiedad solamente estará activa cuando el valor de la propiedad **tipo** sea **numérico**. #### Signo Esta propiedad solamente estará activa cuando el valor de la propiedad **tipo** sea **numérico**. Define si la variable de tipo numérico tiene signo. #### Mínimo Esta propiedad solamente estará activa cuando el valor de la propiedad **tipo** sea **numérico**. Permite establecer el rango límite mínimo válido para la entrada de valores. #### Máximo Esta propiedad solamente estará activa cuando el valor de la propiedad **tipo** sea **numérico**. Permite establecer el rango límite máximo válido para la entrada de valores. ## Ámbito de las variables locales La norma general es que las variables son locales al objeto donde se definen y solamente están accesibles desde éste, aunque existan otros objetos que tengan declarados variables locales idénticas. En un formulario del mismo. Por ejemplo, podremos usar una variable local definida en el formulario en un evento de interfaz del mismo. En un formulario podemos usar controles que agrupan o contienen otros objetos. Por ejemplo, podemos incrustar una rejilla, aunque se llamen de la misma forma. De igual modo un formulario no es un subobjeto de una tabla, por lo tanto, las variables locales definidas en ambos objetos son locales a cada uno de ellos y no hay, por tanto, interacción entre ambos. ## Variables locales especiales Existe una serie de identificadores reservados para usos específicos en determinados objetos. Es lo que llamamos “variables locales especiales”. Podremos crearlas o bien manualmente en el objeto, o bien desde la opción **Variables especiales** del menú que se despliega al pulsar el botón ![](https://content.gitbook.com/content/hGRTr5J3e6YsZ6MYIEDz/blobs/h2Ls5hs3cqSZySs7c6iD/image.png) del [panel de subobjetos](https://doc.velneo.com/interfaz-de-velneo-vdevelop#id-5.-panel-de-subobjetos). Las detallamos a continuación. ### Variables locales especiales para manejadores de evento Se trata de variables locales especiales que se pueden crear en los objetos de interfaz. Estas son: #### **EVENT\_PARAMS** Permite leer las señales emitidas en los [manejadores de eventos](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) que éstas disparen. Debe ser declarada como alfabética de tipo array. En el cuadro siguiente se muestran las distintas señales y qué es lo que devuelven en cada posición del array: | Posición array-> | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | | -------------------------------- | ------------- | ------------------------------------------------------------------------ | -------------- | --------- | -------- | ------ | ------ | ------------ | ------------ | | **Señal** | Nº de comando | Dato 1 | Dato 2 | Dato 3 | Dato 4 | Dato 5 | Dato 6 | Dato 7 | Dato 8 | | Gana foco | 0 | – | – | – | – | – | – | – | – | | Pierde foco | 1 | – | – | – | – | – | – | – | – | | Tecla pulsada | 2 | [Tecla](#enum-de-codigos-de-tecla) | Shift? | Control? | Alt? | Texto | – | – | – | | Tecla soltada | 3 | [Tecla](#enum-de-codigos-de-tecla) | Shift? | Control? | Alt? | Texto | – | – | – | | Ratón: botón doble-click | 4 | Botón | Shift? | Control? | Alt? | Pos x | Pos y | Pos x global | Pos y global | | Ratón: botón pulsado | 5 | Botón | Shift? | Control? | Alt? | Pos x | Pos y | Pos x global | Pos y global | | Ratón: botón soltado | 6 | Botón | Shift? | Control? | Alt? | Pos x | Pos y | Pos x global | Pos y global | | Ratón: movimiento | 7 | Botón | Shift? | Control? | Alt? | Pos x | Pos y | Pos x global | Pos y global | | Ventana movida | 8 | Old pos x | Old pos y | Pos x | Pos y | – | – | – | – | | Ventana redimensionada | 9 | Old ancho | Old alto | New ancho | New alto | – | – | – | – | | Item: cambio de seleccionado | 10 | Pundir select | – | – | – | – | – | – | – | | Inicializado | 11 | – | – | – | – | – | – | – | – | | Timer | 12 | – | – | – | – | – | – | – | – | | Botón pulsado | 13 | – | – | – | – | – | – | – | – | | Acción disparada | 14 | – | – | – | – | – | – | – | – | | Item: activado | 15 | Index: Fila | Index: Columna | – | – | – | – | – | – | | Item: simple-click | 16 | Index: Fila | Index: Columna | – | – | – | – | – | – | | Item: doble-click | 17 | Index: Fila | Index: Columna | – | – | – | – | – | – | | Drop finalizado | 18 | – | – | – | – | – | – | – | – | | Edición iniciada | 19 | – | – | – | – | – | – | – | – | | Edición aceptada | 20 | – | – | – | – | – | – | – | – | | Edición cancelada | 21 | – | – | – | – | – | – | – | – | | ValueChanged | 22 | – | – | – | – | – | – | – | – | | Pre-inicialización | 23 | – | – | – | – | – | – | – | – | | Link clicked | 24 | Url del enlace | – | – | – | – | – | – | – | | Load started | 25 | – | – | – | – | – | – | – | – | | Load progress | 26 | % cargado | – | – | – | – | – | – | – | | Load finished | 27 | – | – | – | – | – | – | – | – | | Url changed | 28 | Nueva URL | – | – | – | – | – | – | – | | Item: pre cambio de seleccionado | 29 | – | – | – | – | – | – | – | – | | Contents changed | 30 | – | – | – | – | – | – | – | – | | On close | 31 | | | | | | | | | | On show | 32 | – | – | – | – | – | – | – | – | | On hide | 33 | – | – | – | – | – | – | – | – | | Pre edición aceptada | 34 | – | – | – | – | – | – | – | – | | Pre edición cancelada | 35 | – | – | – | – | – | – | – | – | | Vista activada | 36 | – | – | – | – | – | – | – | – | | Vista añadida | 37 | – | – | – | – | – | – | – | – | | Pre-vista cerrada | 38 | - | - | - | - | - | - | - | - | | Vista cerrada | 39 | - | - | - | - | - | - | - | - | | Lista cambiada | 40 | Tipo de cambio (ver [enum de tipos de cambio](#enum-de-tipos-de-cambio)) | | | | | | | | | Desconexión del servidor | 41 | | | | | | | | | | Reconexión al servidor | 42 | | | | | | | | | | Previo a la ejecución | 43 | | | | | | | | | | Posterior a la ejecución | 44 | | | | | | | | | | Geoposición actualizada | 45 | | | | | | | | | | Ítem: expandido | 46 | | | | | | | | | | Ítem: contraído | 47 | | | | | | | | | Podremos leer el contenido del array desde cualquier fórmula, siguiendo la siguiente sintaxis: EVENT\_PARAMS\[posición], donde el parámetro **posición** identifica la posición del array que se desee leer. Este dato podrá ser tanto una constante como una variable. Como puede verse en el esquema anterior, en un array la primera posición es la 0. Es conveniente saber que los códigos de las teclas de control y de función multiplataforma devuelven números bastante elevados que provoca un formateo de la cadena devuelta si la imprimimos, y dará la impresión de ser el mismo, aunque realmente no sea así. Si al dato devuelto le aplicamos un formato mediante el uso de la función [numberToString](https://doc.velneo.com/velneo-vdevelop/editores/asistente-de-formulas/funciones-estandar/funciones-numericas#numbertostring), si se pulsa F1 devolverá el valor 16777264, si se pulsa F2 devolverá el valor el valor 16777265 y así sucesivamente. Ver [enum de códigos de tecla](#enum-de-codigos-de-tecla) para saber el valor que devuelve cada tecla. Si queremos conocer qué columnas de una rejilla han producido una señal cuando se realiza la conexión de eventos en rejillas, podremos declarar en la rejilla las siguientes variables locales alfabéticas: #### **EVENT\_SENDER\_ID** Contiene el identificador del control (subobjeto) que envía la señal. Estará vacía si el que envía la señal es el propio objeto (la rejilla o el formulario) y no un control del mismo. Debe ser declarada como alfabética. #### **EVENT\_SENDER\_COL** Específica para columnas de rejillas, cuando son editables. Permite obtener información de la columna en la que estamos posicionados cuando se lanza la señal. Estará vacía en todos los eventos salvo los de columna editable de rejilla. Debe ser declarada como alfabética. ### Variables locales especiales para procesos Web En función de las peticiones que se hagan desde procesos de Velneo ejeuctados vía Velneo [vModApache](https://doc.velneo.com/velneo-vmodapache/que-es-velneo-vmodapache), en éstos podremos crear una serie de variables locales especiales para poder obtener información de la petición. Las variables las crearemos o no en función de lo que necesitemos obtener de la petición. Estas son: #### REQUEST\_INFO Específica para [procesos ejecutado vía Web desde Velneo vModApache](https://doc.velneo.com/velneo-vmodapache/nomenclatura-de-objetos-en-urls#procesos). Debe ser declarada como alfabética. Recoge los datos de la petición en formato JSON (url, método, cabeceras, parámetros y body), que tendrá las siguientes etiquetas: * uri: devolverá el identificador uniforme de recursos de la petición sin las variables. * unparsedUri: devolverá la uri completa sin parsear de la petición. * pathInfo: devolverá de la petición la parte correspondiente a la senda. * method: devolverá el método de la petición. * body: devolverá el cuerpo de la petición. * headers: devolverá las cabeceras de la petición. * varsGET: devolverá las variables de la petición si se ha hecho por el método *get*. #### REQUEST\_INFO\_BODY Específica para [procesos ejecutado vía Web desde Velneo vModApache](https://doc.velneo.com/velneo-vmodapache/nomenclatura-de-objetos-en-urls#procesos). Debe ser declarada como alfabética. Esta variable devolverá el cuerpo de la petición. En el caso de que lo que venga en el cuerpo sea un binario, no usaremos esta variable para procesarlo, sino la variable REQUEST\_INFO\_BODY64. #### REQUEST\_INFO\_BODY64 Específica para [procesos ejecutado vía Web desde Velneo vModApache](https://doc.velneo.com/velneo-vmodapache/nomenclatura-de-objetos-en-urls#procesos). Debe ser declarada como alfabética. Si en el proceso ejecutado vía Web lo que vamos a recibir es un binario, crearemos esta variable, en la que se recogerá dicho binario codificado en base64. #### REQUEST\_INFO\_VARSPOST Específica para [procesos ejecutado vía Web desde Velneo vModApache](https://doc.velneo.com/velneo-vmodapache/nomenclatura-de-objetos-en-urls#procesos). Debe ser declarada como alfabética. Si la petición que nos llega usa el método post, entonces podremos crear esta variable local en el proceso y recogerá, en formato JSON, la/s variable/s post de la petición. #### REQUEST\_IP Específica para [procesos ejecutado vía Web desde Velneo vModApache](https://doc.velneo.com/velneo-vmodapache/nomenclatura-de-objetos-en-urls#procesos). Debe ser declarada como alfabética. La variable devolverá la IP del cliente. ### Variables locales especiales para el objeto consumo servicio Web o para el proceso de respuesta consumo servicio web Tanto en el [objeto Consumo servicio Web ](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/consumo-servicio-web)como en el [proceso](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/consumo-servicio-web/proceso-de-respuesta-de-consumo-servicio-web) que se puede definir para obtener su respuesta, las variables locales especiales son: #### ERROR Recogerá el texto del mensaje de error. Debe ser declarada como alfabética. Esta se crea automáticamente al declarar un nuevo objeto consumo servicio Web. [Ver códigos de error](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/consumo-servicio-web/codigos-de-error-de-consumo-servicio-web). #### STATUS Recogerá el status de la llamada. Debe ser declarada como alfabética. Esta se crea automáticamente al declarar un nuevo objeto consumo servicio Web. Ver [códigos de estados HTTP](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/consumo-servicio-web/codigos-de-estados-http). #### STATUS\_TEXT Recogerá el texto del status de la llamada. Debe ser declarada como alfabética. Esta se crea automáticamente al declarar un nuevo objeto consumo servicio Web. #### REQUEST\_BODY Si el body de lo que llega en la petición es texto, se Recogerá en esta variable. Debe ser declarada como alfabética. #### REQUEST\_BODY64 Se usará esta variable cuando lo que llega en el body de la petición sea un binario. Debe ser declarada como alfabética. #### RESPONSE\_INFO Recogerá toda la información de la respuesta en formato JSON. Debe ser declarada como alfabética. Esta se crea automáticamente al declarar un nuevo objeto consumo servicio Web. #### RESPONSE\_TEXT Recogerá el texto de la respuesta a la llamada al servicio Web. Debe ser declarada como alfabética. Esta se crea automáticamente al declarar un nuevo objeto consumo servicio Web. #### RESPONSE\_64 La declararemos cuando la respuesta a la llamada al servicio Web sea un binario. Debe ser declarada como alfabética. ## **Enum de tipos de cambio** | Tipo | Valor | Descripción | | -------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | setList | 0 | Se añade una lista a la vista de datos. | | ctClear | 1 | Se limpia la vista de datos. | | ctCatchList | 2 | Capturar el contenido de la lista para usarlo en otro objeto: tomarlo de la entrada de una lista para mostrarlo en la vista de datos al recalcular o al cargar, de una cesta para usarlo, etc. | | ctAddOne | 3 | Se añade una ficha a la vista de datos. | | ctRemoveOne | 4 | Se quita una ficha de la vista de datos. | | ctSetOne | 5 | Se asignar un registro a una posición en la lista. Sólo se usa en [QML](https://doc.velneo.com/velneo-vdevelop/scripts/lenguajes/qml). | | ctReverseOrder | 6 | Se invierte el orden de la lista. | | Filter | 7 | Se filtra la vista de datos. | | Order | 8 | Se reordena la lista. | | Split | 9 | Se parte la lista. | | Cross | 10 | Se cruzan dos listas. | | Addlist | 11 | Se añade una lista a la lista en curso. | | RemoveList | 12 | Se quita una lista de la lista en curso. | | LoadMasters | 13 | Se cargan maestros. | | ctModifyOne | 14 | Se modifica una ficha. | | ctRefreshList | 15 | Se refresca la lista. | ## **Enum de códigos de tecla** | Tecla | Valor | | ------------------------ | -------- | | Barra espaciadora | 32 | | ! | 33 | | " | 34 | | # | 35 | | $ | 36 | | % | 37 | | & | 38 | | ' | 39 | | ( | 40 | | ) | 41 | | \* | 42 | | + | 43 | | , | 44 | | - | 45 | | . | 46 | | / | 47 | | 0 | 48 | | 1 | 49 | | 2 | 50 | | 3 | 51 | | 4 | 52 | | 5 | 53 | | 6 | 54 | | 7 | 55 | | 8 | 56 | | 9 | 57 | | : | 58 | | ; | 59 | | < | 60 | | = | 61 | | > | 62 | | ? | 63 | | @ | 64 | | A | 65 | | B | 66 | | C | 67 | | D | 68 | | E | 69 | | F | 70 | | G | 71 | | H | 72 | | I | 73 | | J | 74 | | K | 75 | | L | 76 | | M | 77 | | N | 78 | | O | 79 | | P | 80 | | Q | 81 | | R | 82 | | S | 83 | | T | 84 | | U | 85 | | V | 86 | | W | 87 | | X | 88 | | Y | 89 | | Z | 90 | | \\ | 92 | | ] | 93 | | \[ | 94 | | \_ | 95 | | \| | 124 | | \~ | 126 | | ¡ | 161 | | ¬ | 172 | | · | 183 | | º | 186 | | ª | 170 | | ¿ | 191 | | Ñ | 209 | | Esc | 16777216 | | Tabulador | 16777217 | | Intro | 16777220 | | Intro (teclado numérico) | 16777221 | | Insert | 16777222 | | Supr. | 16777223 | | Pausa inter. | 16777224 | | Inicio | 16777232 | | Fin | 16777233 | | Cursor izquierda | 16777234 | | Cursor arriba | 16777235 | | Cursor derecha | 16777236 | | Cursor abajo | 16777237 | | Re. Pág | 16777238 | | Av. Pág | 16777239 | | Shift | 16777248 | | Control | 16777249 | | Tecla Windows | 16777250 | | Alt | 16777251 | | Bloq. mayus. | 16777252 | | Bloq. num. | 16777253 | | Bloq. despl. | 16777254 | | F1 | 16777264 | | F2 | 16777265 | | F3 | 16777266 | | F4 | 16777267 | | F5 | 16777268 | | F6 | 16777269 | | F7 | 16777270 | | F8 | 16777271 | | F9 | 16777272 | | F10 | 16777273 | | F11 | 16777274 | | F12 | 16777275 |