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

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

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

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

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

Свойство

Описание

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

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

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

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

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

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

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

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

Привязки

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

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

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

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

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

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

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

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

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

0

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

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

Формат поля

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

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

Свойство

Описание

Name

Имя поля.

Description

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

Help

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

Default Value

Значение поля по умолчанию. Вы можете это пропустить, если поле является пустым (см. далее).

Nullable

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

Non-Replicatable

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

Key Field

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

Selection Values

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

Extendable Selection Values

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

Advanced

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

Validators

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

Editor/Renderer

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

Options

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

Icon

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

Group

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

Inline

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

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

Encrypted

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

Типы полей

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

Тип поля

Описание

Integer field

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

Long field

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

String field

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

Boolean field

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

Float field

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

Double field

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

Date field

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

Data Table field

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

Color field

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

Data Block field

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