Таблица

Назначение

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

Компонента Таблица находится в разделе Компоненты - Таблицы - Таблица

Свойства

Компонента имеет набор общих свойств.

Наименование свойства	Назначение свойства	Принимаемые значения
Зависит от	позволяет указать объект (родителя), по идентификатору которого будут отображаться сведения в текущей Таблице; задаётся в случае необходимости связать Таблицу с другой компонентой, например, Выпадающий список или Таблицей
Multiselectable	позволяет задать возможность единовременного выбора одной или нескольких записей в Таблице; выбранные строки окрашиваются в отличный от других строк цвет	возможность выбора сразу нескольких или одной строки возможность выбора одной строки - значение по умолчанию
Checkbox Column	позволяет поставить отметку в виде флажка на тех записях, которые выбраны пользователем в рамках работы с компонентой Таблица	значение не определено - по умолчанию Активно - отображать колонку флагов Не активно - не отображать колонку флагов
Показывать номер строки	позволяет задать автоматическую нумерацию строк	значение не определено - по умолчанию Активно - отображать нумерацию строк Не активно - не отображать нумерацию строк
Pinned Bottom Row Label	позволяет задать значение для названия итоговой строки таблицы (строки с агрегирующими значениями по колонкам таблицы)	пример возможного значения: Итого
Row click selection type	позволяет задать поведение выбора строк при клике на строку Таблицы	SINGLE_SELECT_CLICK – при клике на строку предыдущие выбранные строки сбрасываются, если не была зажата клавиша Ctrl или Shift- данный метод выбран по умолчанию MULTI_SELECT_CLICK -при каждом клике на строку, предыдущие выбранные строки не сбрасываются, т.е если кликнули на одну строку, а затем на другую, то первая строка останется выбранной. Клик по уже выбранной строке снимает с неё выделение. Использования данного метода допустимо, в случае, если в таблице доступен выбор нескольких строк (при значениисвойстваMultiselectable) SUPPRESS_SELECT_CLICK – исключает возможность выбора (выделения) строки по клику. В данном случае, выбор строки представляется возможным только при использовании чекбоксов.
Save Column State	позволяет задать возможность сохранения пользовательских настроек в части состава и ширины колонок в таблице	значение не определено - по умолчанию Активно - изменения пользователя в части отображаемых колонок в таблице (состав и ширина) будут сохраняться в локальном хранилище, т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения отобразятся Не активно - не сохранять изменения пользователя в части отображаемых колонокв таблице (состав и ширина), т.е. если пользователь исключил для отображения конкретную колонку или изменил ширину столбца в таблице, то при повторном переходе на страницу эти изменения не отобразятся и таблица будет иметь исходный вид по умолчанию
Loading Overlay Type	позволяет выбрать вид прелоадера при подгрузке данных в таблицу	Доступны следующие виды настройки: TEXT_OVERLAY - отображает текст в центре таблицы при подгрузке данных, задаваемый в свойствах: No Rows Overlay Message и Loading Overlay Message PROGRESS_BAR - отображает прогресс-бар при подгрузке данных в таблицу
No Rows Overlay Message	позволяет указать текст для отображения пользователю в таблице в случае, если результат запроса не вернул ни одной строки, например, Данные отсутствуют (доступно для настройки при Loading Overlay Type - TEXT_OVERLAY)	пример возможного значения: Данные отсутствуют
Loading overlay message	позволяет указать текст для отображения пользователю в процессе подгрузки данных в таблицу, например, Загрузка данных, пожалуйста, подождите.( доступно для настройки при Loading Overlay Type - TEXT_OVERLAY)	пример возможного значения: Загрузка данных, пожалуйста, подождите.	Allow Context Menu With	позволяет управлять отображением контекстного меню (список доступных для исполнения действий) при нажатии правой кнопкой мыши на ячейку внутри таблицы	значение не определено - по умолчанию Активно - при нажатии правой кнопкой мыши на ячейку внутри таблицы отображается контекстное меню доступных действий, например, копирование значения ячейки Не активно - исключает отображение контекстного меню при нажатии правой кнопкой мыши на ячейку внутри таблицы

Свойство компоненты: Таблица. Подгрузка данных

Подгрузка данных - позволяет задать граф сущностей для подгрузки данных в Таблицу. Является обязательным к заполнению и настройке.

Граф сущностей элемента настраивается в соответствии с п. Настройка Графа сущностей. Является обязательным к заполнению и настройке.
Колонка для режима “Зависит от” - позволяет указать колонку настраиваемой Таблицы, которая обеспечивает связь текущей компоненты с компонентой заданной в параметре “Зависит от”
Datasource Jndi Name -позволяет задать иной источник (базу данных) для выполнения запроса, заданного с помощью элементов базы данных в редакторе Графа сущностей элемента.

Значение данного свойства может быть задано следующим образом: java:/webbpm/AppRepDS, а сам адрес базы данных, логин и пароль для подключения должен быть указан в файле standalone.xml (аналогично тому, как указывается, например, подключение к базе данных безопасности).

В случае, если данное свойство не заполнено, запрос выполняется в базе данных, указанной в конфигурации проекта (во вкладке База данных).

Aggregation Header For Export - свойство в расширенных настройках, позволяющее задать заголовок для агрегационной строки при экспорте данных.

Свойство компоненты: Таблица. Настроить колонки таблицы

позволяет настроить отображаемые колонки в Таблице с сортировкой записей по конкретному порядку

с описанием настройки Колонок Таблицы можно ознакомиться в разделе: Настройка колонок Таблицы

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

Наименование свойства	Назначение свойства	Принимаемые значения
Количество записей в блоке	количество отображаемых записей в Таблице по умолчанию при каждой новой подгрузк	пример возможного значения: 20 - значение по умолчанию

Функции

В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.

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

Вследствие технических особенностей реализации функций (функции, которые выполняются удаленно на сервере приложений, функции, которые выполняются в браузере пользователя), они имеют разные иконки, но это никак не влияет на их функциональность или предпочтительность использования.

Очистить форматирование колонок таблицы

Преобразовать в колонки со значениями-переходами

Определить права текущего пользователя

Определить роли текущего пользователя

Методические рекомендации по применению

Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:

Часто задаваемые вопросы

Вопрос	Ответ
Как задать ширину Таблицы?	Для того, чтобы настроить ширину или высоту таблицы необходимо в Основных настройках - Расширенные настройки - Стили задать необходимые значения для настраиваемых параметров, например, Ширина 500px.
Как задать ширину колонок в процентах?	Для задания ширины колонок в процентах необходимо выставить нужный процент в поле width и поставить галочку “Автоматически выравнивать по ширине” (autoStretchColumns)
Как скрыть колонку Таблицы?	Для того, чтобы скрыть колонку таблицы можно снять флажок с параметра колонки “Скрытое” в Диспетчере компоненты, либо установить ширину колонки в значение 0px (параметр “Ширина” колонки в Диспетчере компоненты)
Можно ли поменять порядок отображаемых колонок в Таблице?	Для того, чтобы изменить порядок колонок в Таблице необходимо в свойстве Настроить колонки таблицы - Колонки нажать правой кнопкой мыши на «Элемент» и выбрать предложенные варианты: Переместить наверх - Переместить вниз - Удалить элемент
Как изменить формат отображения данных в колонке Таблицы?	В случае, если необходимо изменить формат отображения значений в колонке Таблицы необходимо при настройке колонки применить Форматтер. Например, подгружаемое значение в колонку имеет тип данных Дата и Время(DateTime), но на странице пользовательского приложения необходимо отображать значение в колонке без Времени, только Дату. В таком случае, целесообразно использовать форматтер DateFormatter, который отобразит значение колонки в нужном виде. Но при этом предварительно необходимо применить к Таблице функцию Очистить форматирование колонок таблицы, указав наименование настраиваемой колонки.
Можно ли изменить цветовое оформление Таблицы?	Да, можно. Цветовым оформлением Таблицы можно управлять с помощью CSS-стилей, задаваемых в Основных параметрах - Расширенные настройки - CSS классы
Как автоматически вывести сумму значений по колонке в Таблицу?	Для того, чтобы на странице отобразилась сумма значений по колонке, необходимо при настройке колонки выбрать Агрегирующую функцию - Сумма, после чего в Таблице автоматически отобразится зафиксированная (положение не будет изменяться при прокрутке записей) результирующая строка в Таблице. При этом строка будет выделена отличным от других записей в таблице цветом и значение в результирующем поле будет динамически изменяться по мере заполнения колонки (выбранной в качестве источника данных) новыми значениями в таблице базы данных. С описанием настройки колонок в Таблице можно ознакомиться в разделе: Настройка колонок Таблицы
При выборе записи в основной Таблице в зависимой Таблице (с настроенным режимом «Зависит от»)**отображаются некорректные записи. В чем ошибка?	В данном случае, некорректна указана колонка связи между зависимой и основной Таблицами. С описанием настройки связанных Таблиц можно ознакомиться в разделе: Как добавить связанные Таблицы на страницу?
Как настроить возможность многострочного выбора записей в Таблице?	Для того, чтобы настроить многострочный выбор (одновременный выбор нескольких) записей в Таблице необходимо в разделе Таблица. Задействовать режим выбора нескольких строк установить свойство Допустимо выбрать несколько строк в значение(истина).
Можно ли задать автоматическую нумерацию строк (записей) в Таблице?	Да, можно. Для этого необходимо в настраиваемых параметрах Таблицы перейти к свойству Таблица. Основные параметры - Показывать номер строки и привести его в значение(истина).
Колонка в шапке таблицы имеет странное наименование. Как исправить?	Такая ситуация возникает в том случае, если не было задано значение значение параметра “Наименование” в диспетчере компоненты при создании колонки и ей было присвоено название по умолчанию в формате “название таблицы:название колонки”.
Как поменять порядок следования столбцов таблицы в диспетчере компоненты?	Вызвать контекстное меню на надписи Элемент и выбрать соответствующий пункт.
Как отобразить доступный для понимания вариант адреса, если в колонке базы данных он задан идентификатором guid_fias?	Необходимо вручную настроить параметр “Форматирование” в Диспетчере компоненты.