Contenido

# Datos

La pestaña Datos permite asignar un origen de datos al control seleccionado.

Para acceder a esta orden…

Open context menu of a selected form element - choose Control Properties - Data tab.

Open Form Design toolbar, click Control icon - Data tab.

For forms with database links, the associated database is defined in the Form Properties. You will find the functions for this on the Data tab page.

The possible settings of the Data tab page of a control depend on the respective control. You will only see the options that are available for the current control and context.
The following fields are available:

## Cadenas vacías son NULL

Defines how an empty string input should be handled. If set to "Yes", an input string of length zero will be treated as a value NULL. If set to "No", any input will be treated as-is without any conversion.

An empty string is a string of length zero (""). Normally, a value NULL is not the same as an empty string. In general, a term NULL is used to denote an undefined value, an unknown value, or "no value has been entered yet."

Los sistemas de bases de datos varían y pueden manejar un valor NULL de manera diferente. Referirse a las documentaciones de las bases de datos que se están usando.

## Campo de datos

With database forms, you can link controls with the data fields.

Las posibilidades son diversas:

1. Primer caso: en el formulario solamente hay una tabla.

   En Campo de datos especifique el campo de la tabla del origen de datos cuyo contenido quiera ver.

2. Segundo caso: el control pertenece a un subformulario creado por una consulta SQL.

   En Campo de datos especifique el campo de la expresión SQL cuyo contenido quiera ver.

1. Tercer caso: cuadros combinados

   Para los campos combinados, especifique en Campo de datos el campo de la tabla de formulario actual donde han de guardarse los valores seleccionados o introducidos por el usuario. (Los valores visualizados en la lista del campo combinado se determinan con una instrucción SQL introducida en Contenido de lista.)

2. Cuarto caso: cuadros de lista

   La tabla del origen de datos no contiene los datos que se mostrarán, sino una tabla enlazada con la tabla del origen de datos a través de un campo de datos en común.

   Si desea que en una lista se muestren datos procedentes de una tabla vinculada con la tabla de fuente de datos actual, especifique en Campo de datos el campo de la tabla de fuente de datos al que se hace referencia el listado. También puede especificar el campo de la base de datos que controla la visualización de los datos en el formulario. Este campo de datos proporciona el vínculo con la otra tabla, si ambas tablas se pueden vincular a través de un campo de datos común. Suele tratarse de un campo de datos con números de identificación unívocos. El campo de datos cuyo contenido se muestra en el formulario se especifica mediante una expresión SQL en Contenido de lista.

Los listados funcionan con referencias. Estas pueden implementarse con tablas enlazadas a través de instrucciones SQL (cuarto caso) o a través de listas de valores:

Referencias por tablas vinculadas (instrucciones SQL)

Si desea mostrar en un listado datos de una tabla de base de datos vinculada mediante un campo común con la tabla en la que se basa el formulario, deberá especificar el campo de vínculo de la tabla del formulario en Campo de datos.

El enlace se efectúa mediante una expresión Select de SQL que, si seleccionó «SQL» o «SQL nativo», se especifica en Tipo de contenido de lista en el campo Contenido de lista. Por ejemplo, una tabla «Pedidos» se enlaza con el control del formulario actual y en la base de datos una tabla «Clientes» se enlaza a la tabla «Pedidos». Puede usar una instrucción SQL de la forma siguiente:

SELECT NombreCliente, NumCliente FROM Clientes,

donde «NombreCliente» es el campo de datos de la tabla enlazada «Clientes» y «NumCliente» es el campo de la tabla «Clientes» que se enlaza con un campo de la tabla de formulario «Pedidos» especificado en Campo de datos.

Referencias por listas de valores

En los cuadros de lista se pueden utilizar listas de valores, que definen valores referenciales. De esta manera, el control en el formulario no muestra directamente el contenido de un campo de base de datos, sino los valores asignados mediante la lista de valores.

Si trabaja con valores de referencia de una lista de valores, el contenido del campo de datos especificado en el formulario en Campo de datos no es visible; lo que se muestra son los valores asignados. Si elige «Lista de valores» como Tipo de contenido de lista en la pestaña Datos y asigna un valor de referencia a las entradas de lista visibles en el formulario en Entradas de la lista (introducidas en la pestaña General), los valores de referencia se comparan con los datos contenidos en el campo de datos especificado. Si un valor de referencia se corresponde con el contenido de un campo de datos, las entradas de lista asociadas se muestran en el formulario.

## Campo ligado

Si elimina el contenido de la celda Campo ligado del explorador de propiedades, el primer campo del conjunto de resultados se utiliza para mostrar e intercambiar datos.

Esta propiedad disponible para los listados determina el campo de datos de una tabla enlazada que debe visualizarse en un formulario.

Si un cuadro de lista del formulario muestra el contenido de una tabla enlazada con una tabla de formulario, en el campo Tipo del contenido de lista defina si la visualización la determina una orden SQL o se accede a la tabla (enlazada). Con la propiedad Campo ligado, utilice un índice para indicar el campo de datos de la consulta o de la tabla con los que se enlaza la lista.

La propiedad Campo ligado se aplica únicamente a formularios que se utilizan para acceder a más de una tabla. Si el formulario se basa en una única tabla, el campo que se debe mostrar en el formulario se especifica directamente en Campo de datos. No obstante, si desea que en el listado se muestren datos de una tabla vinculada con la tabla actual a través de un campo de datos común, el campo de datos vinculado se define mediante la propiedad Campo ligado.

Si ha seleccionado «SQL» en Tipo del contenido de lista, la orden SQL determina el índice que se debe especificar. Por ejemplo, si especifica en Contenido de la lista una orden SQL como «SELECT Campo1, Campo2 FROM nombretabla», consulte la tabla siguiente:

Campo ligado | Enlace
--- | ---
-1 | El índice de la entrada seleccionada de la lista se enlaza con el campo especificado en Campo de datos.
{vacío} o 0 | El campo de base de datos «Campo1» se enlaza con el campo especificado en Campo de datos.
1 | El campo de base de datos «Campo2» se enlaza con el campo especificado en Campo de datos.

Si ha seleccionado «Tabla» en Tipo de contenido de lista, la estructura de la tabla determina el índice que se debe especificar. Por ejemplo, si en Contenido de la lista se selecciona una tabla de base de datos, consulte la tabla siguiente:

Campo ligado | Enlace
--- | ---
-1 | El índice de la entrada seleccionada de la lista se enlaza con el campo especificado en Campo de datos.
{vacío} o 0 | La primera columna de la tabla se enlaza con el campo especificado en Campo de datos.
1 | La segunda columna de la tabla se enlaza con el campo especificado en Campo de datos.
2 | La tercera columna de la tabla se enlaza con el campo especificado en Campo de datos.

## Celda enlazada

Specifies the reference to a linked cell on a spreadsheet. The live state or contents of the control are linked to the cell contents. The following tables list the controls and their corresponding link type:

### Casilla de verificación con celda enlazada

Acción | Resultado
--- | ---
Marque la casilla de verificación: | TRUE is entered into the linked cell.
Desmarque la casilla de verificación: | FALSE is entered into the linked cell.
Tri-state check box is set to "undetermined" state: | #NV is entered into the linked cell.
Enter a number or a formula that returns a number in the linked cell: | If entered value is TRUE or not 0: Check box is selected. If entered value is FALSE or 0: Check box is deselected.
Clear the linked cell, or enter text, or enter a formula that returns text or an error: | La casilla de verificación se configura en el estado "indeterminado" si es una casilla de tres estados; de lo contrario, se deselecciona.
Select the box. The Reference value box contains text: | The text from the Reference value box is copied to the cell.
Deselect the box. The Reference value box contains text: | En la celda se copia una cadena vacía.
El cuadro Valor de referencia contiene texto. Introduzca el mismo texto en la celda: | Se selecciona la casilla de verificación.
The Reference value box contains text. Enter another text into the cell: | Se deselecciona la casilla de verificación.

### Botón de opción con celda enlazada

Acción | Resultado
--- | ---
Seleccione el botón de opción: | TRUE is entered into the linked cell.
Option button is deselected by selecting another option button: | FALSE is entered into the linked cell.
Enter a number or a formula that returns a number in the linked cell: | If entered value is TRUE or not 0: Option button is selected. If entered value is FALSE or 0: Option button is deselected.
Clear the linked cell, or enter text, or enter a formula that returns text or an error: | Option button is deselected.
Click the option button. The Reference value box contains text: | The text from the Reference value box is copied to the cell.
Click another option button of the same group. The Reference value box contains text: | En la celda se copia una cadena vacía.
El cuadro Valor de referencia contiene texto. Introduzca el mismo texto en la celda: | Se selecciona el botón de opción.
The Reference value box contains text. Enter another text into the cell: | Se borra el botón de opción.

### Cuadro de texto con celda enlazada

Acción | Resultado
--- | ---
Enter text into the text box: | El texto se copia en la celda enlazada.
Vacíe el cuadro de texto: | Se vacía la celda enlazada.
Introduzca texto o un número en la celda enlazada: | El texto o el número se copia en el cuadro de texto.
Introduzca una fórmula en la celda enlazada: | El resultado de la fórmula se copia en el cuadro de texto.
Clear the linked cell: | Se vacía el cuadro de texto.

### Campo numérico y campo con formato con celda enlazada

Acción | Resultado
--- | ---
Enter a number into the field: | Number is copied into the linked cell.
Vacíe el campo: | Value 0 is set in the linked cell.
Enter a number or a formula that returns a number in the linked cell: | El número se copia en el campo.
Vacíe la celda enlazada, introduzca texto o introduzca una fórmula que devuelva texto o un error: | Value 0 is set in the field.

### Cuadro de lista con celda enlazada

Los cuadros de lista admiten dos modos de enlace distintos. Consulte la propiedad «Contenido de la celda enlazada».

1. Linked contents: Synchronize the text contents of the selected list box entry with the cell contents.

2. Linked selection position: The position of the single selected item in the list box is synchronized with the numerical value in the cell.

Acción | Resultado
--- | ---
Select a single list item: | Se enlaza el contenido: el texto del elemento se copia en la celda enlazada. Selection is linked: Position of the selected item is copied into the linked cell. For example, if the third item is selected, the number 3 will be copied.
Select several list items: | #NV is entered into the linked cell.
Deselect all list items: | Contents are linked: Linked cell is cleared. Selection is linked: Value 0 is entered in the linked cell.
Enter text or a number into the linked cell: | Contents are linked: Find and select an equal list item. Selection is linked: The list item at the specified position (starting with 1 for the first item) is selected. If not found, all items are deselected.
Introduzca una fórmula en la celda enlazada: | Find and select a list item that matches the formula result and link mode.
Clear the linked cell: | Deselect all items in the list box.
Change the contents of the list source range: | Los elementos del cuadro de lista se actualizan de acuerdo con el cambio. Se conserva la selección. Esto puede causar una actualización de la celda enlazada.

### Cuadro combinado con celda enlazada

Acción | Resultado
--- | ---
Enter text into the edit field of the combo box, or select an entry from the drop-down list: | El texto se copia en la celda enlazada.
Clear the edit field of the combo box: | Se vacía la celda enlazada.
Enter text or a number into the linked cell: | Text or number is copied into the edit field of the combo box.
Enter a formula into the linked cell: | Formula result is copied into the edit field of the combo box.
Clear the linked cell: | Edit field of the combo box is cleared.
Cambie el contenido del intervalo de origen de la lista: | Los elementos de la lista desplegable se actualizan de acuerdo con el cambio. No se cambian el campo de edición del cuadro combinado ni la celda enlazada.

## Contenido de la celda enlazada

Seleccione el modo de enlace de un cuadro de lista con una celda enlazada en una hoja de cálculo.

1. Linked contents: Synchronize the text contents of the selected list box entry with the cell contents. Select "The selected entry".

2. Linked selection position: The position of the single selected item in the list box is synchronized with the numerical value in the cell. Select "Position of the selected entry".

## Contenido de lista

En los formularios de base de datos, especifica el origen de datos del contenido de la lista del elemento del formulario. Este campo puede utilizarse para definir una lista de valores para los documentos sin efectuar una conexión con una base de datos.

En el caso de formularios de base de datos, el origen de datos determina las entradas que contienen el listado o el cuadro combinado. Según el tipo seleccionado podrá optar entre distintos orígenes de datos en Contenido de la lista, siempre que dichos objetos existan en la base de datos. Aquí se ofrecen todos los objetos de base de datos del tipo seleccionado en Tipo del contenido de lista. Si ha seleccionado el tipo «Lista de valores», puede utilizar referencias para formularios de base de datos. Si la visualización del control depende de una orden SQL, dicha orden se introduce aquí.

Ejemplos de instrucciones SQL:

En cuadros de lista, una sentencia SQL puede tener la siguiente forma:

SELECT campo1, campo2 FROM tabla,

donde "tabla" es la tabla cuyos datos se visualizan en la lista del campo de control (tabla de listas). "campo1" es el campo de datos que determina las entradas visibles del formulario; su contenido se visualiza en el listado. "campo2" es el campo de la tabla de listas que está vinculado a la tabla de formulario (tabla de valores) mediante un campo especificado en Campo de datos si selecciona el valor 1 en Campo ligado.

En cuadros combinados, una sentencia SQL puede tomar la siguiente forma:

SELECT DISTINCT campo FROM tabla,

Aquí, "campo" es un campo de datos de la "tabla" de la lista cuyo contenido se muestra en el cuadro combinado.

Listas de valores para documentos HTML

En el caso de formularios HTML, puede iniciar una lista de valores en Contenido de la lista. Seleccione la opción "Lista de valores" en Tipo del contenido de lista. Los valores introducidos aquí no serán visibles en el formulario y se utilizarán para asignar valores a las entradas visibles. Las entradas efectuadas en Contenido de la lista corresponden a la etiqueta HTML <OPTION VALUE=...>.

En la transferencia de datos de una entrada seleccionada desde un listado o un cuadro combinado, se tienen en cuenta tanto la lista de valores mostrada en el formulario, introducida en entradas de la lista de la pestaña General, como el valor introducido en Contenido de la lista de la pestaña Datos: Si en la posición seleccionada de la lista de valores (<OPTION VALUE=...>) hay un texto (no vacío), dicho texto se transmitirá. En caso contrario se enviará el texto mostrado en el campo de control (<OPTION>).

Si la lista de valores debe contener una cadena vacía, escriba el valor "$$$empty$$$" en la posición correspondiente de Contenido de la lista (tenga en cuenta las mayúsculas y minúsculas). LibreOffice interpreta esta entrada como una cadena vacía y la asigna a la respectiva entrada de lista.

La tabla siguiente muestra las relaciones entre HTML, JavaScript y el campo de LibreOffice Contenido de lista utilizando como ejemplo un cuadro de lista denominado «ListBox1». En este caso, «Item» designa a una entrada de lista visible en el formulario:

Etiqueta HTML | JavaScript | Entrada en la lista de valores del control (Contenido de lista) | Datos transmitidos
<OPTION>Elemento | Imposible | "" | ...el registro de lista visible ("ListBox1=Item").
<OPTION VALUE="Valor">Item | ListBox1.options[0].value="Valor" | "Valor" | ...el valor asignado al registro de lista ("ListBox1=Valor").
<OPTION VALUE="">Item | ListBox1.options[0].value="" | "$$$empty$$$" | ...una cadena de caracteres vacía ("ListBox1=").

## Intervalo de celda de origen

Enter a cell range that contains the entries for a list box or combo box on a spreadsheet. If you enter a multi-column range, only the contents of the leftmost column are used to fill the control.

## Propuesta de filtro

While designing your form, you can set the "Filter proposal" property for each text box in the Data tab of the corresponding Properties dialog. In subsequent searches in the filter mode, you can select from all information contained in these fields. The field content can then be selected using the AutoComplete function. Note, however, that this function requires a greater amount of memory space and time, especially when used in large databases and should therefore be used sparingly.

## Tipo de contenido de lista

Determina los datos con que se rellenarán las listas de cuadros de lista y combinados.

La opción «Lista de valores» determina que todas las entradas del campo Entradas de la lista de la pestaña Generales aparezcan en el control. En el caso de formularios de base de datos, pueden emplearse valores de referencia (consulte la sección Referencias mediante listas de valores).

Si el contenido del control se lee desde una base de datos, puede determinarse el tipo de origen de datos mediante las otras opciones. Por ejemplo, se puede elegir entre tablas y consultas.

## Valor de referencia (activado)

You can assign a reference value to option buttons and check boxes. The reference value will be remitted to a server when sending the web form. With database forms the value entered here will be written in the database assigned to the control field.

Valores referenciales para formularios de bases de datos

Los valores de referencia son útiles si diseña formularios web y la información del estado del control debe transmitirse al servidor. Si el usuario pulsa sobre el control, el valor correspondiente se envía al servidor.

Por ejemplo, si hay dos controles para las opciones «femenino» y «masculino» y se asigna un valor de referencia de 1 al control «femenino» y de 2 al control «masculino», se transmitirá al servidor el valor 1 si un usuario pulsa en el control «femenino» y el valor 2 si pulsa en «masculino».

Valores referenciales para formularios de bases de datos

Con los formularios de bases de datos también puede identificar el estado de un campo de opciones o de una casilla de verificación con un valor referencial y guardar este valor en la base de datos. Por ejemplo, si tiene un grupo de tres opciones llamadas "en curso", "finalizado" y "revisión" con los respectivos valores referenciales "ToDo", "OK" y "REV", son estos valores los que aparecen en la base de datos cada vez que pulsa en la respectiva opción.

## Valor de referencia (desactivado)

Check boxes and radio buttons in spreadsheets can be bound to cells in the current document. If the control is enabled, the value you enter in Reference value (on) is copied to the cell. If the control is disabled, the value from Reference value (off) is copied to the cell.