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

Запуск модуля

Для корректной работы модуля добавьте роль «Эдивеб» пользователям. Для этого перейдите в раздел «Администрирование» → «Пользователи» (Рис. 1).

Рис. 1. Конфигуратор, функциональная панель

Откроется окно «Пользователь». Во вкладке «Прочие» отметьте поле «Эдивеб» (Рис. 2).

Рис. 2. Добавление роли

Запустите учетную систему в режиме предприятия, затем запустите внешнюю обработку Эдивеб.epf. (Рис. 3).

Рис. 3. Запуск внешней обработки

Общий вид обработки может отличаться в зависимости от версии (Рис. 4).

Рис. 4. Общий вид обработки

1. Основные настройки

Для просмотра настроек нажмите кнопку «Открыть настройки» (Рис. 5).

Рис. 5. Общий вид обработки. Расположение настроек

1.1. Профиль настроек

При переходе к настройкам откроется раздел «Профиль настроек» (Рис. 6).

Рис. 6. Основные настройки

В «Профиле настроек» расположен следующий функционал:

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

1.2. Настройки подключения

В «Настройках подключения» доступен функционал (Рис. 7):

Рис. 7. Основные - настройки подключения
  • Сервер SOAP – адрес SOAP сервера
  • Логин/Пароль – логин/пароль к SOAP серверу
  • Сервер обновлений – адрес сервера обновлений
  • Ключ лицензии – ключ действующей лицензии. Позволяет получить обновления с сервера
  • Прокси – подменю настройки прокси-сервера

1.3. Настройки подписания

Раздел «Настройки подписания» содержит информацию о сертификате и подписанте. Данные нужны для формирования документов с электронной подписью. При выставленнии данных, обязательно выберите тип ключа. Для новых ключей Crypto-Pro GOST R 34.10-2012 Cryptographic Service Provider (Рис. 8).

Рис. 8. Настройки подписания

2. Поиск номенклатуры

Во вкладке «Поиск номенклатуры» есть возможность осуществлять поиск номенклатуры при загрузке документов и поиск кода по номенклатуре при выгрузке документов.

Вкладка содержит таблицу, где расположены основные критерии поиска (Рис. 9):

Рис. 9. Поиск номенклатуры
  • Место поиска – возможные варианты для поиска номенклатуры (справочники, регистры). Для режима «По доп. справочнику Эдивеб партнёры» поиск осуществляется по подчинённому справочнику «Эди_партнёра», который создаётся при записи элемента справочника.
  • Тег для поиска – тег из xml-формата EDI-сообщения или документа. Возможные варианты – код продавца, код покупателя, штрих-код.
  • Поле для поиска – реквизит объекта метаданных, по которому происходит сравнение с тегом для поиска.
  • Партнёр – принадлежность реквизита поиска к определённому «Эди_Партнёру». Если партнёр указан, но не совпадает с партнёром элемента справочника «Эдивеб_События», поиск не производится. Если поле не заполнено, поиск производится независимо.

3. Расширения

Во вкладке «Расширения» можно загрузить расширения и обновления (Рис. 10).

Рис. 10. Расширения
  • Загрузить расширение из файла – выводится меню выбора файла обработки расширения (Рис. 11).
Рис. 11. Выбор обработки

Эта обработка содержит в себе структуру, которая при разборе определяет в модуле доступные для загрузки/выгрузки документы, а также дополнительные команды меню главного окна.

В поле «Комментарий» выводится версия расширения (Рис. 12).

Рис. 12. Версия расширения

После загрузки расширений перейдите во вкладку «События» и нажмите кнопку «Загрузить из расширений» (Рис. 13).

Рис. 13. Вкладка «События», загрузка из расширений
  • Получить обновления – отправка запроса к серверу обновлений и отображение архива доступных обновлений в виде таблицы (Рис. 14).
Рис. 14. Доступные обновления для загрузки

Если обновления не найдены, таблица не выводится.

  • Получить количество обновлений – запрос к серверу обновлений. Сами файлы не загружаются, внизу экрана выводится сообщение (Рис. 15).
Рис. 15. Доступные обновления
  • Отладка расширений (предназначено для разработчиков) – сделать доступным отладку расширений в обычном режиме из конфигуратора. Для этого файлы расширений выгружаются из хранилища в каталог «Temp» из основных настроек (п. 2.1.1.). Файлы с предыдущими версиями обработок в данном каталоге будут перезаписаны без предупреждения, т.е. если вы производите отладку и правку кода из одного каталога (Temp), то последние изменения могут быть утеряны при старте основного модуля. Сохраняйте исправленные файлы в отдельном каталоге. Если флаг не установлен, то обработки запускаются из внутреннего хранилища.

4. События

Вкладка «События» содержит перечень событий, загруженных из расширений (Рис. 16).

Рис. 16. Вкладка «События» в разделе настроек

После загрузки нового расширения нажмите кнопку «Загрузить из расширений» (Рис. 17).

Рис. 17. Загрузка из расширений

Обновится список настроек событий во вкладке «Настройки событий». События в названии которых присутствует строка «_comm» являются дополнительной командой и попадают в соответствующий список главного окна.

5. Настройки событий

В данной вкладке задаются параметры, которые передаются в процедуру обработки события (Рис. 18).

Рис. 18. Настройки событий

Кнопка «Загрузить настройки событий» загружает последнее сохранённое событие (Рис. 19).

Рис. 19. Загрузка настроек событий

После перезагрузки списка событий из вкладки «События» загружается предустановленный шаблон.

«Слияние настроек» позволяет заполнить дерево в разделе «Настройки событий» из последних сохранённых настроек для текущего профиля. Используется после обновления списка событий из рисширений. Выполнять слияние нужно до сохранения настроек событий (Рис. 20).

Рис. 20. Слияние настроек

После нажатия кнопки «Сохранить настройки событий», он будет сохранён в регистр настроек и станет текущим (Рис. 21).

Рис. 21. Сохранение настроек событий

5.1. Особенности настроек по документам и событиям

ORDERS (Заказ)

Вид настроек, устанавливаемых из «Мастера настройки» − быстрые установки (Рис. 22).

Рис. 22. Настройки событий

Если нужно добавить дополнительный реквизит, то кликните правой кнопкой мыши по разделу «При запуске» и нажмите кнопку «Добавить» (Рис. 23).

Рис. 23. Добавление дополнительного реквизита

Введите название, например «Валюта», и выберите тип данных (Рис. 24).

Рис. 24. Выбор типа данных

Настройки по загрузке ORDERS:

  • ПомечатьНаУдалениеИсходныйЗаказ − устанавливает пометку удаления на ORDERS, если пришел соответствующий код.
  • ОтменаТабличнойЧасти – устанавливает флаг отмены в товарных линиях заказа.
  • ТипДокумента – тип Эдивеб_план_характеристик. Устанавливает тип создаваемого документа при попытке загрузки ORDERS. ЗаказПокупателя, РеализацияТоваровУслуг, СчётНаОплатуКлиенту (для бухгалтерии). 
  • ВариантОформленияПродажи – при типе документа − реализация, нужно установить значение перечисления «ВариантыОформленияПродажи» как реализация.
  • ВариантЗагрузки(тип Эдивеб_план_характеристик) – основные схемы занесения партнёров-контрагентов:
  1. Точка доставки – Грузополучатель
  2. Точка доставки – Клиент, Грузополучатель
  3. Точка доставки – Клиент, Контрагент, Грузополучатель
  4. Точка доставки – Контрагент Грузополучатель

DESADV (Уведомление об отгрузке)

Возможные параметры для DESADV (Рис. 25):

Рис. 25. Параметры для DESADV
  • ВыгружатьПаллетныйЛист − выгружает палетный лист.
  • КороткийНомер − формирует номер документа по алгоритму «ПолучитьНомерНаПечать» учётной системы без удаления пользовательского префикса.
  • ПоискШКПоХарактеристикам − производит поиск штрих-кода  с учётом характеристики  номенклатуры.
  • ПоискШКПоУпаковке − производит поиск штрих-кода  с учётом упаковки номенклатуры.
  • ПересчитыватьЦеныПоУпаковкам − пересчитывает цены, учитывая коэффициент упаковки.
  • Сворачивать − сворачивает таблицу номенклатуры по номенклатуре, ставке НДС, цене.
  • Тип тары – тип используемой тары.

6. Регламентные задания

Во вкладке «Регламентные задания» настраиваются события для автоматического запуска и его период (Рис. 26).

Рис. 26. Регламентные задания

События выполняются из списка последовательно с заданным интервалом. После добавления новой строки нужно выбрать одну из функций − ПриЗапуске, ПриОбновлении, ДопКоманды (Рис. 27).

Рис. 27. Выбор функции

Для функции «ПриЗапуске» обязательными колонками являются «Событие» и «Период». «Отбор» является необязательным, «Параметр наименование» заполнять не нужно (Рис. 28).

Рис. 28. Обязательные колонки для функции «ПриЗапуске»

Перед запуском команды будет отобран массив элементов справочника «Эдивеб События» по запросу, где дата - данные из колонки «Период». Наименование - данные из колонки «Событие» без префикса «EVENT_”.

Далее будет произведен отбор по партнёру (если установлен), организации и грузополучателю. Для каждого элемента получившегося массива будет выполнена соответствующая ему функция «При запуске».

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

Далее будет запущена функция обновления для события без префикса «EVENT_”.  В функцию будут переданы даты начала и окончания из колонки «Период».

Для функции «Доп. Команда» необходимо заполнить колонки «Событие» - имя команды (суффикс _comm), период и «Параметр наименование» - ORDER или DESADV, например.

Последние являются параметрами запроса. Отбор является необязательным. Будет запущена соответствующая дополнительная команда на вход, которой будет передан выбранный массив элементов справочника.

Установите интервал перезапуска таблицы в поле «Интервал секунд». Значения менее 10 сек. не принимаются. По умолчанию устанавливается 1 минута (Рис. 29).

Рис. 29. Интервал выполнения событий

6.1. Запуск регламентных заданий из командной строки

"C:\Program Files\1cv83\8.хх.хх.хх\bin\1cv8.exe" /IBName "Управление торговлей (демо)" /N "Федоров (администратор)"  /p "123456" C/”ЗавершитьРаботуПослеРегламента ЗапуститьРегламентПриСтарте ИнтервалРегламентныхЗаданий=10 ” /Execute "W:\обработки\Эдивеб.epf"

  • /IBName − Имя базы в списке при запуске
  • /N − Имя пользователя
  • /P − Пароль
  • /Execute − Путь и имя файла запускаемой обработки
  • C/ − Параметры запуска модуля
  • ЗавершитьРаботуПослеРегламента − завершает работу предприятия после первого запуска регламентных заданий
  • ЗапуститьРегламентПриСтарте − запускает при старте модуля регламентные задания
  • ИнтервалРегламентныхЗаданий − интервал регламентных заданий (после числа обязательно пробел).

7. Настройки лога

Здесь настраивается вывод сообщений лога для основных действий (запуск, обновление, доп. команды). Процедура запускается после обработки действий (Рис. 30).

Рис. 30. Настройки лога

В колонке список номеров через запятую указываются номера событий (или диапазон), например «1,100-200,355». Список событий лога приведён в приложении.

В колонке «Расширение» выбирается расширение через которое происходит вывод массива сообщений. Если заведено две строки для одного события с разными номерами, то будет выполнен вывод массива в два окна (в случае с отчётом). Также вывод может быть выполнен на ftp, например (требует отдельного расширения).

Техническое описание формата интерфейса выходного массива и интерфейса расширения осуществляется отделом поддержки по требованию. Массив вывода формируется выборкой по времени выполнения операции из регистра «Эдивеб Журнал». Настройки сохраняются вместе с основными.

Для вывода отчёта по ошибкам кликните правой кнопкой мышки по выбранному документу и выберите пункт «Вывести лог ошибок» (Рис. 31).

Рис. 31. Настройки

Будет выведено окно с ошибками по событию (Рис. 32).

Рис. 32. Лог

8. Стартовый помощник (быстрые настройки)

С помощью «Стартового помощника» можно быстро установить настройки по умолчанию.

Для этого перейдите в раздел «Настройки» → «Основные» и нажмите кнопку «Быстрые настройки» (Рис. 33).

Рис. 33. Основные настройки

Откроется форма «Стартового помощника» (Рис. 34).

Рис. 34. «Стартовый помощник»

Навигация по пунктам осуществляется кнопками «Вперёд» / «Назад» (Рис. 35).

Рис. 35. Навигация в «Стартовом помощнике»

Доступные окна настроек:

  • Пользователь − выбор/ввод нового пользователя.
  • Настройки подключения − нужно завести настройки подключения (Рис. 36).
Рис. 36. Настройки подключения
  • Загрузка расширений − подгружаются с сервера или из файлов (п. 2.3)
  • Партнёры − подгружаются с сервера или из файла с настройками. Новые партнёры выводятся в виде таблицы (Рис. 37).
Рис. 37. Новые партнёры

На форме кнопка найти по ИНН/КПП производит поиск контрагетов и соответствующих им партнёров по реквизитам (Рис. 38).

Рис. 38. Поиск по ИНН/КПП

Флаг «По умолчанию» загружает из фала стандартные настройки.

  • Партнёры настройки по умолчанию – загружает из файла настройки партнёров (сопоставление по GLN). Форма загрузки повторяет предыдущий пункт.
  • Документы – загружает из расширений список доступных документов (Рис. 39).
Рис. 39. Документы
  • Настройки документов − устанавливаются опции загрузки/выгрузки документов (Рис. 40).
Рис. 40. Настройки документов
  1. Тип документа заказа – возможные варианты загрузки заказа: заказ клиента, реализация товаров услуг, расходная накладная, счёт на оплату клиенту.
  2. Склад – устанавливает при загрузке ORDERS склад по умолчанию.
  3. Цена из файла – при значении «Ложь» устанавливает цены из учётной системы, в противном случае − из поступившего файла.
  4. Статус/приоритет и способ доставки – реквизиты ORDERS.
  5. Вид документа подтверждения заказа – устанавливает тип документа в запросе к базе учетной ситемы про обновлении списка ORDRSP.
  6. Короткий номер – со значением «Да» при выгрузке докуметов отбрасывает от номера префикс и лидирующие нули.
  7. Отображать к выгрузке – записанные/проведенные. При обновлении списка исходящих документов учитывает либо все (непомеченные на удаление), либо только проведённые документы.
  8. Подписывать – опция подписания документов.
  9. Адрес продавца/покупателя/грузополучателя/грузоотправителя – адреса используемые для выгрузки УПД, УКД.
  • Настройки номенклатуры – дублирует пункт 2.

27 февраля 2023 г.