Настройки интеграционного модуля управляемых форм на 1С:Предприятие 8
Запуск модуля
Для корректной работы модуля добавьте роль «Эдивеб» пользователям. Для этого перейдите в раздел «Администрирование» → «Пользователи» (Рис. 1).
Откроется окно «Пользователь». Во вкладке «Прочие» отметьте поле «Эдивеб» (Рис. 2).
Запустите учетную систему в режиме предприятия, затем запустите внешнюю обработку Эдивеб.epf. (Рис. 3).
Общий вид обработки может отличаться в зависимости от версии (Рис. 4).
1. Основные настройки
Для просмотра настроек нажмите кнопку «Открыть настройки» (Рис. 5).
1.1. Профиль настроек
При переходе к настройкам откроется раздел «Профиль настроек» (Рис. 6).
В «Профиле настроек» расположен следующий функционал:
- Профиль настроек – имя профиля настроек, вводится после попытки сохранения основных настроек в меню вопроса к пользователю.
- Temp – папка для хранения временных файлов.
- Режим отладки – режим, при котором не происходит отправка данных на сервер о прочтении документов и отправка исходящих документов.
- Сохранить настройки – заведение нового профиля или оставить текущий профиль с записью изменений в основных настройках. Не влияет на настройки расширений.
1.2. Настройки подключения
В «Настройках подключения» доступен функционал (Рис. 7):
- Сервер SOAP – адрес SOAP сервера
- Логин/Пароль – логин/пароль к SOAP серверу
- Сервер обновлений – адрес сервера обновлений
- Ключ лицензии – ключ действующей лицензии. Позволяет получить обновления с сервера
- Прокси – подменю настройки прокси-сервера
1.3. Настройки подписания
Раздел «Настройки подписания» содержит информацию о сертификате и подписанте. Данные нужны для формирования документов с электронной подписью. При выставленнии данных, обязательно выберите тип ключа. Для новых ключей Crypto-Pro GOST R 34.10-2012 Cryptographic Service Provider (Рис. 8).
1.4. Настройка МЧД в модуле
Для отправки документов с МЧД в разделе «Настройки подписания» требуется заполнить следующие поля (Рис. 9):
- Использовать доверенность – выберите пункт;
- Доверитель – лицо, которое передаёт право на подписание документов стороннему лицу. Выберите тип доверителя;
- ИНН Доверителя;
- Подписант – тип подписанта – кто подписывает документ;
- ИНН подписанта;
- Номер доверенности.
После внесения изменений сохраните настройки.
2. Поиск номенклатуры
Во вкладке «Поиск номенклатуры» есть возможность осуществлять поиск номенклатуры при загрузке документов и поиск кода по номенклатуре при выгрузке документов.
Вкладка содержит таблицу, где расположены основные критерии поиска (Рис. 10):
- Место поиска – возможные варианты для поиска номенклатуры (справочники, регистры). Для режима «По доп. справочнику Эдивеб партнёры» поиск осуществляется по подчинённому справочнику «Эди_партнёра», который создаётся при записи элемента справочника.
- Тег для поиска – тег из xml-формата EDI-сообщения или документа. Возможные варианты – код продавца, код покупателя, штрих-код.
- Поле для поиска – реквизит объекта метаданных, по которому происходит сравнение с тегом для поиска.
- Партнёр – принадлежность реквизита поиска к определённому «Эди_Партнёру». Если партнёр указан, но не совпадает с партнёром элемента справочника «Эдивеб_События», поиск не производится. Если поле не заполнено, поиск производится независимо.
3. Расширения
Во вкладке «Расширения» можно загрузить расширения и обновления (Рис. 11).
- Загрузить расширение из файла – выводится меню выбора файла обработки расширения (Рис. 12).
Эта обработка содержит в себе структуру, которая при разборе определяет в модуле доступные для загрузки/выгрузки документы, а также дополнительные команды меню главного окна.
В поле «Комментарий» выводится версия расширения (Рис. 13).
После загрузки расширений перейдите во вкладку «События» и нажмите кнопку «Загрузить из расширений» (Рис. 14).
- Получить обновления – отправка запроса к серверу обновлений и отображение архива доступных обновлений в виде таблицы (Рис. 15).
Если обновления не найдены, таблица не выводится.
- Получить количество обновлений – запрос к серверу обновлений. Сами файлы не загружаются, внизу экрана выводится сообщение (Рис. 16).
- Отладка расширений (предназначено для разработчиков) – сделать доступным отладку расширений в обычном режиме из конфигуратора. Для этого файлы расширений выгружаются из хранилища в каталог «Temp» из основных настроек (п. 2.1.1.). Файлы с предыдущими версиями обработок в данном каталоге будут перезаписаны без предупреждения, т.е. если вы производите отладку и правку кода из одного каталога (Temp), то последние изменения могут быть утеряны при старте основного модуля. Сохраняйте исправленные файлы в отдельном каталоге. Если флаг не установлен, то обработки запускаются из внутреннего хранилища.
4. События
Вкладка «События» содержит перечень событий, загруженных из расширений (Рис. 17).
После загрузки нового расширения нажмите кнопку «Загрузить из расширений» (Рис. 18).
Обновится список настроек событий во вкладке «Настройки событий». События в названии которых присутствует строка «_comm» являются дополнительной командой и попадают в соответствующий список главного окна.
5. Настройки событий
В данной вкладке задаются параметры, которые передаются в процедуру обработки события (Рис. 19).
Кнопка «Загрузить настройки событий» загружает последнее сохранённое событие (Рис. 20).
После перезагрузки списка событий из вкладки «События» загружается предустановленный шаблон.
«Слияние настроек» позволяет заполнить дерево в разделе «Настройки событий» из последних сохранённых настроек для текущего профиля. Используется после обновления списка событий из рисширений. Выполнять слияние нужно до сохранения настроек событий (Рис. 21).
После нажатия кнопки «Сохранить настройки событий», он будет сохранён в регистр настроек и станет текущим (Рис. 22).
5.1. Особенности настроек по документам и событиям
ORDERS (Заказ)
Вид настроек, устанавливаемых из «Мастера настройки» − быстрые установки (Рис. 23).
Если нужно добавить дополнительный реквизит, то кликните правой кнопкой мыши по разделу «При запуске» и нажмите кнопку «Добавить» (Рис. 24).
Введите название, например «Валюта», и выберите тип данных (Рис. 25).
Настройки по загрузке ORDERS:
- ПомечатьНаУдалениеИсходныйЗаказ − устанавливает пометку удаления на ORDERS, если пришел соответствующий код.
- ОтменаТабличнойЧасти – устанавливает флаг отмены в товарных линиях заказа.
- ТипДокумента – тип Эдивеб_план_характеристик. Устанавливает тип создаваемого документа при попытке загрузки ORDERS. ЗаказПокупателя, РеализацияТоваровУслуг, СчётНаОплатуКлиенту (для бухгалтерии).
- ВариантОформленияПродажи – при типе документа − реализация, нужно установить значение перечисления «ВариантыОформленияПродажи» как реализация.
- ВариантЗагрузки(тип Эдивеб_план_характеристик) – основные схемы занесения партнёров-контрагентов:
- Точка доставки – Грузополучатель
- Точка доставки – Клиент, Грузополучатель
- Точка доставки – Клиент, Контрагент, Грузополучатель
- Точка доставки – Контрагент Грузополучатель
DESADV (Уведомление об отгрузке)
Возможные параметры для DESADV (Рис. 26):
- ВыгружатьПаллетныйЛист − выгружает палетный лист.
- КороткийНомер − формирует номер документа по алгоритму «ПолучитьНомерНаПечать» учётной системы без удаления пользовательского префикса.
- ПоискШКПоХарактеристикам − производит поиск штрих-кода с учётом характеристики номенклатуры.
- ПоискШКПоУпаковке − производит поиск штрих-кода с учётом упаковки номенклатуры.
- ПересчитыватьЦеныПоУпаковкам − пересчитывает цены, учитывая коэффициент упаковки.
- Сворачивать − сворачивает таблицу номенклатуры по номенклатуре, ставке НДС, цене.
- Тип тары – тип используемой тары.
6. Регламентные задания
Во вкладке «Регламентные задания» настраиваются события для автоматического запуска и его период (Рис. 27).
События выполняются из списка последовательно с заданным интервалом. После добавления новой строки нужно выбрать одну из функций − ПриЗапуске, ПриОбновлении, ДопКоманды (Рис. 28).
Для функции «ПриЗапуске» обязательными колонками являются «Событие» и «Период». «Отбор» является необязательным, «Параметр наименование» заполнять не нужно (Рис. 29).
Перед запуском команды будет отобран массив элементов справочника «Эдивеб События» по запросу, где дата - данные из колонки «Период». Наименование - данные из колонки «Событие» без префикса «EVENT_”.
Далее будет произведен отбор по партнёру (если установлен), организации и грузополучателю. Для каждого элемента получившегося массива будет выполнена соответствующая ему функция «При запуске».
Для функции «При обновлении» необходимо выбрать обязательные колонки таблицы «Событие» и «Период». Отбор является и «Параметр наименование» заполнять не надо.
Далее будет запущена функция обновления для события без префикса «EVENT_”. В функцию будут переданы даты начала и окончания из колонки «Период».
Для функции «Доп. Команда» необходимо заполнить колонки «Событие» - имя команды (суффикс _comm), период и «Параметр наименование» - ORDER или DESADV, например.
Последние являются параметрами запроса. Отбор является необязательным. Будет запущена соответствующая дополнительная команда на вход, которой будет передан выбранный массив элементов справочника.
Установите интервал перезапуска таблицы в поле «Интервал секунд». Значения менее 10 сек. не принимаются. По умолчанию устанавливается 1 минута (Рис. 30).
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. Настройки лога
Здесь настраивается вывод сообщений лога для основных действий (запуск, обновление, доп. команды). Процедура запускается после обработки действий (Рис. 31).
В колонке список номеров через запятую указываются номера событий (или диапазон), например «1,100-200,355». Список событий лога приведён в приложении.
В колонке «Расширение» выбирается расширение через которое происходит вывод массива сообщений. Если заведено две строки для одного события с разными номерами, то будет выполнен вывод массива в два окна (в случае с отчётом). Также вывод может быть выполнен на ftp, например (требует отдельного расширения).
Техническое описание формата интерфейса выходного массива и интерфейса расширения осуществляется отделом поддержки по требованию. Массив вывода формируется выборкой по времени выполнения операции из регистра «Эдивеб Журнал». Настройки сохраняются вместе с основными.
Для вывода отчёта по ошибкам кликните правой кнопкой мышки по выбранному документу и выберите пункт «Вывести лог ошибок» (Рис. 32).
Будет выведено окно с ошибками по событию (Рис. 33).
8. Стартовый помощник (быстрые настройки)
С помощью «Стартового помощника» можно быстро установить настройки по умолчанию.
Для этого перейдите в раздел «Настройки» → «Основные» и нажмите кнопку «Быстрые настройки» (Рис. 34).
Откроется форма «Стартового помощника» (Рис. 35).
Навигация по пунктам осуществляется кнопками «Вперёд» / «Назад» (Рис. 36).
Доступные окна настроек:
- Пользователь − выбор/ввод нового пользователя.
- Настройки подключения − нужно завести настройки подключения (Рис. 37).
- Загрузка расширений − подгружаются с сервера или из файлов (п. 2.3)
- Партнёры − подгружаются с сервера или из файла с настройками. Новые партнёры выводятся в виде таблицы (Рис. 38).
На форме кнопка найти по ИНН/КПП производит поиск контрагетов и соответствующих им партнёров по реквизитам (Рис. 39).
Флаг «По умолчанию» загружает из фала стандартные настройки.
- Партнёры настройки по умолчанию – загружает из файла настройки партнёров (сопоставление по GLN). Форма загрузки повторяет предыдущий пункт.
- Документы – загружает из расширений список доступных документов (Рис. 40).
- Настройки документов − устанавливаются опции загрузки/выгрузки документов (Рис. 41).
- Тип документа заказа – возможные варианты загрузки заказа: заказ клиента, реализация товаров услуг, расходная накладная, счёт на оплату клиенту.
- Склад – устанавливает при загрузке ORDERS склад по умолчанию.
- Цена из файла – при значении «Ложь» устанавливает цены из учётной системы, в противном случае − из поступившего файла.
- Статус/приоритет и способ доставки – реквизиты ORDERS.
- Вид документа подтверждения заказа – устанавливает тип документа в запросе к базе учетной ситемы про обновлении списка ORDRSP.
- Короткий номер – со значением «Да» при выгрузке докуметов отбрасывает от номера префикс и лидирующие нули.
- Отображать к выгрузке – записанные/проведенные. При обновлении списка исходящих документов учитывает либо все (непомеченные на удаление), либо только проведённые документы.
- Подписывать – опция подписания документов.
- Адрес продавца/покупателя/грузополучателя/грузоотправителя – адреса используемые для выгрузки УПД, УКД.
- Настройки номенклатуры – дублирует пункт 2.