| Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Для настройки интеграции с системой, содержащей информацию о товарах и их свойствах, необходимо выполнить следующие действия:
Видео-инструкция по настройке интеграции с 1С 8.3 УТ 11.4
Видео-инструкция по настройке интеграции с 1С 8.3 УТ 10.3
Первое, что необходимо сделать - скачать комплект поставки Agora, соответствующей используемой редакции 1С, который включает файл конфигурации с предустановленным шлюзом (файл формата .cf). Для загрузки нажмите на наименование необходимого комплекта поставки:
После загрузки комплекта поставки можно переходить к этапу настройки загруженного шлюза в 1С. Якорь |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Раскрыть | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| Якорь | ||||
|---|---|---|---|---|
|
После обновления конфигурации необходимо запустить 1С: Предприятие.
В нформационной базе должен бы включен механизм синхронизации данных. Если синхронизация не использовалась ранее, необходимо установить флаг в настройках системы:
Далее необходимо перейти в план обмена "Агора обмен":
Если в общие модули не были внесены изменения, то будет предложено установить расширение:
Работа шлюза без установленного расширения или изменений в общих модулях невозможна.
После установки расширения необходимо выполнить перезапуск 1С и повторно открыть форму списка плана обмена:
Для инициализации узлов можно вопользоваться кнопкой "Создать узлы". Будет создан новый узел плана обмена и открыта его форма.
Фильтры регистрации изменений
В форме плана обмена необходимо указать организацию по умолчанию, если на портал будут выгружаться данные по нескольким организациям, то необходимо установить флаг "Использовать несколько организаций" и указать все организации для обмена.
Менеджер по умолчанию - будет устанавливаться у новых партнеров.
Статус заказа, приоритет заказа, вариант обеспечения - значения по умолчанию для новых заказов.
Типовое соглашение - соглашение-образец для создания новых соглашений контрагентов, загружаемых с портала.
Виды цен, склады, реквизиты номенклатуры и свойства номенклатуры и характеристик имеют 2 варианта настройки - выгружаются либо только указанные элементы, либо все, кроме указанных.
Если не установлен флаг "Регистрация изменений включена", то регистрация производиться не будет.
На странице "Номенклатура" указываются группы номенклатуры, включенные в обмен с порталом:
Кнопка "Включить в обмен" включает выделенные позиции в обмен, "Исключить из обмена" - исключает. Если установлен флаг "Включать новую номенклатуру в обмен", то при создании или переносе товаров в группу, включенную в обмен, позиции будут включаться в обмен автоматически.
Параметры обмена с порталом
Если установлено количество объектов для выгрузки, то в пакет обмена будет записываться ограниченное количество объектов.
Адрес портала указывается полностью, в виде http(s)://<имя сервера>/gateways/1c
Для рассылки уведомлений об ошибках должно быть включено использование дополнительных отчетов и обработок, отчет по ошибкам обмена добавляется в справочник дополнительных отчетов и обработок при создании узлов или по кнопке "Обновить" формы узла (см. скриншот). Если создана рассылка для данного узла, то на форме будет выведена ссылка на рассылку, иначе по ссылке откроется окно создания новой рассылки.
После записи узла обмен готов к использованию.
Правила регистрации объектов поставлются с планом обмена. При необходимости их можно выгрузить и отредактировать в конфигурации "Конвертация данных" через команду "Загрузить комплект правил"
| Якорь | ||||
|---|---|---|---|---|
|
Первоначальная регистрация осуществляется либо через типовую обработку "Регистрация изменений для обмена", либо через обработку "Полная выгрузка данных":
Внешний вид обработки:
При нажатии кнопки "Выполнить регистрацию" все отмеченные объекты данных, удовлетворяющие условиям выгрузки, будут зарегистрированы для обмена, после чего будет создан или обновлен сценарий синхронизации для выбранного узла, если установлен соответствющий флаг. Также будет обновлено расписание регламентного задания синхронизации.
Проверить состояние синхронизации можно в типовой форме "Настройки синхронизации данных":
Рис.15 - Создание ФлагАгораОбмен.
- В панели конфигурации открыть Общие -> Интерфейсы -> Общий (Рис.16, П.1), перейти на вкладку "Сервис" (Рис.16, П.2) и, кликнув правым кликом, добавить новую кнопку (Рис.16, П.3) и затем войти в свойства созданной кнопки.
Рис.16 - Добавление кнопки в меню.
- В открывшемся окне Свойств, кликните на выбор действия (Рис.17, П.1), затем в появившемся окне найдите среди обработок АгораНастройкаОбменаДанными (Рис.17, П.2) и нажмите ОК (Рис.17, П.2).
Рис. 17 - Настройка кнопки меню.
- Обязательно задайте понятное имя созданной кнопке (Рис. 18).
Рис. 18 - Задание имени для кнопки.
- Обновить конфигурацию баз данных, нажав на иконку
на панели управления (Рис.19).
Рис.19 - Кнопка Обновить конфигурацию
- Принять изменения в структуре информации конфигурации (Рис.20).
Рис.20 - Изменения в структуре информации и конфигурации
Рис.21 - Форма создания нового элемента списка
| title | 1С - УТ 11.1 (Старая версия 2015) |
|---|
Для портирования кода из файла конфигурации выполнить следующие шаги:
- Открыть файл конфигурации с предустановленным шлюзом (файл формата .cf), который входит в комплект поставки.
- В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура (Рис.14, П.1) и открыть модуль объекта (Рис.14, П.2). В строку поиска ввести Центробит (Рис.14, П.3), найти и перенести все участки кода из файла конфигурации в конфигурацию базы поставщика в соответствующие процедуры (Рис.15).
Рис.14 - Выбор модуля объекта
Рис.15 - Перенос кода
- В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура → Формы → Форма элемента (Рис.16, П.1) и перейти на вкладку Модуль (Рис.16, П.2). В строку поиска ввести Центробит, найти и перенести все участки кода из файла конфигурации в конфигурацию базы поставщика в соответствующие процедуры.
Рис.16 - Вкладка Модуль, перенос кода
- В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура → Формы → Форма элемента → Открыть форму (Рис.17) и перейти на вкладку Форма. Перенести реквизиты формы элемента справочника номенклатуры АгораВидНоменклатуры и АгораОбменНачальная из файла конфигурации в конфигурацию базы поставщика.
Рис.17 - Вкладка Форма, перенос реквизитов
- На вкладке Элементы в папку ГруппаДанныеВида добавить объект АгораОбмен из файла конфигурации. Проверить, что в окне Свойства Поля в строке Видстоит значение Поле флажка (Рис.18).
Рис.18 - Добавление объекта АгораОбмен
Обновить конфигурацию баз данных, нажав на иконку на панели управления (Рис.19).
Рис.19 - Кнопка Обновить конфигурацию
- Принять изменения в структуре информации конфигурации (Рис.20).
Рис.20 - Изменения в структуре информации и конфигурации
Рис.21 - Всё функции в панели меню.
Рис.22 - Форма создания нового элемента списка
| title | 1С Альфа-авто |
|---|
- В панели конфигурации открыть Общие -> Интерфейсы -> Общий(Рис.14, П.1), перейти на вкладку "Сервис" (Рис.14, П.2) и, кликнув правым кликом, добавить новую кнопку (Рис.14, П.3) и затем войти в свойства созданной кнопки.
Рис.14 - Добавление кнопки в меню.
- В открывшемся окне Свойств, кликните на выбор действия (Рис.15, П.1), затем в появившемся окне найдите среди обработок АгораНастройкаОбменаДанными (Рис.15, П.2) и нажмите ОК (Рис.15, П.2).
Рис. 15 - Настройка кнопки меню.
- Обязательно задайте понятное имя созданной кнопке (Рис. 16).
Рис. 16 - Задание имени для кнопки.
- Открыть модуль объекта обработки СтартСистемы.
- Перенести в код обработки изменения для Агоры, взяв их из файла конфигурации: в процедуру ВыполнитьПроверкуЗаполненияКонстант добавить код игнорирования проверки заполненности константы АгораНомерСообщения(рис 16.1)
Рис.16.1 - Код игнорирования проверки на заполненность константы
- Обновить конфигурацию баз данных, нажав на иконку на панели управления (Рис.17).
Рис.17 - Кнопка Обновить конфигурацию
- Принять изменения в структуре информации конфигурации (Рис.18).
Рис.18 - Изменения в структуре информации и конфигурации
Рис.19 - Форма создания нового элемента списка
Для пользователей с версиями 1С УТ 10.3 (Старая версия 2015), УТ 11.1 (Старая версия 2015) или Альфа-Авто необходимо предпринять следующие шаги.
Далее в панели конфигурации перейдите: Общие -> Интерфейсы -> Общий:
В открывшемся окне нажмите кнопку Сервис, а в выпадающем меню кнопку < Новая >:
После этого откроется панель свойств элемента:
В открывшемся свойств, нажмите на Выбор действия (знак ... ), затем в появившемся окне найдите раздел Обработки, раскройте его и выберите АгораНастройкаОбменаДанными:
После этого укажите имя добавленного элемента в его свойствах. Рекомендуем указать понятное название, например, Агора. Настройка обмена данных:
Для обновления конфигурации баз данных нажмите кнопку 
, расположенную на панели управления:
После этого откроется окно с описанием изменений в структуре конфигурации, в котором нажмите кнопку Принять:
На завершающем этапе перейдите в интерфейс информационной базы 1С:Предприятие "Управление торговлей".
В открывшемся интерфейсе откройте вкладку Операции и выберите раздел План обмена:
В открывшемся окне выберите Агора обмен и нажмите кнопку ОК:
В открывшемся окне создайте новые узлы обмена 1С и АГОРА (необходимо для хранения изменений данных номенклатуры)
Последовательность создания узлов обмена должна быть следующей: сначала 1С, затем — АГОРА.
Для этого в открывшемся окне нажмите на отображаемую строку плана обмена (например, на колонку Код) и в открывшемся окне заполните поля Код и Наименование фразой 1С (на русском языке), для сохранения внесенных изменений нажмите кнопку ОК.
После этого добавьте узел обмена АГОРА, нажав кнопку добавления 
либо путем перехода: Действия → Добавить
В открывшемся окне укажите Код и Наименование: АГОРА (важно, чтобы все буквы были заглавными) и нажмите кнопку ОК для сохранения изменений:
Обратите внимание, что план в значке 1С имеет зелёную точку, а АГОРА — простое отображение:
После того, как текущий этап настройки будет завершен, необходимо сделать полную выгрузку.
О том, как сделать полную выгрузку с настроенным шлюзом Agora, описано в этом разделе.
Настройка отвечает за периодичность выгрузки данных на портал. На данном этапе можно задать условия обмена данными между сервисами 1С и Agora.
Настройка осуществляется в интерфейсе 1С:Предприятие на вкладке:
- Для УТ10.3: Операции → Обработки → Агора. Настройка Обмена данными.
- Для УТ11.1(2,3): Панель Разделов → Agora.
В открывшемся окне выберите Агора. Настройка Обмена данными и нажмите кнопку ОК:
После открытия настроек обмена данными с системой Agora, перейдите на вкладку Регламентное задание:
По-умолчанию интервал обмена составляет 1 минуту, в случае необходимости можно изменить интервал обмена. Для этого нажмите на значок с часами в разделе Регламентное задание:
Расписание обмена отвечает за периодичность выгрузки данных из 1С в папку Хранилище файлов.
Настройка периодичности загрузки осуществляется на вкладке Дневное:
Расписание обмена с порталом отвечает за периодичность выгрузки данных из 1С на портал.
Настройка периодичности также осуществляется на вкладке Дневное:
| Предупреждение |
|---|
В случае использования серверной версии 1С:Предприятие "Управление торговлей" в настройках администрирования сервера 1С:Предприятие "Управление торговлей" необходимо убедиться, что чекбокс "Блокировка регламентных заданий" не отмечен. |
После завершения настройки регламентных заданий перейдите на вкладку Параметры обмена и заполните следующие поля:
- Портал — выбор настроенного узла обмена (по-умолчанию возможности изменения портала нет, поэтому выберите предустановленный портал АГОРА).
- Хранилище файлов — создайте папку и укажите к ней путь, Все сотрудники, работающие с 1С, должны иметь доступ к созданной папке.
- Количество объектов, добавляемых в исходящий файл обмена.
- Адрес сайта (без http://) - предоставляется службой поддержки. В случае возникновения вопросов, отправьте запрос по адресу: help@agora.ru
- Ключ лицензии - предоставляется службой поддержки. В случае возникновения вопросов, отправьте запрос по адресу: help@agora.ru
- Учетные данные для получения оповещений о ошибках в обмене.
После настройки нажмите кнопку 
для "связки" используемой базы данных со службой обмена портала.
После запуска обмена с порталом:
В указанном Хранилище файлов будут созданы следующие папки:
После окончания обмена с порталом, в административной панели проекта, доступной по адресу: адрес_проекта.agora.ru/admin в разделе Пакеты обмена Импорта будет отображаться массив данных, загружаемый из 1С, доступный при нажатии на имя xml-файла в колонке Файл:
Обратите внимание, после полной выгрузки должно пройти какое-то время для актуализации данных на портале. Как правило, время ожидания не превышает 15 минут.
Пример формата выгружаемых данных из 1С доступен в этом разделе.
Если данные не выгружены, проверьте журнал регистрации ошибок в 1С, доступный следующим образом:
- В выпадающем меню Все функции (1С версии 11) или Операции (1С версии 10.3).
- Перейдите в Обработки и выберите Журнал регистрации.
В данном разделе будут отображаться данные о возникающих ошибках при работы механизма интеграции.
Наглядный пример оформления заказа на портале и его обработка в 1С доступен в разделе Оформление заказа
| Информация |
|---|
Если у вас возникли трудности или вопросы в ходе настройки интеграции, вы всегда можете написать в нашу техническую поддержку: help@agora.ru и вам обязательно помогут. |
...