ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка

Свойства · UsualButton

Стандартная кнопка.

Полное описание, параметры и ограничения

ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка (CollaborationSystemMessageButtonPanelButtonType.UsualButton)

ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия (CollaborationSystemMessageButtonPanelButtonType)

ОбычнаяКнопка (UsualButton)

Доступен, начиная с версии 8.3.25.

Описание:
Стандартная кнопка.
Использование в версии:

Доступен, начиная с версии 8.3.25.

См. также:
ПанельКнопокСообщенияСистемыВзаимодействия, свойство ВидКнопок

Методическая информация

Практические примеры

Панель своего бота: ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка

Точная цепочка производства: идентификатор события → черновик сообщения → readonly-панель → ряд → настоящая кнопка.

Где и как запускать

Модуль собственного бота УчебныеКнигиБот; серверная функция и настоящее событие своего обсуждения.

Подготовка

  1. Редкий API: своя отдельная учебная база с подключённой системой взаимодействия, свой бот УчебныеКнигиБот и собственное учебное обсуждение. Бота создайте в метаданных и штатно зарегистрируйте в своей системе взаимодействия. Транспорт и сервис этим кодом не устанавливаются.

  2. Весь код панели размещайте именно в модуле своего бота. РядКнопок.Добавить вне модуля бота по документации вызывает исключение, даже если код находится в обычном серверном общем модуле.

  3. Конкретный ИдентификаторОбсуждения приходит от платформы в событие создания собственного обсуждения с ботом. Он не конструируется из произвольной строки / UUID.

  4. Самостоятельные уроки не устанавливайте все одновременно в одноимённое событие. BSL, создание бота, обсуждения и отправка сообщений при сборке HTML не выполнялись.

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

  6. ОбработатьБотом вызывает событие нажатия в модуле бота. ОбработатьНаКлиенте вызывает ПриНажатииКнопкиПанелиКнопокСообщенияСистемыВзаимодействия клиентского приложения и не работает в интеграциях с мессенджерами.

  7. ЗапроситьТелефон / ЗапроситьМестоположение доступны в мобильном клиенте и интеграциях с мессенджерами, но не в тонком, толстом и веб-клиенте. В этом черновике личные сведения не запрашиваются.

  8. ОтправитьСообщениеСДанными не доступно в интеграциях с мессенджерами; в свойство Данные нового сообщения копируются собственные сериализуемые данные кнопки. Не вкладывайте секреты.

Функция ПодготовитьПанельКниг(ИдентификаторОбсуждения)
    Черновик = СистемаВзаимодействия.СоздатьСообщение(ИдентификаторОбсуждения);
    Черновик.Текст = "Собственная учебная памятка книг";
    Панель = Черновик.ПанельКнопок;
    Панель.ВидКнопок = ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка;
    Ряд = Панель.РядыКнопок.Добавить();
    Кнопка = Ряд.Добавить(ДействиеКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбработатьБотом, "Книга: 3 штуки");
    Кнопка.ИмяДействия = "УчебныеКниги.Сводка";
    Кнопка.ТекстСообщения = "Учебная книга: 3 штуки";
    Кнопка.Данные = Новый Структура("КодКниги,Количество", "BOOK-001", 3);
    Возврат Черновик;
КонецФункции
Тот же модуль бота: настоящий вызов от события, без отправки черновика
Процедура ПриСозданииОбсужденияСистемыВзаимодействия(ИдентификаторОбсуждения, ДополнительныеПараметры)
    Черновик = ПодготовитьПанельКниг(ИдентификаторОбсуждения);
    ЧислоРядов = Черновик.ПанельКнопок.РядыКнопок.Количество();
    Сообщить("В собственном черновике рядов кнопок: " + Строка(ЧислоРядов));
    Сообщить("Черновик подготовлен, но не отправлен");
КонецПроцедуры

Разбор по шагам

  1. Подготовьте своего зарегистрированного учебного бота.

  2. Разместите функцию и дополнительное событие в его модуле.

  3. Создайте своё обсуждение с ботом и проверьте подготовленный черновик, не объявляя его отправленным сообщением.

Как проверить результат

  1. Сообщение.ПанельКнопок readonly: панель берётся у настоящего черновика, не создаётся несуществующим конструктором.

  2. Ряд.Добавить принимает действие первым параметром, текст вторым. ИмяДействия — собственный идентификатор кнопки, не имя исполняемой процедуры.

  3. ВидКнопок меняет представление кнопок, а не разрешения на телефон / геопозицию и не способ отправки.

Ожидаемый результат

Показан реальный короткий синтаксис редкого API с точным модулем и ограничениями клиента.

На что обратить внимание

  1. Подготовка черновика не нажимает кнопку и не подтверждает поддержку действия выбранной внешней интеграцией.

  2. Для фактической отправки нужен отдельный осознанный Записать только в своё учебное обсуждение; этого вызова здесь нет.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.