Doc. Ref. 9776 Título: El formulario de entrada de un dato en Hexa V8 Autor: Philippe Calvó Última actualización: 17/07/2015

---

documentos\Cliente-3223-HEXA-Formulario interacciones Hexa8-Doc.9776.htm

El formulario de entrada de un dato en Hexa V8

El formulario de entrada de un dato permite solicitar al usuario un dato individual a la vez. Es muy útil en la parametrización de scripts para pedir datos previos a la ejecución de un proceso. Si se ejecuta repetidamente con diferentes parámetros se puede utilizar para recoger un conjunto de datos. Pero en este caso es preferible usar el formulario de interacciones que los solicita todos a la vez.

El formulario se adapta automáticamente a cada tipo de valor y muestra ayudas en los casos convenientes.

Ejemplo de script que solicita un número y a continuación lo muestra

Sub Main (PS0, PS1, PS2)
    Dato = Formularios.IBx ("Introduzca un numero", "Entero", 1)
    Formularios.MBx ("El número introducido es: " & Dato)
End Sub

Los parámetros de la función IBx son los siguientes:

1. Texto: Texto explicativo a mostrar
2. Tipo: Tipo de dato solicitado (ver posibles tipos más adelante)
3. Clave: Para datos compuestos, por ejemplo en un número de factura compuesto por prefijo y número, si clave es 1, se obtiene el prefijo y si clave es 2 el número. Si se indica cero, se devuelve los valores separados por guiones, en el caso de una factura, por ejemplo, se devolvería "A-234" si es cero, "A" si es 1 y "234" si clave es 2.
4. Defecto (opcional). Permite especificar un valor por defecto al solicitar el dato.
5. Filtro (opcional). Si tipo de dato corresponde a una tabla (por ejemplo Cliente), se puede especificar un filtro SQL para los registros que aparecerán para escoger en la ayuda.

Tipos de datos

El parámetro tipo que especifica el tipo de dato, puede tener los siguientes valores y consecuencias:

• Cadena vacía: Se solicita el dato a lo bruto en un cuadro de texto de una línea y sin ninguna restricción ni ayuda.
• "Real": Se solicita un número en un cuadro de texto de una línea. El resultado se interpreta siempre como número. Si se introduce una letra se interpreta cero.
• "Fichero" Se solicita el nombre de un fichero. Se dispone de ayudas para escoger el fichero en los discos del equipo del usuario. Se devuelve el nombre del fichero con su rura completa.
• "Directorio" Se solicita el nombre de un directorio o carpeta. Se dispone de ayudas para escogerla en los discos del equipo del usuario. Se devuelve la ruta completa de la carpeta.
• "Fecha" Se solicita una fecha. Se dispone de un calendario de ayuda para escogerla.
• "Texto" Se solicita un texto en una ventana de varias líneas.
• Nombre de un documento seguido de "Prefijo" (por ejemplo "AlbaranPrefijo") Se solicita el prefijo del documento con un desplegable que ofrece todos los parametrizados.
• Nombre de una tabla (por ejemplo "Cliente") se solicita seleccionar un registro de la tabla, se ofrece ayudas a la búsqueda y se devuelve el valor de la clave principal de esta tabla.

Ejemplos

Sub Main (PS0, PS1, PS2)
    Dato = Formularios.IBx ("Introduzca una fecha", "Fecha", 1, "12/1/2015")
    Formularios.MBx ("La fecha seleccionada es: " & Dato)
    Dato = Formularios.IBx ("Introduzca un fichero", "Fichero", 0)
    Formularios.MBx ("El fichero escogido es: " & Dato)
    Dato = Formularios.IBx ("Introduzca un directorio", "Directorio", 0)
    Formularios.MBx ("El directorio escogido es: " & Dato)
    Dato = Formularios.IBx ("Introduzca el código de un cliente", "Cliente", 0)
    Formularios.MBx ("El cliente seleccionado es: " & Dato)
    Dato = Formularios.IBx ("Introduzca un número de factura", "Factura", 0)
    Formularios.MBx ("La factura seleccionada es: " & Dato)
End Sub

Volver a la búsqueda anterior