Использование Web-сервиса «Клеверенс» для работы в онлайн режиме работы с учетными системами на платформе «1С: Предприятие»

Последние изменение: 24.05.2019

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


Глоссарий

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

Web-сервис - Web-службы могут взаимодействовать друг с другом и со сторонними приложениями посредством сообщений, основанных на определённых протоколах (SOAP, XML-RPC и т. д.) и соглашениях (REST). Web-служба является единицей модульности при использовании сервис-ориентированной архитектуры приложения.

Расширение конфигурации - это специальный механизм, предназначенный для доработки расширяемой конфигурации 1C без изменения этой конфигурации (в том числе без снятия с поддержки).

Публикация расширения - это помещение объектов Web-сервиса для обмена из расширения в службу Web-сервера.

Для чего и кому это нужно

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

Когда мобильному устройству нужен онлайн-доступ в 1С, оно обращается к серверу Mobile SMARTS, который поднимает у себя COM-соединение к нужной базе 1С, открывает в этой базе специальную обработку «Клеверенс» и делает делает выборки по базе 1С, используя сервисные экспортные методы, написанные в этой обработке.

Для чего нужен Web-сервис

Web-сервис — предлагает более современную среду для обмена данными в онлайне с учетной системой на платформе «1С: Предприятие», нежели устаревшее COM-соединение.

Какие плюсы по сравнению с COM-соединением

  • Стабильнее при использовании с множеством клиентов.

  • Быстрый запуск как Web-сервиса, так и Web-сервера.

  • Есть настройки работы как с Web-сервером, так и с конкретным Web-сервисом.

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

  • Проще отлаживать.

  • Лучше работает с множеством запросов.

Какие минусы по сравнению с COM-соединением

  • Более высокие требования к платформе «1С: Предприятие», требуется платформа не ниже версии 8.3.12.

  • Наличие установленного Web-сервера на том же ПК, где и располагается рабочая база 1С.

  • Требуется ручная настройка, и публикация Web-сервиса на Web-сервере.

Кому нужен Web-сервис

  • Web-сервис в первую очередь нужен тем, у кого есть проблемы с использованием COM-соединение к 1С при работе продуктов «Клеверенс», по любым причинам. Долгий первый запуск, медленное получение данных, обрывы соединений и т.д. Если есть проблемы, надо переходить на Web-сервис.

  • Тем кто хочет работать с множества устройств и с использовать множество одновременных запросов в онлайне, в этом случае 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 и выше.

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С: Предприятие» от имени администратора.

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

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

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

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

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

    • для обычных форм из вложенной папки “Обычные формы”.

    • для управляемых форм из вложенной папки “Управляемые формы”.

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

  • Снимаем флаг с “Безопасный режим”.

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

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

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

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

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

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

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

Для проверки работы, открываем Клиент Mobile SMARTS для ПК - Просмотр справочников - открываем просмотр Номенклатуры, Склады или Контрагенты.

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

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

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

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

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

База Mobile SMARTS

Web-сервер

База 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-соединение.

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