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

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

Подходящие типы полей

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

Описание

Опции

Все типы полей

list

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

Не разрешены.

Date

date

Редактор даты. Позволяет задать только дату для полей типа Date. Установка времени невозможна.

Временная зона для визуализации данных. Пользовательские временные зоны могут быть указаны в форме строки, например:

  • GMT-8

  • GMT-08:00

  • Америка/Лос_Анджелес

Date

time

Редактор времени. Позволяет задать только время для полей типа Дата. Установка даты невозможна.

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

Временная зона для визуализации данных. Пользовательские временные зоны могут быть указаны в форме строки, например:

  • GMT-8

  • GMT-08:00

  • Америка/Лос_Анджелес

Integer

spinner

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

Не разрешены.

Integer, Long, Float, String

bar

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

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

Если опции не определены, максимальное значение нужно принимать как 100.

Пример: 10000. Эта строка опций заставит индикатор отрисовывать значения в размере от 0 до 10000.

Integer, Long, Float, String

bytes

Отрисовщик байтов. Интерпретирует значение поля как количество байтов или скорость передачи байтов и отрисовывает его как:

  • количество байтов, килобайтов, мегабайтов, гигабайтов ИЛИ

  • количество байтов, килобайтов, мегабайтов или гигабайтов в секунду

Строка опций будет интерпретирована как Целое значение и использована в следующих случаях:

  • 0 - значения поля будут отрисовываться как байты, килобайты и т.д.

  • 1 - значения поля будут отрисовываться как байты, килобайты и т.д.

  • 2 - значения поля будут умножаться на 8 и отрисовываться как байты, килобайты и т.д.

Long

period

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

Строка опций должна иметь следующую форму: MIN_UNIT MAX_UNIT. MIN_UNIT и MAX_UNIT - минимальные и максимальные типы целых единиц, используемые для отрисовки или редактирования периода. Доступные единицы описаны здесь, единицы Неделя и Квартал не поддерживаются.

Пример: 1 3. Эта строка опций позволяет использовать только секунды, минуты и часы для отрисовки/выбора периода. Милисекунды будут опущены. Значения больше одного часа будут отрисовываться в часах.

Long, String

foreignInstance

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

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

  • Контекст хранилища. Контекст хранилища для просмотра объектов/классов.

  • Просмотр. Определяет, какой вид просмотра будет использован для определения показываемого списка колонок, правил фильтрации и порядка сортировки. Доступно только для классов. Если выбран Пользовательский просмотр, это возможно - определить опции Класс, Колонки, Фильтр и Сортировка.

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

  • Поле ссылки. Определят, какая колонка (поле) будет использоваться как внешний ключ.

  • Колонки. Определяет, какие колонки (поля) будут показаны в диалоге выбора экземпляров.

  • Фильтр. Определяет фильтр экземпляра. В выражениях фильтра можно использовать переменную окружения '{env/sourceInstance}', представляющую экземпляр исходного класса, из которого мы ссылаемся.

  • Сортировка. Определяет порядок сортировки.

  • Инструментальная панель.Определяет, какая инструментальная панель должна быть открыта, если сделан клик по экземпляру выбранного класса. Выбранная инструментальная панель должна быть настроен для визуализации экземпляров Класса.

  • Иконка. Определяет идентификатор иконки, которая должна быть показана после экземпляра выбранного класса.

Integer, Float, Double, String

instance

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

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

  • Контекст хранилища. Контекст хранилища для просмотра объектов/классов.

  • Таблица. Тип/имя объекта этих экземпляров можно выбирать. Большинство контекстов хранилища предоставляют доступ к отельному объекту, в этом случае только одна функция будет доступна в этом поле.

  • Инструментальная панель.Определяет, какая инструментальная панель должна быть открыта, если сделан клик по экземпляру выбранного класса. Выбранная инструментальная панель должна быть настроен для визуализации экземпляров Класса.

  • Иконка. Определяет идентификатор иконки,которая должна быть показана после экземпляра выбранного класса.

Integer, Float, Double, String, Long

formatMask

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

Маска Формата. Тысячи, сотни, десятки и единицы, а также любое количество десятичных мест обозначаются знаком числа #. Разделители могут быть обозначены запятой (,), точкой (.) или пробелом ( ). Когда используется один разделитель, он интерпретируется как разделитель тысяч. Когда используются два разделителя, правый интерпретируется как десятичный разделитель (разделитель целой и дробной части), а левый - как разделитель тысяч. Рассмотрим следующие примеры отображения числа 12345678.1234:

Маска формата # ###.# будет отображать 12345678.1234 как 12 345 678.1

Маска формата #.###,## будет отображать 12345678.1234 как 12.345.678,12

Маска формата #.### будет отображать 12345678.1234 как 12.345.678

String

expression

Редактор выражения. Позволяет ввести SberMobile выражение при помощи Редактора выражения.

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

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

  • Ссылки. Ссылки, которые будут доступны для вставки с помощью одного клика во время редактирования выражения.

  • Ожидаемый результат. Текстовое объяснение того, что должно возвращать выражение.

  • Описание контекста по умолчанию. Текстовое объяснение того, что должно будет контекстом по умолчанию во время оценки выражения.

  • Описание таблицы по умолчанию. Текстовое объяснение того, что будет таблицей по умолчанию во время оценки выражения.

String

password

Редактор пароля. Редактор пароля представляет собой текстовое поле, которое заменяет все символы на "*".

Не разрешены.

String

text

Текстовый редактор. Использует полнофункциональный редактор текстов с поддержкой выделения синтаксиса для редактирования текстовых строк.

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

html - разметка HTML

java - код Java

shellscript - сценарий оболочки Unix

smi-mib - синтаксис файла SNMP MIB

sql - запрос SQL

xml - разметка XML

String

html

Отрисовщик HTML. Отрисовывает текст ячеек как разметку HTML.

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

Пример: 100. Эта строка опций покажет в таблице первые 100 символов строки.

String

textarea

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

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

Пример: 100. Эта строка опций покажет в таблице первые 100 символов строки.

String

etextarea

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

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

Пример: 50. Эта строка опций вызовет отрисовку текстовой области с достаточной шириной для отображения 50 символов и достаточной высотой для вмещения всего текста.

String

context

Редактор контекста. Позволяет пользователю задать путь контекста.

  • Корневой элемент. Выбор контекстов будет разрешен только из контекстов, находящихся ниже этого корневого контекста.

  • Типы контекстов. Если хотя бы один тип указан, редактор контекста позволит выбрать только контексты определенных типов.

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

String

contextmask

Редактор маски контекста. Позволяет пользователю задать маску контекста.

Те же, что выше.

String

reference

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

  • Внешний вид. Стиль ссылки: Ссылка или Кнопка.

  • Тип ссылки. Тип операции: Запись переменной, Вызов функции, Формирование события или Выполнение действия. В большинстве случаев, требуемый тип - это Действие.

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

  • Контекст. Путь контекста, из которого вызывается операция. Доступно, если Тип контекста Статический.

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

Среда вычисления контекста выражения:

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

Контекст по умолчанию текущего редактора.

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

Просматриваемая/изменяемая в редакторе таблица данных.

Строка по умолчанию

Строка, содержащая выбранную ссылку.

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

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

  • Тип объекта. Определяет, каким образом система выбирает объект (переменная/функция/событие/действие), который будет изменен, если был клик по ссылке. Может быть Статическим, когда определен особый Объект во время конфигурации ссылки, либо Динамическим, когда имя объекта  вычислено при помощи оценки Выражения объекта.

  • Объект. Имя объекта для использовании в операции, напр. имя действия, которое нужно выполнить. Доступно, если Тип объекта Статический.

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

Среда вычисления выражения объекта:

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

Контекст по умолчанию текущего редактора.

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

Просматриваемая/изменяемая в редакторе таблица данных.

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

Ряд, содержащий выбранную ссылку.

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

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

  • Параметры объекта. Определяет, какие параметры будут переданы операции. Например, если Тип ссылки - Действие или Функция, то будет использован список параметров объекта для заполнения таблицы параметров ввода действия или функции.

  • Иконка. Определяет идентификатор иконки, которая должна быть показана после текста ссылки.

String

font

Редактор шрифта. Позволяет выбрать шрифт из списка шрифтов, установленных на машине, где запущен SberMobile IIoT Platform Client.

Не разрешены.

String

ip

Редактор IP-адреса. Позволяет ввести IP-адрес. Имена хостов не разрешены.

Не разрешены.

Color

box

Отрисовщик прямоугольников. Обычно цветовые значения отрисовываются как маленькие цветные прямоугольники вместе с числовыми RGB-значениями цвета. Отрисовщик прямоугольников не показывает числовые RGB-значения и вместо этого отображает большой закрашенный прямоугольник.

Не разрешены.

Data Block

dtext

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

Оставлены для внутреннего пользования.

Data Block

image

Редактор изображения. Позволяет вставлять и просматривать изображения в полях типа Data Block.

Оставлены для внутреннего пользования.

Data Block

sound

Редактор звука. позволяет вставлять и прослушивать звуки в полях типа блок данных.

Оставлены для внутреннего пользования.

Data Block

hex

Редактор шестнадцатеричных чисел. Позволяет просматривать/редактировать отдельные байты блоков данных в шестнадцатеричном формате. При редактировании блока данных также возможно поменять размер блока путем ввода нового размера (в байтах) внутри текстового поля.

Не разрешены.