| Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Для настройки интеграции с системой, содержащей информацию о товарах и их свойствах, необходимо выполнить следующие действия:
Видео-инструкция по настройке интеграции с 1С 8.3 УТ 11.4
Видео-инструкция по настройке интеграции с 1С 8.3 УТ 10.3
Первое, что необходимо сделать - скачать комплект поставки Agora, соответствующей используемой редакции 1С, который включает 1 файл:
Для загрузки нажмите на наименование необходимого комплекта поставки.
После загрузки комплекта поставки можно переходить к этапу настройки загруженного шлюза в 1С. Якорь |
|
| Раскрыть | ||
|---|---|---|
| ||
Для портирования кода из файла конфигурации выполнить следующие шаги:
Рис.15 - Создание ФлагАгораОбмен.
Рис.16 - Добавление кнопки в меню.
Рис. 17 - Настройка кнопки меню.
Рис. 18 - Задание имени для кнопки.
Рис.19 - Кнопка Обновить конфигурацию
Рис.20 - Изменения в структуре информации и конфигурации
Рис.21 - Форма создания нового элемента списка |
| Раскрыть | ||
|---|---|---|
| ||
Для портирования кода из файла конфигурации выполнить следующие шаги:
Рис.14 - Выбор модуля объекта
Рис.15 - Перенос кода
Рис.16 - Вкладка Модуль, перенос кода
Рис.17 - Вкладка Форма, перенос реквизитов
Рис.18 - Добавление объекта АгораОбмен
Рис.19 - Кнопка Обновить конфигурацию
Рис.20 - Изменения в структуре информации и конфигурации
Рис.21 - Всё функции в панели меню.
Рис.22 - Форма создания нового элемента списка |
| Раскрыть | ||
|---|---|---|
| ||
Рис.14 - Добавление кнопки в меню.
Рис. 15 - Настройка кнопки меню.
Рис. 16 - Задание имени для кнопки.
Рис.16.1 - Код игнорирования проверки на заполненность константы
Рис.17 - Кнопка Обновить конфигурацию
Рис.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
- Учетные данные для получения оповещений о ошибках в обмене.
После настройки нажмите кнопку 
для "связки" используемой базы данных со службой обмена портала.
После запуска обмена с порталом:
В указанном Хранилище файлов будут созданы следующие папки:
- Complete — папка архива, куда перемещаются файлы после отправки данных на сайт.
- Export — папка, куда перемещаются данные из системы 1С:Предприятие "Управление торговлей" для последующей отправки на сайт и перемещения файлов в архив.
- Img — папка, куда перемещаются данные из системы 1С:Предприятие "Управление торговлей" (изображения) для последующей отправки на сайт и перемещения файлов в архив.
- Import — папка, куда перемещаются данные с сайта для дальнейшего перемещения файлов в систему 1С:Предприятие "Управление торговлей" и архив.
- Preexport — системная папка.
После окончания обмена с порталом, в административной панели проекта, доступной по адресу: адрес_проекта.agora.ru/admin в разделе Пакеты обмена Импорта будет отображаться массив данных, загружаемый из 1С, доступный при нажатии на имя xml-файла в колонке Файл:
Обратите внимание, после полной выгрузки должно пройти какое-то время для актуализации данных на портале. Как правило, время ожидания не превышает 15 минут.
Пример формата выгружаемых данных из 1С доступен в этом разделе.
Если данные не выгружены, проверьте журнал регистрации ошибок в 1С, доступный следующим образом:
- В выпадающем меню Все функции (1С версии 11) или Операции (1С версии 10.3).
- Перейдите в Обработки и выберите Журнал регистрации.
В данном разделе будут отображаться данные о возникающих ошибках при работы механизма интеграции.
Наглядный пример оформления заказа на портале и его обработка в 1С доступен в разделе Оформление заказа
| Информация |
|---|
Если у вас возникли трудности или вопросы в ходе настройки интеграции, вы всегда можете написать в нашу техническую поддержку: help@agora.ru и вам обязательно помогут. |
| Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
To configure integration with a system containing information about products and their properties, you must perform the following steps:
|
| Якорь | ||||
|---|---|---|---|---|
|
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
| 2 | |
| 2 |
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:
In the window that opens, open the Administration tab and go to the Unload infobase section:
In the window that opens, specify the path to save the infobase:
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:
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:
In the window that opens, specify the path to save a copy of the 1C configuration:
In the case of a successful save, a notification of the form:
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:
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:
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:
After clicking on the Yes button, the support rule settings window opens, where specify the following parameters and click OK:
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:
In the window that opens, select Provider objects are edited while maintaining support. Leave unselected Set for subordinate objects and click OK:
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:
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:
After that, mark Agora as a subsystem. Click the Actions button and go to the Mark by file subsystems section:
In the window that opens, leave only the Agora subsystem selected and click Install:
Then merge the code by clicking the Run button:
| Раскрыть | ||||
|---|---|---|---|---|
| ||||
To port the code from the configuration file, follow these steps:
Pic. 14 - Module tab, code transfer
Pic. 15 - Creating a FlagAgoreExchange.
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),
Рic. 17 - Setting the menu button.
Pic. 18 - Setting the name for the button.
Pic. 19 - Update configuration button
Pic. 20 - Changes in the structure of information and configuration
Pic. 21 - Form for creating a new list item |
| Раскрыть | ||||||
|---|---|---|---|---|---|---|
| ||||||
To port the code from the configuration file, follow these steps:
Pic. 14 - Object module selection
Pic. 15 - Code transfer
Pic. 16 - Module tab, code transfer
Pic. 17 - Form tab, transfer of details
Pic. 18 - Adding an Agora Exchange object
Pic. 19 - Update configuration button
Pic. 20 - Changes in the structure of information and configuration
Pic.21 - All functions in the menu bar.
Pic. 22 - Form for creating a new list item |
| Раскрыть | ||
|---|---|---|
| ||
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.
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).
Pic. 15 - Setting the menu button.
Pic. 16 - Setting the name for the button.
Pic. 16.1 - Code for ignoring a constant check
Pic. 17 - Update configuration button
Pic. 18 - Changes in the structure of information and configuration
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:
In the window that opens, click the Tools button, and the <New> button in the drop-down menu:
After that, the item properties panel opens:
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:
After that, specify the name of the added element in its properties. We recommend indicating a friendly name, for example, Agora. Data exchange setup:
To update the database configuration, click the button located on the control panel:
After that, a window opens with a description of the changes in the configuration structure, in which click the Accept button:
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:
In the window that opens, select Agora exchange and click OK:
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.
After that, add the AGORA exchange node by clicking the add button or by going to: Actions → Add
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:
Please note that the plan in the 1C icon has a green dot, and AGORA is a simple display:
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
| 3 | |
| 3 |
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.
In the window that opens, select Agora. Configure Data Exchange and click OK:
After opening the settings for exchanging data with the Agora system, go to the Scheduled Task tab:
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:
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:
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:
| Предупреждение |
|---|
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 button to "link" the database used with the portal exchange service.
After starting the exchange with the portal:
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:
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.
| Информация |
|---|
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. |