Asistente de fórmulas

Asistente de fórmulas
Una fórmula es una secuencia de valores, operadores o números usados para calcular valores nuevos. Ese valor se muestra en el elemento donde se haya declarado la fórmula. En una fórmula se permiten expresiones tanto aritméticas como booleanas (lógicas).

En V7 existen multitud de lugares donde pueden declararse fórmulas, como por ejemplo contenidos iniciales de campos, en valores de propiedades de objetos y subobjetos, etc.

El asistente de fórmulas es una utilidad que nos permite especificar las fórmulas de forma asistida y verificarlas.
Siepmre que debamos especificar una fórmula, junto a control donde deba escribirse ésta, aparecerá siguiente botón: . Si lo pulsamos abriremos el asistente:

Principalmente se compone de un cuadro de edición donde se escribe la expresión de la fórmula. En este área, por medio del asistene, podremos insertar identificadores de campos, variables o constantes, símbolos y funciones a medida que se seleccionan en las diversas opciones. De igual forma puede insertar manualmente datos como paréntesis, operadores, identificadores de campos, etc.

Los botones de la barra le permiten acceder a la lista de:

Operadores.
Funciones estándar.
Funciones proceso.
Lista de campos de la tabla en curso. Esta opción estará inactiva si el objeto o sub-objeto donde etamos creando la fórmula no está asociado a una tabla.
Constantes. Esta opción estará inactiva si no se han declarado constantes en el proyecto en curso ni en los proyectos heredados.
variables globales. Esta opción estará inactiva si no se han declarado variables en los proyectos de datos heredados.
Variables locales. Esta opción estará inactiva si el objeto o sub-objeto donde etamos creando la fórmula no se han declarado variables locales.
Variables del sistema.

Para insertar un elemento (operador, campo, variable, etc.) en la fórmula, bastará con situar el cursor en la parte del editor donde queramos insertarlo y haremos doble clic sobre él.

Una vez declarada la fórmula podremos hacer una verificación de la sintaxis de la misma pulsando el botón .

Operadores
Para activar/desactivar la lista de operadores del asistente para la creación de fórmulas pulsaremos el botón del editor de fórmulas. Los operadores disponibles son:

+ Suma
- Resta
* Multiplicación
/ División
% Resto o módulo
= Igual que
! Distinto de
> Mayor que
< Menor que
& Operador Y
| Operador O

Para añadir un operador en la fórmula hacer doble clic sobre el mismo en la lista de operadores del asistente de fórmulas, o escribirlo directamente en la misma.
Funciones de fórmula
Para activar/desactivar la lista de funciones estándar del asistente para la creación de fórmulas pulsaremos el botón del editor de fórmulas.

Las funciones de fórmula son un conjunto de funciones predefinidas del Asistente para edición de fórmulas que nos permiten retornar valores usando como parámetros los elementos disponibles en el asistente: campos, variables locales variables globales, variables de sistema, constante, operadores y literales: cadenas y números, además del retorno de otras funciones.

API
Conjunto de Funciones de fórmula que hacen de uso del API de Velneo para retornar valores propios de los proyectos y objetos en tiempo de ejecución.

getProjectName
Devuelve el nombre del proyecto en curso.
Sintaxis:

getProjectName()

Parámetros: No tiene.
Devuelve una cadena con el nombre del proyecto en curso.

Ejemplo: getProjectName() = “Velneo vSalesDaybook”
getProjectVersion
Devuelve la versión del proyecto en curso.
Sintaxis:

getProjectVersion()

Parámetros: No tiene.
Devuelve una cadena con la versión del proyecto en curso.

Ejemplo: getProjectVersion() = “0.1 Beta”
getTableHandle
Devuelve el manejador o handle de la tabla en curso.
Sintaxis:

getTableHandle()

Parámetros: Ninguno.
Devuelve el manejador hexadecimal de la tabla en la que nos encontramos.

Ejemplo: getTableHandle() = 1a
Básicas
Conjunto de Funciones de fórmula básicas para la construcción de fórmulas.

choose
Devuelve un valor u otro en función de una condición.
Sintaxis:

choose(condicion, datoSi, datoNo)

Parámetros:

condicion: Condición a evaluar por la función.
datoSi: Valor retornado si la condición se cumple.
datoNoi: Valor retornado si la condición no se cumple.

Ejemplo: choose( “Velneo” = “Velneo”, “Correcto”, “Incorrecto”) = Correcto
isEmpty
Devuelve true (1) si la cadena, parametro pasado esta vacío.
Sintaxis:

isEmpty(parametro)

Parámetros:

parametro: Cadena a evaluar. Esta cadena puede ser un literal, una variable, un campo, el retorno de una función, etc.

Ejemplo: isEmpty(“Velneo”) = 1
remoteFunctionCall
Esta función permite ejecutar funciones-proceso declaradas en otro proyecto de Velneo V7. Muy útil, por tanto, para comunicar distintas aplicaciones, tanto alojadas en un mismo Velneo vServer V7 como en servidores distintos
Sintaxis:

remoteFunctionCall(idFuncion, dominioIP, idInstancia, usuario, contraseña, parametros)

Parámetros:

idFuncion: Identificador de la función a ejecutar.

dominioIP: Dominio o IP de la máquina donde está instalado el Velneo vServer V7 donde se encuentra instanciado el proyecto donde la función ha sido declarada. Debe ir precedido del esquema vatp:// y, si el puerto es distinto del 690, seguido de dos puntos (:) y el número de puerto.

idInstancia: Identificador de la instancia a la que queremos acceder. Para conocer el identificador de la instancia usaremos Velneo vAdmin V7 haciendo doble clic sobre la definición de instancia:

usuario: Nombre de un usuario declarado en Velneo vServer V7 que tenga permisos de acceso a la
instancia.

contraseña: Del usuario anterior. Si ese usuario no tiene contraseña este parámetro será resuelto con “”.

parametros: Si la función tiene declarado más de un parámetro, éstos irán separados por comas.

remoteFunctionCall(“GET_USER_SESION_NUMBER”, “vatp://localhost:85″, “GESTION”, “velneo”, “”, “carlos@gmail.com”, “ib3zax1″)
Cadenas
Conjunto de Funciones de fórmula orientadas al manejo de cadenas.

countString
Devuelve el número de veces que la cadena contiene la subcadena.
Sintaxis:

countString(cadena, subcadena)

Parámetros:

cadena: Expresión alfabética de referencia.

subcadena: Expresión alfabética a buscar en la cadena.

Ejemplo: countString(“velneo”, “e” ) = 2
fillString
Devuelve una cadena con la repetición de la que pasamos como parámetro.
Sintaxis:

fillString(cadena, nRepeticiones)

Parámetros:

cadena: Expresión alfabética a repetir.

nRepeticiones: Número de repeticiones.

Ejemplo: fillString(“*”, “4″ ) = ****

getStringRegExp
Devuelve la cadena que se corresponde con la subexpresión regular a partir de la posición indicada teniendo en cuenta si distinguimos mayúsculas y minúsculas. Para la subexpresion 0 devuelve toda cadena.
SINTAXIS:

getStringRegExp(cadena, expresionRegular, posIni, caseSensitive, numSubExpresion)

PARÁMETROS:

cadena: Expresión alfabética de referencia.
expresionRegular: Expresión regular con el texto a encontrar en la cadena.
posIni: Posición inicial de la búsqueda.
caseSensitive: 1 distingue mayúsculas y minúsculas, 0 no.
numSubExpresion: Si la expresión regular establecida en el segundo parámetro contiene varios gupos de expresiones regulares, en este parámetro podremos hacer que busque coincdencias de todas las subexpresiones (0) o de una en concreto; en cuyo caso escribiremos un valor comprendido entre 1 y el número total de subexpresiones declaradas. La primera subexpresión será la 1, la segunda la 2 y así sucesivamente.

Una expresión regular (regexp) es un patrón que sirve encontrar coincidencias de subcaednas en un texto.Esto es muy útil en varios contextos. Por ejemplo:

Validación: Una regexp puede comprobar si una subcadena cumple determinados criterios, por ejemplo, si es un número o si no contiene espacios en blanco.
Búsqueda: Una regexp facilita patrones más potentes para buscar coincidencias que una simple búsqueda de subcadena, por ejemplo, comprobar la exisstencia en una cadena de las palabras “mail”, “letter” o “correspondence” y la no existencia de las palabras “email”,”letterbox”, “mailman”, “mailer”, etc.
Buscar y reemplazar: Podremos usar esta función combinada con la función replaceString para reemplazar en una cadena todas las ocurrencias de la subcadena & por & amp; excepto cuando el & ya se encuentre seguido de la subcadena amp;.
División de cadenas: Una regexp puede ser usada para identificar dónde debería dividirse una cadena, por ejemplo, al encontrar tabulaciones en la misma.

Las expresiones regulares son construidas mediante expresiones, cuantificadores y metacaracteres. La expresión más simple es un carácter, por ejemplo: x ó 5. Una expresión también puede ser una serie de caracteres contenidos entre corchetes. [ABCD] genera una ocurrencia cuando encuentra A, B, C o D. Esta misma expresión podría ser escrita de la forma siguiente: [A-D]. La expresión para generar ocurrencias con cualquier letra del alfabeto será [A-Z].

Un cuantificador permite indicar el número de ocurrencias de una subcadena que deben darse. x{1,1} significa que debe generar solamente la ocurrencia de un carácter x. x{1,5} siginifica que debe generar solamente la ocurrencia si se da una secuencia de caracteres que contenga al menos una x pero no más de cinco.

En general las expresiones regulares no pueden ser usadas para comprobar un correcto anidamiento de corchetes o etiquetas. Por ejemplo, una expresión regular puede ser escrita para encontrar la etiqueta html de apertura y su correspondiente etiqueta de cierre si las etiquetas no están anidadas, pero si las etiquetas se encuentran anidadas, la misma expresión regular generará una ocurrencia con una etiqueta de apertura con la etiqueta de cierre equivocada. Para el texto destacadomás destacado, el primer sería emparejado con el primer , lo que no es correcto. Sin embargo, es posible escribir una expresión regular que permita generar las coincidencias de corchetes o etiquetas anidadas correctamente, pero solamente si el número de niveles de anidamiento es fijo y conocido. Si el número de niveles de anidamiento no es fijo y conocido, será imposible escribir una expresión regular que no falle.

Supongamos que queremos construir una expresión regular que gener coincidencias con números comprendidos entre 0 y 99. Al menos se requiere un dígito, así que comenzaremos con la expresión [0-9] {1,1}, que generará coincidencia con un único dígito una única vez. Esta expresión regular genera coincidencia con números comprendidos entre 0 y 9. Para genear coincidencias con números hasta 99, incrementaremos el número máximo de ocurrencias a 2, así que la expresión regular pasaría a ser [0-9] {1,2}. Esta expresión regular cumple con el requisito original de encontrar números comprendidos entre 0 y 99, pero también generará ocurrencias con números que existan en el medio de cadenas. Si queremos que el número que genere concurrencia sea la cadena completa, debemos usar los metacaracteres, ^ (acento circunflejo) y $ (dólar). Cuando ^ es el primer carácter en una expresión regular, significa que la expresión regular debe generar la ocurrencia desde el comienzo de la cadena. Cuando $ es el último carácter de la expresión regular, significa que la expresión regular debe generar coincidencia con el final de la cadena. La expresión regular, por tanto, pasaría a ser ^[0-9] {1,2}$. Los metacaracteres ^ y $ no son usados para buscar ocurrencias de ambos caracteres en la cadena, sino para indicar posiciones dentro de la cadena.

Determinados conjuntos de caraceteres y cuantificadores son tan comunes que se les han asignado símbolos especiales para su representación. [0-9] puede ser reemplazado por el símbolo \d. El cuantificador que permite especificar una única ocurrencia {1,1}, puede ser reemplazado por la expresión en sí misma, Ejemplo: x{1,1} es lo mismo que x. Para nuestro generador coincdencias de números comprendidos entre el 0 y el 99 podríamos escribirlo de la forma siguiente ^\d{1,2}$. También podría ser escrito como ^\d\d{0,1}$, por ejemplo: Desde el comienzo de la cadena, genera ocurrencia de un número, seguido inmediatamente por 0 ó 1 dígito. En la práctica, podría ser escrito como ^\d\d?$. El carácter ? es el símbolo especial que equivale a cuantificador {0,1}, por ejemplo, 0 ó 1 ocurrencias. ? hace una expresión opcional. La expresión regular ^\d\d?$ significa: Desde el comienzo de la cadena, que haya coincidencia de un número, seguido inmediatamente por 0 ó 1 dígito más y seguido inmediatamente del final de la cadena.

Para escribir una expresión regular que genere una coincidencia con las palabras “mai” o “letter” o “correspondence” pero que no genere coincidencia con palabras que contengan las palabras “email”, “mailman”, “mailer” ni “letterbox”, comenzaremos con la expresión regular que genere una coincidencia con la palabra “mail”. Expresada en su totalidad la expresión regular sería m{1,1}a{1,1}i{1,1}l{1,1}, pero ya que una expresión de carácter es automáticamente cuantificada por {1,1}, podemos simplificar la regesp escribiendo mail, es decir, una “m” seguida de una “a” seguida de una “i” seguida de una “l”. Ahora podemos usar la barra vertical |, que significa o, para incluir las otras dos palabras, así, nuestra regesp para generar coincidencia con cualquier de las tres palabras sería: mail|letter|correspondence. Genera coincidencia con “mail”, o con “letter” o con “correspondence”. Mientras esta regesp generará una coincidencia con cualquiera de las tres palabras indicadas, también generaría coincidencia con palabras con las que no queremos, por ejemplo, “email”. Para impedir que la expresión regular genere coincidencias con palabras no deseadas, debemos indicarle que la coincidencia debe darse con el comienzo y el final de una palabra,es decir, la palabra completa. En primer lugar, cerraremos nuestra expresión regular entre paréntesis (mail|letter|correspondence). Los paréntesis agrupan expresiones, e identifican una parte de la expresión regular que se desea caputrar en el parámetro numSubExpresion de esta función (recordar que si este parámetro es 0, identificará la expresión regular completa). Cerrar la expresión entre paréntesis nos permite usarla como un componente en expresiones regulares complejas. Para forzar la generación de coincidencia con la palabra completa, cerraremos la expresión regular con el metacarácter que indica límite de palabra \b: \b(mail|letter|correspondence)\b. Ahora la expresión regular significa: Genera coincidencia de una palabra, seguida de la expresión regular entre paréntesis, seguido de un límite de palabra. El metacarácter \b genera coincidencia con una posición dentro de la expresión regular, no un carácter. Un límite de palabra es cualquier carácter no de palabra,por ejemplo, espacio, nueva línea o el comienzo o el final de una cadena.

Si queremos localizar en una cadena el carácter ampersand (&) con el fin de reemplazaro con por su código equivalente en html: & amp;, la expresión regular es &. Pero esta expresión regular también generará coincidencias con ampersands que ya hayan sido reemplazados por su equivalente html. Si queremos generar coincidencia solamente con aquellos ampersands que no se encuentren seguidos de la cadena amp;, para ello necesitaremos el metacaracter de negación (?!__). La expresión regular, por tanto, podrá ser escrita: &(?!amp;).

Si queremos generar conicicencias de las palabras “Eric” y “Eirik” en una cadena, dos posibles soluciones son \b(Eric|Eirik)\b y \bEi?ri[ck]\b. El metacarácter de límite de palabra \b se necesita para evitar la generación de coincidencias, por ejemplo, con cadenas como “Erica”. Atención: La segunda expresión regular generará coincidencia con más palabras que las indicadas: “Eric”, “Erik”, “Eiric” y “Eirik”.

Caracteres y abreviaturas para conjuntos de caracteres

c: En una expresión regular cualquier carácter se representa a sí mismo, salvo si el carácter es un carácter que se usa como metacarácter o cuantificador. Así, c se corresponde con el carácter c, pero ^ no representa al carácter ^ ya que es un metacarácter que se usa identificar una posición en la cadena.
\c: Un carácter precedido de la barra de directorios (\) se corresponde con ese carácter en sí. Es decir, en una expresión regular “\c” y “c” identifican indistintamente al carácter cy la cadena \^ se corresponde con el carácter ^, no es tomado como metacarácter.
\a: Equivale al carácter ASCII de campana (BEL, 0×07).
\f: Equivale al carácter ASCII de salto de página (FF, 0×0C).
\n: Equivale al cáracter ASCII de nueva línea (LF, 0×0A, Unix newline).
\r: Equivale al cáracter ASCII de retorno de carro (CR, 0×0D).
\t: Equivale al cáracter ASCII de tabulador horizontal (HT, 0×09).
\v: Equivale al cáracter ASCII de tabulador vertical (VT, 0×0B).
\xhhhh: Equivale al carácter Unicode correspondiente al número hexadecimal hhhh (entre 0×0000 y 0xFFFF). ooo (i.e., \zero ooo) equivale al carácter ASCII/Latin-1 character que se corresponde con el número octal ooo (entre 0 y 0377).
. (dot): Equivale a cualquier carácter (incluido nueva línea).
\d: Equivale a un dígito.
\D: Equivale a un no-dígito.
\s: Equivale a un espacio en blanco.
\S: Equivale a un no-espacio en blanco.
\w: Equivale a un carácter (dígito o letra).
\W: Equivale a un no-carácter (espacio en blanco, fin de línea, etc.).

NOTA: Si en un expresión regular queremos incluir el carácter \ como carácter, tendremos que escrbirlo dos veces: \\.

Conjuntos de caracteres

Los corchetes implican generar coincidencia con cualquier carácter contenido entre ellos. Las abreviaturas de conjuntos de caracteres descritas anteriormente pueden aparecer en un conjunto de caracteres entre corchetes. Los cracteres no tienen ningún significado especial cuando van entre corchetes, excepto en los casos sigiuentes:

^: El acento circunflejo niega el conjunto de caracteres cuando es el primer carácter (por ejemplo, inmediatamente después del corchete de apertura). [abc] genera ocurrencia con cualquier carácter “a” o “b” o “c” de la cadena, pero [^abc] generará una ocurrencia con cualquier carácter distitno de “a”, “b” o “c”.
-: El guión indica un rango de caracteres. [W-Z] generará una ocurrencia con cualquier carácter comprendido entre la “W” y la “Z”; es decir, con “W” o “X” o “Y” o “Z”.

Cuantificadores

Por defecto, una expresión regular es automáticamente cuantificada como {1,1}, es decir, solamente podría generar una única ocurrencia. En la lista que presentamos a continuación, E significa “expresión”. Una expresión es un carácter, o una abreviatura de conjunto de caracteres, o un conjunto de caracteres entre corchetes, o una expresión entre paréntesis.

E?: Genera cero o una ocurrencias de E. Este cuantificador significa “la expresión anterior es opcional”, ya que generará ocurrencia tanto si encuentra la expresión en la cadena como si no. E? es lo mismo que E{0,1}. Ejemplo: dientes? generará concidencia con “diente” o “dientes”.
E+: Genera cero o más ocurrencias de E. E+ es lo mismo que E{1,}. Ejemplo: 0+ generará concidencia con “0″, “00″, “000″, etc.
E*: Genera cero o más ocurrencias de E. E* es lo mismo que E{0,}. El cuantificador * suele ser usado equivocadamente cuando debería usarse +. Ejemplo: Si \s*$ es usado en una expresión para generar ocurrencias con cadenas que terminen con un espacio en blanco, generaría ocurrencia con cualquier cadena porque \s*$ quiere decir “Genera ocurrencia con cero o más espacios en blanco seguidos de un final de cadena”. La expresión regular correcta para generar ocurrencia con cadenas que tengan al menos un espacio en blanco al final es \s+$.
E{n}: Genera n ocurrencias exactas de E. E{n} es lo mismo que repetir E n veces. Ejemplo: x{5} es lo mismo que xxxxx. Es también lo mismo que x{5,5}.
E{n,}: Genera ocurrencias de al menos n ocurrencias de E.
E{,m}: Genera ocurrencias de como mucho n ocurrencias de E. E{,m} es lo mismo que E{0,m}
E{n,m}: Genera ocurrencias desde n ocurrencias de E hasta m ocurrencias de E.

Para aplicar un cuantificador a más que simplemente al caracter previo, utilizaremos paréntesis para agrupar los caracteres en una expresión. Por ejemplo, tag+ genera ocurrencia de una “t” seguida de una “a” seguida de al menos una “g”, mientras que (tag)+ generará al menos una ocurrencia de “tag”.

NOTA: Los cuantificadores son “avariciosos”. Siempre generan ocurrencia con tanto texto como les sea posible. Por ejemplo, 0+ generará ocurrencia con el primer 0 que encuentre pero también con los siguientes ceros consecutivos después del primero. Aplicado a 2005generará coincidencia con 20005.

Metacaracteres

Los metacaracteres permiten declarar posiciones dentro del texto en el punto en el que ocurran en la expresión regular, pero no generan coincidencia con carácter alguno. En la siguiente lista E equivale a cualquier expresión:

^: El acento circunflejo indica comienzo de la cadena. Si en una expresión regular quisiésemos usar el acento circunflejo ^ como carácter y no como metacarácter tendríamos que escribirlo precedido por el carácter de escape: \\^. Por ejemplo ^#include solamente generará ocurrencia con cadenas que comiencen con los caractres “#incluide”. Cuando el acento circunflejo es el primer carácter de un grupo de caracteres, recordemos que tiene un significado especial (ver el apartado dedicado a los conjuntos de caracteres de este mismo capítulo).
$: El dólar indica fin de cadena. Por ejemplo \d\s*$ generará ocurrencia con cadenas que finalicen con un número opcionalmente seguido en un espacio en blanco. Si quisiésemos comprobar ocurrencias del literal $, tendríamos que escribirlo precedido por el carácter de escape: \\$
\b: Límite de palabra. Por ejeplo, la expresión regular \bOK\b significa generar ocurrencia de la letra “O” seguida de la letra “K”, tras un límite de palabra (por ejemplo, el comienzo de la cadena o un espacio en blanco). Destacar que este metacarácter no genera ocurrencia con ningún espacio en blanco, por lo que si escribimos (\bOK\b) y encontramos una ocurrencia, ésta será de la cadena OK, incliuso si la cadena es “Todo está OK ahora”.
\B: No-límite de palabra. Este metacarácter es el contrario a \b. Por ejemplo, si buscamos \Bno\B en la cadena “Esto no” no se generaría ocurrencia alguna (el espacio y el finla de la cadena no son no-límites de palabra), si generaría coincidencia en “tonos”.
(?=E): Aserción. Este metacarácter es verdadero cuando la expresión genere coincidencia en este punto en la expresión regular. Por ejemplo, const(?=\s+char) genera ocurrencia con “const” siempre que vaya seguido por “char” como por ejemplo en “static const char *”. const\s+char, aplicado sobre la cadena “static const char *” generará coincidencia con “const char”.
\B: No-límite de palabra. Este metacarácter es el contrario a \b. Por ejemplo, si buscamos \Bno\B en la cadena “Esto no” no se generaría ocurrencia alguna (el espacio y el finla de la cadena no son no-límites de palabra), si generaría coincidencia en “tonos”.
(?!E): Negación. Este metacarácter es verdadero cuando la expresión genere coincidencia en este punto en la expresión regular. Por ejemplo, const(?!\s+char) genera ocurrencia con “const” excepto cuando vaya seguido por la cadena “char”.

Uso del parámetro numSubExpresion de la función getStringRegExp

Como hemos explicado anteriormente, podemos agrupar distintas subexpresiones de una expresión regular simplemente cerrándolas entre paréntesis. Si en la expresión regular escribimos (a)|(b)|(c) y el parámetro numSubExpresion de esta función es 0, se buscarán coincidencias de las tres subexpresiones, es decir, de “a”, “b” o “c” en la cadena. Si quisiésemos que solamente se buscasen coincdencias de una de ellas, por ejemplo b, sin tener que modificar la expresión regular, bastará con escribir en el parámetro numSubExpresion de esta función en valor 2 que se corresponde con el número de subexpresión declarado; (a) sería 1 y (c) sería 3.

Ejemplos:

getStringRegExp(“Hay 1235 personas”, “\d{1,3}”, 0, 0, 0) = 123
getStringRegExp(“abcd”, “(a)(b)(c)(d)”, 0, 0, 0) = abcd
getStringRegExp(“( 2 * 4 = 8 )”, “[0-9]“, 0, 0, 0) = 2
getStringRegExp(“( 2 * 4 = 8 )”, “^[0-9]“, 0, 0, 0) = No generará ocurrencia peus el primer carácter de la cadena no es un número.
indexOfRegExp
Devuelve la posición de la cadena en la que encontramos la expresión regular a partir de la posición indicada teniendo en cuenta si distinguimos o no entre mayúsculas y minúsculas.
Devolverá -1 si no la encuentra.
Sintaxis:

indexOfRegExp(cadena, expresionRegular, posIni, caseSensitive)