UI-действия

Действия пользовательского интерфейса (UI) — это кнопки, ссылки и элементы контекстного меню в формах и списках. Они позволяют настроить взаимодействие пользователя с интерфейсом, чтобы он был более интерактивным, регулируемым и удобным для работы.

Типы действий

1. На формах:
   • Вверху слева
   • Вверху справа
   • В бургер-меню
   • В контекстном меню заголовка поля
   • Ссылка внизу формы 
   • Внизу формы
2. В списках:
   • Вверху слева
   • Вверху справа
   • В бургер-меню
   • В контекстном меню заголовка поля
   • В контекстом меню строки
   • Ссылка под списком 
3. Другие:
   • В контекстом меню кнопки 
   • В контекстом меню схемы зависимостей

Действия на формах

Действия на списках

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

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

Для этого выполните следующие шаги:

1. Перейдите в Настройка системы → UI-действия.
2. Нажмите Создать или выберите существующее действие пользовательского интерфейса.
3. Настройте действие пользовательского интерфейса, используя предоставленную форму.
4. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы UI-действия

Глобальные действия

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

Для этого выполните следующие действия:

1. Откройте нужную запись действия пользовательского интерфейса.
2. На форме в поле Таблица укажите Глобальная таблица .
3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Добавление многоуровневых действий

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

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

1. Создайте родительское действие пользовательского интерфейса, указав его тип с помощью флажков В бургер-меню в областях Стиль формы или Стиль списка во вкладке Позиция и стиль.
2. Нажмите Сохранить и выйти, чтобы закрыть форму.
3. Создайте дочернее действие пользовательского интерфейса того же типа, указав его родительское действие пользовательского интерфейса, созданное ранее.
4. (опционально) Установите флажок Наследуемое, чтобы добавить эти действия на дочерние таблицы.
5. Нажмите Сохранить, чтобы применить изменения.

Настройка условий отображения

Условия определяют ситуации, когда отображаются действия пользовательского интерфейса. Поле Условие предполагает использование серверного API. Чтобы включить использование клиентского API, на форме действия пользовательского интерфейса установите флажок Клиентское. В Условие для доступа к действию пользовательского интерфейса используйте объект конкретной записи current, на которой будет находиться действие. Этот объект можно использовать только для действий пользовательского интерфейса, отображаемых на формах.

Используйте логические операторы && (И) и || (ИЛИ) для составления сложных условий.

Условие позволяет вызывать созданные на стороне сервера внешние скрипты. В приведенном ниже примере функция wfContextExists() из внешнего скрипта с тем же именем получает current.sys_id и current.getTableName в качестве аргументов recordID и tableName.

Это действие пользовательского интерфейса является ссылкой на запись с ID таблицы getTableName. Если запись существует, функция возвращает true или false, если запись не найдена. В зависимости от возвращаемого значения функция отображает действие пользовательского интерфейса или нет.

function wfContextExists(recordID, tableName){
  const table = new SimpleRecord('sys_db_table');
  table.get('name', tableName);
  const wfContext = new SimpleRecord('wf_context');
  wfContext.addQuery('related_record_id', ss.getDocIdByIds(table.sys_id, recordID));
  wfContext.selectAttributes('sys_id');
  wfContext.query();
  return (wfContext.getRowCount() > 0)
}

Определение поведения действия с помощью скрипта

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

Например, это действие пользовательского интерфейса добавляет информационное сообщение с содержимым поля Описание:

ss.addInfoMessage(current.description);