Программная работа с системой взаимодействия 1С для типовых и нетиповых конфигураций

В данной статье будут рассмотрены методы программного взаимодействия с подсистемой «Обсуждения» из библиотеки стандартных подсистем (БСП) для типовых конфигураций 1С, а также встроенные средства платформы 1С для работы с нетиповыми конфигурациями. Такой подход позволяет автоматизировать отправку сообщений в обсуждения, что особенно актуально при интеграции информационной системы 1С с популярными мессенджерами, например, Telegram или WhatsApp.

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

Типичные сценарии применения системы взаимодействия включают:

• Взаимодействие сотрудников внутри компании.

• Уведомления пользователей о событиях в системе.

• Взаимодействие с контрагентами через мессенджеры.

• Интеграция с ВКонтакте, Telegram и WhatsApp.

Основные объекты системы взаимодействия для программной работы:

• МенеджерСистемыВзаимодействия - предоставляет доступ к функциям системы взаимодействия

• ПользовательСистемыВзаимодействия - предоставляет доступ к свойствам и методам пользователя системы взаимодействия

• ОбсуждениеСистемыВзаимодействия - используется для обращения к свойствам и методам обсуждения системы взаимодействия

• СообщениеСистемыВзаимодействия - предназначен для хранения параметров сообщения в системе взаимодействия

Практическим примером применения представленных в статье методов является автоматизация информирования менеджеров в учетной системе задач на базе 1С о действиях клиентов через Telegram-бота — при создании задачи через бот в Telegram соответствующее уведомление автоматически появляется в системе взаимодействия 1С, что помогает избежать пропуска важных задач.

Рисунок 1 -  Сообщение менеджеру в системе взаимодействия в 1С после создания новой задачи в Telegram боте

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

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

Рисунок 2 - Объекты БСП, включенные в подсистему «Обсуждения»

Общий модуль «Обсуждения» является серверным и содержит процедуры и функции, которые упрощают программную работу с системой взаимодействия. Рассмотрим несколько процедур и функций, которые можно использовать.

Рисунок 3 - Общий модуль «Обсуждения»

Для отправки сообщения в системе взаимодействия, надо знать:

• уникальный идентификатор пользователя системы взаимодействия, которому будет отправлено сообщение

• идентификатор обсуждения (чат), в которое будет отправлено сообщение

• контекст обсуждения – если отправляется сообщение в рамках конкретного объекта 1С

Для получения идентификатора пользователя системы взаимодействия можно воспользоваться функцией «ПользовательСистемыВзаимодействия».

Рисунок 4 - Получение уникального идентификатора пользователя системы взаимодействия

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

Рисунок 5 - Программное создание обсуждения

Рисунок 6 - Результат создания обсуждения в обсуждениях

Для отправки сообщения от одного пользователя (автора) к получателям (один или несколько пользователей) может быть использована процедура «ОтправитьСообщение».

Рисунок 7 - Отправка сообщения от автора получателю или списку получателей

Рисунок 8 - Результат отправки сообщения пользователю

Для отправки сообщения в общий чат необходимо в качестве контекста передать идентификатор обсуждения. Обсуждение можно получить по уникальному ключу.

Рисунок 9 - Отправка сообщения в общий чат по ключу

Рисунок 10 - Результат отправки сообщения в общий чат

Для отправки контекстного сообщения (в чат, связанный с каким-либо объектом базы 1С) необходимо при вызове процедуры 4 параметром определить контекст обсуждения (любая ссылка на объект 1С).

Рисунок 11 - Отправка контекстного сообщения

Рисунок 12 - Результат отправки сообщения с контекстом

Если требуется отправить сообщение без указания получателей, необходимо использовать процедуру «ОтправитьУведомление» общего модуля «Обсуждения». В остальном принцип такой же, как с отправкой сообщений: можно отправить сообщение в общий чат или в контекстное обсуждение.

Рисунок 13 - Отправка уведомления в общий чат

Рисунок 14 - Результат отправки уведомления в общий чат

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

Рисунок 15 - Отправка уведомления в контекстное обсуждение

Рисунок 16 - Результат отправки уведомления в контекстное обсуждение

Для программной работы с системой взаимодействия в нетиповых конфигурациях воспользоваться подсистемой «Обсуждения» библиотеки стандартных подсистем не получится. Необходимо пользоваться встроенными методами платформы для объектов системы взаимодействия. Например, для отправки сообщения, будет использоваться функция объекта МенеджерСистемыВзаимодействия «СоздатьСообщение».

Рисунок 17 - Отправка сообщения с помощью встроенных методов платформы

Рисунок 18 - Результат отправки сообщения

Таким образом, были рассмотрены основные объекты и методы программной работы с системой взаимодействия 1С через подсистему «Обсуждения» из библиотеки стандартных подсистем, а также пример использования встроенных средств платформы для решения аналогичных задач в нетиповых конфигурациях.

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