Sisukord

# Andmed

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

Selle käsu kasutamiseks...

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.

Valitud juhtelemendi omaduste kaardil Andmed olevad sätted sõltuvad vastavast juhtelemendist. Kuvatakse valitud juhelemendi ja konteksti jaoks võimalikke sätteid.
Saadaval on järgnevad väljad:

## Andmeväli

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

Sul on järgnevad võimalused:

1. Esimene juhtum: vorm on seostatud ainult ühe tabeliga.

   Määra sektsioonis Andmeväli andmeallikatabeli väli, mille sisu soovid kuvada.

2. Teine juhtum: juhtelement kuulub alamvormi, mis luuakse SQL-päringu poolt.

   Määra sektsioonis Andmeväli SQL-lause väli, mille sisu soovid kuvada.

1. Kolmas juhtum: liitboksid

   Liitbokside jaoks määratakse andmeallika tabeli väli, kuhu kasutaja sisestatud või valitud andmed tuleks talletada, sektsioonis Andmeväli. Liitboksi väljadel kuvatud väärtuste aluseks on SQL-lause, mis sisestatakse väljale Loendi sisu.

2. Neljas juhtum: loendiboksid

   Andmeallika tabel ei sisaldab kuvatavaid andmeid, vaid tabelit, mis on lingitud andmeallika tabeliga ühise andmevälja kaudu.

   Kui soovid, et loendiboks kuvab andmed tabelist, mis on lingitud praeguse andmeallikatabeliga, määra sektsioonis Andmeväli andmeallikatabeli väli, millele loendiboksi sisu viitab. Teine võimalus on määrata andmebaasiväli, mis määrab vormil andmete kuvamise. See andmeväli esitab lingi muule tabelile, kui mõlemad tabelid saab linkida ühise andmevälja kaudu. See on tavaliselt andmeväli, millel salvestatakse unikaalsed tunnusnumbrid. Andmeväli, mille sisu vormil kuvatakse, on määratud SQL-lausega sektsioonis Loendi sisu.

Loendiboksid töötavad viidetega. Need saab rakendada lingitud tabelitega SQL-lausete abil (neljas juhtum) või väärtuseloendite kaudu:

Viited lingitud tabelite kaudu (SQL-laused)

Kui soovid, et loendiboks kuvab andmed andmebaasitabelist, mis on lingitud ühise andmevälja kaudu vormi aluseks oleva tabeliga, määratakse vormitabeli lingiväli sektsioonis Andmeväli.

Link luuakse SQL-valikuga, mis sätte "SQL" või "Loomulik SQL" valimisel on määratud sektsiooni Loendi sisu tüüp väljal Loendi sisu. Näitena on tabel "Tellimused" lingitud praeguse vormi juhtelemendiga ja andmebaasis on tabel "Kliendid" lingitud tabeliga "Tellimused". Saad kasutada SQL-lauset järgmiselt:

SELECT KliendiNimi, KliendiNr FROM Kliendid,

kus "KliendiNimi" on andmeväli lingitud tabelist "Kliendid" ja "KliendiNr" on väli tabelist "Kliendid", mis on lingitud vormitabeli "Tellimused" väljaga, mis on määratud sektsioonis Andmeväli.

Väärtuseloendeid kasutavad viited

Loendibokside jaoks saad kasutada väärtuseloendeid. Väärtuseloendid on loendid, mis on määravad viiteväärtused. Nii ei kuva vormi juhtelement andmebaasivälja sisu, vaid väärtuseloendis määratud väärtused.

Kui töötad väärtuseloendi viiteväärtustega, pole vormi sektsioonis Andmeväli määratud andmevälja sisu kuvatud, vaid hoopis määratud väärtused. Kui valisid sektsiooni Loendi sisu tüüp kaardil Andmed sätte "Väärtuseloend" ja määrasid vormi sektsioonis Loendi kirjed (sisestatud kaardil Üldine) nähtavatele loendikirjetele viiteväärtuse, siis võrreldakse viiteväärtusi antud andmevälja andmesisuga. Kui viiteväärtus vastab andmevälja sisule, kuvatakse vormil seotud loendikirjed.

## Filtri ettepanek

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.

## Lahtrite lähtevahemik

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.

## Lingitud lahter

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:

### Märkeruut lingitud lahtriga

Toiming | Tulemus
--- | ---
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: | Märkeruut on kolmeolekuline märkeruut, seatakse see olekusse "määramata". Muidu märkeruut tühjendatakse.
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: | Lahtrisse kopeeritakse tühi string.
The Reference value box contains text. Enter the same text into the cell: | Märkeruut on märgistatud.
The Reference value box contains text. Enter another text into the cell: | Märkeruut pole märgistatud.

### Raadionupp koos lingitud lahtriga

Toiming | Tulemus
--- | ---
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: | Lahtrisse kopeeritakse tühi string.
The Reference value box contains text. Enter the same text into the cell: | Raadionupp on valitud.
The Reference value box contains text. Enter another text into the cell: | Raadionupp pole valitud.

### Tekstikast koos lingitud lahtriga

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

### Arvuväli ja vormindatud väli koos lingitud lahtriga

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

### Loendiboks koos lingitud lahtriga

Loendiboksid toetavad kahte linkimisrežiimi, vt omadust "Lingitud lahtri sisu".

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.

Toiming | Tulemus
--- | ---
Select a single list item: | Sisu on lingitud: üksuse tekst kopeeritakse lingitud lahtrisse. 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: | Loendiboksi üksused uuendatakse vastavalt muudatusele. Valik säilitatakse. See võib põhjustada lingitud lahtri uuendamise.

### Liitboks lingitud lahtriga

Toiming | Tulemus
--- | ---
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: | Ripploendi kirjeid uuendatakse vastavalt muudatusele. Liitboksi redigeerimisvälja ja lingitud lahtrit ei muudeta.

## Lingitud lahtri sisu

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

## Loendi sisu

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.

Andmebaasivormide korral määrab andmeallikas loendi- või liitboksi kirjed. Sõltuvalt valitud tüübist saad sektsioonis Loendi sisu valida erinevate andmeallikate vahel, eeldusel et need objektid on andmebaasis. Siin on pakutud kõik sektsioonis Loendi sisu tüüp valitud tüübi saadaolevad andmebaasiobjektid. Kui valisid tüübina sätte "Väärtuseloend", saad kasutada andmebaasivormide viiteid. Kui juhtelemendi kuva juhitakse SQL-käsuga, sisestatakse siia SQL-lause.

SQL-lausete näited:

Loendibokside jaoks võib SQL-lause olla järgmisel kujul:

SELECT väli1, väli2 FROM tabel,

Siin on "tabel" tabel, mille andmed kuvatakse juhtelemendi loendis (loenditabel). "väli1" on andmeväli, mis määrab vormil nähtavad kirjed; selle sisu kuvatakse loendiboksis. "väli2" on loenditabeli väli, mis on lingitud vormitabeliga (väärtuste tabel) sektsioonis Andmeväli määratud välja kaudu, kui säte Seotud väli = 1 on valitud.

Liitbokside jaoks võib SQL-lause olla järgmisel kujul:

SELECT DISTINCT väli FROM tabel,

Siin on "väli" v loenditabelist "tabel", mille sisu on kuvatud liitboksi loendis.

HTML-dokumentide väärtuseloendid

HTML-vormide jaoks saad sisestada väärtuseloendi sektsioonis Loendi sisu. Vali sektsioonis Loendi sisu tüüp säte "Väärtuseloend". Siin sisestatud väärtused pole vormil nähtavad ja neid kasutatakse nähtavatele kirjetele väärtuste määramiseks. Sektsioonis Loendi sisu tehtud kirjed vastavad HTML-sildile <OPTION VALUE=...>.

Valitud kirje andmete ülekandel loendiboksist või liitboksist arvestatakse sektsiooni Loendi kirjed kaardile Üldine sisestatud vormil kuvatud väärtuste loendit ja sektsiooni Loendi sisu kaardile Andmed sisestatud väärtuste loendit: kui väärtuste loendis on valitud asukohas (mitte-tühi) tekst (<OPTION VALUE=...>), kantakse see üle. Vastasel korral saadetakse juhtelemendis (<OPTION>) kuvatud tekst.

Kui väärtuseloend peaks sisaldama tühja stringi, sisesta sektsioonis Loendi sisu vastavasse asukohta väärtus "$$$empty$$$" (arvesta suur- ja väiketähti). LibreOffice tõlgendab seda sisestust tühja stringina ja määrab selle vastavale loendikirjele.

Järgmises tabelis on esitatud ühendused HTML-i, JavaScripti ja LibreOffice-i välja Loendi sisu vahel, kasutades näitena loendiboksi nimega "Loendiboks1". Praegusel juhul tähistab "Element" vormil nähtavat loendikirjet:

HTML-silt | JavaScript | Kirje juhtelemendi väärtuseloendis (loendi sisu) | Edastatud andmed
<OPTION>Element | Pole võimalik | "" | nähtav loendikirje ("ListBox1=Element")
<OPTION VALUE="Value">Element | ListBox1.options[0].value="Väärtus" | "Väärtus" | Loendi kirjele määratud väärtus ("ListBox1=Väärtus")
<OPTION VALUE="">Element | ListBox1.options[0].value="" | "$$$empty$$$" | Tühi string ("ListBox1=")

## Loendi sisu tüüp

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

Sättega "Väärtuseloend" kuvatakse juhtelemendis kõik kaardi Üldine väljale Loendi kirjed lisatud kirjed. Andmebaasivormide jaoks saad kasutada viiteväärtusi (vt teemat Väärtuseloendeid kasutavad viited).

Kui juhtelemendi sisu loetakse andmebaasist, saad määrata andmeallika tüübi muude sätete abil. Näiteks saad valida tabelite ja päringute vahel.

## Seotud väli

Kui kustutad omaduste brauseris lahtri Seotud väli sisu, kasutatakse tulemuste kogumi esimest välja andmete kuvamiseks ja vahetamiseks.

See loendibokside omadus määrab, mis lingitud tabeli andmeväli kuvatakse vormis.

Kui vormi loendiboks peab kuvama vormitabeliga lingitud tabeli sisu, siis määra väljal Loendi sisu tüüp, kas kuvamine on määratud SQL-käsuga või (lingitud) tabelile on ligipääs. Saad omadusega Seotud väli kasutada registrit, et määrata, mis päringu või tabeli andmeväljaga loendiväli lingitakse.

Omadus Seotud väli on vaid vormide jaoks, mida kasutatakse mitmele tabelile ligipääsuks. Kui vorm põhineb vaid ühel tabelil, määratakse vormil kuvatav väli otse sektsioonis Andmeväli. Kuid kui soovid, et loendiboks kuvab andmed tabelist, mis on lingitud praeguse tabeliga ühise andmevälja kaudu, määratakse lingitud andmeväli omadusega Seotud väli.

Kui valid sektsioonis Loendi sisu tüüp valiku SQL, määrab SQL-käsk määratava registri. Näiteks kui määrad sektsioonis Loendi sisu SQL-käsu "SELECT Väli1, Väli2 FROM tabelinimi", siis vaata järgmist tabelit:

Seotud väli | Lingi
--- | ---
-1 | The index of the selected entry in the list is linked to the field specified under Data field.
{empty} or 0 | Andmebaasiväli "Väli1" lingitakse sektsioonis Andmeväli määratud väljaga.
1 | Andmebaasiväli "Väli2" lingitakse sektsioonis Andmeväli määratud väljaga.

Kui valisid sektsioonis Loendi sisu tüüp sätte "Tabel", määrab tabelistruktuur määratava registri. Näide: kui sektsioonis Loendi sisu valitakse andmebaasitabel, vaata järgmist tabelit:

Seotud väli | Lingi
--- | ---
-1 | The index of the selected entry in the list is linked to the field specified under Data field.
{empty} or 0 | Tabeli esimene veerg lingitakse sektsioonis Andmeväli määratud väljaga.
1 | Tabeli teine veerg lingitakse sektsioonis Andmeväli määratud väljaga.
2 | Tabeli kolmas veerg lingitakse sektsioonis Andmeväli määratud väljaga.

## Tühi string on 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."

Andmebaasisüsteemid on erinevad ja need võivad väärtust NULL erinevalt käsitleda. Vaata kasutatud andmebaasi dokumentatsiooni.

## Viiteväärtus (sees)

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.

Veebivormide viiteväärtused

Viiteväärtused on kasulikud, kui kujundad veebivormi ja juhtelemendi olekuteave edastatakse serverile. Kui kasutaja klõpsab juhtelemendil, saadetakse vastav viiteväärtus serverile.

Näiteks kui kasutad kahte juhtelemendi välja sätete "naine" ja "mees" jaoks ning määrad väljale "naine" väärtuse 1 ja väljale "mees" väärtuse 2, saadetakse serverile väärtus 1, kui kasutaja klõpsab väljal "naine" ja väärtus 2, kui kasutaja klõpsab väljal "mees".

Andmebaasivormide viiteväärtused

Andmebaasivormide jaoks saad lisaks tähistada sätte või märkeruudu oleku viiteväärtusega, salvestades selle andmebaasis. Kui kasutad kolme sätte komplekti - nt "Pooleli", "Valmis" ja "Taasesitus" - koos vastavate viiteväärtustega "Ül", "OK" ja "TE", kuvatakse need viiteväärtused andmebaasis vastaval sättel klõpsamisel.

## Viiteväärtus (väljas)

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.