Стандартная кнопка.
Полное описание, параметры и ограничения
ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка (CollaborationSystemMessageButtonPanelButtonType.UsualButton)
ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия (CollaborationSystemMessageButtonPanelButtonType)
ОбычнаяКнопка (UsualButton)
Доступен, начиная с версии 8.3.25.
Описание:
Стандартная кнопка.
Использование в версии:
Доступен, начиная с версии 8.3.25.
См. также:
ПанельКнопокСообщенияСистемыВзаимодействия, свойство ВидКнопок
Методическая информация
Практические примеры
Панель своего бота: ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка
Точная цепочка производства: идентификатор события → черновик сообщения → readonly-панель → ряд → настоящая кнопка.
Где и как запускать
Модуль собственного бота УчебныеКнигиБот; серверная функция и настоящее событие своего обсуждения.
Подготовка
Редкий API: своя отдельная учебная база с подключённой системой взаимодействия, свой бот УчебныеКнигиБот и собственное учебное обсуждение. Бота создайте в метаданных и штатно зарегистрируйте в своей системе взаимодействия. Транспорт и сервис этим кодом не устанавливаются.
Весь код панели размещайте именно в модуле своего бота. РядКнопок.Добавить вне модуля бота по документации вызывает исключение, даже если код находится в обычном серверном общем модуле.
Конкретный ИдентификаторОбсуждения приходит от платформы в событие создания собственного обсуждения с ботом. Он не конструируется из произвольной строки / UUID.
Самостоятельные уроки не устанавливайте все одновременно в одноимённое событие. BSL, создание бота, обсуждения и отправка сообщений при сборке HTML не выполнялись.
Основная функция возвращает настоящий черновик сообщения с заполненной панелью. Дополнительный обработчик создания обсуждения вызывает её с настоящим идентификатором и проверяет число рядов. Записать здесь намеренно не вызывается — кнопка никому не отправлена.
ОбработатьБотом вызывает событие нажатия в модуле бота. ОбработатьНаКлиенте вызывает ПриНажатииКнопкиПанелиКнопокСообщенияСистемыВзаимодействия клиентского приложения и не работает в интеграциях с мессенджерами.
ЗапроситьТелефон / ЗапроситьМестоположение доступны в мобильном клиенте и интеграциях с мессенджерами, но не в тонком, толстом и веб-клиенте. В этом черновике личные сведения не запрашиваются.
ОтправитьСообщениеСДанными не доступно в интеграциях с мессенджерами; в свойство Данные нового сообщения копируются собственные сериализуемые данные кнопки. Не вкладывайте секреты.
Функция ПодготовитьПанельКниг(ИдентификаторОбсуждения)
Черновик = СистемаВзаимодействия.СоздатьСообщение(ИдентификаторОбсуждения);
Черновик.Текст = "Собственная учебная памятка книг";
Панель = Черновик.ПанельКнопок;
Панель.ВидКнопок = ВидКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбычнаяКнопка;
Ряд = Панель.РядыКнопок.Добавить();
Кнопка = Ряд.Добавить(ДействиеКнопкиПанелиКнопокСообщенияСистемыВзаимодействия.ОбработатьБотом, "Книга: 3 штуки");
Кнопка.ИмяДействия = "УчебныеКниги.Сводка";
Кнопка.ТекстСообщения = "Учебная книга: 3 штуки";
Кнопка.Данные = Новый Структура("КодКниги,Количество", "BOOK-001", 3);
Возврат Черновик;
КонецФункцииТот же модуль бота: настоящий вызов от события, без отправки черновика
Процедура ПриСозданииОбсужденияСистемыВзаимодействия(ИдентификаторОбсуждения, ДополнительныеПараметры)
Черновик = ПодготовитьПанельКниг(ИдентификаторОбсуждения);
ЧислоРядов = Черновик.ПанельКнопок.РядыКнопок.Количество();
Сообщить("В собственном черновике рядов кнопок: " + Строка(ЧислоРядов));
Сообщить("Черновик подготовлен, но не отправлен");
КонецПроцедурыРазбор по шагам
Подготовьте своего зарегистрированного учебного бота.
Разместите функцию и дополнительное событие в его модуле.
Создайте своё обсуждение с ботом и проверьте подготовленный черновик, не объявляя его отправленным сообщением.
Как проверить результат
Сообщение.ПанельКнопок readonly: панель берётся у настоящего черновика, не создаётся несуществующим конструктором.
Ряд.Добавить принимает действие первым параметром, текст вторым. ИмяДействия — собственный идентификатор кнопки, не имя исполняемой процедуры.
ВидКнопок меняет представление кнопок, а не разрешения на телефон / геопозицию и не способ отправки.
Ожидаемый результат
Показан реальный короткий синтаксис редкого API с точным модулем и ограничениями клиента.
На что обратить внимание
Подготовка черновика не нажимает кнопку и не подтверждает поддержку действия выбранной внешней интеграцией.
Для фактической отправки нужен отдельный осознанный Записать только в своё учебное обсуждение; этого вызова здесь нет.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.