Low-code дизайнер > Конструктор приложений / Типы данных в системе

Типы данных в системе

Для хранения данных на формах, виджетах, задачах или стартовых событиях бизнес-процесса в системе используются наборы полей. Выбор типа поля зависит от информации, которую необходимо отображать. Например, для комментария создаётся поле типа Строка, для суммы договора — Деньги и т. д.

Подробнее о добавлении полей на формы читайте в статье «Вкладка „Контекст“». Ниже подробно описаны типы данных, которые поддерживаются в системе. О том, как работать с различными типами данных в сценариях, читайте в справке ELMA365 TS SDK.

Строка

Применяется для внесения текстовой информации.

datatype

Возможны варианты отображения в виде строки или текста. Опция Markdown позволяет форматировать вводимую информацию с помощью разметки. Подробнее об этом читайте в статье «Markdown»‎.

строка или текст

Кроме общих настроек, у данного типа есть дополнительная настройка:

  • Валидаторы — позволяет задать шаблон, с помощью которого будет проверяться корректность введённой информации.
  • Маска ввода —  в качестве маски используются регулярные выражения. В маске доступны только выражения без флагов. Подробнее про написание регулярных выражений можно прочитать в документации MDN Web Docs.
  • Сообщение при несоответствии маске ввода — текст сообщения, который будет отображаться при вводе строки, не отвечающей требованиям введённого регулярного выражения. Подробнее об этом читайте в статье «Создание масок строковых полей с помощью регулярных выражений».

Число

Данное поле используется для ввода чисел.

процент продаж пример

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

Определите тип вводимых чисел:

  • Целое или Дробное — определяет формат числа для ввода. Тип числа Дробное позволяет вводить дробные числа.

число

Выбор «да/нет»

Добавляет на форму флажок или переключатель и позволяет пользователям выбрать один из возможных вариантов.

По умолчанию доступны значения Да и Нет, но вы можете переименовать их.

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

data_types-5

Варианты отображения:

  • Флажок

выбор да нет пример 1

  • Переключатель

выбор да нет пример 2

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

Дата/время

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

дата время пример

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

1. Дата/Время на форме нужно будет указать дату и время.

2. Дата на форме нужно указать только дату. При этом значению автоматически присвоится время 00:00.

3. Время на форме нужно указать только время.

дата время

Вы можете также включить опции:

  • Устанавливать текущую дату и время — в поле будет указана текущая дата и время. При выборе данной опции для переменной бизнес-процесса подставится дата запуска этого процесса;
  • Время опционально — при необходимости, помимо даты, пользователь сможет указать на форме время. Опция доступна для типа Дата/Время. Дополнительно можно определить, какое время будет установлено по умолчанию:  
    • Начало дня — 00:00;
    • Конец дня — 23:59.

дата время пример 2

На форме в поле Время будет записан один из двух вариантов.

Категория

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

Определите количество выбираемых вариантов, включив опцию Одиночный или Множественный.

категория

Для выбора варианта в настроенном на форме поле откройте выпадающий список.

hmfile_hash_5d96da6f

Сбросить значение можно, нажав значок delete_2 или выбрав пустую строку.

Для работы с полем Категория можно использовать сценарии, что позволяет автоматически заполнять список вариантов выбора. Например, можно записать в него статусы приложения. Это делается путем настройки динамического списка. Для этого используется переменная, собирающая статусы и их значения, передаваемые в поле типа Категория в виде массива. Такая настройка также обеспечивает автоматическое обновление списка при изменениях в статусах приложений, устраняя необходимость ручной корректировки. Дополнительная информация по настройке такого поля доступна в справке
ELMA365 TS SDK.

 

Деньги

Поле для ввода чисел c указанием кода валюты.

System_Data_types-16

Валюта — выберите тип валюты в выпадающем списке справа от названия поля. В дальнейшем, при редактировании поля, вы сможете изменить валюту на другую. Однако в таком случае значения, указанные пользователями ранее, не изменятся до тех пор, пока кто-то не откроет поле и не сохранит введённые данные заново. Наименования и коды валют соответствуют стандарту ISO 4217.

Обязательно отображать__знаков после целого — укажите количество цифр, выводимых после запятой на форме просмотра элемента приложения. Функция доступна даже для целых чисел. Например, введите в поле цифру 2, и данные на форме просмотра будут отображаться следующим образом: 100,00₽.

Учетная запись

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

Вы можете указать Тип учетной записи: Telegram, WhatsApp, Viber и т. д. Также доступен тип Другие, который используется для хранения записи, тип которой не указан в списке, например, электронной почты.

тип учетная запись

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

System_Data_types_17

Номер телефона

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

Вы можете указать Тип номера телефона: главный, домашний, рабочий и т. д.

system-data-types-18

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

Опция Степень валидации позволяет задать строгость проверки введённого на форме номера на соответствие формату номеров в выбранной стране:

  • Предупреждать о неверном значении — если пользователь введёт номер в неверном формате, справа от поля появится значок attention. При этом элемент приложения с таким значением в поле можно сохранить;
  • Запрещать неверные значения — при неверном формате номера под полем появится предупреждение. Чтобы сохранить элемент приложения, пользователю нужно скорректировать номер телефона.

system-data-types-20

При заполнении поля на форме пользователь может указать добавочный номер абонента через разделитель:

  • +79991234567 x1234
  • +79991234567 ext 1234
  • +79991234567 доб 1234
  • +79991234567;1234

На форме просмотра добавочный номер будет отображаться следующим образом: +79991234567 x1234.

Электронная почта

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

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

system-data-types-21

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

Опция Степень валидации позволяет задать строгость проверки формата электронной почты при заполнении поля на форме:

  • Предупреждать о неверном значении — если пользователь введёт электронную почту в неверном формате, справа от поля появится значок attention. При этом элемент приложения с таким адресом можно сохранить;
  • Запрещать неверные значения — при неверном формате адреса электронной почты под полем появится предупреждение. Чтобы сохранить элемент приложения, пользователю нужно скорректировать адрес почты.

system-data-types-22

При заполнении поля на форме пользователи могут указывать доменное имя в адресе английскими и русскими буквами: petrov@example.com, petrov@домен.ру.

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

data_type_2

  • Почтовый клиент по умолчанию — выберите опцию, чтобы перейти в окно добавления письма в email-приложении, установленном на вашем компьютере. Адрес получателя будет заполнен автоматически;
  • ELMA365 — если вы подключили электронный адрес к встроенному почтовому клиенту ELMA365 в разделе Почта, вы сможете создать и отправить новое письмо в интерфейсе системы. При нажатии откроется окно Написать сообщение. Поле Кому будет заполнено автоматически;
  • Скопировать в буфер — сохраните электронный адрес в буфере обмена.

Изображение

Изображение позволяет прикрепить файлы следующих форматов: .jpg, .tiff, .gif, .bmp, .png. При настройке поля вы можете определить количество прикрепляемых изображений: Одно или Несколько.

Если установлен флажок Выбирать фрагмент изображения при загрузке, вы сможете указать определённую область изображения для отображения.

изображение 1

Вид отображения на форме:

изображение пример

Файлы

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

Вы можете настроить количество прикрепляемых файлов: Один или Несколько.

количество файлов

Добавленный в поле файл будет отображаться на форме следующим образом:

файлы пример

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

  • загрузить документ на компьютер, нажав на значок save-doc-icon;
  • вызвать меню с дополнительными опциями, нажав на значок doc-options-icon:
    • Управление доступом — по умолчанию доступ к файлу определяется настройками доступа к элементу приложения, в котором он добавлен. Вы можете выдать дополнительные права на файл другим пользователям системы;
    • Создать копию — сохраните копию документа в папке раздела Файлы. В этом случае вы сможете применять к нему все доступные действия с файлами.

Версионность файлов

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

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

file-version

Начало внимание 

Чтобы использовать версионность файлов в поставке ELMA365 On-Premises, администратору системы нужно включить на сервере фича-флаг allowAddVersionFileFields. Для активации этой возможности в облачной поставке — обратиться в техподдержку ELMA365.

Конец внимание 

Ф.И.О.

Данное поле позволяет вносить данные о фамилии, имени и отчестве.

фио пример

Произвольное приложение

Поле позволяет выбрать элемент любого приложения.

Вы можете определить количество элементов приложения, указываемое на форме: Один или Несколько.

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

произвольное приложение

Чтобы выбрать элемент, на форме приложения нажмите на поле или на значок лупы. В окне поиска выберите приложение из списка.

System_Data_types_18

Откроется окно, в котором можно выбрать элемент приложения. В дальнейшем он отобразится на форме в виде ссылки. Нажмите на неё для перехода на страницу элемента.

Чтобы выбрать другой элемент, нажмите значок корзины справа от ссылки. Поле выбора элемента будет очищено.

arbitrary-app-2

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

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

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

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

Ссылка

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

ссылка пример

Таблица

С помощью поля Таблица вы можете структурировать данные по строкам и колонкам, изменять их внешний вид и вставлять специальные формулы, которые будут выполнять расчёты. Подробнее о том, как работать с этим типом поля, вы можете прочитать в статье «Тип данных „Таблица“».

таблица пример

Роль

С помощью поля Роль вы можете указать пользователей системы, группы пользователей, а также элементы оргструктуры.

role_2

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

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

role_1

Пользователи

В поле такого типа вы можете указать одного или несколько конкретных пользователей системы.

user-field-type

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

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

system-data-types-19

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

В открывшемся окне нажмите кнопку + Фильтр и выберите поля из карточки пользователя в качестве условий для фильтрации.

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

Приложение

Разместив поле на форме приложения, вы можете выбрать в нём один или несколько элементов другого приложения. Тогда между элементами приложений создастся связь. В карточке элемента одного приложения добавится ссылка на связанный элемент другого приложения. Нажав на неё, вы сможете открыть карточку связанного элемента.

начало внимание

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

конец внимание

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

приложение эл-т прил

После выбора приложения появляются дополнительные опции:

зависимое поле

  • Значения по умолчанию для новых элементов — опция позволяет настроить приложение таким образом, чтобы на его форме пользователи могли создавать элементы другого приложения с автоматически заполненными значениями. Например, на форме договора можно создавать относящиеся к нему акты и заполнять их поля в соответствии с данными договора. Подробнее читайте в статье «Значения по умолчанию для новых элементов».
  • Зависимое поле — эта опция позволяет связать элементы одного приложения с другим. При этом элементы дочернего приложения создаются на карточке родительского и не сохраняются до тех пор, пока не будет сохранено родительское приложение. Подробнее о настройке можно прочитать в статье «Зависимые связи в приложениях».
  • Ограничить выбор — опция позволяет отфильтровать доступные для выбора элементы приложения. Например, показывать только элементы, созданные позднее заданной даты, или элементы, которые были добавлены текущим пользователем. Подробную информацию о настройке можно найти в статье «Динамические формы».

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

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

приложение пример 2

В расширенном режиме настройки форм для полей типа Приложение автоматически включается опция Только для чтения. При заполнении поля на форме пользователи увидят только кнопку создания нового элемента. Вы можете настроить, как она будет выглядеть. Подробнее об этом читайте в статье «Создание элементов приложения на карточке другого приложения».

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

Отчет

Отчёт — это компонент системы, в котором в виде таблицы показываются данные из нескольких приложений-источников. Например, в отчёте Реестр заказов можно связать между собой разные приложения системы и отобразить информацию о заказе, клиенте, договоре и счёте. Подробнее читайте в разделе «Отчет».

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

report-type-field-1

Создание поля типа Отчет доступно только в дизайнере интерфейсов на вкладке Контекст.

Чтобы добавить поле типа Отчет:

  1. В приложении включите расширенный режим настройки форм.
  2. Перейдите в дизайнер интерфейсов выбранной формы приложения или страницы и на вкладке Контекст нажмите + Добавить.
  3. Укажите имя и тип свойства, выберите созданный в системе отчёт и нажмите Создать.

report-field-type-2

Теперь вы сможете обращаться к полям выбранного отчёта в сценариях с помощью методов TSSDK или добавить ссылку на отчёт на форму или страницу.

  1. Перейдите на вкладку Шаблон, на правой панели выберите Свойства и перетащите свойство типа Отчет на поле для моделирования.
  2. В открывшемся окне задайте название поля на форме и нажмите Сохранить.
  3. Чтобы отредактировать название ссылки на отчёт, измените имя поля на вкладке Контекст.
  4. Сохраните и опубликуйте настроенную форму или страницу.

Для поля типа Отчет включается опция Только для чтения. Пользователи смогут переходить на страницу отчёта по заданной ссылке, но не смогут изменять значение поля.