El asistente está presente en todos los controles de edición donde se permite emplear fórmulas, de manera que al pulsar el botón Asistente aparecerá

06 Asistentes 06 6.1 Asistentes Asistente para edición de fórmulas Las fórmulas pueden utilizarse en cualquier cuadro de edición que permita introducir expresiones de tipo fórmula. Normalmente haremos uso del Asistente para edición de fórmulas, disponible en el botón Asistente, aunque también podemos introducirlas manualmente. Se aconseja el uso del asistente ya que detecta errores. El asistente está presente en todos los controles de edición donde se permite emplear fórmulas, de manera que al pulsar el botón Asistente aparecerá la ventana: ASISTENTE PARA EDICIÓN DE FÓRMULAS La parte principal es un cuadro de edición donde escribimos la expresión de la fórmula. En este área del asistente insertaremos identificadores, símbolos y funciones a medida que los seleccionamos en las diversas opciones. De igual forma podemos insertar manualmente datos como paréntesis, operadores, campos, etc. Los botones de la barra permiten acceder a una lista de: Operadores (F3). Operadores Funciones (F4). Funciones Funciones de dll. Funciones de dll Funciones (objeto visual). Funciones (objeto visual) 408 409 Campos Variables Globales VELAZQUEZ VISUAL Campos (F5). Variables Globales (F6). Variables Locales Variables Locales (F7). Variables del Sistema Cortar, Copiar y Pegar Variables del Sistema (F8). Deshacer Deshacer (Control + Z). Verificar Ayuda Aceptar Cortar (Control + X), Copiar (Control + C) y Pegar (Control + V). Verificar (F9): este botón comprueba que la sintaxis de la fórmula sea correcta. En caso contrario presentará una ventana con el error cometido. También se verifica al aceptar la fórmula con el botón OK o al pulsar intro. Ayuda (F1). Cancelar Aceptar (Intro): guarda los cambios realizados en la fórmula. Operadores Cancelar (Esc): cancela los cambios llevados a cabo en la fórmula. 6.1.1. Sintaxis de las fórmulas. Operadores y funciones En una fórmula se permiten expresiones tanto aritméticas (suma, resta, división...) como booleanas (lógicas). Disponemos de una lista de operadores, funciones, accesos a los campos de la tabla de datos en curso y a sus maestros, acceso a las variables globales del proyecto, a las variables locales y a las variables del sistema para poder crear las fórmulas. Operadores Pulsando el botón operadores aparecerá en pantalla un asistente en el que podremos seleccionar el operador necesario de entre los siguientes: OPERADORES Expresiones aritméticas: por ejemplo ((4 + 5 + 1) / 2) - (45 / 8). Aquí se han usado constantes, pero podemos operar con campos y variables globales, además de otras funciones. Expresiones condicionales: 06 4>2 condición cierta. 4 < (2+2) condición falsa. 4 = (2+2) condición cierta. 4!3 condición cierta Asistentes Expresiones booleanas (lógicas): (4 > 1) & (4 = 5) En el ejemplo anterior, la primera condición (4>1) es cierta, pero la segunda (4=5) no lo es. El operador & es verdadero si sus condiciones (izquierda y derecha) también lo son, por lo tanto, la condición en su conjunto es falsa. (4 > 1) | (4 = 5) En el ejemplo anterior la primera condición (4>1) es cierta pero la segunda (4=5) no lo es. El operador | (ó) es verdadero si una de sus condiciones (izquierda y derecha) lo es, por lo tanto, la condición en su conjunto es cierta. Expresiones unarias - X: la expresión devuelve el valor negativo de la variable X. !X: indica NO X. Se trata de la negación de la variable X. Si poseía algún valor, lo evalúa como cero, mientras que si poseía el valor 0, lo evalúa como 1. Es recomendable el uso de los paréntesis en las expresiones de fórmulas, sobre todo cuando no se conoce la forma de evaluación de los operadores, ya que fuerzan a realizar primero las operaciones incluidas en ellos. Las funciones Pulsando el botón funciones, aparecerá el asistente de funciones. En el anexo II del manual encontraremos un listado con todas las funciones del Asistente de edición de fórmulas de Velázquez Visual. El asistente para la edición de fórmulas puede volver a abrirse por cada parámetro de la función, de esta manera resultará más fácil su composición. Funciones 410 411 VELAZQUEZ VISUAL VENTANA ASISTENTE DE FUNCIONES El cuadro Ayuda del Asistente de funciones indica cómo trabaja la función, en Sintaxis vemos cuál es la sintaxis para esa función en particular y en Parámetros aparecen los parámetros que lleva la función. Para introducir esos parámetros podemos recurrir de nuevo al Asistente (botones a la derecha de los controles de edición correspondientes a parámetros). Velázquez Visual presenta los siguientes tipos de funciones: Numéricas: funciones que trabajan sobre datos numéricos, como Absoluto (devuelve el valor absoluto de un número) o Redondear (devuelve el número entero o decimal más próximo al valor). Funciones de cadenas y de conversión de cadenas: trabajan sobre cadenas de caracteres, como es el caso de la función Len (devuelve el número de caracteres de una expresión) o la función Mayúsculas (convierte una función alfabética a mayúsculas). Funciones de fecha: trabajan sobre datos con carácter de fecha, como la función Edad (devuelve la diferencia en años entre dos fechas). Funciones de hora: trabajan con datos de carácter hora, por ejemplo la función Ahora (que devuelve la hora del sistema). Funciones Varias: aquí se incluyen funciones de diverso tipo, como puede ser DecidirDato (elige un dato de acuerdo con una condición), o CampoVacío (devuelve 1 si el campo que se le pasa como parámetro está vacío y 0 si no lo está). Funciones de cliente-servidor: específicas para la ejecución de aplicaciones en arquitectura cliente-servidor. Por ejemplo GetWebAplicación (de- 06 Asistentes vuelve la url correspondiente a la aplicación que se esté ejecutando en ese momento). Funciones de códigos: trabajan sobre códigos que les pasamos como parámetros. Un ejemplo es EsEan13, que devuelve 1 si el código es un EAN13 y 0 en caso contrario. Funciones de juegos de caracteres: devuelven los códigos o caracteres correspondientes a los parámetros que se le haya pasado, por ejemplo GetCharAlfa40 (devuelve el carácter correspondiente al número que se le haya pasado como parámetro en la tabla de caracteres Alfa40). Funciones de directorios: realizan operaciones sobre directorios y ficheros, como la función AjustaSenda (convierte una senda para que sea interpretada correctamente). Funciones científicas: incluyen las funciones científicas clásicas, como ArcoSeno (devuelve el arcoseno del argumento). Funciones Api de Velázquez: devuelven información acerca de aplicaciones de Velázquez. Un ejemplo es GetProyectoNombre (devuelve el nombre de un proyecto de Velázquez). Las funciones de dll Si en el proyecto se ha creado algún objeto dll con funciones, éstas podrán ser seleccionadas pulsando el botón funciones de dll de la barra de botones del asistente. Aparecerá el Asistente de funciones de dll. Funciones de dll Funciones proceso ASISTENTE DE FUNCIONES DE DLL Las funciones proceso Si en el proyecto hemos creado alguna función, ésta podrá ser seleccionada pulsando el botón funciones proceso de la barra de botones del asistente. Obtendremos la ventana del Asistente de funciones proceso. 412 413 VELAZQUEZ VISUAL ASISTENTE DE FUNCIONES PROCESO (OBJETO VISUAL) Una función habitualmente usa parámetros. Éstos aparecerán entre paréntesis tras el nombre de la función, por ejemplo: FuncionNombre( parametro1, parametro2, parámetro3 ). Una vez seleccionada debemos sustituir las cadenas parámetro1, parámetro2, parámetro3 por los parámetros que vayamos a suministrar a la función, éstos podrán ser constantes o variables, por ejemplo: Constantes: FunciónNombre( 12, 1, 4 ) Variables: FunciónNombre( %CAMPO-1%, $VARIABLE-1$, ‘VARIABLE1’ ) Para ello hemos de seleccionar la función en el Asistente de funciones proceso, y mediante el Asistente de edición de fórmulas le pasamos los parámetros necesarios. Uso de los campos Para incluir manualmente en una fórmula un campo de la tabla de datos en curso hemos de escribir en mayúsculas el identificador del campo, precedido y seguido de un símbolo %. Por ejemplo, para calcular el 16 por ciento del campo Precio que tiene por identificador PRECIO, escribimos en la fórmula el texto siguiente: (%PRECIO% * 16) / 100. Es posible usar campos de una tabla de datos enlazada ascendentemente con la primera. En este ejemplo se han usado dos operadores; el operador (*) para la multiplicación y el operador (/) para la división. Veamos otro ejemplo: para obtener el valor del campo Nombre de la provincia de la población del cliente del albarán en curso, escribimos en la fórmula el texto siguiente: 06 Asistentes %CLIENTE.POBLACION.PROVINCIA.NOMBRE% Todo el texto va entre símbolos de tantos por ciento, mientras que los campos enlazados se separan con un punto (.). Para Velázquez Visual el campo Nombre de la tabla de datos enlazada, es tratado como si fuera de la propia tabla de datos. No hay limitación en el número de enlaces. También podemos movernos por los campos enlazados pinchando en el botón campos , de modo que se presentará una ventana en la que podemos seleccionar el campo a incluir en el asistente sin necesidad de escribirlo a mano. Campos Al pulsar las letras del teclado el foco se situará en el campo que comience por las mismas. En el caso de la figura anterior, si pulsáramos P, el foco se situaría sobre el campo Perfil. 6.1.2. Operaciones avanzadas Acceso a campos de otra tabla de datos En un proceso, para obtener un campo de un registro de una tabla de datos que no está en curso ni está enlazada, habiendo guardado anteriormente el registro en el proceso con la función Guardar ficha, se utiliza la siguiente sintaxis: :ID_VAR%CAMPO% Como prefijo se introduce : (dos puntos), a continuación el identificador de la variable en la que se ha guardado la ficha con la función Guardar ficha, y entre tantos por ciento, el campo de donde se quiere obtener el dato. De este modo también podemos acceder a los campos de las tablas enlazadas a la tabla a la que pertenece la ficha que hemos guardado en el proceso con la función Guardar ficha. Por ejemplo, supongamos las tablas enlazadas PAISES y PROVINCIAS. En un proceso guardamos un registro de la ADVERTENCIA Esta operación sólo puede ser utilizada en un Proceso. 414 415 VELAZQUEZ VISUAL tabla PROVINCIAS con la función Guardar ficha, utilizando la variable ID_FICHA. Desde una tabla no enlazada podemos acceder al nombre del país de la provincia de la ficha que hemos guardado; la sintaxis sería: :ID_FICHA%PAIS.NOMBRE% Si existen los mismos identificadores para una ficha guardada y una tabla de datos, tendrá prioridad el identificador de la ficha. Uso de las variables globales Variables globales Para introducir manualmente variables globales que estén declaradas en el proyecto hemos de escribir su identificador entre dos símbolos $. También podemos introducirlas haciendo uso de la Lista de Variables: Globales que aparece cuando pulsamos el botón variables globales del asistente para edición de fórmulas. Variables locales Por ejemplo: para hacer un cálculo con la variable global IVA y el campo PRECIO, escribimos en la fórmula el texto siguiente: (%PRECIO% * $IVA$) / 100 Advirtamos que el identificador del campo va entre tantos por ciento (%), mientras que el de la variable global va entre símbolos de dólar ($). Es posible combinar campos de una tabla de datos enlazada con variables globales. Por ejemplo, para hacer un cálculo con la variable global IVA y el campo PRECIO de la tabla de datos enlazada ARTICULOS, escribimos en la fórmula el texto siguiente: (%ARTICULOS.PRECIO% * $IVA$) / 100 VENTANA LISTA DE VARIABLES GLOBALES Uso de las variables locales Para introducir manualmente variables locales escribimos su identificador entre dos apóstrofes (‘). También podemos acceder a ellas mediante el botón variables locales (F7). Los ámbitos más corrientes de las variables locales son los procesos y los informes, aunque también se usan en componentes html, pies de rejilla... Al terminar se destruyen, y su uso no es posible desde fuera del proceso o informe. 06 Asistentes No es necesario declarar el tipo de las variables locales ya que éste será el de su contenido. Por ejemplo, una misma variable puede ser en un momento dado alfabética y luego numérica. Uso de las variables de sistema Para introducir manualmente variables de sistema escribimos el identificador de la variable en minúsculas, sin prefijos ni sufijos, o hacemos clic en el botón variables de sistema, obteniendo en este caso la ventana Lista de Variables: Sistema en la que se da un listado de todas las variables de sistema. VENTANA LISTA DE VARIABLES: SISTEMA Constantes Las constantes tienen un valor fijo predefinido por el programador. Dependiendo del tipo constante se especificarán de una u otra forma: • Constantes numéricas: se escribirá el número, precedido por el signo si es negativo, y utilizando el punto (.) como separador decimal. Por ejemplo, para pasar a una fórmula el número -1.231,35 hemos de escribir: -1231.35 • Constantes alfabéticas: se escribirá el contenido entrecomillado. Por ejemplo, si se desea tener el texto Pesetas como constante, la fórmula sería: “Pesetas”. • Constantes de tipo hora: su contenido se especificará separando las horas, minutos y segundos por un espacio en blanco o un carácter como puede ser un punto (.), dos puntos (:), etc. Por ejemplo para especificar las 3:04:30 como constante, la fórmula sería: 3 4 30 o 3:4:40 o 03:04:40. • Constantes de tipo fecha: su contenido puede especificarse de varias formas. Por ejemplo, para la fecha 1-enero-1999 podemos escribir como fórmula: 010199 o 1-1-1999 o 1-ene-1999. • Constantes de tipo booleano: su contenido puede especificarse con un número o con un texto: 1 Sí, 0 No. Variables de sistema 416 417 VELAZQUEZ VISUAL Subcadenas de formato Las subcadenas de formato ajustan la visualización de la información (por ejemplo, forzar a que un campo numérico se visualice con cinco caracteres, alineado a la derecha y rellenando con ceros por la izquierda, como 00021). ¿Cómo se pueden usar desde el Asistente de edición de fórmulas? Supongamos una línea de proceso en la que mandamos un mensaje que incluye el contenido de un campo del proyecto (no nos preocupemos por no haber visto aún los procesos; esto es solo un ejemplo). VENTANA DE EDICIÓN PARA LA FUNCIÓN DE PROCESOS MENSAJE Queremos incluir el mensaje “El precio del libro es PVP”, donde PVP es el precio, guardado en el campo P.V.P. En el control de edición Mensaje escribimos “El precio del libro es” y pulsamos el botón Asistente, apareciendo el asistente para edición de fórmulas. En él pulsamos el botón Campos y elegimos el campo P.V.P. En esta última ventana (Seleccione campo de:) es donde damos formato al campo (controles Justificar y longitud). 06 Al final obtendremos la siguiente ventana de línea de proceso: Asistentes 418 419 VELAZQUEZ VISUAL Conversión automática de datos Cuando pasamos datos de un tipo a otro, Velázquez realiza una conversión automática de los mismos. Así tenemos: • Dato numérico en una cadena de texto: cuando en una expresión de texto utilizamos un dato numérico, éste se toma con el signo y con los decimales. Por ejemplo, el número -26.125,55 al incluirlo en una fórmula de texto se convertirá a -26125.55. Cuando en una fórmula intervienen datos numéricos y el operador +, la operación a realizar (suma o concatenación) dependerá del primero de los valores especificados. Si es un número, se tomará como una suma, si es una cadena, como una concatenación. Por ejemplo, si en un campo o variable de tipo alfabético se escribe la fórmula: 1+1, puesto que el primer dato es numérico, se tomará como una suma, por lo que se devolverá 2. Si lo que queremos es concatenar ambas cifras, para indicar que se trata de una concatenación basta con que al principio de la expresión se escriba “ ” (comillas - comillas) con lo que la fórmula sería “”+1+1, lo que devolvería 11. En ambos casos el resultado es una cadena de texto, aunque en el primer caso se devuelve como cadena la suma de ambas cifras y en el segundo la concatenación de las mismas. • Fecha en una cadena de texto: cuando en una cadena de texto incluimos un dato de tipo fecha, lo devuelve en formato de día-nombre del mes abreviado-año completo. Por ejemplo, 12/12/1998 es incluido en la cadena de texto como 12-dic-1998. 06 • Hora en una cadena de texto: cuando se pasa un dato de tipo hora a una cadena de texto, se convierte automáticamente en formato hh:mm:ss. Por ejemplo: 12:15:33. • Hora en numérico: al pasar un dato de tipo hora a un campo o variable numérico, este último convierte la hora en segundos. Así, por ejemplo: 10:44:01 pasa a ser 38641. Secuencias de escape en cadenas de caracteres Para introducir en el interior de una cadena de caracteres algunos caracteres especiales imposibles de representar mediante texto, utilizamos lo que comúnmente se denominan secuencias de escape. Todas ellas comienzan con una barra invertida seguida de otro carácter. Las secuencias de escape se sustituyen en tiempo de ejecución por los caracteres adecuados. Éstas son las secuencias de escape aceptadas: \a Campana: es el pitido del sistema. \b Retroceso: produce el mismo efecto que pulsar la tecla de Retroceso destructivo. \c Comilla: provoca la introducción de una comilla. \f Salto de página: provoca el salto de una página. \n Nueva línea: provoca el salto a la línea siguiente. \r Retorno de carro: provoca el retroceso al comienzo de la línea. \t Tabulador: produce el mismo efecto que pulsar la tecla del Tabulador. \v Tabulador Vertical. \\ Barra invertida. Las secuencias de escape \r y \n pueden ser utilizadas en textos estáticos multilíneas (menús, for

22 downloads 62 Views 334KB Size

Story Transcript

06 Asistentes

06 6.1

Asistentes

Asistente para edición de fórmulas

Las fórmulas pueden utilizarse en cualquier cuadro de edición que permita introducir expresiones de tipo fórmula. Normalmente haremos uso del Asistente para edición de fórmulas, disponible en el botón Asistente, aunque también podemos introducirlas manualmente. Se aconseja el uso del asistente ya que detecta errores. El asistente está presente en todos los controles de edición donde se permite emplear fórmulas, de manera que al pulsar el botón Asistente aparecerá la ventana:

ASISTENTE PARA EDICIÓN DE FÓRMULAS

La parte principal es un cuadro de edición donde escribimos la expresión de la fórmula. En este área del asistente insertaremos identificadores, símbolos y funciones a medida que los seleccionamos en las diversas opciones. De igual forma podemos insertar manualmente datos como paréntesis, operadores, campos, etc. Los botones de la barra permiten acceder a una lista de: Operadores (F3).

Operadores

Funciones (F4).

Funciones

Funciones de dll.

Funciones de dll

Funciones (objeto visual).

Funciones (objeto visual)

408 409

Campos Variables Globales

VELAZQUEZ VISUAL

Campos (F5). Variables Globales (F6).

Variables Locales

Variables Locales (F7).

Variables del Sistema Cortar, Copiar y Pegar

Variables del Sistema (F8).

Deshacer

Deshacer (Control + Z).

Verificar Ayuda Aceptar

Cortar (Control + X), Copiar (Control + C) y Pegar (Control + V).

Verificar (F9): este botón comprueba que la sintaxis de la fórmula sea correcta. En caso contrario presentará una ventana con el error cometido. También se verifica al aceptar la fórmula con el botón OK o al pulsar intro. Ayuda (F1).

Cancelar

Aceptar (Intro): guarda los cambios realizados en la fórmula. Operadores

Cancelar (Esc): cancela los cambios llevados a cabo en la fórmula.

6.1.1. Sintaxis de las fórmulas. Operadores y funciones En una fórmula se permiten expresiones tanto aritméticas (suma, resta, división...) como booleanas (lógicas). Disponemos de una lista de operadores, funciones, accesos a los campos de la tabla de datos en curso y a sus maestros, acceso a las variables globales del proyecto, a las variables locales y a las variables del sistema para poder crear las fórmulas.

Operadores Pulsando el botón operadores aparecerá en pantalla un asistente en el que podremos seleccionar el operador necesario de entre los siguientes:

OPERADORES

Expresiones aritméticas: por ejemplo ((4 + 5 + 1) / 2) - (45 / 8). Aquí se han usado constantes, pero podemos operar con campos y variables globales, además de otras funciones. Expresiones condicionales:

06 4>2

condición cierta.

4 < (2+2)

condición falsa.

4 = (2+2)

condición cierta.

4!3

condición cierta

Asistentes

Expresiones booleanas (lógicas): (4 > 1) & (4 = 5) En el ejemplo anterior, la primera condición (4>1) es cierta, pero la segunda (4=5) no lo es. El operador & es verdadero si sus condiciones (izquierda y derecha) también lo son, por lo tanto, la condición en su conjunto es falsa. (4 > 1) | (4 = 5) En el ejemplo anterior la primera condición (4>1) es cierta pero la segunda (4=5) no lo es. El operador | (ó) es verdadero si una de sus condiciones (izquierda y derecha) lo es, por lo tanto, la condición en su conjunto es cierta. Expresiones unarias - X: la expresión devuelve el valor negativo de la variable X. !X: indica NO X. Se trata de la negación de la variable X. Si poseía algún valor, lo evalúa como cero, mientras que si poseía el valor 0, lo evalúa como 1. Es recomendable el uso de los paréntesis en las expresiones de fórmulas, sobre todo cuando no se conoce la forma de evaluación de los operadores, ya que fuerzan a realizar primero las operaciones incluidas en ellos.

Las funciones Pulsando el botón funciones, aparecerá el asistente de funciones. En el anexo II del manual encontraremos un listado con todas las funciones del Asistente de edición de fórmulas de Velázquez Visual. El asistente para la edición de fórmulas puede volver a abrirse por cada parámetro de la función, de esta manera resultará más fácil su composición.

Funciones

410 411

VELAZQUEZ VISUAL

VENTANA ASISTENTE DE FUNCIONES

El cuadro Ayuda del Asistente de funciones indica cómo trabaja la función, en Sintaxis vemos cuál es la sintaxis para esa función en particular y en Parámetros aparecen los parámetros que lleva la función. Para introducir esos parámetros podemos recurrir de nuevo al Asistente (botones a la derecha de los controles de edición correspondientes a parámetros). Velázquez Visual presenta los siguientes tipos de funciones: Numéricas: funciones que trabajan sobre datos numéricos, como Absoluto (devuelve el valor absoluto de un número) o Redondear (devuelve el número entero o decimal más próximo al valor). Funciones de cadenas y de conversión de cadenas: trabajan sobre cadenas de caracteres, como es el caso de la función Len (devuelve el número de caracteres de una expresión) o la función Mayúsculas (convierte una función alfabética a mayúsculas). Funciones de fecha: trabajan sobre datos con carácter de fecha, como la función Edad (devuelve la diferencia en años entre dos fechas). Funciones de hora: trabajan con datos de carácter hora, por ejemplo la función Ahora (que devuelve la hora del sistema). Funciones Varias: aquí se incluyen funciones de diverso tipo, como puede ser DecidirDato (elige un dato de acuerdo con una condición), o CampoVacío (devuelve 1 si el campo que se le pasa como parámetro está vacío y 0 si no lo está). Funciones de cliente-servidor: específicas para la ejecución de aplicaciones en arquitectura cliente-servidor. Por ejemplo GetWebAplicación (de-

06

Asistentes

vuelve la url correspondiente a la aplicación que se esté ejecutando en ese momento). Funciones de códigos: trabajan sobre códigos que les pasamos como parámetros. Un ejemplo es EsEan13, que devuelve 1 si el código es un EAN13 y 0 en caso contrario. Funciones de juegos de caracteres: devuelven los códigos o caracteres correspondientes a los parámetros que se le haya pasado, por ejemplo GetCharAlfa40 (devuelve el carácter correspondiente al número que se le haya pasado como parámetro en la tabla de caracteres Alfa40). Funciones de directorios: realizan operaciones sobre directorios y ficheros, como la función AjustaSenda (convierte una senda para que sea interpretada correctamente). Funciones científicas: incluyen las funciones científicas clásicas, como ArcoSeno (devuelve el arcoseno del argumento). Funciones Api de Velázquez: devuelven información acerca de aplicaciones de Velázquez. Un ejemplo es GetProyectoNombre (devuelve el nombre de un proyecto de Velázquez).

Las funciones de dll Si en el proyecto se ha creado algún objeto dll con funciones, éstas podrán ser seleccionadas pulsando el botón funciones de dll de la barra de botones del asistente. Aparecerá el Asistente de funciones de dll.

Funciones de dll Funciones proceso

ASISTENTE DE FUNCIONES DE DLL

Las funciones proceso Si en el proyecto hemos creado alguna función, ésta podrá ser seleccionada pulsando el botón funciones proceso de la barra de botones del asistente. Obtendremos la ventana del Asistente de funciones proceso.

412 413

VELAZQUEZ VISUAL

ASISTENTE DE FUNCIONES PROCESO (OBJETO VISUAL)

Una función habitualmente usa parámetros. Éstos aparecerán entre paréntesis tras el nombre de la función, por ejemplo: FuncionNombre( parametro1, parametro2, parámetro3 ). Una vez seleccionada debemos sustituir las cadenas parámetro1, parámetro2, parámetro3 por los parámetros que vayamos a suministrar a la función, éstos podrán ser constantes o variables, por ejemplo: Constantes: FunciónNombre( 12, 1, 4 ) Variables: FunciónNombre( %CAMPO-1%, $VARIABLE-1$, ‘VARIABLE1’ ) Para ello hemos de seleccionar la función en el Asistente de funciones proceso, y mediante el Asistente de edición de fórmulas le pasamos los parámetros necesarios.

Uso de los campos Para incluir manualmente en una fórmula un campo de la tabla de datos en curso hemos de escribir en mayúsculas el identificador del campo, precedido y seguido de un símbolo %. Por ejemplo, para calcular el 16 por ciento del campo Precio que tiene por identificador PRECIO, escribimos en la fórmula el texto siguiente: (%PRECIO% * 16) / 100.

Es posible usar campos de una tabla de datos enlazada ascendentemente con la primera. En este ejemplo se han usado dos operadores; el operador (*) para la multiplicación y el operador (/) para la división. Veamos otro ejemplo: para obtener el valor del campo Nombre de la provincia de la población del cliente del albarán en curso, escribimos en la fórmula el texto siguiente:

06

Asistentes

%CLIENTE.POBLACION.PROVINCIA.NOMBRE% Todo el texto va entre símbolos de tantos por ciento, mientras que los campos enlazados se separan con un punto (.). Para Velázquez Visual el campo Nombre de la tabla de datos enlazada, es tratado como si fuera de la propia tabla de datos. No hay limitación en el número de enlaces. También podemos movernos por los campos enlazados pinchando en el botón campos , de modo que se presentará una ventana en la que podemos seleccionar el campo a incluir en el asistente sin necesidad de escribirlo a mano.

Campos

Al pulsar las letras del teclado el foco se situará en el campo que comience por las mismas. En el caso de la figura anterior, si pulsáramos P, el foco se situaría sobre el campo Perfil.

6.1.2. Operaciones avanzadas Acceso a campos de otra tabla de datos En un proceso, para obtener un campo de un registro de una tabla de datos que no está en curso ni está enlazada, habiendo guardado anteriormente el registro en el proceso con la función Guardar ficha, se utiliza la siguiente sintaxis: :ID_VAR%CAMPO% Como prefijo se introduce : (dos puntos), a continuación el identificador de la variable en la que se ha guardado la ficha con la función Guardar ficha, y entre tantos por ciento, el campo de donde se quiere obtener el dato. De este modo también podemos acceder a los campos de las tablas enlazadas a la tabla a la que pertenece la ficha que hemos guardado en el proceso con la función Guardar ficha. Por ejemplo, supongamos las tablas enlazadas PAISES y PROVINCIAS. En un proceso guardamos un registro de la

ADVERTENCIA Esta operación sólo puede ser utilizada en un Proceso.

414 415

VELAZQUEZ VISUAL

tabla PROVINCIAS con la función Guardar ficha, utilizando la variable ID_FICHA. Desde una tabla no enlazada podemos acceder al nombre del país de la provincia de la ficha que hemos guardado; la sintaxis sería: :ID_FICHA%PAIS.NOMBRE% Si existen los mismos identificadores para una ficha guardada y una tabla de datos, tendrá prioridad el identificador de la ficha.

Uso de las variables globales

Variables globales

Para introducir manualmente variables globales que estén declaradas en el proyecto hemos de escribir su identificador entre dos símbolos $. También podemos introducirlas haciendo uso de la Lista de Variables: Globales que aparece cuando pulsamos el botón variables globales del asistente para edición de fórmulas.

Variables locales

Por ejemplo: para hacer un cálculo con la variable global IVA y el campo PRECIO, escribimos en la fórmula el texto siguiente: (%PRECIO% * $IVA$) / 100 Advirtamos que el identificador del campo va entre tantos por ciento (%), mientras que el de la variable global va entre símbolos de dólar ($). Es posible combinar campos de una tabla de datos enlazada con variables globales. Por ejemplo, para hacer un cálculo con la variable global IVA y el campo PRECIO de la tabla de datos enlazada ARTICULOS, escribimos en la fórmula el texto siguiente: (%ARTICULOS.PRECIO% * $IVA$) / 100

VENTANA LISTA DE VARIABLES GLOBALES

Uso de las variables locales Para introducir manualmente variables locales escribimos su identificador entre dos apóstrofes (‘). También podemos acceder a ellas mediante el botón variables locales (F7). Los ámbitos más corrientes de las variables locales son los procesos y los informes, aunque también se usan en componentes html, pies de rejilla... Al terminar se destruyen, y su uso no es posible desde fuera del proceso o informe.

06

Asistentes

No es necesario declarar el tipo de las variables locales ya que éste será el de su contenido. Por ejemplo, una misma variable puede ser en un momento dado alfabética y luego numérica.

Uso de las variables de sistema Para introducir manualmente variables de sistema escribimos el identificador de la variable en minúsculas, sin prefijos ni sufijos, o hacemos clic en el botón variables de sistema, obteniendo en este caso la ventana Lista de Variables: Sistema en la que se da un listado de todas las variables de sistema.

VENTANA LISTA DE VARIABLES: SISTEMA

Constantes Las constantes tienen un valor fijo predefinido por el programador. Dependiendo del tipo constante se especificarán de una u otra forma: • Constantes numéricas: se escribirá el número, precedido por el signo si es negativo, y utilizando el punto (.) como separador decimal. Por ejemplo, para pasar a una fórmula el número -1.231,35 hemos de escribir: -1231.35 • Constantes alfabéticas: se escribirá el contenido entrecomillado. Por ejemplo, si se desea tener el texto Pesetas como constante, la fórmula sería: “Pesetas”. • Constantes de tipo hora: su contenido se especificará separando las horas, minutos y segundos por un espacio en blanco o un carácter como puede ser un punto (.), dos puntos (:), etc. Por ejemplo para especificar las 3:04:30 como constante, la fórmula sería: 3 4 30 o 3:4:40 o 03:04:40. • Constantes de tipo fecha: su contenido puede especificarse de varias formas. Por ejemplo, para la fecha 1-enero-1999 podemos escribir como fórmula: 010199 o 1-1-1999 o 1-ene-1999. • Constantes de tipo booleano: su contenido puede especificarse con un número o con un texto: 1 Sí, 0 No.

Variables de sistema

416 417

VELAZQUEZ VISUAL

Subcadenas de formato Las subcadenas de formato ajustan la visualización de la información (por ejemplo, forzar a que un campo numérico se visualice con cinco caracteres, alineado a la derecha y rellenando con ceros por la izquierda, como 00021). ¿Cómo se pueden usar desde el Asistente de edición de fórmulas? Supongamos una línea de proceso en la que mandamos un mensaje que incluye el contenido de un campo del proyecto (no nos preocupemos por no haber visto aún los procesos; esto es solo un ejemplo).

VENTANA DE EDICIÓN PARA LA FUNCIÓN DE PROCESOS MENSAJE

Queremos incluir el mensaje “El precio del libro es PVP”, donde PVP es el precio, guardado en el campo P.V.P. En el control de edición Mensaje escribimos “El precio del libro es” y pulsamos el botón Asistente, apareciendo el asistente para edición de fórmulas. En él pulsamos el botón Campos y elegimos el campo P.V.P. En esta última ventana (Seleccione campo de:) es donde damos formato al campo (controles Justificar y longitud).

06

Al final obtendremos la siguiente ventana de línea de proceso:

Asistentes

418 419

VELAZQUEZ VISUAL

Conversión automática de datos Cuando pasamos datos de un tipo a otro, Velázquez realiza una conversión automática de los mismos. Así tenemos: • Dato numérico en una cadena de texto: cuando en una expresión de texto utilizamos un dato numérico, éste se toma con el signo y con los decimales. Por ejemplo, el número -26.125,55 al incluirlo en una fórmula de texto se convertirá a -26125.55. Cuando en una fórmula intervienen datos numéricos y el operador +, la operación a realizar (suma o concatenación) dependerá del primero de los valores especificados. Si es un número, se tomará como una suma, si es una cadena, como una concatenación. Por ejemplo, si en un campo o variable de tipo alfabético se escribe la fórmula: 1+1, puesto que el primer dato es numérico, se tomará como una suma, por lo que se devolverá 2. Si lo que queremos es concatenar ambas cifras, para indicar que se trata de una concatenación basta con que al principio de la expresión se escriba “ ” (comillas - comillas) con lo que la fórmula sería “”+1+1, lo que devolvería 11. En ambos casos el resultado es una cadena de texto, aunque en el primer caso se devuelve como cadena la suma de ambas cifras y en el segundo la concatenación de las mismas. • Fecha en una cadena de texto: cuando en una cadena de texto incluimos un dato de tipo fecha, lo devuelve en formato de día-nombre del mes abreviado-año completo. Por ejemplo, 12/12/1998 es incluido en la cadena de texto como 12-dic-1998.

06 • Hora en una cadena de texto: cuando se pasa un dato de tipo hora a una cadena de texto, se convierte automáticamente en formato hh:mm:ss. Por ejemplo: 12:15:33. • Hora en numérico: al pasar un dato de tipo hora a un campo o variable numérico, este último convierte la hora en segundos. Así, por ejemplo: 10:44:01 pasa a ser 38641.

Secuencias de escape en cadenas de caracteres Para introducir en el interior de una cadena de caracteres algunos caracteres especiales imposibles de representar mediante texto, utilizamos lo que comúnmente se denominan secuencias de escape. Todas ellas comienzan con una barra invertida seguida de otro carácter. Las secuencias de escape se sustituyen en tiempo de ejecución por los caracteres adecuados. Éstas son las secuencias de escape aceptadas: \a

Campana: es el pitido del sistema.

\b

Retroceso: produce el mismo efecto que pulsar la tecla de Retroceso destructivo.

\c

Comilla: provoca la introducción de una comilla.

\f

Salto de página: provoca el salto de una página.

\n

Nueva línea: provoca el salto a la línea siguiente.

\r

Retorno de carro: provoca el retroceso al comienzo de la línea.

\t

Tabulador: produce el mismo efecto que pulsar la tecla del Tabulador.

\v

Tabulador Vertical.

\\

Barra invertida.

Las secuencias de escape \r y \n pueden ser utilizadas en textos estáticos multilíneas (menús, formularios, etc.).

Cuestiones 1. Supongamos una aplicación en la que tenemos una tabla que contiene los campos valor1 y valor 2 (numéricos). También tenemos definidas dos variables globales: variable1 y variable2 (numéricas). Queremos que el contenido inicial del campo valor1 sea variable1 si se cumple que valor2 > 10. En caso contrario el contenido inicial de valor1 debe ser la variable2. Usar para ello la función DecidirDato (dentro de la carpeta Varias). 2. Supuesto el siguiente esquema de tablas, ¿cuál sería la sintaxis para obtener el nombre de la región a la que pertenece el lugar de interés en el que se encuentra la casa rural en curso?

Asistentes

420 421

VELAZQUEZ VISUAL

3. Supongamos una aplicación con tres tablas: CLIENTES, ARTÍCULOS y LÍNEAS DE VENTA. En la tabla CLIENTES hemos incluido el campo Descuento, que guarda el descuento a aplicar según el cliente. La tabla ARTÍCULOS contiene el campo Precio, y además hemos incluido en el proyecto la variable global IVA. En la tabla LÍNEAS DE VENTA hemos añadido el campo Total (lo que finalmente debe pagar el cliente). Queremos que el contenido del campo Total sea el precio del artículo menos el descuento por cliente, sin olvidarnos de aplicar el IVA. Escribir el contenido inicial del campo Total usando las funciones del asistente.

Resumen Podemos utilizar fórmulas en cualquier cuadro de edición que admita expresiones de tipo fórmula. Aunque se pueden introducir a mano se recomienda utilizar el Asistente para edición de fórmulas. En las fórmulas se admiten expresiones tanto aritméticas como booleanas. Para construirlas disponemos de una lista de operadores, funciones, accesos a los campos de la tabla de datos en curso y a sus maestros, acceso a las variables globales del proyecto, a las variables locales, a las variables del sistema y a constantes. En el asistente encontramos funciones numéricas, de cadenas, de conversión de cadenas, de fecha, de hora, varias, Api de Velázquez, cliente - ser-

06 vidor, de códigos, de juegos de caracteres, de directorios y científicas, todas ellas con un asistente de funciones. También podemos introducir funciones de dll y de procesos si éstas han sido creadas en el proyecto. Gracias a las subcadenas de formato podemos ajustar la visualización de la información. Cuando pasamos datos de un tipo a otro, Velázquez realiza una conversión automática de los mismos. Podemos convertir: datos numéricos en cadenas de texto, fechas en cadenas de texto, horas en cadenas de texto y horas en numérico. Gracias a las secuencias de escape introducimos, en el interior de cadenas de caracteres, algunos caracteres especiales que no se pueden representar mediante texto (retrocesos, comillas, saltos de página, etc.).

6.2

Uso de las cadenas de formato

Las cadenas de formato pueden usarse en ciertos controles, y sirven para concatenar textos y campos sin utilizar operadores aritméticos, formateando la visualización de la información. Los controles donde se pueden usar son: • Rejillas: cuando se activa la casilla de verificación Manual en las propiedades de cuerpo (ventana Columna de rejilla). • Tubos de ficha y tubos de lista: en los Capilares de campos alfabéticos. • Formularios: cuando se activa la casilla de verificación Manual en los controles de edición de campo. • En la especificación del texto en controles de casilla de verificación de formularios y menús formulario. • En la especificación del texto y del dato fijo en controles de botones de radio de formularios y menús formulario.

6.2.1. Sintaxis de las cadenas de formato En las cadenas de formato todos los caracteres que no estén posicionados entre tantos por ciento son interpretados como texto a concatenar. Los identificadores de los campos se escriben como en las fórmulas, es decir, entre tantos por ciento. Por ejemplo: Tel.: %CLIENTE.TELEFONO% Fax: %CLIENTE.FAX% Da como resultado la cadena siguiente: Tel.: TTT Fax: FFF, donde TTT sería el teléfono del cliente y FFF el fax del cliente. Advirtamos que no se utiliza el operador +. El equivalente a una expresión fórmula sería:

Asistentes

422 423

VELAZQUEZ VISUAL

“Tel.: “+%CLIENTE.TELEFONO%+” Fax:”+%CLIENTE.FAX%.

6.2.2. El asistente para la edición de cadenas 6.2.2. de formato El asistente de cadenas de formato está presente en todos los controles de edición donde está permitido emplear cadenas de formato. Al pulsar el botón Asistente visualizaremos la ventana del asistente.

ASISTENTE PARA EDICIÓN DE CADENAS DE FORMATO

Principalmente se compone de un cuadro de edición donde se escribe la expresión de la cadena de formato. En este área el asistente insertará identificadores de campo, de variables globales, etc. Los botones Operadores y Funciones no están activos, pues para las cadenas de formato no se pueden utilizar ni los operadores ni las funciones de fórmulas. Los botones de la barra del asistente permiten acceder a una lista de: Campos

Campos (F5).

Variables Globales

Variables Globales (F6).

Variables Locales

Variables Locales (F7).

Variables del Sistema Cortar, Copiar y Pegar Deshacer

Variables del Sistema (F8). Cortar (Control + X), Copiar (Control + C) y Pegar (Control + V). Deshacer (Control + Z).

06

Asistentes

Verificar (F9): este botón comprueba que la sintaxis de la fórmula sea correcta. En caso contrario presentará una ventana con el error cometido.

Verificar

Ayuda (F1).

Ayuda

Aceptar (Intro): guarda los cambios realizados en la fórmula.

Aceptar

Cancelar (Esc): cancela los cambios llevados a cabo en la fórmula.

Cancelar

Cuestiones 1. En una aplicación queremos ver un precio en tres monedas distintas: euros, libras y dólares. Para ello creamos un formulario en el que introducimos el precio en euros, de modo que los campos precio en libras y precio en dólares sean de tipo fórmula y se calculen directamente al meter el precio en euros. En el formulario queremos que aparezcan los tres precios en tres cadenas de formato que nos indiquen la moneda que es.

6.2.3. Subcadenas de formato Mediante las subcadenas de formato ajustamos la visualización de la información. Para ello disponemos de unos formateadores que son utilizados conjuntamente con el identificador del campo, precedidos del símbolo # (Alt Gr + 3). La sintaxis es la siguiente: %ID_CAMPO#F% ID_CAMPO: es el identificador del campo. F: es el formateador. Para crear una subcadena de formato tenemos dos opciones: escribirla directamente o a través de la opción correspondiente que aparece al seleccionar un campo, tanto en el asistente para la edición de fórmulas como en el asistente para la edición de cadenas de formato. En función del tipo de campo seleccionado se presentarán las opciones de subcadenas de formato que correspondan. Cuando se hace a través de la opción del asistente, al ir seleccionando las distintas subcadenas de formato, Velázquez irá componiendo la fórmula que corresponda. En el anexo I del manual encontraremos una relación de los formateadores con los que podemos trabajar en Velázquez Visual.

Ejemplo: Subcadenas de formato Queremos visualizar en un formulario el campo CODIGO (numérico), con una longitud de 8 caracteres, alineado a la derecha y rellenando con ceros por la izquierda (ej.: 00000158). Para ello habrá que seguir los pasos siguientes:

e

424 425

VELAZQUEZ VISUAL

e Insertamos un control de edición de campo en el formulario. En las propiedades de dicho control de edición seleccionamos la opción Manual.

Pulsamos el botón Asistente para abrir el asistente de creación de cadenas de formato.

Campos

Una vez abierto, pulsamos el botón Campos ra acceder a la lista de campos.

de la barra de botones pa-

Seleccionamos el campo %CODIGO%. En la parte inferior de la ventana se presentan las distintas opciones para formatear campos numéricos.

06

Asistentes e

En Justificar seleccionamos la opción Derecha con ceros a la izquierda. En Longitud escribimos 8.

426 427

VELAZQUEZ VISUAL

e

Al aceptar, la fórmula se habrá convertido en %CODIGO#C8%.

Con esto, el campo código aparecerá en el formulario con el formato que requeríamos.

06 6.2.4 Conversión automática de datos y secuencias de escape en cadenas de caracteres Velázquez Visual realiza una conversión automática cuando pasamos datos de un tipo a datos de otro tipo (dato numérico en una cadena de texto, fecha en una cadena de texto, hora en una cadena de texto, hora en numérico). Por otro lado, para introducir en el interior de una cadena de caracteres algunos caracteres especiales imposibles de representar mediante texto, utilizaremos las secuencias de escape. En tiempo de ejecución, éstas se sustituyen por los caracteres adecuados.

Cuestiones 1. Escribir la subcadena de formato necesaria para ver el contenido de un campo Precio con dos decimales, separador de miles, de modo que aparezca pegado a la derecha y rellenando con ceros a la izquierda hasta llegar a diez caracteres. 2. Escribir la cadena de formato para que un campo Fecha de un registro, que contiene la fecha 2-8-1998 (domingo), se vea en una rejilla como “La fecha es dom 2 de agosto de ‘98”.

Resumen Las cadenas de formato sirven para concatenar textos y campos sin utilizar operadores aritméticos, formateando la visualización de la información. Se pueden usar en rejillas, en tubos de lista, tubos de ficha, formularios, etc. Para editar las cadenas de formato contamos con el Asistente para edición de cadenas de formato. Desde él tenemos acceso a campos de la tabla y de tablas enlazadas, variables globales, variables locales y variables de sistema del proyecto. Con las subcadenas de formato ajustamos la visualización de la información, para lo que disponemos de formateadores. Podemos escribirlas directamente o al seleccionar un campo, tanto en el asistente para la edición de fórmulas como en el asistente para la edición de cadenas de formato. Velázquez Visual cuenta con formateadores alfabéticos, numéricos, de fechas y de horas. También hay subcadenas específicas para informes. Cuando pasamos datos de un tipo a datos de otro tipo, Velázquez realiza una conversión automática de los mismos. Gracias a las secuencias de escape introducimos, en el interior de cadenas de caracteres, algunos caracteres especiales que no se pueden representar mediante texto (retrocesos, comillas, saltos de página, etc.).

Asistentes

Get in touch

Social

© Copyright 2013 - 2024 MYDOKUMENT.COM - All rights reserved.