Для настройки интеграции с системой, содержащей информацию о товарах и их свойствах, необходимо выполнить следующие действия: 

1. Скачать файл конфигурации, содержащий предустановленный шлюз обмена.
2. Установить шлюз обмена в 1С.
3. Настроить регламентные задания.

Рассмотрим настройку шлюза обмена используя 1С.Управление торговлей 10.3.

   1. Загрузка комплекта поставки 

Первое, что необходимо сделать - скачать комплект поставки Agora, соответствующей используемой редакции 1С, который включает 2 файла:

• Файл конфигурации с предустановленным шлюзом (файл формата .cf).
• Обработка полной выгрузки Полная выгрузка.epf.

 Список готовых решений для интеграции доступен в этом разделе. 

Для загрузки нажмите на наименование необходимого комплекта поставки. 

После загрузки комплекта поставки можно переходить к этапу настройки загруженного шлюза в 1С.

     2. Установка шлюза обмена

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

Для этого откройте конфигуратор 1С:

В открывшемся окне откройте вкладку Администрирование и перейдите в раздел Выгрузить информационную базу:

В открывшемся окне укажите путь для сохранения информационной базы:

 Сохранение информационной базы может занять продолжительное время, если операция выполняется на "слабом" компьютере.

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

Следующий этапом настройки выгрузка копии конфигурации базы 1С. Для этого откройте вкладку Конфигурация и перейдите в раздел Сохранить конфигурацию в файл:

В открывшемся окне укажите путь для сохранения копии конфигурации 1С:

В случае успешного сохранения, будет отображено уведомление вида: 

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

Для выбора конфигурации откройте раздел Конфигурация и выберите вкладку Открыть конфигурацию:

После сохранения информационной базы можно переходить к этапу установки шлюза обмена.

Для этого откройте Конфигуратор, перейдите на вкладку Конфигурация, далее Открыть конфигурацию. Затем перейдите :  Конфигурация → Поддержка → Настройка поддержки:

В открывшемся окне нажмите кнопку Включить возможность изменения. В окне запроса нажмите кнопку Да, чтобы дать согласие на включение возможности изменения:

После нажатия на кнопку Да откроется окно настроек правил поддержки, где укажите следующие параметры и нажмите кнопку ОК: 

После настройки правил поддержки,  необходимо изменить правило поддержки для корня конфигурации. Для этого откройте меню изменений режима поддержки нажав правую кнопку мыши на кнопке Не редактируется и затем нажав кнопку Установить правило поддержки.

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

После  этого можно закрыть окно Настройка поддержки, нажав кнопку Закрыть. 

Следующим этапом настройки будет объединение загруженного файла конфигурации с ранее используемым. Для этого откройте вкладку Конфигурация и выберите пункт Сравнить, объединить с конфигурацией из файла:

 В открывшемся окне укажите путь к файлу в формате .cf, который был загружен на первом этапе настройки на основании комплекта поставки.

После успешной загрузки доработанного для интеграции файла конфигурации снимите отметки всех чекбоксов сравнения-объединения:

После этого отметьте Agora в качестве подсистемы. Нажмите кнопку Действия и перейдите в раздел Отметить по подсистемам файла:

В открывшемся окне оставьте выделенной только подсистему Агора и нажмите кнопку Установить:

Затем выполните объединение кода, нажав кнопку Выполнить:

Далее в панели конфигурации перейдите: Общие -> Интерфейсы -> Общий:

В открывшемся окне нажмите кнопку Сервис, а в выпадающем меню кнопку < Новая >:

После этого откроется панель свойств элемента: 

В открывшемся свойств, нажмите на Выбор действия (знак ... ), затем в появившемся окне найдите раздел Обработки, раскройте его и выберите АгораНастройкаОбменаДанными:

После этого укажите имя добавленного элемента в его свойствах. Рекомендуем указать понятное название, например, Агора. Настройка обмена данных:

Для обновления конфигурации баз данных нажмите кнопку , расположенную на панели управления: 

После этого откроется окно с описанием изменений в структуре конфигурации, в котором нажмите  кнопку Принять:

 На завершающем этапе перейдите в интерфейс информационной базы 1С:Предприятие "Управление торговлей".

В открывшемся интерфейсе откройте вкладку Операции и выберите раздел План обмена:

В открывшемся окне выберите Агора обмен и нажмите кнопку ОК:

В открывшемся окне создайте новые узлы обмена 1С и АГОРА (необходимо для хранения изменений данных номенклатуры)

 Последовательность создания узлов обмена должна быть следующей: сначала 1С, затем — АГОРА.

Для этого в открывшемся окне нажмите на отображаемую строку плана обмена (например, на колонку Код) и в открывшемся окне заполните поля Код и Наименование фразой 1С (на русском языке), для сохранения внесенных изменений нажмите кнопку ОК.

После этого добавьте узел обмена АГОРА, нажав кнопку добавления  либо путем перехода: Действия → Добавить

В открывшемся окне укажите Код и Наименование: АГОРА (важно, чтобы все буквы были заглавными) и нажмите кнопку ОК для сохранения изменений:

 Обратите внимание, что план в значке 1С имеет зелёную точку, а АГОРА — простое отображение:

    3. Настройка регламентных заданий

Настройка отвечает за периодичность выгрузки данных на портал. На данном этапе можно задать условия обмена данными между сервисами 1С и Agora.

Настройка осуществляется в интерфейсе 1С:Предприятие на вкладке:

• Для УТ10.3: Операции → Обработки → Агора. Настройка Обмена данными.
• Для УТ11.1(2,3): Панель Разделов →  Agora.

В открывшемся окне выберите Агора. Настройка Обмена данными и нажмите кнопку ОК:

После открытия настроек обмена данными с системой Agora, перейдите на вкладку Регламентное задание:

По-умолчанию интервал обмена составляет 1 минуту, в случае необходимости можно изменить интервал обмена. Для этого нажмите на значок с часами в разделе Регламентное задание:

Расписание обмена отвечает за периодичность выгрузки данных из 1С в папку Хранилище файлов. 

Настройка периодичности загрузки осуществляется на вкладке Дневное:

Расписание обмена с порталом отвечает за периодичность выгрузки данных из 1С на портал.  

Настройка периодичности также осуществляется на вкладке Дневное:

После завершения настройки регламентных заданий перейдите на вкладку Параметры обмена и заполните следующие поля:

• Портал — выбор настроенного узла обмена (по-умолчанию возможности изменения портала нет, поэтому выберите предустановленный портал АГОРА).
• Хранилище файлов — создайте папку и укажите к ней путь, Все сотрудники, работающие с 1С, должны иметь доступ к созданной папке.
• Количество объектов, добавляемых в исходящий файл обмена.
• Адрес сайта (без http://) - предоставляется службой поддержки. В случае возникновения вопросов, отправьте запрос по адресу: help@agora.ru
• Ключ лицензии - предоставляется службой поддержки. В случае возникновения вопросов, отправьте запрос по адресу: help@agora.ru
• Учетные данные для получения оповещений о ошибках в обмене.

После настройки нажмите кнопку  для "связки" используемой базы данных со службой обмена портала.

После запуска обмена с порталом: 

 В указанном Хранилище файлов будут созданы следующие папки:

• Complete — папка архива, куда перемещаются файлы после отправки данных на сайт.
• Export — папка, куда перемещаются данные из системы 1С:Предприятие "Управление торговлей" для последующей отправки на сайт и перемещения файлов в архив.
• Img — папка, куда перемещаются данные из системы 1С:Предприятие "Управление торговлей" (изображения) для последующей отправки на сайт и перемещения файлов в архив.
• Import — папка, куда перемещаются данные с сайта для дальнейшего перемещения файлов в систему 1С:Предприятие "Управление торговлей" и архив.
• Preexport — системная папка.

После окончания обмена с порталом, в административной панели проекта, доступной по адресу: адрес_проекта.agora.ru/admin в разделе Пакеты обмена Импорта будет отображаться массив данных, загружаемый из 1С, который доступен при клике на наименование xml-файла в колонке Файл:

Обратите внимание, после полной выгрузки должно пройти какое-то время для актуализации данных на портале. Как правило время ожидания не превышает 15 минут. 

 Пример формата выгружаемых данных из 1С доступен в этом разделе. 

Если данные не выгружены, необходимо проверить в 1С журнал регистрации ошибок, который доступен по пути: 

• Выбрать в выпадающем меню "Все функции" (в 1С 11 версии), либо Операции (в версии 10.3)
• Зайти в "Обработки" и выбрать "Журнал регистрации"

Этот раздел будет хранить в себе информацию о возникающих ошибках в ходе работы интеграции.