Forms: Data Tab

Содержимое

# Data Tab

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

Доступ к этой команде

#### From the context menu:

Choose Control Properties - Data tab.

#### From the tabbed interface:

Choose Forms - Control Properties - Data tab.

#### From toolbars:

Control Properties

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:

## Значение индекса (вкл.)

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.

Значения индекса для веб-форм

Значения индекса удобны при создании веб-формы, если сведения о состоянии элемента управления должны быть переданы серверу. Если пользователь выбирает данный элемент управления, соответствующее значение индекса отправляется серверу.

Например, если имеется два поля элементов управления для вариантов "женский" и "мужской" и полю "женский" назначено значение индекса 1, а полю "мужской" - значение индекса 2, значение 1 передаётся серверу, когда пользователь выбирает поле "женский", а значение 2 - когда пользователь выбирает поле "мужской".

Значения индекса для форм базы данных

Для форм базы данных можно также характеризовать состояние параметра или флажка с помощью значения индекса, хранящегося в базе данных. Если задано три параметра, например, "не завершено", "завершено" и "повторная отправка" с соответствующими значениями индекса ToDo", "OK" и "RS", эти значения индекса появятся в базе данных, если будет выбран соответствующий параметр.

## Значение индекса (выкл.)

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.

## Исходный диапазон ячеек

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.

## Поле данных

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

Имеется несколько возможностей:

1. Первый случай. В форме только одна таблица.

   В поле Поле данных укажите поле источника данных таблицы, содержимое которого должно отображаться.

2. Второй случай. Элемент управления принадлежит подчинённой форме, которая создана запросом SQL.

   В поле Поле данных укажите поле инструкции SQL, содержимое которого должно отображаться.

1. Третий случай. Поля со списком

   ,Для полей со списком поле источника данных таблицы, в котором значения вводятся или выбираются пользователем, должно быть сохранено, если указано в поле Поле данных. Значения, выводимые в списке поля со списком, основаны на инструкции SQL, которая вводится в поле Содержимое списка.

2. Четвёртый случай: Списки

   Источник данных таблицы не содержит данных, которые должны отображаться, за исключением таблицы, связанной с таблицей источника данных через общее поле данных.

   Если необходимо, чтобы в списке отображались данные из таблицы, которая связана с текущей таблицей источника данных, в поле Поле данных укажите поле таблицы источника данных, на которое ссылается содержимое списка. Можно также указать поле базы данных, которое управляет отображением данных в форме. Это поле данных содержит ссылку на другую таблицу, если обе таблицы могут быть связаны через общее поле данных. Обычно это поле данных, в котором хранятся уникальные идентификационные номера. Поле данных, содержимое которого отображается в форме, определяется инструкцией SQL в поле Содержимое списка.

Списки работают со ссылками. Они могут быть внедрены со связанными таблицами или с помощью инструкций SQL (четвёртый случай), или с помощью списков значений:

Ссылки через связанные таблицы (инструкции SQL)

Если необходимо, чтобы в списке отображались данные из таблицы базы данных, связанной с таблицей, на которой основана данная форма, через общее поле данных поле ссылки таблицы формы указывается в поле Поле данных.

Ссылка создаётся с помощью инструкции SQL Select, которая, если выбрать «SQL» или «Native SQL», указана в разделе Тип содержимого списка в поле Содержимое списка Например, таблица «Заказы» связана с данным элементом управления формы, а в базе данных с таблицей «Заказы» связана таблица «Клиенты». Можно использовать следующую инструкцию SQL:

SELECT CustomerName, CustomerNo FROM Customers,

где "CustomerName" - это поле данных из связанной таблицы "Клиенты", а "CustomerNo" - поле таблицы "Клиенты", которое связано с полем таблицы формы "Заказы", указанным в поле Поле данных.

Ссылки, использующие списки значений

Для списков можно использовать списки значений. Списки значений - это списки, которые определяют значения индекса. Таким образом, элемент управления в форме не отображается непосредственно в содержимом поля базы данных, за исключением значений, присвоенных в списке значений.

При работе со значениями индекса списка значений содержимое поля данных, указанного в поле Поле данных в форме, невидимо, за исключением назначенных значений. Если выбрать значение "Valuelist" на вкладке Данные в разделе Тип содержимого списка и назначить значение индекса видимым элементам списка в форме в поле Элементы списка (вводится на вкладке Общие), то значения индекса будут сравниваться с данными в текущем поле данных. Если значение индекса соответствует содержимому поля данных, связанные элементы списка отображаются в форме.

## Предложение фильтра

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.

## Пустая строка - ПУСТО

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

Системы баз данных отличаются и могут обрабатывать значение NULL по-разному. См. документацию к используемой базе данных.

## Связанная ячейка

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:

### Флажок со связанной ячейкой

Действие | Результат
--- | ---
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: | Флажок установлен в состояние "не определено", если это флажок с тремя состояниями, в противном случае флажок снят.
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: | Пустая строка копируется в ячейку.
The Reference value box contains text. Enter the same text into the cell: | Флажок установлен.
The Reference value box contains text. Enter another text into the cell: | Флажок снят.

### Переключатель со связанной ячейкой

Действие | Результат
--- | ---
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: | Пустая строка копируется в ячейку.
The Reference value box contains text. Enter the same text into the cell: | Переключатель выбран.
The Reference value box contains text. Enter another text into the cell: | Выбор переключателя отменён.

### Текстовое поле со связанной ячейкой

Действие | Результат
--- | ---
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.

### Числовое поле и поле с форматированием со связанной ячейкой

Действие | Результат
--- | ---
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.

### Список со связанной ячейкой

Списки поддерживают два различных режима связывания, см. свойство "Содержимое связанной ячейки".

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.

Действие | Результат
--- | ---
Select a single list item: | Содержимое связано: Текст элемента копируется в связанную ячейку. 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: | Элементы списка обновляются в соответствии с изменением. Выбор не изменяется. Это может вызвать обновление связанной ячейки.

### Поле со списком со связанной ячейкой

Действие | Результат
--- | ---
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: | Элементы раскрывающегося списка обновляются в соответствии с изменением. Поле для редактирования поля со списком и связанная ячейка не изменяются.

## Связываемое поле

Если удалить значение ячейки Связываемое поле в браузере свойств, то для отображения и обмена данными будет использоваться первое поле из набора результатов.

Это свойство для списков определяет, какое поле данных связанной таблицы отображается в форме.

Если в списке в форме должно отображаться содержимое таблицы, связанной с таблицей формы, определите в поле Тип содержимого списка, должно ли отображение определяться командой SQL или происходит обращение к (связанной) таблице. С помощью свойства Связываемое поле можно использовать индекс, чтобы указать, с каким полем данных запроса или таблицы связан список.

Свойство Связываемое поле предназначено только для форм, которые служат для обращения к нескольким таблицам. Если форма основана только на одной таблице, поле, которое должно отображаться в этой форме, указывается непосредственно в поле Поле данных. Однако если необходимо, чтобы в списке отображались данные из таблицы, которая связана с текущей таблицей через общее поле данных, связанное поле данных определяется свойством Связываемое поле.

Если в поле Тип содержимого списка выбрать "SQL", индекс, который должен быть указан, определяется командой SQL. Пример: Если в поле Содержимое списка указана команда SQL "SELECT Field1, Field2 FROM tablename", см. следующую таблицу:

Связываемое поле | Связь
--- | ---
-1 | The index of the selected entry in the list is linked to the field specified under Data field.
{пусто} или 0 | Поле базы данных "Field1" связывается с полем, указанным в поле Поле данных.
1 | Поле базы данных "Field2" связывается с полем, указанным в поле Поле данных.

Если в поле Тип содержимого списка выбрать "Таблица", индекс, который должен быть указан, определяется структурой таблицы. Пример: Если в поле Содержимое списка указана таблица базы данных, см. следующую таблицу:

Связываемое поле | Связь
--- | ---
-1 | The index of the selected entry in the list is linked to the field specified under Data field.
{пусто} или 0 | 1-й столбец таблицы связывается с полем, указанным в поле Поле данных.
1 | 2-й столбец таблицы связывается с полем, указанным в поле Поле данных.
2 | 3-й столбец таблицы связывается с полем, указанным в поле Поле данных.

## Содержимое связанной ячейки

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

## Содержимое списка

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.

В случае форм баз данных источник данных определяет элементы списка или поля со списком. В зависимости от выбранного типа можно выбирать различные источники данных в поле Содержимое списка при условии, что эти объекты существуют в базе данных. Здесь возможны все доступные объекта для типа, выбранного в поле Тип содержимого списка. Если в качестве типа выбрано «Список значений», можно использовать ссылки для форм базы данных. Если отображение элемента управления управляется командой SQL, здесь вводится инструкция SQL.

Примеры инструкций SQL.

Для списков инструкция SQL может иметь следующий вид:

SELECT field1, field2 FROM table,

Здесь "table" - это таблица, данные которой отображаются в списке элемента управления (таблица списка). "field1" - поле данных, которое определяет видимые элементы в форме, его содержимое отображается в списке. "field2" - поле таблицы списка, которое связано с таблицей формы (таблица значений) через поле, указанное в Поле данных, если выбрано значение Связываемое поле = 1.

Для полей со списками инструкция SQL может иметь следующий вид:

SELECT DISTINCT field FROM table,

Здесь "field" - это поле данных из таблицы списка "table", содержимое которого отображается в поле со списком.

Списки значений для документов HTML

Для форм HTML можно ввести список значений в поле Содержимое списка. Выберите параметр "Valuelist" в поле Тип содержимого списка. Введённое здесь значение не будет отображаться в форме, оно используется для присвоения значений видимым элементам. Записи в поле Содержимое списка соответствуют тегу HTML <OPTION VALUE=...>.

В переносе данных выбранного элемента из списка или поля со списком учитываются как список значений, отображённый в форме, которая была введена на вкладке Общие в поле Элементы списка, так и список значений, введённый на вкладке Данные в поле Содержимое списка: Если в положении выделения в списке значений (<OPTION VALUE=...>) имеется (непустой) текст, он будет передан. В противном случае отправляется текст, отображённый в элементе управления (<OPTION>).

Если список значений должен содержать пустую строку, введите значение "$$$empty$$$" в поле Содержимое списка в соответствующее положение (обратите внимание на регистр символов). LibreOffice воспринимает этот ввод как пустую строку и назначает её соответствующему элементу списка.

В следующей таблице на примере списка "ListBox1" показаны связи между полями Содержимое списка HTML, JavaScript и LibreOffice. В этом случае "Item" означает элемент, отображаемый в форме.

Тег HTML | JavaScript | Элемент в списке значений элемента управления (содержимое списка) | Переданные данные
<OPTION>Item | Невозможно | "" | видимый элемент списка ("ListBox1=Item")
<OPTION VALUE="Value">Item | ListBox1.options[0].value="Value" | "Значение" | Значение, назначенное элементу списка ("ListBox1=Value")
<OPTION VALUE="">Item | ListBox1.options[0].value="" | "$$$empty$$$" | Пустая строка ("ListBox1=")

## Тип содержимого списка

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

Если выбрать значение "Valuelist", все записи, введённые в поле Элементы списка вкладки Общие, отображаются в элементе управления. Для форм базы данных могут служить значения индекса (см. раздел Ссылки, использующие списки значений).

Если содержимое элемента управления считано из базы данных, можно определить тип источника данных с помощью других параметров. Можно, например, выбирать между таблицами и запросами.

См. также

General Tab

Events Tab

Пожалуйста, поддержите нас!