Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Sv translation
languageru_RU

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

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

...

...

  1. Выполнить обмен с порталом

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

...

11.

...

4.


Примечание

...

Отличие используемой версии 1С от УТ 10.3 не повлияет на последовательность настройки. Вне зависимости от используемой версии и редакции 1С, вы сможете настроить интеграцию, руководствуясь этой инструкцией.

Image Removed

...

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

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

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

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

...

Шлюз предназначен для работы в типовых конфигурациях 1С, построенных на основе библиотеки стандартных подсистем.

Информация
titleДополнительные возможности

Возможность установки шлюза Агора через расширение доступно для следующих версий 1С:
УТ 11,4, ЕРП 2,4 , КА 2.
При установке расширения конфигурация НЕ СНИМАЕТСЯ С ПОДДЕРЖКИ.
Установка производится разработчиком, так как с большой вероятностью потребуется донастройка расширения под конкретную конфигурацию в случае возникновения конфликтов по метаданным.
Для установки необходимо:
1) Зайти в конфигуратор.
2) Далее открыть раздел Конфигурация - Расширения.
3) Добавить новое расширение.
4) Загрузить в него расширение шлюза.

Файл с расширением расположен в разделе  1. Загрузка комплекта поставки


Image Added

Видео-инструкция по настройке интеграции с 1С 8.3 УТ 11.4

Коннектор виджета
width500
url

https://www.

...

youtube.

...

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

Image Removed

...

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

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

Image Removed

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

Image Removed

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

Image Removed

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

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

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

Image Removed

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

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

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

Image Removed

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

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

(информация) Дальнейшие действия по настройке отличаются в зависимости от вашей конфигурации 1С. Если ваша версия  УТ 10.3 (Старая версия 2015)УТ 11.1 (Старая версия 2015) или Альфа-Авто, тогда раскройте инструкцию для вашей версии 1С и выполните указанные далее шаги. Если в перечисленном списке отсутствует используемая вами редакция 1С отсутствует, напишите в нашу техническую поддержку help@agora.ru и вам обязательно помогут.

...

title1C - УТ 10.3 (Старая версия 2015)

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

  • Открыть файл конфигурации с предустановленным шлюзом (файл формата .cf), который входит в комплект поставки.
  • В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура → Формы → Форма элемента (Рис.14, П.1) и перейти на вкладку Модуль (Рис.14, П.2). В строку поиска ввести Центробит (Рис.14, П.3)найти и перенести все участки кода из файла конфигурации в конфигурацию базы поставщика в соответствующие процедуры (Рис.14, П.4)

Image Removed
Рис.14 - Вкладка Модуль, перенос кода

...

Icon

После добавления Реквизита перейдите обратно на вкладку Модуля, с помощью поиска (как и при поиске строки Центробит) найдите совпадения по запросу "ФлагАгораОбмен."

Если вы обнаружили в коде записи типа ФлагАгораОбмен.Ключ, то кликните на кнопку отменить действие в основном меню конфигуратора, и данный код исчезнет.
Это автоматическая вставка кода 1С при добавлении реквизита, мы это не используем, поэтому отменяем. 

Image Removed

Рис.15 - Создание ФлагАгораОбмен.

  • В панели конфигурации открыть Общие -> Интерфейсы -> Общий (Рис.16, П.1), перейти на вкладку "Сервис" (Рис.16, П.2) и, кликнув правым кликом, добавить новую кнопку (Рис.16, П.3) и затем войти в свойства созданной кнопки.

Image Removed

Рис.16 - Добавление кнопки в меню.

  • В открывшемся окне Свойств, кликните на выбор действия (Рис.17, П.1), затем в появившемся окне найдите среди обработок АгораНастройкаОбменаДанными (Рис.17, П.2) и нажмите ОК (Рис.17, П.2).

Image Removed

Рис. 17 - Настройка кнопки меню.

  • Обязательно задайте понятное имя созданной кнопке (Рис. 18).

Image Removed

Рис. 18 - Задание имени для кнопки.

  • Обновить конфигурацию баз данных, нажав на иконку Image Removed на панели управления (Рис.19).

Image Removed

Рис.19 - Кнопка Обновить конфигурацию

  • Принять изменения в структуре информации конфигурации (Рис.20).

Image Removed

Рис.20 - Изменения в структуре информации и конфигурации

...

com/watch?v=Lzf7DU3ly_U
height300

Видео-инструкция по настройке интеграции с 1С 8.3 УТ 10.3

Коннектор виджета
width500
urlhttps://www.youtube.com/watch?v=4elEvLrmEEM&feature=youtu.be
height300

Image Added


   

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

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

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


Информация

Если вы не нашли версию используемой вами редакции 1С, напишите письмо по адресу help@agora.ru или оставьте заявку https://www.agora.ru/help/  в техническую поддержку и мы предоставим комплект поставки для иных редакций, к примеру, ERP 2.0

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

Image Added

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

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

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

Image Added

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

Image Added

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

Image Added

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

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

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

Image Added

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

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

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

Image Added

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

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

Image Added

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

Image Added

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

Image Added

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

Image Added
Нажать на кнопку Продолжить

Далее нужно обновить конфигурацию, нажав на кнопку обновления.

Image Added

В открывшемся окне нажимаем Принять.

Image Added

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

Расширение будет установлено автоматически из режима Предприятия. Общие модули включены в состав плана обмена и содержат только изменяемые функции.

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

(информация) О том, как сделать полную выгрузку с настроенным шлюзом Agora, описано в этом разделе.

    
Якорь
4
4
3. Настройка обмена с порталом

После обновления конфигурации необходимо запустить 1С: Предприятие.

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

Image Added

Image Added

Далее необходимо перейти в план обмена "Агора обмен":

Image Added

Если в общие модули не были внесены изменения, то будет предложено установить расширение:

Image Added

Работа шлюза без установленного расширения или изменений в общих модулях невозможна.

После установки расширения необходимо выполнить перезапуск 1С и повторно открыть форму списка плана обмена:

Image Added

Для инициализации узлов можно воспользоваться кнопкой "Создать узлы". Будет создан новый узел плана обмена и открыта его форма.

Фильтры регистрации изменений

Image Added

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

Менеджер по умолчанию - будет устанавливаться у новых партнеров.

Статус заказа, приоритет заказа, вариант обеспечения - значения по умолчанию для новых заказов.

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

Виды цен, склады, реквизиты номенклатуры и свойства номенклатуры и характеристик имеют 2 варианта настройки - выгружаются либо только указанные элементы, либо все, кроме указанных.

Если не установлен флаг "Регистрация изменений включена", то регистрация производиться не будет.

На странице "Номенклатура" указываются группы номенклатуры, включенные в обмен с порталом:

Image Added

Кнопка "Включить в обмен" включает выделенные позиции в обмен, "Исключить из обмена" - исключает. Если установлен флаг "Включать новую номенклатуру в обмен", то при создании или переносе товаров в группу, включенную в обмен, позиции будут включаться в обмен автоматически.

Параметры обмена с порталом

Image Added

Если установлено количество объектов для выгрузки, то в пакет обмена будет записываться ограниченное количество объектов.

Адрес портала указывается полностью, в виде http(s)://<имя сервера>

Ключ лицензии указывается одинаковый в 1С и на платформе. Он предоставляется службой поддержки. В случае возникновения вопросов, отправьте запрос по адресу: help@agora.ru

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

После записи узла обмен готов к использованию.

Правила регистрации объектов поставляются с планом обмена. При необходимости их можно выгрузить и отредактировать в конфигурации "Конвертация данных" через команду "Загрузить комплект правил"

Якорь
3
3
4. Выполнение обмена с порталом

Первоначальная регистрация осуществляется либо через типовую обработку "Регистрация изменений для обмена", либо через обработку "Полная выгрузка данных":
Image Added

Внешний вид обработки:

Image Added

При нажатии кнопки "Выполнить регистрацию" все отмеченные объекты данных, удовлетворяющие условиям выгрузки, будут зарегистрированы для обмена, после чего будет создан или обновлен сценарий синхронизации для выбранного узла, если установлен соответствющий флаг. Также будет обновлено расписание регламентного задания синхронизации.

Проверить состояние синхронизации можно в типовой форме "Настройки синхронизации данных":

Image Added

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

Image Added

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

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

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

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

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

Image AddedImage Added Наглядный пример оформления заказа на портале и его обработка в 1С доступен в разделе Оформление заказа

Более подробная информация по работе со шлюзом обмена на стороне 1С рассказана в видео:

Коннектор виджета
width800
urlhttps://www.youtube.com/watch?v=s8_e65whBW0
height400

Информация

Если у вас возникли трудности или вопросы в ходе настройки интеграции, вы всегда можете написать в нашу техническую поддержку: help@agora.ru и вам обязательно помогут. 

Sv translation
languageen

To configure integration with a system containing information about products and their properties, you must perform the following steps:

  1. Download a configuration file containing a predefined exchange gateway.

  2. Install the exchange gateway in 1C

  3. Set up scheduled tasks.

(информация) Consider setting up an exchange gateway using 1C. Trade management 10.3.

Примечание
The difference between the used version 1C and UT 10.3 will not affect the setup sequence. 
Regardless of the version used and the 1C edition, you can configure the integration, guided by this instruction.
Информация
titleAdditional features
The ability to install the Agora gateway through the extension is available for the following versions of 1C:
UT 11.4, ERP 2.4, KA 2.
When installing an extension, the configuration is NOT REMOVED FROM SUPPORT.
Installation is carried out by the developer, since it is highly likely that the extension will need to be adjusted for a specific configuration in case of metadata conflicts.
To install you need:
1) go to the configurator.
2) Next, open the Configuration - Extensions section.
3) Add a new extension.
4) Load the gateway extension into it.

The file with the extension is located just below in section 1. Download package


Video instructions for setting up integration with 1C 8.3 UT 11.4

Коннектор виджета
width700
urlhttps://www.youtube.com/watch?v=Lzf7DU3ly_U
height350

Video instructions for setting up integration with 1C 8.3 UT 10.3

Коннектор виджета
width700
urlhttps://www.youtube.com/watch?v=4elEvLrmEEM
height350

Якорь
1
1
1. Download package

The first thing to do is download the Agora delivery kit corresponding to the 1C edition used, which includes 1 file:
  • A configuration file with a pre-installed gateway (.cf file).

(информация)A list of turnkey integration solutions is available in this section.

To download, click on the name of the required package.

Информация

If you did not find the version of the 1C edition you are using, write a letter to help@agora.ru or leave a request https://www.agora.ru/help/ for technical support and we will provide a delivery kit for other editions, for example, ERP 2.0

After downloading the package, you can proceed to the step of setting up a loaded gateway in 1C.

Якорь
2
2
2. Installation of the exchange gateway

(информация) Before installing the Agora software product, save a backup copy of the database in order to "roll back" 1C to its original state in the event of a configuration failure.

To do this, open the 1C configurator:

2019-01-11 10-56-09.jpgImage Added

In the window that opens, open the Administration tab and go to the Unload infobase section:

Image Added

In the window that opens, specify the path to save the infobase:

Image Added

(информация) Saving a database can take a long time if the operation is performed on a “weak” computer.


If saved successfully, the following notification will be displayed:
Image Added
The next step in the configuration is to unload a copy of the 1C database configuration.
To do this, open the Configuration tab and go to the Save configuration to file section:
Image Added

In the window that opens, specify the path to save a copy of the 1C configuration:
Image Added

In the case of a successful save, a notification of the form:

Image Added

(информация) If the Save configuration to file button is not active (is displayed in gray and cannot be pressed), then the configuration to be saved is not selected.

To select a configuration, open the Configuration section and select the Open configuration tab:

Image Added

After saving the infobase, you can proceed to the stage of installing the exchange gateway.

To do this, open the Configurator, go to the Configuration tab, then Open configuration. Then go to: Configuration → Support → Configure Support:

Image Added

In the window that opens, click the Enable change option button. In the request window, click Yes to agree to enable the possibility of changes:

Image Added

After clicking on the Yes button, the support rule settings window opens, where specify the following parameters and click OK:

Image Added

After setting up support rules, you need to change the support rule for the configuration root. To do this, open the support mode change menu by right-clicking on the Not edited button and then clicking the Set support rule button:

Image Added

In the window that opens, select Provider objects are edited while maintaining support. Leave unselected Set for subordinate objects and click OK:

Image Added

After that, you can close the Support Settings window by clicking the Close button.


The next configuration step will be combining the downloaded configuration file with the previously used one. To do this, open the Configuration tab and select Compare, merge with configuration from file:

Image Added

(информация) In the window that opens, specify the path to the file in the .cf format, which was downloaded at the first stage of configuration based on the delivery kit.

After successfully loading the configuration file that was modified for integration, uncheck all the comparison-union checkboxes:

Image Added

After that, mark Agora as a subsystem. Click the Actions button and go to the Mark by file subsystems section:

Image Added

In the window that opens, leave only the Agora subsystem selected and click Install:

Image Added

Then merge the code by clicking the Run button:

Image Added

Click the Continue button

Информация

The following setup steps differ depending on your 1C configuration. If your version is 1C UT 10.3 (Old version 2015), UT 11.1 (Old version 2015) or Alfa-Auto, then open the instructions for your version of 1C and follow the steps below. If the 1C edition you are using is missing from the listed list, write to our technical support help@agora.ru and you will definitely be helped.

Раскрыть
title1C - UT 10.3 (Old version 2015)

To port the code from the configuration file, follow these steps:     

  • Open the configuration file with a pre-installed gateway (.cf file), which is included in the package.     
  • In the configuration panel and in the configuration file, select Directories → Nomenclature → Forms → Element shape (pic. 14, A.1) and go to the Module tab (pic. 14, A.2). In the search bar, enter Centrobit (pic. 14, A.3), find and transfer all sections of code from the configuration file to the configuration of the supplier database in the appropriate procedures (pic. 14, A.4).

Image Added

Pic. 14 - Module tab, code transfer

  • Go to the Details tab and create the FlagAgoraExchange as shown in the picture (pic. 15).


Примечание

After adding the Props, go back to the Module tab, using the search (as with the search for the Centrobit string) find matches for the query "FlagAgoraExchange"

If you find a flag type FlagAgoraExchange.Key in the code, click on the cancel button in the main menu of the configurator, and this code will disappear.

This is an automatic insertion of the 1C code when adding props, we do not use it, therefore we cancel it.

Image Added

Pic. 15 - Creating a FlagAgoreExchange.

  • In the configuration panel, open General -> Interfaces -> General (Pic. 16, A.1), go to the "Service" tab (Pic. 16, A.2) and, right-clicking, add a new button (Pic. 16, A.3) and then enter the properties of the created button.

Image Added

Pic. 16 - Adding a button to the menu.

  • In the Properties window that opens, click on the selection of the action (Pic. 17, A.1),
    then in the window that appears, search for AgoraSettingsDataExchange (Fig. 17, A.2) and click OK (Fig. 17, A.2).

Image Added

Рic. 17 - Setting the menu button.

  • Be sure to set the friendly name for the created button (Pic. 18).

Image Added

Pic. 18 - Setting the name for the button.

  • Update the database configuration by clicking on the icon Image Added on the control panel (Fig. 19).

Image Added

Pic. 19 - Update configuration button

  • Accept changes in the structure of configuration information (Pic. 20).

Image Added

Pic. 20 - Changes in the structure of information and configuration

  • Log in to the information base 1C: Enterprise "Trade Management".
  • Open the Operations menu in the navigation panel. In the menu window that opens, select the Exchange Plan (pic. 21, Cl.1), then in the window that appears select Agora exchange and create new elements of the 1C and AGORA list (it is necessary to store changes in the data on the item list, it is necessary to start in order: 1C, then AGORA). To do this, click on the Add button, fill out the form as shown in the picture (Pic. 21, A.2), only the code and name. Please note that the plan in the 1C icon has a green dot, and the AGORA has a simple display.


Информация
This step must be performed to store changes to item data.

Image Added

Pic. 21 - Form for creating a new list item

Раскрыть
title1C - UT 11.1 (Old version 2015)

To port the code from the configuration file, follow these steps:     

  • Open the configuration file with a pre-installed gateway (.cf file), which is included in the package.    
  • In the configuration panel and in the configuration file, select DirectoriesNomenclature (Pic. 14, A.1) and open the object module (Pic. 14, A.2). In the search bar, enter Centrobit (Pic. 14, A.3), find and transfer all sections of code from the configuration file to the configuration of the vendor database in the appropriate procedures (Pic. 15)

Image Added

Pic. 14 - Object module selection

Image Added

Pic. 15 - Code transfer

  • In the configuration panel and in the configuration file, select DirectoriesNomenclatureFormsElement shape (Pic. 16, A.1) and go to the Module tab (Pic. 16, A.2). In the search bar, enter Centrobit, find and transfer all portions of the code from the configuration file to the configuration of the provider database in the appropriate procedures.

Image Added

Pic. 16 - Module tab, code transfer

  • In the configuration panel and in the configuration file, select Directories → Nomenclature → Forms → Element form → Open a form (Pic. 17) and go to the Form tab. Transfer the details of the form of the element of the catalog reference book AgoraFormNomenclature and AgoraExchangeStart from the configuration file to the configuration of the supplier base.

Image Added

Pic. 17 - Form tab, transfer of details

  • On the Elements tab, in the FormDataGroup folder, add the AgoraExchange object from the configuration file. Verify that in the Fields Properties window, in the Form line, the value is the Flag field (Pic. 18).



Примечание

For UT 11.2: On the Elements tab, in the CollapsibleGroupMainParametersAccount folder add the AgoraExchange object from the configuration file.

Check that in the Fields Properties window, in the View line, the value is Flag field.

Image Added

Pic. 18 - Adding an Agora Exchange object


  • Update the database configuration by clicking on the icon Image Added on the control panel (Pic. 19).

Image Added

Pic. 19 - Update configuration button

  • Принять изменения в структуре информации конфигурации (Рис.20).

Image Added

Pic. 20 - Changes in the structure of information and configuration

  • Log in to the information base 1C: Enterprise "Trade Management".
  • In the navigation panel, open the context menu and go to All functions. In the window that opens, select Exchange plans → Agora exchange and create new elements of the 1C and AGORA list (it is necessary to store changes in the data on the nomenclature, you need to start in order: 1C, then AGORA). To do this, click on the Create button, fill out the form as shown in the picture (Pic. 22) and click on the Save and Close button (Pic. 22). Please note that the plan in the 1C icon has a green dot, and the AGORA has a simple display.



Информация

This step must be performed to store changes to item data.

Примечание

If you do not have the "All functions" item in the menu, then its display must be enabled by going to the "Tools" menu and to "Parameters".

Image Added

Pic.21 - All functions in the menu bar.

Image Added

Pic. 22 - Form for creating a new list item

Раскрыть
title1C Alpha-auto

In the configuration panel, open General -> Interfaces -> General (Pic. 14, A.1), go to the "Service" tab (Pic. 14, A.2) and, right-clicking, add a new button (Pic. 14, A.3) and then enter the properties of the created button.

Image Added

Pic. 14 - Adding a button to the menu.

In the Properties window that opens, click on the selection of the action (Pic. 15, A.1), then in the window that appears, find the AgoraSettingsDataExchange (Pic. 15, A.2) among the processors and click OK (Pic. 15, A.2).

Image Added

Pic. 15 - Setting the menu button.

  • Be sure to set the friendly name for the created button (Pic. 16).

Image Added

Pic. 16 - Setting the name for the button.

  • Open the module of the StartSystem processing object.
  • Transfer changes to the processing code for Agora, taking them from the configuration file: to the procedure RunCheckFillConstants add the code that ignore AgoraNumberOfMessage constant filling check (Pic. 16.1)

Image Added

Pic. 16.1 - Code for ignoring a constant check

  • Update the database configuration by clicking on the Image Added icon on the control panel (Pic. 17).

Image Added

Pic. 17 - Update configuration button

  • Accept the changes in the structure of the configuration information (Pic. 18).

Image Added

Pic. 18 - Changes in the structure of information and configuration

  • Log in to the information base 1C: Enterprise "Trade Management".
  • In the navigation panel open the menu Tools -> All operations. In the menu window that opens, select the Exchange plan (Pic.19, Cl.1), then click on the "Create nodes" button. Please note that the plan in the 1C icon has a green dot, and the AGORA has a simple display.


Информация

This step must be performed to store changes to item data.

Image Added

Pic. 19 - Form for creating a new list item


For users with versions 1C UT 10.3 (Old version 2015), UT 11.1 (Old version 2015) or Alfa-Auto setup is completed. If your version is different from those listed, follow these steps.

Next, in the configuration panel, go to: General -> Interfaces -> General:

Image Added

In the window that opens, click the Tools button, and the <New> button in the drop-down menu:

Image Added

After that, the item properties panel opens:

Image Added

In the properties that opens, click on the Select action (sign ...), then in the window that appears, find the Processing section, open it and select AgoraSetupDataExchange:

Image Added

After that, specify the name of the added element in its properties. We recommend indicating a friendly name, for example, Agora. Data exchange setup:

Image Added

To update the database configuration, click the Image Added button located on the control panel:

Image Added

After that, a window opens with a description of the changes in the configuration structure, in which click the Accept button:

Image Added

(информация)At the final stage, go to the interface of the information base 1C: Enterprise "Trade Management".

In the interface that opens, open the Operations tab and select the Exchange plan section:

Image Added

In the window that opens, select Agora exchange and click OK:

Image Added

In the window that opens, create new exchange nodes 1C and AGORA (necessary to store changes to the item data)

(информация) The sequence of creating exchange nodes should be as follows: first 1C, then AGORA.

To do this, in the window that opens, click on the displayed exchange plan line (for example, on the Code column) and fill in the Code and Name fields with the phrase 1C (in Russian) in the window that opens, click OK to save the changes.

Image Added

After that, add the AGORA exchange node by clicking the add button Image Added or by going to: ActionsAdd

In the window that opens, specify the Code and Name: AGORA (it is important that all letters are capitalized) and click OK to save the changes:

Image Added

(информация)Please note that the plan in the 1C icon has a green dot, and AGORA is a simple display:

Image Added

After the current setup phase is completed, you need to do a complete upload.

(информация) How to do a full upload with a configured Agora gateway is described in this section.

Якорь
3
3
3. Setting up scheduled tasks

The setting is responsible for the frequency of uploading data to the portal. At this stage, you can set the conditions for data exchange between 1C and Agora services.

Setup is carried out in the 1C: Enterprise interface on the tab:     

  • For UT10.3: Operations → Processing → Agora. Setting Data Exchange.     
  • For UT11.1 (2,3): Partition Panel → Agora.

Image Added

In the window that opens, select Agora. Configure Data Exchange and click OK:

Image Added

After opening the settings for exchanging data with the Agora system, go to the Scheduled Task tab:

Image Added

By default, the exchange interval is 1 minute; if necessary, you can change the exchange interval. To do this, click on the clock icon in the Scheduled Task section:

Image Added

The exchange schedule is responsible for the frequency of uploading data from 1C to the File Storage folder.

Setting the download frequency is carried out on the Daily tab:

Image Added

The exchange schedule with the portal is responsible for the frequency of uploading data from 1C to the portal.

The frequency setting is also carried out on the Daily tab:

Image Added


Предупреждение
If you are using the server version 1C: Enterprise "Trade Management" in the administration settings of the server 1C: Enterprise "Trade Management", you need to make sure that the checkbox "Blocking scheduled tasks" is not 

After completing the scheduled tasks settings, go to the Exchange Settings tab and fill in the following

  • Portal - select a configured exchange node (by default, there is no possibility to change the portal, so select the AGORA pre-installed portal).
  • File storage - create a folder and specify the path to it. All employees working with 1C should have access to the created folder.
  • The number of objects to add to the outgoing exchange file.
  • Website address (without http://) - provided by the support service. In case of questions, send a request to: help@agora.ru
  • License key - provided by customer support. In case of questions, send a request to: help@agora.ru

Credentials to receive notifications of exchange errors.

After setting, click the Image Added button to "link" the database used with the portal exchange service.

After starting the exchange with the portal:

Image Added

The following folders will be created in the specified File Storage:

  • Complete - the archive folder where the files are moved after sending data to the site.
  • Export - the folder where data from the 1C: Enterprise Trade Management system is moved for subsequent sending to the site and moving files to the archive.
  • Img - the folder where data from the 1C: Enterprise "Trade Management" system (images) is moved for subsequent sending to the site and moving files to the archive.
  • Import - the folder where data from the site is moved to further move files to the 1C: Enterprise Trade Management system and archive.
  • Preexport is the system folder.

After the exchange with the portal is completed, in the project administrative panel, available at: project_address.agora.ru/admin, in the Import Exchange Packages section, an array of data loaded from 1C will be displayed, accessible by clicking on the name of the xml file in the File column:

Image Added

Please note that after a complete upload, some time should pass for updating the data on the portal. Typically, the waiting time does not exceed 15 minutes.

(информация) An example of the format for uploading data from 1C is available in this section.

If the data is not uploaded, check the error log in 1C, available as follows:

  • In the drop-down menu All functions (1C version 11) or Operations (1C version 10.3)
  • Go to Processes and select the Log.

This section will display data on errors that occur during the operation of the integration mechanism.


Image Added

(отметить) An example of ordering on the portal and its processing in 1C is available in the Checkout section

Информация

If you have any difficulties or questions during the integration setup, you can always write to our technical support: help@agora.ru and they will certainly help you.

Sv translation
languagept_BR
Предупреждение
Como este sistema ERP não está disponível para o Brasil, esta seção é descrita apenas para usuários da Rússia.
Icon

Данный шаг необходимо выполнить для хранения изменений данных по номенклатуре.

Image Removed

Рис.21 - Форма создания нового элемента списка

...

title1С - УТ 11.1 (Старая версия 2015)

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

  • Открыть файл конфигурации с предустановленным шлюзом (файл формата .cf), который входит в комплект поставки.
  • В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура (Рис.14, П.1) и открыть модуль объекта (Рис.14, П.2). В строку поиска ввести Центробит (Рис.14, П.3), найти и перенести все участки кода из файла конфигурации в конфигурацию базы поставщика в соответствующие процедуры (Рис.15).

Image Removed

Рис.14 - Выбор модуля объекта

Image Removed

Рис.15 - Перенос кода

  • В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура → Формы → Форма элемента (Рис.16, П.1) и перейти на вкладку Модуль (Рис.16, П.2). В строку поиска ввести Центробит, найти и перенести все участки кода из файла конфигурации в конфигурацию базы поставщика в соответствующие процедуры. 

Image Removed

Рис.16 - Вкладка Модуль, перенос кода

  • В панели конфигурации и в файле конфигурации выбрать Справочники → Номенклатура → Формы → Форма элемента → Открыть форму (Рис.17) и перейти на вкладку Форма. Перенести реквизиты формы элемента справочника номенклатуры АгораВидНоменклатуры и АгораОбменНачальная из файла конфигурации в конфигурацию базы поставщика. 

Image Removed

Рис.17 - Вкладка Форма, перенос реквизитов

  • На вкладке Элементы в папку ГруппаДанныеВида добавить объект АгораОбмен из файла конфигурации. Проверить, что в окне Свойства Поля в строке Видстоит значение Поле флажка (Рис.18).
Icon

Для УТ 11.2: На вкладке Элементы в папку СворачиваемаяГруппаОсновныеПараметрыУчета добавить объект АгораОбмен из файла конфигурации. Проверить, что в окне Свойства Поля в строке Вид стоит значение Поле флажка .

 

 

Image Removed

Рис.18 - Добавление объекта АгораОбмен

...

 

Image Removed

Рис.19 - Кнопка Обновить конфигурацию

  • Принять изменения в структуре информации конфигурации (Рис.20).

 

Image Removed

Рис.20 - Изменения в структуре информации и конфигурации

...

Icon

Данный шаг необходимо выполнить для хранения изменений данных по номенклатуре.

Icon

Если у Вас нет в меню пункта "Все функции", то его отображение надо включить войдя в Меню "Сервис", в "Параметры".

Image Removed

Рис.21 - Всё функции в панели меню.

Image Removed

Рис.22 - Форма создания нового элемента списка

...

title1С Альфа-авто
  • В панели конфигурации открыть Общие -> Интерфейсы -> Автосервис(Рис.14, П.1), перейти на вкладку "Сервис" (Рис.14, П.2) и, кликнув правым кликом, добавить новую кнопку (Рис.14, П.3) и затем войти в свойства созданной кнопки.

Image Removed

Рис.14 - Добавление кнопки в меню.

  • В открывшемся окне Свойств, кликните на выбор действия (Рис.15, П.1), затем в появившемся окне найдите среди обработок АгораНастройкаОбменаДанными (Рис.15, П.2) и нажмите ОК (Рис.15, П.2).

Image Removed

Рис. 15 - Настройка кнопки меню.

  • Обязательно задайте понятное имя созданной кнопке (Рис. 16).

Image Removed

Рис. 16 - Задание имени для кнопки.

  • Открыть модуль объекта обработки СтартСистемы.
  • Перенести в код обработки изменения для Агоры, взяв их из файла конфигурации: в процедуру ВыполнитьПроверкуЗаполненияКонстант добавить код игнорирования проверки заполненности константы АгораНомерСообщения(рис 16.1)

Image RemovedРис.16.1 - Код игнорирования проверки на заполненность константы

  • Обновить конфигурацию баз данных, нажав на иконку Image Removed на панели управления (Рис.17).

Image Removed

Рис.17 - Кнопка Обновить конфигурацию

  • Принять изменения в структуре информации конфигурации (Рис.18).

Image Removed

Рис.18 - Изменения в структуре информации и конфигурации

...

Icon

Данный шаг необходимо выполнить для хранения изменений данных по номенклатуре.

Image Removed

Рис.19 - Форма создания нового элемента списка

Для пользователей с версиями  УТ 10.3 (Старая версия 2015)УТ 11.1 (Старая версия 2015) или Альфа-Авто настройка завершена.  Если ваша версия отличается от перечисленных, следуйте дальнейшим действиям.

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

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

Image Removed

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

Image Removed

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

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

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

Image Removed

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

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

Image Removed

(информация) Обратите внимание, что план в значке  имеет зелёную точку, а АГОРА — простое отображение:

Image Removed

Image Removed

...

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

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

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

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

Image Removed

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

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

Image Removed

Предупреждение

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

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

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

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

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

Image Removed

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

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

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

Image Removed

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

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

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

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

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

Image Removed

...