Настройка действий в контентах

Описание настройки

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

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

Место настройки в интерфейсе

Меню навигации "Настройка системы" → настройка "Мобильное приложение" → вкладка "Карточки объектов" → страница настройки карточки объекта в мобильном приложении.

На странице настройки карточки объекта в мобильном приложении в блоке "Настройка интерфейса карточки" разверните меню управления контентом и нажмите "Настроить действия".

Откроется форма "Настройка действий".

Добавление действия

В контенте "Параметры объекта" можно разместить элемент управления для выполнения действия с объектом.

Для контента "Параметры объекта" допустимо не указывать группу атрибутов. Тогда контент будет содержать только элементы управления.

Выполнение настройки

Чтобы добавить элемент управления, выполните следующие действия:

1. На форме "Настройка действий" нажмите кнопку Добавить действие.

2. На форме "Добавление элемента" заполните поля:

   • Область контента — выберите область контента, в которой будет отображаться элемент управления:

     • "Верхний блок действий" — элемент отображается в контенте выше списка атрибутов;
     • "Нижний блок действий" — элемент отображается в контенте ниже списка атрибутов.

   • Название — укажите название элемента управления (127 символов).

   • Внешний вид — выберите представление элемента управления: кнопка с иконкой и подписью, кнопка с подписью, кнопка с иконкой, ссылка, иконка, иконка и подпись.

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

       Для выбора доступны неархивные иконки из справочника "Иконки для элементов управления (векторные)". Для каждой иконки отображается ее изображение и название.

       Для настройки элементов управления с иконками используются иконки в формате svg версии 1.1 и старше из справочника "Иконки для элементов управления (векторные)". Перед началом настройки добавьте иконки в справочник. Можно загрузить свои или использовать готовые иконкискачать.

   • Действие — выберите действие по событию, которое будет инициироваться данным элементом управления. По умолчанию "[не указано]". Если значение не указано, то элемент управления будет недоступен для использования.

     Для выбора доступны:

     • системные действия — системные действия для объектов класса, карточка которого настраивается в мобильном приложении;
     • пользовательские действия — настроенные в системе действия по событию, для которых параметр "Событие" = "[Пользовательское событие]" и параметр "Объекты" содержит класс и/или типы объектов, для которых настраивается карточка в мобильном приложении.

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

     Описание настройки действия по событию "[Пользовательское событие]", см. Настройка пользовательского действия по событию.

   • Форма редактирования (отображается, если в параметре "Действия" выбрано системное действие "Редактировать") — выберите код формы редактирования, которая будет открываться при нажатии на элемент управления. По умолчанию "[не указано]".

     Для выбора доступны коды форм редактирования, которые настроены для класса объектов карточки. Если карточка настроена для некоторых типов класса (в параметре "Типы" для карточки заданы типы), то в списке доступны коды форм, настроенные хотя бы для одного из типов (параметр "Типы" для формы).

     Если выбрано значение "[не указано]", то при нажатии на элемент управления будет открываться первая по списку форма редактирования для класса/типа, см. Формы редактирования объектов.

   • Цвет фона — выберите цвет фона для элемента управления в представлении "Кнопка с иконкой и подписью", "Кнопка с подписью", "Кнопка с иконкой".

     Если значение не указано, то цвет кнопки определяется цветовой темой, установленной на устройстве.

   • Передавать геопозицию устройства — параметр доступен для всех действий, кроме системных действий "Поделиться" и "Обновить":

     • флажок снят (по умолчанию) — геопозиция не передается;

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

3. Нажмите кнопку Сохранить.

Результат настройки

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

Отображение элемента зависит от доступности для выполнения действия:

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

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

Добавление переноса строки

В контенте "Параметры объекта" созданные элементы управления размещаются на карточке горизонтально друг за другом. Перенос строки позволяет расположить элементы управления на разных уровнях — вертикально друг под другом.

Выполнение настройки

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

1. На форме "Настройка действий" нажмите кнопку Добавить перенос строки.

2. На форме "Добавление переноса строки" заполните поле "Область контента" ("Верхний блок действий"/"Нижний блок действий") и нажмите кнопку Сохранить.

   На форме "Настройка действий" в указанной области отобразится элемент [перенос строки] (после всех элементов последним ).

3. Переместите элемент [перенос строки] между элементами управления, которые необходимо расположить друг под другом и нажмите кнопку Сохранить.

Результат настройки

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

Чтобы изменить область контента, в которой добавлен перенос строки, на форме "Настройка действий" нажмите иконку в строке переноса. На форме "Добавление переноса строки" измените область контента и нажмите кнопку Сохранить.

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

Настройка кнопки добавления объектов в списке

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

Настройка выполняется в контентах "Список связанных объектов" и "Список вложенных объектов".

Чтобы добавить кнопку добавления объектов в списке, выполните следующие действия:

1. На форме "Настройка действий" нажмите кнопку Добавить действие.

   

2. На форме добавления элемента заполните поля:

   • Название — укажите название кнопки добавления.
   • Действие — выберите "Добавить объект".

   • Форма добавления (отображается после выбора действия) — выберите код формы добавления, которая будет открываться при нажатии на кнопку. По умолчанию "[не указано]".

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

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

   • Передавать геопозицию устройства — параметр доступен для всех действий, кроме системных действий "Поделиться" и "Обновить":

     • флажок снят (по умолчанию) — геопозиция не передается;

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

3. Нажмите кнопку Сохранить.

На форме настройки действий отображается действие "Добавить объект".

В мобильном приложении в меню действий списка отображается кнопка добавления объектов.

Настройка порядка отображения элементов

Можно установить порядок отображения элементов управления и переносов строки.

Чтобы установить порядок отображения элементов управления и переносов строки, на форме "Настройка действий" определите порядок отображения элементов с помощью инструмента Drag and drop или иконок и в строке элемента и нажмите кнопку Сохранить.

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

Редактирование элемента управления

Чтобы изменить параметры элемента управления:

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

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

Удаление элемента управления / переноса строки

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

Далее нажмите кнопку Сохранить на форме "Настройка действий".

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