Формат таблицы

Формат таблицы содержит полную информацию о таблице. Он может существовать отдельно от Таблицы данных. Вы можете создать различные Таблицы данных, используя один и тот же формат таблицы. Когда вы добавляете новую (пустую) запись в такую таблицу, каждое ее поле будет изначально содержать значение по умолчанию, как указано в Формате таблицы. Если поле определено как "пустое", значение также может быть NULL (т.е. значения не будет).

Формат таблицы обычно используется в следующих случаях:

  • Для определения формата переменной контекста,

  • Для определения формата значений входных параметров и возвращаемых значений функций контекста,

  • Для определения формата Таблицы данных, относящейся к событию.

Все поля в объекте TableFormat должны иметь уникальные имена.

AggreGate проверяет уникальность имён полей при создании таблиц данных.
Если таблица или её формат содержат два или более поля с одинаковыми именами — например, при генерации с помощью функций table() или executeQuery() драйвера базы данных — платформа выдаёт ошибку, предотвращая неоднозначность и возможную порчу данных.

Используйте SQL-псевдонимы (алиасы) или переименуйте поля, чтобы сделать имена уникальными.

Формат таблицы определяет следующие свойства таблицы:

Свойство

Описание

Минимальное и максимальное количество записей

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

Сортировка разрешена

Флажок, указывающий, что записи в таблице могут быть переставлены местами (перестроены) во время обработки таблицы

Валидаторы значения записей

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

Валидаторы таблицы

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

Привязки

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

Выражение именования

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

Среда вычисления выражения наименования таблицы данных:

Контекст по умолчанию

Отсутствует.

Таблица данных по умолчанию

Таблица вычисляемого выражения наименования.

Ряд по умолчанию

0

Переменные среды

Только стандартные переменные.

Формат поля

Формат поля состоит из нескольких дескрипторов Формата поля, которые описывают каждое поле. Большинство из них никогда не конфигурируются пользователем (или администратором). Они являются внутренними настройками, и упоминаются здесь для дополнительной информации.

Свойства поля:

Свойство

Описание

Имя

Имя поля.

Тип

Тип поля

Описание

Текстовое описание поля.

Справка

Подробное описание поля.

Значение по-умолчанию

Значение поля по-умолчанию.

Только для чтения

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

Может быть NULL

Флаг, указывающий, что поле может содержать значения NULL ("Неопределенные")

Не реплицируемое

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

Ключевое

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

Допустимые значения

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

Расширяемые допустимые значения

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

Дополнительное

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

Скрытое

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

Редактор/Отрисовщик

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

Опции редактора

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

Валидаторы

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

Смотри корректный синтаксис для опций валидации в разделе Валидаторы полей.

Группа

Понятное для человека описание группы полей.

Пиктограмма

ID строки иконки поля.

Встроенное

Этот флаг имеет особые значения для разных полей:

  • Если флажок Встроенное установлен на поле типа Data Block, значение поля будет сохранено в отдельной таблице базы данных. Значение не будет изначально загружено, если сама таблица загружается из базы данных и отправляется в AggreGate Client или внешнее приложение. Однако значение Data Block будет содержать идентификатор блока данных, который можно использоваться для запуска загрузки данных Data Block из базы данных сервера. Это подходит для больших бинарных значений, таких как изображение, звук и видеофайлы.

  • Если флажок Встроенное установлен на поле Цвет, значение поля будет использоваться для выделения записей таблицы, когда она просматривается/редактируется в Редакторе Таблиц Данных. Возможно совместить флажок Встраиваемый с флажком Скрытый, чтобы спрятать в таблице само поле Цвет. Более подробную информацию смотрите в разделе Окрашивание строк ниже.

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

Зашифрованное

Активирует шифрование значения поля на уровне базы данных.

Типы полей

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

Тип поля

Описание

Integer

Содержит 32-битное целое число со знаком.

Long

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

String

Содержит строку (неограниченной длины).

Boolean

"Флажок" с двумя возможными значениями: TRUE или FALSE.

Float

Содержит 32-битное число с плавающей запятой.

Double

Содержит 64-битное число с плавающей запятой. В большинстве случаев, поле типа Double не должно быть использовано преимущественно по отношению к полю типа Float.

Date

Содержит временную метку с точностью до миллисекунд. Может рассматриваться как дата, время или временная метка (дата+время).

Data Table

Содержит вложенную Таблицу данных.

Color

Содержит определение цвета (RGBA).

Data Block

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

Окрашивание строк

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

Чтобы включить раскраску строк:

  1. Добавьте поле Цвет: в формате таблицы добавьте поле с типом «Цвет».

  2. Отметьте поле Цвет как Встроенное: включите флаг «Встроенное» для поля «Цвет».

  3. (Необязательно) Скройте поле Цвет: включите флаг «Скрытый» для поля «Цвет», если вы не хотите, чтобы выбор цвета был виден в таблице.

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

Was this page helpful?