Conteníu

# Datos

The Data tab page allows you to assign a data source to the selected control.

P'aportar a esta orde...

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:

## Cadenes baleres 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 sistemes de bases de datos varien y puen remanar un valor NULL de mou distintu. Referise a les documentaciones de les bases de datos que se tán usando.

## Campu amestáu

Si desanicia'l conteníu de la caxella Campu amestáu del esplorador de propiedaes, el primer campu del conxuntu de resultancies utilizar p'amosar ya intercambiar datos.

Esta propiedá disponible pa los llistaos determina'l campu de datos d'una tabla enllazada que tien de visualizase nun formulariu.

Si un cuadru de llista del formulariu amuesa'l conteníu d'una tabla enllazada con una tabla de formulariu, nel campu Tipu del conteníu de llista defina si la visualización determinar un comandu SQL o s'apuerta a la tabla (enllazada). Cola propiedá Campu amestáu, utilice un índiz pa indicar el campu de datos de la consulta o de la tabla colos que se enllaza la llista.

La propiedá Campu amestáu aplícase namái a formularios que s'utilicen p'aportar a más d'una tabla. Si'l formulariu basar nuna única tabla, el campu que se debe amosar nel formulariu especifícase direutamente en Campu de datos. Sicasí, si deseya que nel llistáu amuésense datos d'una tabla enllazada cola tabla actual al traviés d'un campu de datos común, el campu de datos enllazáu definir por aciu la propiedá Campu amestáu.

Si escueye "SQL" en Tipu del conteníu de llista, la orde SQL determina l'índiz que se debe especificar. Exemplu: Si especifica en Conteníu de la llista una orde SQL como "SELECT Campu1, Campu2 FROM nometabla", consulte la tabla siguiente:

Campu amestáu | Enllaz
--- | ---
-1 | L'índiz de la entrada seleicionada na llista ta enllazáu col campu indicáu en Campu de datos.
{balero} o 0 | La base de datos "Campu1" enllazar al campu especificáu en Campu de datos.
1 | La base de datos "Campu2" enllazar al campu especificáu en Campu de datos.

Si escueye "Tabla" en Tipu del conteníu de llista, la estructura de la tabla determina l'índiz que se debe especificar. Exemplu: Si en Conteníu de la llista escuéyese una tabla de base de datos, consulte la tabla siguiente:

Campu amestáu | Enllaz
--- | ---
-1 | L'índiz de la entrada seleicionada na llista ta enllazáu col campu indicáu en Campu de datos.
{balero} o 0 | La primer columna de la tabla enllazar al campu especificáu en Campu de datos.
1 | La segunda columna de la tabla enllazar al campu especificáu en Campu de datos.
2 | La tercer columna de la tabla enllazar al campu especificáu en Campu de datos.

## Campu de datos

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

Les posibilidaes son diverses:

1. Primer casu: Nel formulariu namái hai una tabla.

   En Campu de datos especifique'l campu de la tabla de la fonte de datos que'l so conteníu quiera ver.

2. Segundu casu: el control pertenez a un soformulariu creáu por una consulta SQL.

   En Campu de datos especifique'l campu de la espresión SQL que'l so conteníu quiera ver.

1. Third case: Cuadros combinaos

   Pa los campos combinaos, especifique en Campu de datos el campu de la tabla de formulariu actual onde han de guardase los valores escoyíos o introducíos pol usuariu. (Los valores visualizaos na llista del campu combinao determinar con una instrucción SQL introducida en Conteníu de llista.)

2. Fourth case: Llistaos

   La tabla de la fonte de datos nun contién los datos que se van amosar, sinón una tabla enllazada cola tabla de la fonte de datos al traviés d'un campu de datos comunes.

   Si deseya que nuna llista amuésense datos procedentes d'una tabla enllazada cola tabla de fonte de datos actual, especifique en Campu de datos el campu de la tabla de fonte de datos al que se fai referencia'l llistáu. Tamién pue especificar el campu de la base de datos que controla la visualización de los datos nel formulariu. Esti campu de datos apurre'l enllaz cola otra tabla, si dambes tables puen enllazase al traviés d'un campu de datos común. Suel tratase d'un campu de datos con númberos d'identificación unívocos. El campu de datos que'l so conteníu amosar nel formulariu especificar por aciu d'una espresión SQL en Conteníu de llista.

Los llistaos funcionen con referencies. Estes puen implementase con tables enllazaes al traviés d'instrucciones SQL (cuartu casu) o al traviés de llistes de valores:

Referencies por tables enllazaes (instrucciones SQL)

Si deseya amosar nun llistáu datos d'una tabla de base de datos enllazada por aciu d'un campu común cola tabla na que se basa'l formulariu, tendrá d'especificar el campu de enllaz de la tabla del formulariu en Campu de datos.

L'enllaz faise por aciu d'una espresión Select de SQL que, si escoyesti «SQL» o «SQL nativu», s'especifica en Triba del conteníu de llista nel campu Conteníu de llista. Por exemplu, una tabla «Pidíos» enllázase al control del formulariu actual y na base datos una tabla «Veceres» enllázase a la tabla «Pidíos». Pues usar una instrucción SQL d'esta forma:

SELECT NomeCliente, NumCliente FROM Veceros,

onde "nomecliente" ye'l campu de datos de la tabla enllazada "Veceres" y "Númberucliente" ye'l campu de la tabla "Veceres" que se enllaza a un campu de la tabla de formulariu "Ordes" especificáu en Campu de datos.

Referencies por llistes de valores

Nes caxes de llista puen utilizase llistes de valores, que definen valores referenciales. D'esti mou, el control nel formulariu nun amuesa direutamente'l conteníu d'un campu de base de datos, sinón los valores asignaos por aciu la llista de valores.

Si trabaya con valores de referencia d'una llista de valores, el conteníu del campu de datos especificáu nel formulariu en Campu de datos nun ye visible; lo que s'amuesa son los valores asignaos. Si escueye "Llista de valores" como Tipu de conteníu de llista na llingüeta Datos y asigna un valor de referencia a les entraes de llista visibles nel formulariu en Entraes de la llista (introducíes na llingüeta Xeneral), los valores de referencia comparar colos datos conteníos nel campu de datos especificáu. Si un valor de referencia corresponder col conteníu d'un campu de datos, les entraes de llista asociaes amosar nel formulariu.

## Caxella enllazada

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:

### Caxellu de verificación con caxella enllazada

Aición | Resultáu
--- | ---
Select the check box: | TRUE is entered into the linked cell.
Deselect the check box: | 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: | El caxellu de verificación afítase nel estáu «indetermináu» si ye un caxellu de tres estaos; de lo contrario, se deseleiciona.
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: | Na caxella copia una cadena balera.
The Reference value box contains text. Enter the same text into the cell: | Escuéyese'l caxellu de verificación.
The Reference value box contains text. Enter another text into the cell: | Se deseleiciona el caxellu de verificación.

### Botón d'opción con caxella enllazada

Aición | Resultáu
--- | ---
Select the option button: | 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: | Na caxella copia una cadena balera.
The Reference value box contains text. Enter the same text into the cell: | Escuéyese'l botón d'opción.
The Reference value box contains text. Enter another text into the cell: | Bórrase'l botón d'opción.

### Caxa de testu con caxella enllazada

Aición | Resultáu
--- | ---
Enter text into the text box: | Text is copied into the linked cell.
Clear the text box: | Linked cell is cleared.
Enter text or a number in the linked cell: | Text or number is copied into the text box.
Enter a formula into the linked cell: | Formula result is copied into the text box.
Clear the linked cell: | Text box is cleared.

### Campu numbérico y campu con formatu con caxella enllazada

Aición | Resultáu
--- | ---
Enter a number into the field: | Number is copied into the linked cell.
Clear the field: | Value 0 is set in the linked cell.
Enter a number or a formula that returns a number in the linked cell: | Number is copied into the field.
Clear the linked cell, or enter text, or enter a formula that returns text or an error: | Value 0 is set in the field.

### Cuadru de llista con caxella enllazada

Los cuadros de llista almiten dos maneres de vinculación distintos. Consulte la propiedá "Conteníu de la caxella enllazada".

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.

Aición | Resultáu
--- | ---
Select a single list item: | Vencéyase'l conteníu: el testu del elementu copiar na caxella enllazada. 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.
Enter a formula into the linked cell: | 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 cuadru de llista actualícense acordies col cambéu. Caltiense la seleición. Esto pue causar una anovación de la caxella enllazada.

### Cuado combináu con caxella enllazada

Aición | Resultáu
--- | ---
Enter text into the edit field of the combo box, or select an entry from the drop-down list: | Text is copied into the linked cell.
Clear the edit field of the combo box: | Linked cell is cleared.
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.
Change the contents of the list source range: | Los elementos de la llista desplegable actualícense acordies col cambéu. Nun se camuden el campu d'edición del cuadru combináu nin la caxella enllazada.

## Conteníu de la caxella enllazada

Select the mode of linking a list box with a linked cell on a spreadsheet.

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

## Conteníu de llista

With database forms, specifies the data source for the list content of the form-element. This field can be used to define a value list for documents without a database connection.

Nel casu de formularios de base de datos, la fonte de datos determina les entraes que contienen el llistáu o'l cuadru combináu. Según el tipu escoyíu va poder optar ente distintes fontes de datos en Conteníu de la llista, siempres que dichos oxetos esistan na base de datos. Equí ufiértense tolos oxetos de base de datos del tipu escoyíu en Tipu del conteníu de llista. Si escoyesti la triba «Llista de valores», pues usar referencies pa formularios de base de datos. Si la visualización del control depende d'una orde SQL, dicha orde introduzse equí.

Exemplos d'instrucciones SQL:

En cuadros de llista, una sentencia SQL pue tener la siguiente forma:

SELECT riolo1, campu2 FROM tabla,

onde "tabla" ye la tabla que los sos datos visualizar na llista del campu de control (tabla de llistes). "campu1" ye'l campu de datos que determina les entraes visibles del formulariu; el so conteníu visualizar nel llistáu. "campu2" ye'l campu de la tabla de llistes que ta enllazáu a la tabla de formulariu (tabla de valores) por aciu d'un campu especificáu en Campu de datos si escueye'l valor 1 en Campu amestáu.

En cuadros combinaos, una sentencia SQL pue tomar la siguiente forma:

SELECT DISTINCT riolo FROM tabla,

Equí, "campu" ye un campu de datos de la "tabla" de la llista que'l so conteníu amosar nel cuadru combináu.

Llistes de valores pa documentu HTML

Nel casu de formulario HTML, pue empecipiar una llista de valores en Conteníu de la llista. Escueya la opción "Llista de valores" en Tipu del conteníu de llista. Los valores introducíos equí nun van ser visibles nel formulariu y van utilizase p'asignar valores a les entraes visibles. Les entraes efeutuaes en Conteníu de la llista correspuenden a etiquetar HTML <option value=...>.

Na tresferencia de datos d'una entrada escoyida dende un llistáu o un cuadru combináu, tener en cuenta tantu la llista de valores amosada nel formulariu, introducida en entraes de la llista de la llingüeta Xeneral, como'l valor introducíu en Conteníu de la llista de la llingüeta Datos: Si na posición escoyida de la llista de valores (<option value=...>) hai un testu (non baleru), dichu testu va tresmitise. En casu contrariu va unviase'l testu amosáu nel campu de control (<option>).

Si la llista de valores tien de contener una cadena balera, escriba'l valor "$$$empty$$$" na posición correspondiente de Conteníu de la llista (tenga en cuenta les mayúscules y minúscules). LibreOffice interpreta esta entrada como una cadena balera y asignar a la respectiva entrada de llista.

La tabla siguiente amuesa les relaciones ente HTML, JavaScript y el campu Conteníu de llista de LibreOffice con un llistáu llamáu "ListBox1". Nesti casu "Item" designa a un rexistru de llista visible nel formulariu:

Tag HTML | JavaScript | Entrada na llista de valores del control (Conteníu de llista) | Datos tresmitíos
<option>Elementu | Imposible | "" | ...el rexistru de llista visible ("ListBox1=Item").
<option value="Valor">Item | ListBox1.options[0].value="Valor" | "Valor" | ...el valor asignáu al rexistru de llista ("ListBox1=Valor").
<option value="">Item | ListBox1.options[0].value="" | "$$$empty$$$" | ...una cadena de caráuteres balera ("ListBox1=").

## Propuesta de filtru

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.

## Rangu de caxelles d'orixe

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.

## Tipu de conteníu de llista

Determines the data to fill the lists in list and combo boxes.

La opción «Llista de valores» determina que toles entraes del campu Entraes de la llista de la llingüeta Xenerales apaezan nel control. Nel casu de formularios de base datos, puen emplegase valores de referencia (consulte la seición Referencies por aciu llistes de valores ).

Si'l conteníu del campu de control lleer d'una base de datos, pue determinase el tipu de fonte de datos por aciu les otres opciones. Por exemplu, pue escoyese ente tables y consultes.

## Valor de referencia (activáu)

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 pa formularios de bases de datos

Los valores de referencia son útiles si diseña formulario web y l'información del estáu del control tresmitir al sirvidor. Si l'usuariu prime clic sobre'l control, el valor correspondiente ye unviáu al sirvidor.

Por exemplu, si hai dos campos de control pa les opciones "femenín" y "masculín", y asígnase un valor de referencia de 1 al campu "femenín" y de 2 al campu "masculín", va tresmitir al sirvidor el valor 1 si un usuariu calca nel campu "femenín" y el valor 2 si calca nel campu "masculín".

Valores referenciales pa formularios de bases de datos

Colos formularios de bases de datos tamién pue identificar l'estáu d'un campu d'opciones o d'un caxellu de verificación con un valor referencial y guardar esti valor na base de datos. Por exemplu, si tien un grupu de tres opciones llamaes "en cursu", "rematáu" y "revisión" colos respectivos valores referenciales "Tou", "OK" y "REV", son estos valores los qu'apaecen na base de datos cada vez que calca na respectiva opción.

## Valor de referencia (desactiváu)

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.