Для хранения данных на формах, виджетах, задачах или стартовых событиях бизнес-процесса в системе используются наборы полей. Выбор типа поля зависит от информации, которую необходимо отображать. Например, для комментария создаётся поле типа Строка, для суммы договора — Деньги и т. д.
Подробнее о добавлении полей на формы читайте в статье «Вкладка „Контекст“». Ниже подробно описаны типы данных, которые поддерживаются в системе. О том, как работать с различными типами данных в сценариях, читайте в справке ELMA365 TS SDK.
Строка
Применяется для внесения текстовой информации.
Возможны варианты отображения в виде строки или текста. Опция Markdown позволяет форматировать вводимую информацию с помощью разметки. Подробнее об этом читайте в статье «Markdown».
Кроме общих настроек, у данного типа есть дополнительная настройка:
- Валидаторы — позволяет задать шаблон, с помощью которого будет проверяться корректность введённой информации.
- Маска ввода — в качестве маски используются регулярные выражения. В маске доступны только выражения без флагов. Подробнее про написание регулярных выражений можно прочитать в документации MDN Web Docs.
- Сообщение при несоответствии маске ввода — текст сообщения, который будет отображаться при вводе строки, не отвечающей требованиям введённого регулярного выражения. Подробнее об этом читайте в статье «Создание масок строковых полей с помощью регулярных выражений».
Число
Данное поле используется для ввода чисел.
Ввести другие символы кроме чисел в данное поле не получится.
Определите тип вводимых чисел:
- Целое или Дробное — определяет формат числа для ввода. Тип числа Дробное позволяет вводить дробные числа.
Выбор «да/нет»
Добавляет на форму флажок или переключатель и позволяет пользователям выбрать один из возможных вариантов.
По умолчанию доступны значения Да и Нет, но вы можете переименовать их.
Чтобы одно из значений отображалось на форме по умолчанию, отметьте его флажком. При необходимости вы сможете изменить значение поля на форме.
Варианты отображения:
- Флажок
- Переключатель
Вы можете изменить вариант отображения, указанный при создании поля. Для этого перейдите в Настройки формы приложения, выберите поле и отметьте нужную опцию.
Дата/время
Данный тип используется для добавления на форму выбора даты и/или времени.
Настроить формат отображения можно при создании свойства или контекстной переменной.
1. Дата/Время — на форме нужно будет указать дату и время.
2. Дата — на форме нужно указать только дату. При этом значению автоматически присвоится время 00:00.
3. Время — на форме нужно указать только время.
Вы можете также включить опции:
- Устанавливать текущую дату и время — в поле будет указана текущая дата и время. При выборе данной опции для переменной бизнес-процесса подставится дата запуска этого процесса;
- Время опционально — при необходимости, помимо даты, пользователь сможет указать на форме время. Опция доступна для типа Дата/Время. Дополнительно можно определить, какое время будет установлено по умолчанию:
- Начало дня — 00:00;
- Конец дня — 23:59.
На форме в поле Время будет записан один из двух вариантов.
Категория
Данный тип помогает настроить поле для выбора одного или нескольких вариантов из списка. Доступные варианты можно добавить при настройке и редактировании формы или при создании контекстной переменой.
Определите количество выбираемых вариантов, включив опцию Одиночный или Множественный.
Для выбора варианта в настроенном на форме поле откройте выпадающий список.
Сбросить значение можно, нажав значок 
или выбрав пустую строку.
Деньги
Поле для ввода чисел c указанием кода валюты.
Валюта — выберите тип валюты в выпадающем списке справа от названия поля. В дальнейшем, при редактировании поля, вы сможете изменить валюту на другую. Однако в таком случае значения, указанные пользователями ранее, не изменятся до тех пор, пока кто-то не откроет поле и не сохранит введённые данные заново. Наименования и коды валют соответствуют стандарту ISO 4217.
Обязательно отображать__знаков после целого — укажите количество цифр, выводимых после запятой на форме просмотра элемента приложения. Функция доступна даже для целых чисел. Например, введите в поле цифру 2, и данные на форме просмотра будут отображаться следующим образом: 100,00₽.
Учетная запись
Поле используется для хранения учётных записей мессенджеров. Приложение, в контексте которого есть поле этого типа, можно связывать с сессиями в линиях в разделе Линии.
Вы можете указать Тип учетной записи: Telegram, WhatsApp, Viber и т. д. Также доступен тип Другие, который используется для хранения записи, тип которой не указан в списке, например, электронной почты.
Если вы выбрали опцию Несколько, пользователь сможет выбрать тип и добавить несколько учётных записей при заполнении поля на форме.
Номер телефона
Поле используется для ввода номера телефона.
Вы можете указать Тип номера телефона: главный, домашний, рабочий и т. д.
Если вы выбрали опцию Несколько, пользователь сможет указать тип номера при заполнении поля на форме.
Вы можете указать в поле добавочный номер через разделитель, например:
- +79991234567 x1234
- +79991234567 ext 1234
- +79991234567 доб 1234
- +79991234567;1234
На форме добавочный номер будет отображаться следующим образом: +79991234567 x1234.
Дополнительно при заполнении и редактировании поля на форме предусмотрена валидация формата номера в зависимости от выбранной страны. Если формат основного и добавочного номеров не соответствует заданным настройкам, справа от поля появится значок 
.
Электронная почта
Поле используется для ввода электронной почты.
При заполнении поля на форме происходит проверка на соответствие формату электронной почты: если формат не совпадает, появится сообщение об ошибке. При этом указывать доменное имя в адресе можно английскими и русскими буквами: ivanov@example.com, ivanov@домен.ру.
Вы можете указать Тип электронной почты: главная, домашняя, рабочая.
Если вы выбрали опцию Несколько, при заполнении поля пользователь может сам определить тип.
Когда поле заполнено, на форме просмотра доступны дополнительные опции: вы можете быстро перейти к добавлению и отправке письма на указанный электронный адрес, а также скопировать почту в буфер обмена. Для этого нажмите на значок 
рядом с заполненным полем и выберите опцию.
- Почтовый клиент по умолчанию — выберите опцию, чтобы перейти в окно добавления письма в email-приложении, установленном на вашем компьютере. Адрес получателя будет заполнен автоматически;
- ELMA365 — если вы подключили электронный адрес к встроенному почтовому клиенту ELMA365 в разделе Почта, вы сможете создать и отправить новое письмо в интерфейсе системы. При нажатии откроется окно Написать сообщение. Поле Кому будет заполнено автоматически;
- Скопировать в буфер — сохраните электронный адрес в буфере обмена.
Изображение
Изображение позволяет прикрепить файлы следующих форматов: .jpg, .tiff, .gif, .bmp, .png. При настройке поля вы можете определить количество прикрепляемых изображений: Одно или Несколько.
Если установлен флажок Выбирать фрагмент изображения при загрузке, вы сможете указать определённую область изображения для отображения.
Вид отображения на форме:
Файлы
Поле Файлы позволяет прикрепить файлы любого формата, например, счета, документы, видео и т. д.
Вы можете настроить количество прикрепляемых файлов: Один или Несколько.
Добавленный в поле файл будет отображаться на форме следующим образом:
Нажав на файл в карточке элемента или задачи, вы можете открыть его в режиме предпросмотра. На странице превью можно:
- загрузить документ на компьютер, нажав на значок
; - вызвать меню с дополнительными опциями, нажав на значок
:- Управление доступом — по умолчанию доступ к файлу определяется настройками доступа к элементу приложения, в котором он добавлен. Вы можете выдать дополнительные права на файл другим пользователям системы;
- Создать копию — сохраните копию документа в папке раздела Файлы. В этом случае вы сможете применять к нему все доступные действия с файлами.
Версионность файлов
У файлов, которые загружаются в поле Файлы одиночного типа в ELMA365 поддерживается версионность. Пользователь может добавить новую версию к существующему в поле файлу, загрузив файл с компьютера при редактировании элемента, или прикрепив версию в ходе бизнес-процесса с помощью блоков Присваивание и Изменение элемента.
Все загруженные версии файла сохраняются в системе. Чтобы отобразить список версий в карточке задачи или элемента приложения, вынесите на форму виджет Версии документа и в его настройках укажите свойство, хранящее файл.
Начало внимание
Чтобы использовать версионность файлов в поставке ELMA365 On-Premises, администратору системы нужно включить на сервере фича-флаг allowAddVersionFileFields. Для активации этой возможности в облачной поставке — обратиться в техподдержку ELMA365.
Конец внимание
Ф.И.О.
Данное поле позволяет вносить данные о фамилии, имени и отчестве.
Произвольное приложение
Поле позволяет выбрать элемент любого приложения.
Вы можете определить количество элементов приложения, указываемое на форме: Один или Несколько.
Если выбрана опция Несколько, в поле можно будет указывать элементы разных приложений.
Чтобы выбрать элемент, на форме приложения нажмите на поле или на значок лупы. В окне поиска выберите приложение из списка.
Откроется окно, в котором можно выбрать элемент приложения. В дальнейшем он отобразится на форме в виде ссылки. Нажмите на неё для перехода на страницу элемента.
Чтобы выбрать другой элемент, нажмите значок корзины справа от ссылки. Поле выбора элемента будет очищено.
Если значок корзины не отображается, значит поле доступно только для чтения. Изменить его значение нельзя.
Поле Произвольное приложение можно добавить, например, на виджет. А затем использовать его на разных формах, как универсальный компонент.
Обратите внимание, при сопоставлении входных и выходных атрибутов, а также связывании с полем типа Произвольное приложение вы можете указать переменные одного из следующих типов: Произвольное приложение, Приложение, Файл, Пользователь.
Узнать больше о входных и выходных атрибутах и связывании полей.
Ссылка
Позволяет отображать ссылку на сайт, документ в ELMA365, раздел и другие интернет-источники.
Таблица
С помощью поля Таблица, сможете структурировать данные по строкам и колонкам, изменять их внешний вид и вставлять специальные формулы, которые будут выполнять расчёты. Подробнее о том, как работать с этим типом поля, вы можете прочитать в статье «Тип данных „Таблица“».
Роль
С помощью поля Роль вы можете указать пользователей системы, группы пользователей, а также элементы оргструктуры.
Использовать тип Роль удобно, когда нужно выбрать целую группу пользователей или определённые элементы оргструктуры. В этом случае не придётся выделять каждого конкретного пользователя, достаточно указать должность или группу.
При настройке поля вы также можете включить опцию Показывать заблокированных.
Пользователи
В поле такого типа вы можете указать одного или несколько конкретных пользователей системы.
При настройке поля вы можете включить опцию Показывать заблокированных, а также указать количество выбранных пользователей: Один или Несколько.
Если в поле с опцией Несколько нажать значок лупы, можно выбрать пользователей в открывшемся списке.
Также вы можете ограничить список доступных для выбора пользователей. Для этого включите опцию Ограничить выбор и нажмите на появившуюся ссылку Настроить условия. 
В открывшемся окне нажмите кнопку + Фильтр и выберите поля из карточки пользователя в качестве условий для фильтрации.
Например, вы можете настроить фильтр так, чтобы на форме в списке пользователей отображались только сотрудники из определённой группы.
Приложение
Разместив поле на форме приложения, вы можете выбрать в нём один или несколько элементов другого приложения. Тогда между элементами приложений создастся связь. В карточке элемента одного приложения добавится ссылка на связанный элемент другого приложения. Нажав на неё, вы сможете открыть карточку связанного элемента.
начало внимание
Добавленную связь между приложениями нельзя отредактировать или удалить, даже в случае удаления полей.
конец внимание
Приложение выбирается на этапе настройки формы или создания контекстной переменной. Чтобы определить, сколько элементов приложения можно будет указывать в поле, в настройках переменной отметьте опцию Один или Несколько.
После выбора приложения появляются дополнительные опции:
- Значения по умолчанию для новых элементов — опция позволяет настроить приложение таким образом, чтобы на его форме пользователи могли создавать элементы другого приложения с автоматически заполненными значениями. Например, на форме договора можно создавать относящиеся к нему акты и заполнять их поля в соответствии с данными договора. Подробнее читайте в статье «Значения по умолчанию для новых элементов».
- Зависимое поле — это опция позволяет связать элементы одного приложения с другим. При этом элементы дочернего приложения создаются на карточке родительского и не сохраняются до тех пор, пока не будет сохранено родительское приложение. Подробнее о настройке можно прочитать в статье «Зависимые связи в приложениях».
- Ограничить выбор — опция позволяет отфильтровать доступные для выбора элементы приложения. Например, показывать только элементы, созданные позднее заданной даты, или элементы, которые были добавлены текущим пользователем. Подробную информацию о настройке можно найти в статье «Динамические формы».
Чтобы заполнить поле на настроенной форме, начните вводить название элемента или нажмите значок лупы для перехода к списку доступных элементов и поиску по параметрам.
Если пользователю предоставлены права доступа на создание элементов в выбранном приложении, он также может добавить новый элемент при заполнении поля на форме. Для этого необходимо нажать кнопку +Создать.
В расширенном режиме настройки форм для полей типа Приложение автоматически включается опция Только для чтения. При заполнении поля на форме пользователи увидят только кнопку создания нового элемента. Вы можете настроить, как она будет выглядеть. Подробнее об этом читайте в статье «Создание элементов приложения на карточке другого приложения».
Чтобы пользователи при заполнении поля могли выбирать элемент из списка существующих, перейдите в настройки формы приложения и отключите опцию Только для чтения для этого свойства. Подробнее читайте в статье «Вкладки „Создание“, „Просмотр“, „Редактирование“».
Отчет
Отчёт — это компонент системы, в котором в виде таблицы показываются данные из нескольких приложений-источников. Например, в отчёте Реестр заказов можно связать между собой разные приложения системы и отобразить информацию о заказе, клиенте, договоре и счёте. Подробнее читайте в разделе «Отчет».
Поле типа Отчет позволяет добавить на форму приложения или страницу ссылку на созданный в системе отчёт. При переходе по ссылке будет открываться страница с настроенной таблицей отчёта.
Создание поля типа Отчет доступно только в дизайнере интерфейсов на вкладке Контекст.
Чтобы добавить поле типа Отчет:
- В приложении включите расширенный режим настройки форм.
- Перейдите в дизайнер интерфейсов выбранной формы приложения или страницы и на вкладке Контекст нажмите + Добавить.
- Укажите имя и тип свойства, выберите созданный в системе отчёт и нажмите Создать.
Теперь вы сможете обращаться к полям выбранного отчёта в сценариях с помощью методов TSSDK или добавить ссылку на отчёт на форму или страницу.
- Перейдите на вкладку Шаблон, на правой панели выберите Свойства и перетащите свойство типа Отчет на поле для моделирования.
- В открывшемся окне задайте название поля на форме и нажмите Сохранить.
- Чтобы отредактировать название ссылки на отчёт, измените имя поля на вкладке Контекст.
- Сохраните и опубликуйте настроенную форму или страницу.
Для поля типа Отчет включается опция Только для чтения. Пользователи смогут переходить на страницу отчёта по заданной ссылке, но не смогут изменять значение поля.