Gegevens

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

Om toegang te krijgen tot deze functie..

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

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


Notitiepictogram

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:

Bronbereik cel

Voer een celbereik in dat de items voor een keuzelijst of keuzelijst met invoervak op een werkblad bevat. Als u een bereik met meerdere kolommen invoert, wordt alleen de inhoud van de meest linkse kolom gebruikt om het besturingselement te vullen.

Contents of the linked cell

Selecteer de modus voor het koppelen van een keuzelijst aan een gekoppelde cel op een werkblad.

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

Filtervoorstel

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.

Gebonden veld

Notitiepictogram

Als u de inhoud van de cel Gebonden veld in het eigenschappenvenster verwijdert, wordt het eerste veld van de resultatenset gebruikt om gegevens weer te geven en uit te wisselen.


Deze eigenschap voor keuzelijsten definieert welk gegevensveld van een gekoppelde tabel in het formulier wordt weergegeven.

Als een keuzelijst in het formulier inhoud moet weergeven van een tabel die aan de formuliertabel is gekoppeld, definieert u in het veld Type Lijstinhoud of de weergave door een SQL-opdracht wordt bepaald of dat de (gekoppelde) tabel wordt opgeroepen. Met de eigenschap Gebonden veld gebruikt u een index om te specificeren aan welk gegevensveld van de query of van de tabel het lijstveld wordt gekoppeld.

Notitiepictogram

De eigenschap Gebonden veld is alleen van toepassing op formulieren die worden gebruikt om toegang tot meerdere tabellen te krijgen. Als het formulier slechts op één tabel is gebaseerd, wordt het veld dat in het formulier moet worden weergegeven, direct onder Gegevensveld gespecificeerd. Als u echter wilt dat de keuzelijst gegevens weergeeft uit een tabel die via een gemeenschappelijk gegevensveld aan de huidige tabel is gekoppeld, wordt het gekoppelde gegevensveld door de eigenschap Gebonden veld gedefinieerd.


Als u 'SQL' onder Type lijstinhoud hebt geselecteerd, bepaalt de SQL-opdracht welke index er moet worden gespecificeerd. Voorbeeld: Als u bijvoorbeeld de SQL-opdracht SELECT Veld1, Veld2 FROM tabelnaam onder Lijstinhoud specificeert, dient u de volgende tabel te raadplegen:

Gebonden veld

Koppelen

-1

De index van het in de lijst geselecteerde item is gekoppeld aan het veld onder Gegevensveld.

{leeg} of 0

Het databaseveld Veld1 is gekoppeld aan het veld dat onder Gegevensveld is gespecificeerd.

1

Het databaseveld Veld2 is gekoppeld aan het veld dat onder Gegevensveld is gespecificeerd.


Als u 'Tabel' onder Type lijstinhoud hebt geselecteerd, definieert de tabelstructuur de index die moet worden gespecificeerd. Voorbeeld: Als er een databasetabel is geselecteerd onder Lijstinhoud, raadpleegt u de volgende tabel:

Gebonden veld

Koppelen

-1

De index van het in de lijst geselecteerde item is gekoppeld aan het veld onder Gegevensveld.

{leeg} of 0

De eerste kolom van de tabel wordt aan het veld gekoppeld dat onder Gegevensveld is gespecificeerd.

1

De tweede kolom van de tabel wordt aan het veld gekoppeld dat onder Gegevensveld is gespecificeerd.

2

De derde kolom van de tabel wordt aan het veld gekoppeld dat onder Gegevensveld is gespecificeerd.


Gegevensveld

Met databaseformulieren kunt u besturingselementen aan de gegevensvelden koppelen.

U hebt verschillende mogelijkheden:

  1. Eerste geval: Er is slechts één tabel in het formulier.

    Specificeer onder Gegevensveld het veld van de gegevensbrontabel waarvan u de inhoud wilt weergeven.

  2. Tweede geval: het besturingselement hoort bij een subformulier dat door een SQL-query is gemaakt.

    Specificeer onder Gegevensveld het veld van de SQL-instructie waarvan u de inhoud wilt weergeven.

  1. Derde geval: Keuzelijsten met invoervak

    Voor keuzelijsten met invoervak wordt het veld van de gegevensbrontabel waarin de waarden moeten worden opgeslagen die door de gebruiker zijn ingevoerd of geselecteerd, onder Gegevensveld gespecificeerd. De waarden die in de keuzelijst met invoervak worden weergegeven, zijn op een SQL-instructie gebaseerd die onder Lijstinhoud is ingevoerd.

  2. Vierde geval: Keuzelijsten

    De gegevensbrontabel bevat niet de weer te geven gegevens, maar in plaats daarvan een tabel die via een gemeenschappelijk gegevensveld aan de gegevensbrontabel is gekoppeld.

    Als u wilt dat een keuzelijst gegevens weergeeft uit een databasetabel die via een gemeenschappelijk gegevensveld is gekoppeld aan de tabel waarop het formulier is gebaseerd, dient u het koppelingsveld van de formuliertabel onder Gegevensveld te specificeren. U kunt ook het databaseveld specificeren dat de weergave van de gegevens in het formulier beheert. Dit gegevensveld biedt de koppeling naar de andere tabel als beide tabellen via een gemeenschappelijk gegevensveld kunnen worden gekoppeld. Het is gewoonlijk een gegevensveld waarin unieke identificatiegetallen worden opgeslagen. Het gegevensveld waarvan de inhoud in het formulier wordt weergegeven, wordt door een SQL-instructie onder Lijstinhoud gespecificeerd.

Keuzelijsten werken met verwijzingen. Deze kunnen met gekoppelde tabellen door SQL-instructies (vierde geval) of via waardenlijsten worden geïmplementeerd:

Verwijzingen via gekoppelde tabellen (SQL-instructies)

Als u wilt dat een keuzelijst gegevens weergeeft uit een databasetabel die via een gemeenschappelijk gegevensveld is gekoppeld aan de tabel waarop het formulier is gebaseerd, dient u het koppelingsveld van de formuliertabel onder Gegevensveld te specificeren.

De koppeling wordt met een SQL Select-instructie gemaakt die als u 'SQL' of 'Native SQL' hebt geselecteerd, wordt gespecificeerd onder Type lijstinhoud in het veld Lijstinhoud. Bijvoorbeeld: Een tabel Bestellingen is aan het huidige formulierbesturingselement gekoppeld, en in de database is de tabel Klanten aan die tabel Bestellingen gekoppeld. U kunt een SQL-instructie als volgt gebruiken:

SELECT KlantNaam, KlantNr FROM Klanten.

waar 'KlantNaam' het gegevensveld is uit de gekoppelde tabel Klanten, en 'KlantNr' het veld uit de tabel Klanten die aan het veld van de formuliertabel Bestellingen is gekoppeld die onder Gegevensveld wordt gespecificeerd.

Verwijzingen met behulp van waardenlijsten

Voor keuzelijsten kunt u waardenlijsten gebruiken. Waardenlijsten zijn lijsten die referentiewaarden definiëren. Op deze manier geeft het besturingselement in het formulier niet direct de inhoud van een databaseveld weer, maar in plaats daarvan de waarden die in de waardenlijst zijn toegewezen.

Als u met referentiewaarden van een waardenlijst werkt, is de inhoud van het gegevensveld dat u onder Gegevensveld in het formulier hebt gespecificeerd, niet zichtbaar, maar de toegekende waarden wel. Als u 'Waardenlijst' op het tabblad Gegevens onder Type lijstinhoud kiest en u hebt een referentiewaarde toegewezen aan de zichtbare lijstitems in het formulier onder Items in lijst (ingevoerd op het tabblad Algemeen), dan worden de referentiewaarden met de gegevensinhoud van het opgegeven gegevensveld vergeleken. Als een referentiewaarde overeenkomt met de inhoud van een gegevensveld worden de bijbehorende lijstitems in het formulier getoond.

Gekoppelde cel

Specificeert de verwijzing naar een gekoppelde cel op een werkblad. De livestatus of -inhoud van het besturingselement is aan de celinhoud gekoppeld. In de volgende tabellen staan de besturingselementen en hun overeenkomstige koppelingstype:

Keuzevakje met gekoppelde cel

Actie

Resultaat

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:

Keuzevakje wordt ingesteld op de onbepaalde status als het een vakje met drie statussen is, anders wordt de selectie ervan opgeheven.

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:

Er wordt een lege tekenreeks naar de cel gekopieerd.

The Reference value box contains text. Enter the same text into the cell:

Het keuzevakje wordt geselecteerd.

The Reference value box contains text. Enter another text into the cell:

Het keuzevakje wordt uitgeschakeld.


Keuzerondje met gekoppelde cel

Actie

Resultaat

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:

Er wordt een lege tekenreeks naar de cel gekopieerd.

The Reference value box contains text. Enter the same text into the cell:

Het keuzerondje wordt geselecteerd.

The Reference value box contains text. Enter another text into the cell:

Het keuzerondje wordt gewist.


Tekstvak met gekoppelde cel

Actie

Resultaat

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.


Numeriek veld en opgemaakt veld met gekoppelde cel

Actie

Resultaat

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.


Keuzelijst met gekoppelde cel

Keuzelijsten ondersteunen twee verschillende koppelingsmodi (zie de eigenschap 'Inhoud van de gekoppelde cel').

  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.

Actie

Resultaat

Select a single list item:

Inhoud wordt gekoppeld: Tekst van het item wordt naar de gekoppelde cel gekopieerd.

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:

Items in de keuzelijst worden aan de hand van de wijziging bijgewerkt. De selectie blijft behouden. Dit kan ertoe leiden dat de gekoppelde cel wordt bijgewerkt.


Keuzelijst met invoervak met gekoppelde cel

Actie

Resultaat

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:

Items in de vervolgkeuzelijst worden aan de hand van de wijziging bijgewerkt. Het invoervak van de keuzelijst en de gekoppelde cel worden niet gewijzigd.


Lege tekenreeks is 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."

Database-systemen variëren en zij zouden de waarde NULL verschillend kunnen afhandelen. Kijk in de documentatie van de database die u gebruikt.

Lijstinhoud

Specificeert bij databaseformulieren de gegevensbron voor de lijstinhoud van het formulierelement. Dit veld kan worden gebruikt om een waardenlijst voor documenten zonder een databaseverbinding te definiëren.

De gegevensbron bepaalt in het geval van databaseformulieren de items van de keuzelijst of van de keuzelijst met invoervak. Afhankelijk van het geselecteerde type kunt u onder Lijstinhoud tussen verschillende gegevensbronnen kiezen, mits deze objecten in uw database bestaan. Alle beschikbare databaseobjecten van het type dat onder Type lijstinhoud is geselecteerd, worden hier aangeboden. Als u de optie 'Waardenlijst' als het type hebt geselecteerd, kunt u verwijzingen voor databaseformulieren gebruiken. Als de weergave van het besturingselement door een SQL-opdracht wordt bestuurd, wordt de SQL-instructie hier ingevoerd.

Voorbeelden van SQL-instructies:

Voor keuzelijsten kan een SQL-instructie de volgende vorm hebben:

SELECT veld1, veld2 FROM tabel,

'tabel' is hier de tabel waarvan de gegevens in de lijst van het besturingselement (lijsttabel) worden getoond. 'veld1' is het gegevensveld dat de zichtbare items in het formulier definieert; de inhoud ervan wordt in de keuzelijst weergegeven. 'veld2' is het veld uit de lijsttabel dat aan de formuliertabel (waardentabel) is gekoppeld door het veld dat onder Gegevensveld is gespecificeerd als Gebonden veld = 1 is geselecteerd.

Voor keuzelijsten met invoervak kan een SQL-instructie de volgende vorm hebben:

SELECT DISTINCT veld FROM tabel,

'veld' is hier een gegevensveld uit de lijsttabel 'tabel' waarvan de inhoud in de keuzelijst met invoervak wordt weergegeven.

Waardenlijsten voor HTML-documenten

Voor HTML-formulieren kunt u een waardenlijst onder Lijstinhoud invoeren. Selecteer de optie Waardenlijst onder Type lijstinhoud. De hier ingevoerde waarden zijn niet zichtbaar in het formulier en worden gebruikt om waarden aan de zichtbare items toe te wijzen. De items die onder Lijstinhoud zijn gemaakt, komen overeen met de HTML-tag <OPTION VALUE=...>.

In de gegevensoverdracht van een geselecteerd item uit een keuzelijst of keuzelijst met invoervak wordt rekening gehouden met de lijst met waarden die in het formulier is weergegeven en die op het tabblad Algemeen onder Items in lijst is ingevoerd, en de waardenlijst die op het tabblad Gegevens onder Lijstinhoud is ingevoerd: Als er zich (niet-lege) tekst bij de geselecteerde positie in de waardenlijst (<OPTION VALUE=...>) bevindt, wordt deze overgedragen. Anders wordt de tekst die in het besturingselement (<OPTION>) wordt weergegeven, verzonden.

Als de waardenlijst een lege tekenreeks bevat, voert u de waarde $$$empty$$$ onder Lijstinhoud op de overeenkomstige positie in (let op kleine/hoofdletters). LibreOfficeDev interpreteert deze invoer als een lege tekenreeks en wijst deze aan het respectievelijke lijstitem toe.

De volgende tabel toont de verbindingen tussen HTML, JavaScript en het LibreOfficeDev-veld Lijstinhoud via een voorbeeldkeuzelijst genaamd 'ListBox1'. In dit geval verwijst 'Item' naar een lijstitem dat in het formulier zichtbaar is:

HTML-tag

JavaScript

Invoer in waardenlijst van het besturingselement (Lijstinhoud)

Verzonden zal worden...

<OPTION>Item

Niet mogelijk

""

het zichtbare lijstitem ("ListBox1=Item")

<OPTION VALUE="Value">Item

ListBox1.options[0].value="Waarde"

"Waarde"

De waarde die aan het lijstitem is toegewezen ('ListBox1=Waarde').

<OPTION VALUE="">Item

ListBox1.options[0].value=""

"$$$empty$$$"

Een lege tekenreeks ("ListBox1=")


Referentiewaarde (aan)

U kunt een referentiewaarde aan keuzerondjes en selectievakjes toewijzen. De referentiewaarde wordt naar een server verzonden wanneer het webformulier wordt verstuurd. Bij databaseformulieren wordt de hier ingevoerde waarde in de database geschreven die aan het veld van het besturingselement is toegewezen.

Referentiewaarden voor webformulieren

Referentiewaarden zijn nuttig als u een webformulier ontwerpt en de informatie over de status van het besturingselement naar een server moet worden verstuurd. Als de gebruiker op het besturingselement klikt, wordt de overeenkomstige referentiewaarde naar de server verzonden.

Als u bijvoorbeeld twee velden van besturingselementen hebt voor de opties 'vrouwelijk' en 'mannelijk' en een referentiewaarde toekent van 1 aan het veld 'vrouwelijk' en de waarde 2 aan het veld 'mannelijk', wordt de waarde 1 naar de server verzonden als een gebruiker op het veld 'vrouwelijk' klikt en de waarde 2 als op er op het veld 'mannelijk' wordt geklikt.

Referentiewaarden voor databaseformulieren

Voor databaseformulieren kunt u ook de status van een keuzerondje of selectieveld karakteriseren door een referentiewaarde, die u in de database opslaat. Als u een verzameling van drie opties hebt, bijvoorbeeld "in behandeling", "voltooid" en "gecontroleerd", met de respectievelijke referentiewaarden "Doen", "Klaar" en "OK", verschijnen deze referentiewaarden in de database als op de respectievelijke optie wordt geklikt.

Referentiewaarde (uit)

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.

Type lijstinhoud

Bepaalt de gegevens waarmee de lijsten in keuzelijsten en keuzelijsten met invoervak gevuld moeten worden.

Met de optie Waardenlijst verschijnen alle items die u in het veld Lijstitems van het tabblad Algemeen hebt ingevoerd in het besturingselement. U kunt voor databaseformulieren referentiewaarden gebruiken (zie de sectie Verwijzingen met behulp van waardenlijsten).

Als de inhoud van het besturingselement via een database wordt gelezen, kunt u het type van de gegevensbron met de andere opties bepalen. U kunt hier bijvoorbeeld tussen tabellen en query's kiezen.