Low-code дизайнер > Создание интерфейсов > Типы виджетов > Простые виджеты / Кнопка

Кнопка

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

Чтобы разместить виджет, перетащите его с правой панели дизайнера интерфейсов на поле для моделирования или нажмите кнопку + Виджет. Подробнее читайте в статье «Шаблон формы». Затем выполните настройку в открывшемся окне.

Вкладка «Основные»

button-widget-1

  • Отображение — выберите внешний вид виджета;
  • Надпись/подсказка* — укажите текст надписи или подсказки, отображаемый на кнопке. Вы можете связать это поле с контекстной переменной, нажав bind_table-icon;
  • Иконка — вы можете выбрать иконку, отображаемую вместе с надписью на кнопке;
  • Не показывать стартовую формуопция используется для кнопок, связанных с запуском бизнес-процесса. Включите её, чтобы при нажатии на кнопку настроенная в стартовом событии форма запуска не отображалась. Исполнение процесса начнётся с блока, следующего за стартовым событием. Вы можете связать это поле с контекстной переменной, нажав bind_table-icon;
  • Тип действия — выберите действие, которое выполнится, когда пользователь нажмёт кнопку:

Сценарий

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

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

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

Использование констант Global или Namespace в сценариях ограничивает экспорт компонентов системы. Подробнее об этом читайте в статье «Глобальные константы в сценариях».

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

Предопределенное действие

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

Для любых приложений доступно действие:

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

Для приложений типа Документ доступны действия:

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

Для задач бизнес-процесса доступны действия:

  • Переназначить задачу — позволяет пользователю переназначить задачу на другого сотрудника;
  • Меню задачи — открывает меню задачи с действиями:
    • Переназначить;
    • Изменить список участников;
    • Изменить дату начала;
    • Запланировать в Календарь;
    • Изменить время в Календаре;
    • Изменить процент выполнения.

Запустить процесс

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

  1. В поле Бизнес-процесс* выберите процесс согласования.
  2. В настройке Связать с полем выберите переменную Договор. В неё запишется текущий элемент приложения Договор.
  3. Затем вы можете передать в процесс данные договора — его номер, дату создания, контрагента. Для этого нажмите Настроить входные параметры.
  4. В открывшемся окне сопоставьте переменные процесса и свойства приложения Договор. В левой колонке выберите свойства контекста процесса, которые хотите заполнить, а в правой колонке выберите свойства Договора, которые хотите передать в процесс.

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

Создать элемент приложения

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

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

  1. В поле Приложение выберите Акт.
  2. В настройке Связать с полем выберите свойство Договор, в которое запишется текущий элемент приложения Договор.
  3. Затем вы можете передать в акт данные договора — его номер, дату создания, контрагента. Для этого нажмите Настроить входные параметры.
  4. В открывшемся окне сопоставьте свойства приложений Акт и Договор. Так, в левой колонке выберите свойство Номер акта, которое хотите заполнить, а в правой колонке выберите свойство Номер договора, которое хотите передать.

кнопка 1

Важно: связывать можно только поля одинакового типа, например, поле типа Строка — с полем такого же типа Строка, поле типа Число — с полем такого же типа Число.

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

Ссылка

Когда пользователь нажмёт кнопку, осуществится переход по ссылке.

Вы можете связать кнопку со свойством контекста типа Текст. Например, чтобы настроить переход к тексту инструкции, выберите bind_table-icon, затем нажмите <Не установлено> и в выпадающем списке выберите переменную Текст инструкции.

Также можно включить опцию Открывать ссылку в новой вкладке.

Вкладки «События» и «Системные»

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

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

Пример

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

кнопка пример