Назначение

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

Создание экранной формы

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

Создание вручную

Для создания новой экранной формы:

1. Нажмите на кнопку "Создать экранную форму".
2. Заполните поля в открывшемся окне:
   
   
   
3. Нажмите на кнопку "Создать". 
4. В таблицу с личными экранными формами будет добавлена запись о новой форме с версией "Новая".
   Текущее окно закроется и откроется страница редактора новой экранной формы (подробнее о редакторе):
   
   

Добавление из примеров

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

Для добавления новой экранной формы:

1. Нажмите на кнопку "Использовать пример".
2. Откроется окно, в котором отображается количество выбранных примеров и таблица с доступными примерами. В таблице отображаются название и описание экранных форм.
   
   
   
3. Выберите один или несколько примеров, активировав чекбокс в строке с нужной экранной формой.
4. Нажмите на кнопку "Добавить". Кнопка неактивна, если не выбран ни один пример.
5. Окно закроется. Выбранные формы будут добавлены в таблицу раздела.
   Если в таблице уже есть экранная форма с таким же названием, как у примера, то к названию добавляемой формы автоматически добавится индекс. Например, если форма "Распознанный паспорт" уже существует, то новая форма будет добавлена с названием "Распознанный паспорт_1".

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

Добавление через импорт

Любую опубликованную экранную форму можно скачать в виде отдельного файла с расширением .robin-form при помощи функции экспорта.

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

1. Нажмите на кнопку "Импортировать".
2. Откроется окно Проводника, в котором нужно выбрать файл с экспортированной формой
   
3. Подтвердите выбор в окне Проводника.
4. Откроется окно, в котором можно сразу поменять название и описание для импортируемой формы:
   
   
   
5. Внесите изменения в полях (при необходимости) и нажмите на кнопку "Импортировать".
6. Процесс импорта может занять некоторое время. Дождитесь завершения операции - по ее завершению окно автоматически закроется, и новая форма отобразится в таблице личных экранных форм.
   

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

Особенности импорта

• Помимо самой импортированной формы, также будут созданы все справочники, которые в ней используются. Они появятся в разделе "Справочники" модуля "Активности". Если импортируемый (основной) справочник содержит ссылки на другие справочники, то эти справочники также будут добавлены.
• Если у связанного справочника (или его вложенных справочников) есть атрибуты с типом "Пользователи", для которых было выбрано значение "Пользователи из указанной группы", то при импорте у всех таких атрибутов будет по умолчанию установлено значение "Все пользователи".
  После завершения импорта проверьте параметры таких атрибутов на странице со структурой соответствующего справочника. При необходимости поменяйте значение для этих атрибутов (подробнее об атрибутах).
• Импортируемая экранная форма создается с названием и описанием, указанными в окне импорта. А связанные справочники сохраняют те названия и описания, которые были у них при экспорте экранной формы. Но если в текущем тенанте название создаваемого справочника уже занято другим справочником, то к названию нового справочника добавится индекс: _1, _2 и т.д.
  Например, если справочник "Города" уже существует, то новый справочник будет добавлен с названием "Города_1".
• Если импорт не был завершен до конца из-за возникшей ошибки или отмены операции пользователем, то система не выполнит автоматический откат уже созданных связанных справочников. 

Таблица личных экранных форм

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

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

Фильтрация таблицы

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

По кнопке "Фильтры" открывается панель:

Доступна фильтрация только по автору экранной формы. В поле "Автор" можно выбрать пользователя(-ей), чьи личные формы должны остаться в таблице.

Кнопка "Очистить" сбрасывает настроенный фильтр. Но применить изменения (установку или сброс фильтра) можно только по кнопке "Применить".

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

Публикация экранной формы

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

Чтобы опубликовать экранную форму:

1. Нажмите на кнопку "Опубликовать" в строке с нужной формой.
   
2. Заполните параметры в открывшемся окне:
   
   
   
3. Нажмите кнопку "Опубликовать". Окно закроется, текущая версия экранной формы появится на вкладке "Опубликованные" в модуле "Редактор экранных форм".
   Экранная форма публикуется: 
   • Как новая форма с версией 1, если ранее форму с таким названием ни разу не публиковали.
   • В родительскую ветку - к другим опубликованным версиям формы с таким же названием. Номер новой версии будет равен номеру самой последней из ранее опубликованных версий, увеличенному на 1.

Параметры в окне

^{Параметры, отмеченные красной звездочкой, обязательны для заполнения.}

• Экранная форма* - для ввода названия, с которым будет опубликована экранная форма. Не должно превышать 128 символов.
• Изменения в версии - для ввода описания изменений, которые выполнили в публикуемой версии экранной формы. Не должно превышать 500 символов.
• Группа - выпадающий список для выбора группы, в которую будет добавлена экранная форма. Можно выбрать только одну группу.
  Добавление формы в группу ограничивает доступ к ней - она будет доступна только тем пользователям, которым доступна выбранная группа. 
  Если новая версия экранной формы публикуется в ветку, которая уже добавлена в группу (т.е. в группу добавлены все ранее опубликованные версии этой формы), то в поле отобразится название этой группы и будет недоступно изменение выбранной группы.
  Если публикация происходит в ветку экранной формы, которая еще не добавлена в группу, то в поле будет пусто и можно будет выбрать группу (при необходимости). И если в итоге выбрать группу и опубликовать экранную форму, то в эту группу будет добавлена не только новая версия формы, но и все её ранее опубликованные версии.

• Описание - для ввода описания экранной формы, с которым она будет опубликована. Не должно превышать 500 символов.

Редактирование параметров экранной формы

Для изменения параметров экранной формы:

1. Нажмите на кнопку "Редактировать" в строке с нужной формой. Откроется окно:
   
   
   
2. Внесите необходимые корректировки. 
3. Нажмите на кнопку "Сохранить". 

Параметры в окне

^{Параметры, отмеченные красной звездочкой, обязательны для заполнения.}

• Название* - для ввода названия экранной формы. Не должно превышать 128 символов.
• Изменения в версии - для ввода описания изменений, которые выполнили в текущей версии экранной формы. Не должно превышать 500 символов.
• Описание - для ввода описания экранной формы. Не должно превышать 500 символов.