Таблица данных

Редактор таблицы данных (РТД) является компонентом, необходимым для изменения или просмотра одной Таблицы данных. Он используется:

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

Всплывающая подсказка для заголовка столбца содержит поле type и строку help, заданные в формате таблицы, если такой определен.

Всплывающая подсказка для ячейки содержит строковое представление значения ячейки, а также тип поля, используемого для данной ячейки. Это может пригодиться, например, если:

  • значение ячейки слишком длинное и не помещается в ней,
  • редактор ячейки имеет допустимые значения, и вы хотите увидеть само значение, а не его описание в раскрывающемся списке.

Отображения временных меток

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

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

Источник данных

Редактор таблицы данных может использовать два типа источников данных:

Таблица данных

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

Список экземпляров класса

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

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

Режимы

Редактор таблицы данных может работать с различных режимах, описанных в этом разделе.

Режимы редактирования

Доступны два режима редактирования:

  • Обычный режим. В этом режиме разрешено изменение значений.
  • Режим Только чтение. В этом режиме редактирование данных не разрешено.

Режимы представления данных

Существуют два режима представления данных:

  • Множество записей. В этом режиме заголовок таблицы показывает описание для множества столбцов, а каждый ряд представляет собой одну запись таблицы данных.
  • Отдельная запись (режим также называется Вертикальным). РТД использует этот режим, когда редактируемая таблица содержит всего одну запись, и добавление дополнительных записей невозможно. Этот режим имеет структуру из двух столбцов: левый столбец показывает имена полей, а правый содержит значения.

Панель инструментов

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

Показать/Скрыть дополнительные свойства

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

Обновить

Кнопка доступна только в режиме Список серверных объектов. Кнопка "Обновить" перезагружает весь список и обновляет текущую страницу.

Добавить ряд

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

Если компонент работает в режиме Список серверных объектов, эта кнопка позволяет вставить новый объект в список на стороне сервера, а не добавлять запись прямо с отображаемую таблицу. Сначала отобразится еще один Редактор таблица данных, чтобы дать заполнить поля вновь создаваемого объекта. Новый объект станет видимым, только если он отвечает текущим правилам фильтрации и подходит к текущей странице. В большинстве случаев, чтобы увидеть новый объект, потребуется нажать на кнопку "Обновить".

Удалить выбранные ряды

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

Если компонент работает в режиме Список серверных объектов, эта кнопка удаляет объект(ы) из списка на стороне сервера помимо удаления соответствующих записей из отображаемой таблицы.

В начало

Кнопка доступна только режиме Список серверных объектов. Делает прокрутку списка до первой страницы.

Предыдущая страница

Кнопка доступна только режиме Список серверных объектов.  Делает прокрутку списка до предыдущей страницы.

Следующая страница

Кнопка доступна только режиме Список серверных объектов. Делает прокрутку списка до следующей страницы.

В конец

Кнопка доступна только режиме Список серверных объектов. Делает прокрутку списка до последней страницы.


Row Count

Кнопка доступна только режиме Список серверных объектов. Определяет количество объектов для отображения на одной странице. Перечисленные выше кнопки прокрутки могут использоваться для навигации по длинному списку.

Поднять ряд

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

Опустить ряд

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

Отменить изменения

Отменяет изменения в таблице. Данная кнопка включается только после того, как в таблицу были внесены изменения.

Включить/Отключить горизонтальную прокрутку

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

Импорт таблицы данных

Импортирует данные из файла.

Экспорт таблицы данных

Экспортирует данные в файл.

Создать отчет

Формирует отчет на основе редактируемой или просматриваемой таблицы.

Помощь

Открывает раздел документации, относящийся к редактируемым/просматриваемым данным.

Обработка привязок данных

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

Общие переменные (свойства)

[?]

Общие переменные: Имя, Видимый, Свойства расширения, Ширина сетки, Высота сетки, Выход за пределы контента, Стиль контейнера, Пользовательские классы, Стиль

Обще свойства

Компонент Таблица данных служит основой для некоторых других компонентов.

Переменные (свойства), общие для наследуемых компонентов, описаны в разделе Общие свойства.

Таблица данных

Имя переменной:

dataTable

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

dataTable

Data Table

Таблица данных, отображаемая в компоненте.

Общие события

[?]

Общие события

Компонент Таблица данных служит основой для некоторых других компонентов.

События, общие для наследуемых компонентов, описаны в разделе Общие события.