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

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

• 1 Минимальный набор, который должен быть установлен на ПК для работы с Web-сервисом «ТСД Клеверенс»
• 2 Порядок настройки обмена Mobile SMARTS и 1С
• 2.1 1. Установка Web-сервера Apache или IIS
• 2.2 2. Установка расширения
• 2.3 3. Публикация Web-сервиса
• 2.4 4. Проверка работы опубликованного Web-сервиса
• 2.5 5. Настройка подключения к Web-сервису из панели управления Mobile SMARTS
• 2.6 6. Настройки бизнес-процессов и отборов документов
• 2.7 7. Добавить интеграционную обработку в базу 1С
• 3 Дополнительная информация и решение возможных проблем
• 3.1 Возможные варианты развертывания
• 3.2 Настройки опубликованного Web-сервиса через файл default.vrd
• 3.3 Включение отладки для Web-сервиса
• 3.4 Обновление обработки в расширении
• 3.5 Перезапуск службы Web-сервера для применения сделанных настроек
• 3.6 Ошибка при вызове конструктора (Файл): Установлен безопасный режим. Выполнение операции запрещено.
• 3.7 Ошибка: CleverenceWebExtension: Значение контролируемого свойства ОсновнойРежимЗапуска у объекта  не совпадает со значением в расширяемой конфигурации.
• 3.8 Ошибка при публикации Web-сервера: Не установлены модули расширении веб-сервера.
• 4 Заключение

Минимальный набор, который должен быть установлен на ПК для работы с 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С: Предприятие» от имени администратора.

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

  

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

  

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

  

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

  

• Загружаем в созданное расширение данные из файла 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С:Предприятие».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  

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

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

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

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

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

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

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

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

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

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

Заключение

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

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