Этап 2. Установка расширения в 1С

2.1. Откройте конфигуратор 1С

Запустите 1С:Предприятие и откройте нужную информационную базу в режиме «Конфигуратор» (с правами администратора).

2.2. Создайте новое расширение

  1. В меню конфигуратора выберите: Конфигурация → Расширения конфигурации.
  2. В открывшемся окне нажмите кнопку «Добавить» (иконка с зелёным плюсом).
  3. Откроется диалог «Новое расширение конфигурации». Заполните поля:
    • Имя: рекомендуем Esqon
    • Синоним: рекомендуем Esqon
    • Префикс: рекомендуем Esqon_
    • Назначение: обязательно выберите «Адаптация»
  4. Нажмите «ОК».
⚠️ Важно Назначение расширения должно быть именно «Адаптация» — это необходимо для корректной работы расширения.

2.3. Загрузите расширение из файла

  1. Выделите созданное расширение «Esqon» в списке.
  2. Нажмите: Конфигурация → Загрузить конфигурацию расширения из файла.
  3. Выберите скачанный файл .cfe (например, Esqon_UNF.cfe).
  4. В диалоге подтверждения нажмите «Да».
  5. Снимите флаг «Безопасный режим» у расширения.
  6. Нажмите: Конфигурация → Обновить конфигурацию базы данных (F7).
  7. Подтвердите обновление.
⚠️ Обязательно снимите флаг «Безопасный режим» Если флаг «Безопасный режим» останется включённым, расширение не сможет обращаться к данным базы и HTTP-сервис не будет работать. Убедитесь, что флаг снят в свойствах расширения.

Убедитесь, что расширение активно — галочка «Активно» должна быть установлена в списке расширений.

💡 Совет Если 1С:Предприятие было запущено в момент установки расширения — закройте и запустите его заново, чтобы расширение подхватилось.

2.3.1. Альтернативный вариант: установка в режиме «1С:Предприятие»

Если в вашей базе допускается установка расширений в режиме «1С:Предприятие», можно использовать этот сценарий:

  1. Откройте: Администрирование → Печатные формы, отчёты и обработки → Расширения.
  2. Нажмите «Добавить из файла...» и выберите нужный файл расширения Esqon.
  3. После загрузки расширения откройте его свойства и убедитесь, что флаг «Безопасный режим» снят.
  4. Если платформа запросит перезапуск — перезапустите 1С.
💡 Совет Если в вашей компании принят сценарий установки только через конфигуратор, используйте основной вариант из пунктов 2.1–2.3.

2.4. Проверьте объекты расширения

Расширение добавляет в конфигурацию:

2.5. Настройте права доступа

Расширение добавляет роль «Доступ для бота». Эту роль нужно назначить пользователю 1С, от имени которого бот будет обращаться к базе.

Настройка выполняется в режиме «1С:Предприятие» (не в конфигураторе).

Шаг 1. Создайте профиль групп доступа:

  1. Откройте: Администрирование → Настройки пользователей и прав → Профили групп доступа.
  2. Нажмите «Создать».
  3. Укажите наименование, например Esqon — доступ для бота.
  4. В списке ролей найдите и отметьте галочкой роль «Доступ для бота».
  5. Нажмите «Записать и закрыть».

Шаг 2. Создайте группу доступа:

  1. Откройте: Администрирование → Настройки пользователей и прав → Группы доступа.
  2. Нажмите «Создать».
  3. Укажите наименование, например Esqon.
  4. В поле «Профиль» выберите созданный профиль «Esqon — доступ для бота».
  5. На вкладке «Участники» добавьте пользователя 1С, от имени которого будет работать бот.
  6. Нажмите «Записать и закрыть».
💡 Рекомендация Создайте отдельного пользователя 1С для бота (например, «БотEsqon»). Это безопаснее, чем использовать учётную запись администратора. Логин и пароль этого пользователя вы укажете в конфиге бота (AUTH_LOGIN / AUTH_PASSWORD).

2.6. Опубликуйте HTTP-сервис на веб-сервере

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

  1. В конфигураторе выберите: Администрирование → Публикация на веб-сервере.
  2. Заполните параметры публикации:
    • Имя: укажите имя публикации (например, MyBase)
    • Веб-сервер: выберите установленный веб-сервер (Apache или IIS)
    • Каталог: путь к каталогу публикации
  3. На вкладке «HTTP-сервисы» установите две галочки:
    • «Публиковать HTTP-сервисы расширений по умолчанию»
    • «Публиковать доступ для клиентских приложений»
  4. Нажмите «Опубликовать».

После публикации HTTP-сервис будет доступен по адресу:

http://ВАШ_IP/ИмяПубликации/hs/Esqon

Например:

http://192.168.1.100/MyBase/hs/Esqon

Проверьте доступность, открыв в браузере тестовый URL:

http://ВАШ_IP/ИмяПубликации/hs/Esqon/search?id=test&q=test
💡 Примечание Если всё настроено правильно, вы увидите JSON-ответ. Возможна ошибка авторизации 401 или ошибка доступа 403 — это нормально на этапе проверки: HTTP-сервис опубликован и отвечает.