Общие объекты
Общие модули
- АгораAPI - процедуры и функции для формирования содержимого и чтения XML-файла обмена
- АгораВыгрузка - процедуры для выгрузки данных в файл обмена
- АгораЗагрузка - процедуры для загрузки данных из файла обмена
- АгораОбменССайтом - процедуры для отправки и получения файлов наа портал
- АгораОбщий - процедуры общего назначения
- АгораРегистрацияИзменений - процедуры для регистрации объектов в плане обмена
- АгораСерверПовтИсп - модуль с повторным использованием значения для кэширования.
Планы обмена
- АгораОбмен - план обмена для регистрации изменений для выгрузки данных
Подписки на события
- АгораОбъекты - регистрация справочников и документов при записи
- АгораРегистрыПередЗаписью - регистрация изменений регистров сведений
- АгораРегистрыПриЗаписи - регистрация изменений регистров сведений
- АгораУдаление - регистрация удаления справочников и документов
- АгораРегистрыПередЗаписьюСтатусы - регистрация изменений статусов заказов клиентов и расчетов с клиентами
- АгораРегистрыПриЗаписиСтатусы - регистрация изменений статусов заказов клиентов и расчетов с клиентами
- АгораОбъектыПередЗаписью - регистрация изменений иерархических справочников
- АгораДокументыПередЗаписью - не используется, добавлен для возможности расширения
Регламентные задания
- АгораОбмен - формирование файлов обмена, отправка файлов на портал, получение файлов с портала, загрузка данных. Запуск каждые 60 сек
XDTO-пакеты
- Агора - содержит схему формирования XML-файла обмена
Регистры сведений
- АгораЗаказы - для хранения признака заказов, пришедших с портала
- АгораИзмененияЦенОстатков - для регистрации изменений цен и остатков товара
- АгораИсторияОбменаДанными - история обмена с порталом и выгрузки/загрузки данных
- АгораКонтрагенты - для хранения признака контрагентов портала
- АгораНоменклатура - для хранения признака номенклатуры портала
- АгораПакетыОбменаДанными - для хранения сформированных и полученных файлов обмена
- АгораПараметры - для хранения параметров работы шлюза
- АгораСтатусыЗаказов - статусы заказов для портала
- АгораСтатусыОбъектов - статусы произвольных объектов, не используется
Обработки
- АгораНастройкаОбменаДанными - настройка шлюза
- АгораПолнаяВыгрузка - регистрация и выгрузка данных на портал
Работа со схемой данных
Для каждого объекта метаданных, для которого необходим обмен с порталом требуется описать свойство в типе AgoraMessage:
Имя свойства должно совпадать с именем метаданных объекта, локальное имя может использоваться, если для портала требуется изменить имя свойства при выгрузке.
Имя типа свойства должно совпадать с именем метаданных.
Для объектов также должны быть заданы свойства для выгруки на портал + свойство "ВремяИзменения". При выгрузке по умолчанию заполняется текущей датой.
Табличные части объектов описываются свойством вида <Имя табличной части>_add_<Имя объекта-владельца> и имеют одно свойство вида <Имя табличной части>Строка_add_<Имя объекта-владельца>, с заданным локальным именем "Строка":
Если для определения значения свойства требуется дополнительные преобразования или вызов кода 1С, то в имени свойства добавляется префикс "f_" и задается локальное имя:
В таком случае в общем модуле АгораAPI должна быть описана экспортная функция с именем, совпадающим с именем свойства, которая возвращает значение свойства для выгрузки в XML. Параметр процедуры - Структура с ключами ИмяОбъекта, Объект, ОбъектСтруктура. TODO: добавить сноску на подробное описание
Регистрация данных
Регистрация происходит в подписках на события при записи объектов. Для некоторых объектов применяются фильтры при регистрации:
Справочник "Контрагенты"
Для выгрузки регистрируются только те контрагенты, для которых присутствует запись в регистре "АгораКонтрагенты". Запись автоматически добавляется при загрузке контрагента с портала.
Справочник "Номенклатура", Справочник "ХарактеристикиНоменклатуры"
Для выгрузки регистрируются только та номенклатура, для которой присутствует запись в регистре "АгораНоменклатура" и ресурс "Вид флажка" равен 1. Регистрация характеристик происходит аналогично, с проверкой по номенклатуре.
Документ "ЗаказКлиента", Документ "СверкаВзаиморасчетов"
Для выгрузки регистрируются только те документы, для которых есть запись в регистре "АгораЗаказы". Запись автоматически добавляется при загрузке документа с портала.