Развернутая инструкция по настройке обмена Mobile SMARTS с конфигурациями на платформе «1С:Предприятие 8» через расширение конфигурации и Web-сервис «Клеверенс»

Последние изменения: 05.06.2020

Платная услуга по установке и настройке Web-сервиса


Минимальный набор, который должен быть установлен на ПК для работы с Web-сервисом «ТСД Клеверенс»

  • Операционная система: Windows 7 и выше.
  • Microsoft .Net Framework 4.6.1 и выше.
  • Платформа «1С: Предприятие» не ниже 8.3.12.
  • Компонент «1С: Предприятие»:  “Модули расширения Web-сервера”.
  • Конфигурация базы данных 1С с версией совместимости не ниже 8.3.10.
  • Платформа Mobile SMARTS, версии 3.0.46.46670 и выше.

Порядок настройки обмена Mobile SMARTS и 1С

1. Установка Web-сервера Apache или IIS

  • Что лучше выбрать?
  • Смотрите на свои предпочтения и удобство использования, сервер Mobile SMARTS от «Клеверенс» будет работать одинаково с любым из них!

В ОС Windows проще всего установить IIS. Включить и установить его можно через программы и компоненты в панели управления, подробная инструкция по установке сервера на IIS и публикации базы, можно найти на просторах интернета, вот прекрасная инструкция с сайта tavalik.ru.

Обратите внимание что должны быть включены компоненты:

  • Общие функции HTTP (Common HTTP Features)
    • Статическое содержимое (Static Content)
    • Документ по умолчанию (Default Document)
    • Обзор каталогов (Directory Browsing)
    • Ошибки HTTP (HTTP Errors)
  • Разработка приложений (Application Development)
    • ASP
    • ASP.NET 3.5
    • Расширяемость .NET 3.5 (.NET Extensibility 3.5)
    • Расширения ISAPI (ISAPI Extensions)
    • Фильтры ISAPI (ISAPI Filters)
  • Исправление и диагностика (Health and Diagnostics)
    • Ведение журнала HTTP (HTTP Logging)
    • Монитор запросов (Request Monitor)
  • Средства управления (Management Tools)
    • Консоль управления IIS (IIS Management Console)

Если же вы хотите использовать именно Web-сервер Apache, то используйте его, инструкция по установке есть на сайте programmist1s.ru.

2. Установка расширения

Установка расширения может осуществляться двумя способами:

  1. Типовой, для нижеперечисленных сертифицированных конфигураций:
    • «1С:Розница 2.3».
    • «1С:Управление торговлей 11.4».
    • «1С:Комплексная автоматизация 2.4».
    • «1С:ERP Управление предприятием 2.4».
    • «1С: Управление нашей (небольшой) фирмой 1.6».
  2. Через конфигуратор 1С (для всех остальных конфигураций).

Типовой способ установки расширения

  • Откройте базу 1С и перейдите в раздел «НСИ и администрирование». Выберите пункт «Печатные формы, отчеты, обработки».

  • Выберите пункт «Расширения».

  • Нажмите на кнопку «Добавить из файла».

  • В появившемся окне откройте папку «Расширение для Web-сервиса», а затем выберите файл CleverenceWebExtension.cfe. Нажмите кнопку «Открыть».

  • В списке расширений появится установленное расширение для Web-сервиса от Клеверенса.

    В случае если для данного расширения будет установлен флаг в пункте «Безопасный режим», его потребуется снять, т.к. расширению необходим доступ к сети для принятия вызовов с сервера Mobile SMRTS через Web-коннектор. После того, как флаг снят, 1С потребуется перезапустить.

Далее потребуется опубликовать Web-сервис из расширения, чтобы далее использовать Web-connector для подключения к Web-сервису.

Установка расширения через конфигуратор 1С

  • Запуск конфигуратора платформы 1С.

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

  • Открываем окно с расширениями конфигурации.

  • Добавляем в список новую пустую, ничего не меняем и нажимаем “ОК”.

  • Открываем конфигурацию созданного расширения.

  • Загружаем конфигурацию расширения «Клеверенс».

  • Загружаем в созданное расширение данные из файла CleverenceWebExtension.cfe из папки базы, подпапки “\Обработки 1С\Расширение для Web-сервиса\” и далее

    • для обычных форм из вложенной папки “Обычные формы”.
    • для управляемых форм из вложенной папки “Управляемые формы”.
  • Отключаем в расширении безопасный режим и защиту:

    • Снимаем флаг с “Безопасный режим”.
    • Снимаем флаг с “Защита от опасных действий”.

  • Устанавливаем режим совместимости для расширения.

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

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

    Если режим совместимости у расширения пришлось изменить, то необходимо обновить конфигурацию расширения.

После того как расширение добавлено, потребуется опубликовать Web-сервис из расширения, чтобы далее использовать Web-connector для подключения к Web-сервису.

3. Публикация Web-сервиса

Для публикации или изменения публикации базы данных необходимо запускать конфигуратор «1С:Предприятие» от имени администратора!!

Если файл web.config не создался в каталоге (по умолчанию «C:\inetpub\wwwroot\» ) и база 1С в браузере не открывается - необходимо выполнить публикацию открыв конфигуратор «1С:Предприятие» от имени администратора или для каталога хранения файлов дать полные права.

Минимальные настройки (отмечены на скриншоте ниже) для публикации Web-сервиса для расширения «Клеверенс». В этом случае сама база 1С не будет опубликована на Web-сервере, будет опубликован только наш Web-сервис.

4. Проверка работы опубликованного Web-сервиса

Для проверки открываем в браузере страницу:

http://127.0.0.1/ut114demo/ws/CleverenceWebExtension.1cws

127.0.0.1 - ip-адрес сервера, где установлен Web-сервер.

ut114demo - имя базы 1С в которую установлено расширение «Клеверенс».

Вводим логин пароль пользователя от базы данных 1С и если видим данную xml страницу, значит Web-сервис «ТСД Клеверенс» запущен и работает.

Обратите внимание, что в некоторых браузерах возможна проблема с вводом логина и пароля, содержащих кириллицу, поэтому для подключения Web-сервиса создайте отдельного пользователя с логином и паролем, не содержащего кириллицу. https://www.forum.mista.ru/topic.php?id=771002

5. Настройка подключения к Web-сервису из панели управления Mobile SMARTS

Предполагается что переход на Web-сервис осуществляется с уже настроенного онлайн-режима работы через COM-коннектор, об использовании онлайн режима работы описано в статье в базе знаний.

Если онлайн-режим работы с базой Mobile SMARTS включен, то всё хорошо.

Если не включен, то сначала добавляем вручную коннектор в 1С по инструкции. Затем прописываем события сервера с указанием идентификатора коннектора (пример: OneC_Connector) для событий сервера Mobile SMARTS, по которым он бужет вызывать коннектор к 1С.

Открываем панель управления - Внешние соединения - 1С Предприятие версия 8: OneC_Connector (коннектор был создан мастером настройки при включении онлайн-режима работы).

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

Меняем тип подключения с «Менеджер COM-соединений» на «WebConnector».

В строке сервер, меняем значение на строку которую использовали для проверки в браузере http://127.0.0.1/ut114demo/ws/CleverenceWebExtension.1cws

Сохраняем и запускаем коннектор.

С помощью Web-коннектора происходит подключение к опубликованному Web-сервису. Для проверки работы открываем Win-клиент Mobile SMARTS для ПК - «Просмотр справочников» - открываем просмотр «Номенклатуры», «Склады» или «Контрагенты».

6. Настройки бизнес-процессов и отборов документов

Настройки по обмену документами производятся в обработке 1С тем же способом как и при обычном онлайн режиме работы через COM-соединение, подробнее см. статью - Как работать с обработкой «Клеверенса» в «1С:Предприятие».

7. Добавить интеграционную обработку в базу 1С

Так как при работе через веб-сервис всё выполняется на стороне сервера 1С, а не на стороне машины, на которой запускается COM-соединение 1С, интеграционную обработку потребуется добавить в базу 1С, и выбрать её из справочника дополнительных отчетов и отбработок (подробнее см. в статье «Интеграционная обработка»).

Дополнительная информация и решение возможных проблем

Возможные варианты развертывания

Возможные и невозможные варианты развертывания Базы Mobile SMARTS с подключением к Web-сервису «ТСД Клеверенс» относительно Web-сервера и базы 1С.

База Mobile SMARTS

Web-сервер
IIS/ Apache

База 1С

Результат

ПК1

ПК1

ПК1

Работает

ПК2

ПК1

ПК1

Работает

ПК2

ПК2

ПК1

Работает

ПК1

ПК2

ПК1

Работает

ПК1

ПК2

ПК3

Работает

Из таблицы понятно, что Web-сервер может располагаться на любой машине.

Если база Mobile SMARTS расположена не на сервере 1С, тогда на сервере 1С необходимо либо установить платформу Mobile SMARTS, либо зарегистрировать компоненту обмена. 

В: База 1С может быть файловой?

О: База 1С может быть и серверной и файловой. В случае с серверной базой, установка Web-сервера должна происходить на кластере сервера «1С: Предприятие».

Настройки опубликованного Web-сервиса через файл default.vrd

Дополнительные настройки можно указать в файле default.vrd в папке опубликованной базы 1С.

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

добавляем в секции <ws

<point name="CleverenceWebExtension"
alias="CleverenceWebExtension.1cws"
enable="true"
reuseSessions="autouse"
sessionMaxAge="3600"
poolSize="10"
poolTimeout="5"/>

Представлены настройки по умолчанию, после публикации Web-сервиса в файле не представлены, добавляйте их, только если хотите что то изменить.

Подробное описание по данным настройкам можно найти в интернете.

Включение отладки для Web-сервиса

Для включения отладки, после ключа “ws”, добавляем ключ “debug”:

<debug enable="true"
protocol="tcp"
url="127.0.0.1"/>

Включение этого параметра дает возможность подключиться отладчиком из конфигуратора 1С в модули вызываемой обработки и в модуль самого Web-сервиса.

Пример файла настроек default.vrd после добавления всех ключей.

Обновление обработки в расширении

В случае, если продукт обновился или например при обращении в техническую поддержку Клеверенс Вам прислали новую обработку, для замены обработки на новую необходимо:

  • Открыть конфигурацию расширения в конфигураторе 1С
  • Перейти к обработке и правой кнопкой мыши выбрать “Заменить на внешнюю обработку, отчет” и в открывшемся окне выбрать файл из папки обновленной базы \Обработки 1С\, или выбрать присланную обработку специалистами компании Клеверенс.
  • Обновить конфигурацию базы данных (кнопка F7)

Перезапуск службы Web-сервера для применения сделанных настроек

Диспетчер служб IIS - Перезапустить (в правом верхнем углу окна).

Ошибка при вызове конструктора (Файл): Установлен безопасный режим. Выполнение операции запрещено.

Отключите в расширении безопасный режим и защиту:

  • Снимаем флаг с “Безопасный режим”.
  • Снимаем флаг с “Защита от опасных действий”.

Ошибка: CleverenceWebExtension: Значение контролируемого свойства ОсновнойРежимЗапуска у объекта  не совпадает со значением в расширяемой конфигурации.

Режим запуска конфигурации 1С и расширения не соответствуют, необходимо привести режим запуска приложения к значению конфигурации (Управляемое приложение\Обычное приложение).

Ошибка при публикации Web-сервера: Не установлены модули расширении веб-сервера.

Данная ошибка возникает в том случае, если не был установлен необходимый компонент при установке платформы «1С: Предприятие».

Необходимо установить компонент «1С: Предприятие»:  “Модули расширения Web-сервера”. Данный компонент поставляется вместе с платформой 1С: Предприятие 8.3.

Заключение

Выполнив настройки по данной инструкции, вы получите онлайн работу через Web-сервис «ТСД Клеверенс», который заменит устаревшее Com-соединение.

По всем возникшим вопросам вы можете обратится в нашу техническую поддержку.