Texto

Configuración General

Configuración general

Tipo de Datos

Define el tipo de campo en la aplicación. En este caso debemos seleccionar Texto.

Etiqueta

Define el título que se mostrará en el campo al ejecutar la aplicación. La terminología utilizada en la interfaz es fundamental para que su sistema tenga una buena usabilidad, debemos utilizar nombres y términos familiares para el usuario final de la aplicación, en lugar de utilizar términos originados en el sistema.

Por ejemplo, este campo de texto que en la tabla tiene el nombre nombre, el cliente tendría un mejor entendimiento de la funcionalidad del campo al definir la etiqueta como Nombre.

Además de un texto fijo, el atributo Etiqueta permite la utilización de lang para definir el título del campo, posibilitando así la internacionalización de su Aplicación.

Tipo SQL

Informa el tipo de campo en la base de datos.

Optiones de Lookup

Configuraciones de Lookup

Un método utilizado para ofrecer al usuario una lista de valores que se pueden seleccionar en las aplicaciones de formulario. Por ejemplo, el campo de género en la Base de datos con los valores H o M puede presentarse como Hombre o Mujeres o de una manera dinámica, teniendo estos valores recuperados de la base de datos.

Lookup Settings Display for the field. Pantalla de Configuración para el campo Lookup .

Métodos de Lookup

Tendrá disponibles dos tipos de métodos de lookup: Manual (informando manualmente las condiciones de la selección) o Automático (usando una consulta de base de datos).

Seleccionando el tipo de lookup.
- Lookup Método- Automático
  
  Interfaz de lookup automática.
  - SQL : Defina el comando SQL que recuperará los valores que se mostrarán en el campo de formulario. El comando necesita tener la siguiente estructura SELECT display_field FROM table WHERE key_field = {grid_field}.
  El campo de la grid necesita ser referenciado por las llaves {}. Mientras se ejecuta la aplicación, el campo dentro de las llaves se reemplaza por su valor en la tabla.
  - Varios valores: cuando está habilitado, permite seleccionar más de un elemento de la lista, separados por un delimitador.
  - Delimiter: define el carácter utilizado para separar los valores seleccionados en el formulario. Solo informe un valor a este campo si necesita separar las opciones seleccionadas con un delimitador diferente y luego (;).
  - Utilice el lookup en :
    - Grid : Aplica la búsqueda a todos los formatos de Grid (HTML, PDF, XML , CSV and RTF).
    - Resumen : Aplica el lookup solo para el resumen (HTML y PDF).
    - Ambos : Se aplica tanto a la Grid como al resumen.
  - Valor predeterminado : Define el valor predeterminado, utilizado en los casos en que el comando de selección no devuelve ningún valor.
  - Mostrar original y el valor de lookup : Cuando se selecciona No, se visualiza en el valor del comando de selección. De lo contrario, se mostrará el valor original del campo y el valor devuelto por el comando de selección separado por el carácter en el campo “Separado por”.
  - Separados por : Define qué carácter se usará para separar los valores del campo con el valor devuelto por el lookup. Solo es necesario informar este valor de la opción Mostrar original y el valor de lookup está habilitado.
  - Elija la conexión : Le permite seleccionar otra conexión específica existente en el proyecto. El comando de selección se realizará en la segunda conexión.
- Lookup Método - Manual
  
  Este método se usa para que el desarrollador pueda crear manualmente la lista de valores que se guardarán en la aplicación generada. Este método se usa principalmente cuando la base de datos no tiene una tabla que contenga esta información.
  
  Interfaz de lookup manual.
  - Tipo de Lookup : Defina la funcionalidad del lookup, siendo: Valor único, Valores múltiples (delimitador), Valores múltiples (posición) y Valores múltiples (binario).
    - Valor único :
    Se mostrará solo un valor para el campo. Y reemplazará el valor almacenado de la tabla con el definido en la etiqueta del artículo.
    
    Configuración de lookup de valor único
    - Etiqueta : Texto que se mostrará en la lista de elementos del campo de selección.
    - Valor : Atributo que corresponde al valor que está almacenado en el campo de la tabla. Por ejemplo, el valor H se incluirá en la tabla cuando el usuario verá en la lista Hombre.
  - Múltiples Valores (Delimitador) Se pueden mostrar varios valores para el campo seleccionado. Los valores deben estar separados por un delimitador que será informado. Se realiza una sustitución en las partes del campo, separadas por el delimitador, con los valores que figuran en la lista.
    
    Configurar múltiples valores (delimitador).
    - Etiqueta : Texto que se mostrará en la lista de elementos del campo de selección.
    - Valor : Atributo que corresponde al valor que está almacenado en el campo de la tabla. Por ejemplo, el valor H se incluirá en la tabla cuando el usuario verá en la lista Hombre.
    - Delimitador Caracteres utilizados para separar valores múltiples en el campo de la tabla. Si no se informa, el delimitador predeterminado es un punto y coma (;).
  - Múltiples Valores (posición)
    Permite almacenar una diversidad de información seleccionada en el campo en una sola cadena. Para que se agregue esta información, debe informar la etiqueta, la posición inicial y el número de bytes que ocupa cada información en una cadena. Para este ejemplo, se usaron Género, Estado civil y Pasatiempo. El género usa un byte como el estado marcial, el Hobby usará dos bytes.
El ejemplo a continuación:
```
          | Etiqueta     | Valor    | Inicio     | Tamaño      |
          |--------------|----------|------------|-------------|
          | Hombre       | H        | 1          | 1           |
          | Mujer        | M        | 1          | 1         |
          | Divorciado  | D        | 2         | 1         |
          | Soltero        | S        | 2         | 1         |
          | Estudiante  | Es       | 3         | 2         |
          | Deporte      | Dp       | 3         | 2         |
          | Lectura       | L       | 3         | 2         |

          Ejemplo: De que elija __Hombre__, __Soltero__ y __Lectura__, en la base de datos se almacenó el siguiente valor __HSL__.
```
Configuración de Múltiples valores (posición).
- Etiqueta: Texto que se mostrará en la Grid.
- Valor : Atributo que corresponde al valor que está almacenado en el campo de la tabla. Por ejemplo, el valor H se incluirá en la tabla cuando el usuario verá en la lista Hombre.
- Iniciar : Posición de inicio de la cadena que se va a almacenar. La primera posición es siempre 1.
- Tamaño : Cantidad de bytes que va a ocupar en la cadena.
  - Múltiples Valores (binario)
    Permite almacenar una diversidad de información seleccionada en el campo en un solo valor. En este ejemplo utiliza la siguiente lista (aunque no está informado al insertar valores en la lista, cada elemento tiene un valor aplicado automáticamente según el orden): | Valor de atributo | Descripción del Lookup | |-------------------|-----------------------| | 1 | Deportes | | 2 | Cultura | | 4 | Placer | | 8 | Leyendo | | 16 | Música |
Para almacenar los datos, se hace una suma interna del número decimal. Vea los ejemplos a continuación.
```
          Ejemplo 1: si se seleccionaron las opciones __Deportes__ y __Cultura__, el número almacenado en la tabla sería __3__.

           | Valor de atributo   | Descripción del Lookup  |
          |-------------------|-----------------------|
          | 1                 | Deportes                |
          | 2                 | Cultura               |
          | 4                 | Placer              |
          | 8                 | Leyendo              |
          | 16                | Música                 |

          1 (Deportes) + 2 (Cultura) = __3__

          Ejemplo 2: Si se seleccionaron las opciones __Deportes__, __Placer__ y __Leyendo__, el número almacenado en la tabla sería __13__.

          | Valor de atributo   | Descripción del Lookup  |
          |-------------------|-----------------------|
          | 1                 | Deportes                |
          | 2                 | Cultura               |
          | 4                 | Placer              |
          | 8                 | Leyendo              |
          | 16                | Música                 |

          1 (Deportes) + 4 (Placer) + 8 (Leyendo) = __13__
```
Configuración de Múltiples valores (binario).
- Etiqueta : Texto que se mostrará en la grid.
- Insertar : Agrega a la lista los valores informados en los campos Etiqueta y Valor.
- Actualizar : Modifica los atributos del elemento seleccionado.
- Borrar : Eliminar el elemento seleccionado de la lista.
- Limpiar : Borrar los campos.
- Guardar : Permite al usuario guardar todos los elementos de la lista, para usar en otros campos, simplemente haga clic en Cargar definición de lookup.
- Cargar definiciones de lookup : Permite actualizar la lista de valores predefinidos cuando se utiliza la búsqueda. Se enumerarán las definiciones existentes en ScriptCase y las guardadas por el usuario.
- Utilice el lookup en :
  - Grid : Aplica la búsqueda a todos los formatos de la Grid (HTML, PDF, XML, CSV y RTF).
  - Resumen: Aplica la búsqueda solo para el resumen (HTML and PDF).
  - Ambos : Se aplica tanto a la cuadrícula como al resumen.
- Valor predeterminado : Define el valor predeterminado, utilizado en los casos en que el comando de selección no devuelve ningún valor.
- Mostrar original y el valor de lookup : Cuando se selecciona No, se visualiza en el valor del comando de selección. De lo contrario, se mostrará el valor original del campo y el valor devuelto por el comando de selección separado por el carácter en el campo “Separado por”.
- Separado por : Define qué carácter se usará para separar los valores del campo con el valor devuelto por la búsqueda. Solo es necesario informar este valor de la opción Mostrar original y el valor de búsqueda está habilitado.