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

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

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

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

Строка

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

datatype

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

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

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

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

Число

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

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

При добавлении свойства выберите его тип:

number-fraction-01

  • Целое или Дробное — определяет формат числа для ввода.
  • Максимальное количество знаков после целого настройка доступна только для дробного числа и позволяет указать, сколько знаков после разделителя будет отображаться в поле. Значение выбирается из списка от двух до десяти.
    Например, поле на форме заполняется по формуле, и для него указано ограничение 2 знака после целого. Если в результате вычислений получилось число 3,14159, в поле отобразится 3,14.
    При ручном вводе числа на форме создания или редактирования пользователь также сможет указать только допустимое количество знаков.

 

Вычисление дробного числа в системе может быть неточным по причине особенностей исполнения языка JavaScript в браузере пользователя и в NodeJS на сервере. Подробнее об этом читайте в статье «Неточные вычисления в JavaScript».

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

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

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

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

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₽.
    Максимально возможное значение зависит от типа валюты. Если оно превышено, отобразится значок money-1. Наведите на него курсор, чтобы увидеть допустимое количество знаков.

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

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

Вы можете указать Тип учетной записи: 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, .gif, .bmp, .png. При настройке поля вы можете определить количество прикрепляемых изображений: Одно или Несколько.

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

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

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

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

Файлы

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

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

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

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

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

files-data-types

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

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

файлы пример

Вы можете скопировать ссылку на файл, чтобы поделиться им с коллегой. Для этого нажмите значок link-to-file-icon-on-white. Другой сотрудник сможет скачать файл по ссылке, если у него есть соответствующие права доступа.

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

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

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

Версионность для типа данных «Файлы»

Для файлов, которые загружаются в поле типа Файлы, в ELMA365 поддерживается версионность.

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

Чтобы версионность файлов стала доступна, администратору системы нужно включить фича‑флаг allowAddVersionFileFields. Подробнее читайте в статьях «Изменение параметров On‑Premises Enterprise» и «Изменение параметров On‑Premises Standard». Если вы используете поставку SaaS, для включения фича‑флага обратитесь к вашему менеджеру ELMA365.

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

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

Особенности версионности:

  • если в поле типа Один загрузить новый файл, он добавится как версия для существующего;
  • если в поле типа Несколько загрузить файлы с таким же названием и форматом, как у существующих, они добавятся как версии к существующим файлам;
  • если в ходе бизнес-процесса или скрипта в поле записывается файл, полностью совпадающий с последней версией существующего, то новая версия не добавляется.

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

file-version

Ф.И.О.

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

фио пример

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

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

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

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

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

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

System_Data_types_18

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

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

arbitrary-app-2

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

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

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

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

Ссылка

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

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

Таблица

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

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

Роль

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

role_2

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

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

role_1

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

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

user-field-type

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

В дизайнере интерфейсов вы можете выносить вложенные поля свойства типа Пользователь с подтипом Один на шаблон виджета или форму приложения.

user-4

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

system-data-types-19

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

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

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

Приложение

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

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

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

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

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

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

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

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

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

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

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

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

В дизайнере интерфейсов вы можете выносить вложенные поля свойства типа Приложение с подтипом Один на шаблон виджета или форму приложения.

app-4

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

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

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

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

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

Событие

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

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

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

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

Подробнее о свойстве типа Событие и работе с ним читайте в справке ELMA365 TS SDK. Примеры использования этого типа данных приведены в статьях: «Передать событие из дочернего виджета в родительский», «Передать событие между двумя дочерними виджетами».

Произвольный тип

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

Отчет

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

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

report-type-field-1

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

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

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

report-field-type-2

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

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

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