Настройка колонок Таблицы

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

После настройки Графа сущностей и сохранения внесённых изменений в его структуру*, во встроенных функциях элемента Таблица* необходимо перейти к разделу Таблица. Настроить колонки таблицы - Колонки и нажать на кнопку “Плюс” (рис.1). По нажатию на кнопку будет добавлен первый элемент (колонка), который имеет следующие настройки:

• Колонка - позволяет указать конкретную таблицу или представление базы данных, предварительно включенную в Граф сущностей, и колонку из этой таблицы, значения из которой будут отображаться на странице;
• Наименование - это свойство, которое**позволяет задать наименование колонки, которое будет отображаться в шапке Таблицы; если название колонки не задано, то по умолчанию будет отображаться название таблицы и колонки в базе данных, откуда подгружаются значения
• Ширина - свойство, которое**позволяет указать ширину (по умолчанию в пикселях) отображаемой колонки в Таблице;
• Фиксированная ширина - данное условие выполняется только при заполненном выше значении Ширина и фиксирует размер колонки в Таблице;
• Скрытое - данное свойство позволяет задать возможность скрытия столбца в Таблице. Применяется в том случае, когда необходимо настроить сортировку по содержимому колонки или использовать её в качестве входного параметра для кастомных (нестандартных) функций, но при этом отображать колонку в Таблице пользователю не нужно.
• Агрегирующая функция - это функция, которая обрабатывает набор строк в указанной колонке для подсчета и возвращения одного обобщающего значения.Предусмотрено использование следующих агрегирующих функций:
  • Сумма- возвращает сумму содержащихся в колонке значений, при этом указанная колонка из таблицы базы данных должна иметь числовой тип;
  • Максимум- возвращает максимальное значение из массива имеющихся значений в колонке, при этом указанная колонка из таблицы базы данных должна иметь числовой тип;
  • Минимум- возвращает минимальное значение из массива имеющихся значений в колонке,при этом указанная колонка из таблицы базы данных должна иметь числовой тип;
  • Среднее- возвращает среднее подсчитанное значение из массива имеющихся значений в колонке,при этом указанная колонка из таблицы базы данных должна иметь числовой тип;

  Количество - возвращает общее количество записей в колонкеВ случае, когда свойство настроено у колонки, например, выбрана Агрегирующая функция Сумма, на странице пользовательского приложения вычисленное значение по колонке будет автоматически отображаться зафиксированной (положение не будет изменяться при прокрутке записей) результирующей строкой в Таблице (рис.3). При этом строка будет выделена отличным от других записей в таблице цветом и значение в результирующем поле будет динамически изменяться по мере заполнения колонки (выбранной в качестве источника данных) новыми значениями в таблице базы данных.

• Форматирование - данное свойство позволяет отобразить значение из колонки базы данных в необходимом формате на странице в приложении. Например, подгружаемое значение в колонку имеет тип данных Дата и Время (DateTime), но на странице пользовательского приложения необходимо отображать значение в колонке без Времени, только Дату. В таком случае, целесообразно использовать форматтер DateFormatter, который отобразит значение колонки в нужном виде. Но при этом предварительно необходимо применить к Таблице функцию Очистить форматирование колонок таблицы, указав наименование настраиваемой колонки.

Порядок и удаление колонки в Таблице можно регулировать нажав правой кнопкой мыши на надписи Элемент и выбрав один из трех вариантов Переместить наверх - Переместить вниз - Удалить элемент (рис.2).

рис.1 Добавление колонок в Таблицу

рис.2 Изменение элемента в Таблице (порядок или удаление)

рис.3 Отображение колонок с Агрегирующими функциями

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

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

Для отображения записей в Таблице в определенном порядке используется Сортировка, которую можно настроить перейдя к разделу Таблица. Настроить колонки таблицы - Сортировкаи нажать на кнопку. Важно отметить, что колонка(и), по которым будет производитьсяСортировкадолжны быть включены в качестве элементов в Таблицу, либо включены, но скрыты, иначе при открытии страницы пользовательского приложения будет выведена ошибка. На языке SQL-запросовданное условие равно оператору ORDER BY, который можно применять как к числовым столбцам, так и к строковым (в последнем случае, сортировка будет происходить по алфавиту). По нажатию на кнопку будет добавлен элемент сортировки, который имеет следующие настройки:

• Колонка - позволяет указать конкретную таблицу или представление базы данных, предварительно включенную в Граф сущностей, и колонку из этой таблицы, по которой будут сортироваться записи в Таблице;
• Порядок сортировки позволяет указать в каком порядке будет производиться сортировка По возрастанию или По убыванию (рис.5)

рис.4 Добавление элемента Составная колонка

рис.5 Добавление сортировки Таблиц по условию