Feedback

# Select
View video

## Configuración General

Interfaz de configuración de un campo Select

- Tipo de datos: Permite definir el tipo de campo para la aplicación. Cuando se establece en Seleccionar, puede seleccionar múltiples opciones de un cuadro combinado(Seleccionar campo).

- Etiqueta: Permite definir el título de un campo en la aplicación. Por ejemplo: si el campo está definido en la base de datos como cmp_name_client, será más claro para la comprensión del usuario si el nombre sería “Nombre del cliente”.

- Etiqueta debajo del campo: Define el mensaje que se mostrará debajo del campo.

- Valor inicial (tipo): Le permite definir el valor inicial para el campo cuando está en modo insertar. Las opciones son:
- Definido: El campo recibirá el valor del campo de texto de la opción de valor definido.

- Fecha Sistema: El campo recibirá la fecha actual del servidor.

  > Si selecciona la Fecha sistema, entonces no es necesario informar el atributo Valor inicial.

- Valor inicial: Informará aquí el valor definido.
- Usar Select2: Utiliza el nuevo componente para la selección de datos, permitiendo búsquedas dentro de la selección.
- Mostrar área de búsqueda Select2: Establece si se muestra el campo de búsqueda dentro de Select2.

Interfaz de configuración de valor inicial.

- Guardar variable: Permite guardar una variable en la sesión con el valor del campo, que se puede usar en otras aplicaciones. Por ejemplo, en el formulario de inicio de sesión, el nombre de usuario se puede guardar en la sesión para que pueda mostrarse en el encabezado de otras aplicaciones.
- Nombre de la variable: Permite definir el nombre de la variable de sesión que recibirá el valor del campo.
- Tamaño en la base de datos: Permite determinar el tamaño del campo en bytes. Se usa para determinar el tamaño máximo de caracteres que se permite escribir.
- Campo oculto: Esta opción hace que el campo esté oculto, pero aún permite que su valor sea procesado a través de Javascript o PHP.
- Deshabilitar campo: Permite definir si el campo se desactivará en “Insertar modo”, “Actualizar modo” o en “Insertar y actualizar modo”.
- Tipo de HTML: El objeto HTML se usará para mostrar el campo en el formulario.
- Tipo de SQL: Informa el tipo de datos del campo en la base de datos.

## Valor de la Base de Datos

Permite definir un valor que se guardará en la base de datos.

Interfaz de configuración de valores de base de datos.

- Definido : Permite especificar el valor fijo asociado a las variables globales.

Interfaz de configuración de valor definido.

- Aumento automático (automático) : Permite usar el incremento generado por la base de datos. Se usa solo cuando el campo de la base de datos es del tipo INCREMENTO AUTOMÁTICO o similar. Para las bases de datos que usan secuencias como Oracle, PostGres y Firebird, es necesario informar el nombre de la secuencia.

Interfaz de configuración de incremento automático.

- Aumento automático (manual) : La aplicación generada simula un incremento automático en el campo. Para incluir un valor en el campo, calculará automáticamente la siguiente identificación.
- Fecha de inclución : Al insertar un registro, el campo contendrá la fecha del servidor como un valor.
- Datos de actualización : Al actualizar un registro, el valor del campo será la fecha del servidor.
- IP de usuario : El campo recibirá la dirección IP de la máquina a la que se accede a la aplicación mediante.
- Calculado por la base de datos : El valor del campo será aplicado por la base de datos. El campo no se usará en los procesos de actualización. Por ejemplo: se actualizará con un disparador.
- Null : El campo será informado el valor nulo.

## Optiones de Lookup

### Configuración 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 M o F puede presentarse como Masculino o Femenino o de forma dinámica, teniendo estos valores recuperados de la base de datos.

Configuración de Lookup para el campo.

Edición de lookup Tendrá disponibles dos tipos de métodos de búsqueda: Manual (que informa manualmente las condiciones de la selección) o Automático (utilizando una consulta de base de datos).

Seleccionando el tipo de Lookup.

Método de lookup - Automático

El lookup mostrará los valores seleccionados en el campo de verificación. Estos valores se recuperarán dinámicamente con el comando Select.

Interfaz del Lookup Automático

SQL Select: Permite definir el comando SQL que se mostrarán en el campo del formulario. El comando necesita tener la siguiente estructura “SELECT campo_clave, campo_descripcion FROM tabla”.

> El valor de campo_clave se almacenará en el campo de la tabla.

- Valores múltiples: Cuando está habilitada esta opción, permite seleccionar más de un elemento de la lista, separados por un delimitador.

- Delimitador : Permite definir 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 (;).
- Altura : Permite definir la altura para el objeto seleccionado.

- Utilice título : Permite mostrar una línea de título en el objeto de selección (Atributo del título) asociado a un valor informado manualmente (Valor interno del título).

- Valor interno del título: Valor Guardado en el campo cuando se selecciona la línea del título en el objeto.
- Título: Texto que se muestra en el título del objeto Seleccionar.
- Recargar formulario cuando el valor ha cambiado: Con esta opción seleccionada, el formulario se actualizará si hay un cambio en el objeto seleccionado en el campo.
- Mostrar original y valor de lookup: Muestra el valor del campo y el valor devuelto por la búsqueda.

- Separado por: Permite definir 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.
- 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.
- Enlace: Permite crear un enlace a otro formulario que permite manipular la lista que se muestra en el campo de selección. Después de la manipulación, el objeto seleccionado se actualizó automáticamente.

Método de lookup - 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 del Lookup Manual.

Tipo de lookup: Permite definir la funcionalidad del lookup, siendo: valor único, valores múltiples (delimitador), valores múltiples (posición) y valores múltiples (binario).

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 M se incluirá en la tabla cuando el usuario verá en la lista Masculino.
- Predeterminado: Con esta opción habilitada, el elemento seleccionado se insertará en la tabla cuando se haya confirmado.
- Altura: Permite definir la altura para el objeto seleccionado.

Múltiples Valores(delimitador)

Puede almacenar varios valores para el campo de selección. Los valores están separados por el delimitador informado. Por ejemplo: la combinación Deporte, Cinema y Turismo se almacenará como D; C; T en caso de que el delimitador sea; (semi coma).

Configuración de lookup de Multiple 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 M se incluirá en la tabla cuando el usuario verá en la lista Masculino. * Delimitador Caracteres utilizados para separar valores múltiples en el campo de la tabla. Si no se informa, el delimitador predeterminado es un semi coma (;). * Altura: Permite definir la altura para el objeto seleccionado.

- 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 civil, el Pasatiempo usará dos bytes.

El siguiente ejemplo:

                 | Etiqueta     | Valor    | Inicio    | Tamaño   |
                 |-----------|----------|-----------|-----------|
                 | Hombre       | H        | 1         | 1         |
                 | Mujer     | M        | 1         | 1         |
                 | Divorciado  | D        | 2         | 1         |
                 | Soltero    | S        | 2         | 1         |
                 | Estudiar     | ES       | 3         | 2         |
                 | Deporte    | DE       | 3         | 2         |
                 | Leer      | LE       | 3         | 2         |

> Ejemplo: Usted elige Hombre, Soltero y Leer, en el banco de datos será llamado con el siguiente valor MSLE.

Configuración de valores múltiples (posición)

- 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 M se incluirá en la tabla cuando el usuario verá en la lista Masculino.

  - Negativo : Valor que se guardará en la tabla en caso de que no haya ningún valor seleccionado en el campo.

  - 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.

  - Altura : Define la altura para el objeto seleccionado.

- Múltiple 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):

Atributo del Valor | Descripción de 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.

Atributo del Valor | Descripción de 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.

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

1 (Deportes) + 4 (Placer) + 8 (Leyendo) = 13

Configuración del la edición de lookup Múltiples valores (Binario)

- Etiqueta: Texto que se mostrará en el elemento de lista del campo de selección.

* Altura: Define la altura para el select object.

* Insertar Botón: Inserta a la lista de los valores informados en los campos de etiqueta y valor.

* Actualizar Botón: Modifica los atributos del elemento seleccionado.

* Borrar Botón: Quita el elemento seleccionado de la lista.

* Limpiar Botón: Limpia los campos.

* Guardar Botón: Permite que el usuario para guardar todos los elementos de la lista, para usarlos en otros campos, haga clic en Load lookup definition.

* Cargar definiciones de lookup: Permite restaurar la lista de valores predeterminados cuando se utiliza la búsqueda. Se enumeran las diferencias existentes en la secuencia de comandos y los guardados por el usuario.

* Usar título: Permite que se muestre una línea de título en el objeto seleccionado (Atributo del Título) asociado a un valor informado manual (Valor interno del título).

- Valor interno del título: Valor Guardado en el campo cuando se selecciona la línea del título en el objeto.
- Título: Texto que se muestra en el título del objeto Seleccionar.
- Recargar formulario cuando el valor ha cambiado: Con esta opción seleccionada, el formulario se actualizará si hay un cambio en el objeto seleccionado en el campo.
- Mostrar original y valor de lookup: Muestra el valor del campo y el valor devuelto por la búsqueda.

Mostrando la búsqueda original.

- Separado por: Permite definir 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.

#### Método de Lookup - Valor Actual

Este lookup se usa para enumerar todos los valores en el campo seleccionado.

> Este lookup aplicará un “distint” a su consulta SQL.

## Procesamiento Ajax

Interfaz de configuración de procesamiento Ajax.

Permite definir el campo que se volverá a cargar al seleccionar un valor que tenga el activador (onChange).

Por ejemplo: un campo del tipo seleccionar con una lista de estados, y otro campo de selección con una lista de ciudades. Al seleccionar un estado, la lista de ciudades se vuelve a cargar.

## Configuración de Visualización

La configuración de visualización permite definir el CSS para los campos individualmente. Para cada Configuración de pantalla de Scriptcase, existen los mismos atributos disponibles para esta interfaz.

Interfaz Configuración de visualización.

- CSS del título
  - Fuente : Permite elegir el tipo de letra, que se aplicará al título del campo de la aplicación.
  - Tamaño de Fuente: : Permite elegir el tamaño de letra, que se aplicará al título del campo de la aplicación.
  - Color de fuente :Permite elegir un color para la fuente desde la paleta de colores.
  - Color de fondo : Permite definir el color para el campo, el color se puede seleccionar de la paleta de colores.
  - Negrita : Aplica el estilo en negrita a la fuente.
  - Subrayado : Aplica el estilo de subrayado a la fuente.
  - Tamaño del borde : Aplica el tamaño del borde al título del campo.
  - Color del borde : Permite elegir un color para el borde, usando una paleta de colores para aplicar al título.
  - Alinear horizontal : Permite colocar la etiqueta del campo en la posición deseada (izquierda, derecha, centro y justificar).
  - Alinear vertical : Permite colocar la etiqueta del campo en la posición deseada (línea base, sub, super, arriba, texto arriba, medio, abajo, fondo de texto).
  - Anchura : Para definir un ancho para el título del campo.
  - Altura : Para definir una altura para el título del campo.
- CSS del Campo
  - Fuente : Permite elegir el tipo de letra, que se aplicará al campo de la aplicación.
  - Tamaño de Fuente : Permite elegir el tamaño de letra, que se aplicará al campo de la aplicación.
  - Color de fuente :Permite elegir un color para la fuente desde la paleta de colores.
  - Color de fondo : Permite definir el color para el campo, el color se puede seleccionar de la paleta de colores.
  - Negrita : Aplica el estilo en negrita a la fuente.
  - Subrayado : Aplica el estilo de subrayado a la fuente.
  - Tamaño del borde : Aplica el tamaño del borde al campo.
  - Color del borde : Permite elegir un color para el borde, usando una paleta de colores para aplicar al campo.
  - Alinear horizontal : Permite colocar el objeto de entrada en la posición deseada (izquierda, derecha, centro y justificar)
  - Alinear vertical : Permite colocar el campo en la posición deseada (línea base, sub, super, arriba, texto arriba, medio, abajo, fondo de texto).
  - Anchura : Para definir un ancho para el campo.
  - Altura : Para definir una altura para el campo.
- CSS del OBJETO INPUT
  - Fuente : Permite elegir el tipo de letra, que se aplicará al objeto de entrada. Por ejemplo: Radio, Seleccionar, Texto, etc.
  - Tamaño de Fuente : Permite elegir el tamaño de fuente que se aplicará al campo de aplicación.
  - Color de fuente :Permite elegir un color para la fuente desde la paleta de colores.
  - Color de fondo : Permite definir el color para el objeto de entrada, el color se puede seleccionar desde la paleta de colores.
  - Negrita : Aplica el estilo en negrita a la fuente.
  - Subrayado : Aplica el estilo de subrayado a la fuente.
  - Tamaño del borde : Aplica el tamaño del borde al objeto de entrada.
  - Color del borde : Permite elegir un color para el borde, usando una paleta de colores para aplicar al objeto de entrada.
  - Alinear horizontal : Permite colocar el objeto de entrada en la posición deseada (izquierda, derecha, centro y justificar).
  - Vertical Alignment :Permite colocar el objeto de entrada en la posición deseada (línea de base, sub, super, arriba, texto arriba, medio, abajo, fondo de texto).
  - Anchura : Para definir un ancho para el objeto de entrada.
  - Altura : Para definir una altura para el objeto de entrada.

## Configuración de Ayuda

Permite que el desarrollador añada instrucciones y consejos de uso en el campo, permitiendo así que los desarrolladores ayuden a los usuarios en el entendimiento y la utilización del sistema.

### Descripción de los atributos de configuración.

#### Describa Ayuda

Área destinada a la inclusión del texto que será presentado en la aplicación de acuerdo con el tipo seleccionado abajo.

#### Tipo de ayuda

Define qual és el tipo de ayuda.

#### Sugerencia

Muestra un icono estándar ? al lado del campo. Al colocar el ratón sobre el ícono, aparecerá el mensaje.

#### Texto

Muestra el texto dentro de un `<span> </ span>`al lado del campo.

#### Pop-up

Muestra un icono estándar ? al lado del campo. Para ver el mensaje basta con hacer clic en el icono, aparecerá una ventana emergente que contiene el texto.

> El icono que aparece al seleccionar los tipos Hint o Popup varía según el tema que se utiliza. Este icono se puede cambiar en [css dos botoes].

#### Tippy

Muestra un icono estándar ? junto al campo. Al pasar el mouse sobre el ícono, el mensaje se mostrará de una manera más fácil de usar.

##### Configuración del tipo de ayuda (Tippy)

- Descripción de ayuda: Define dónde se mostrará el botón de ayuda del campo.

- Posición del botón de ayuda: define la posición de visualización de la sugerencia de Tippy en relación con el icono de ayuda del campo.

- Tiempo para abrir hin Tippy: Define el tiempo en milisegundos para que se muestre la sugerencia de Tippy después de que el mouse pasa sobre el ícono de ayuda.

- Tiempo para cerrar Tippy: establece el tiempo en milisegundos para que la sugerencia de Tippy esté oculta después de que el mouse abandona el ícono de ayuda.

- Ancho del hint Tippy: establece el ancho de la sugerencia Tippy en píxeles.

#### Posición del botón de ayuda (Excepto Tippy)

Define donde el botón de ayuda aparecerá en el campo de aplicación en ejecución. Las opciones son:

Al lado: El icono de ayuda aparecerá al lado del campo. En la columna: El icono de ayuda aparecerá junto a la etiqueta del campo.

#####

#####