Произвольный конфигурации, реализованной на платформе 1С:Предприятие 8.
Порядок работы
При применении управляемой формы обработка имеет два порядок работы:
1. На клиенте. При применении этого режима файлы правил и загружаемых данных будут переданы с клиента на сервер, а файл выгружаемых данных передается с сервера на клиент. Пути к этим файлам, находящимся на клиенте, требуется задавать в открывающемся окне прямо перед исполнением действия.
2. На сервере. В данном варианте файлы не будут переданы на клиент и пути к ним требуется задавать на сервере.
Примечание: Файл внешней обработки и файлы протоколов обмена всегда обязаны находиться на сервере вне зависимости от режима работы.
Обработка имеет четыре закладки
Выгрузка данных
Для осуществления выгрузки данных требуется определить наименование файла, в который будет происходить выгрузка данных и указать файл правил обмена. Правила обмена для любых конфигураций имеют возможность быть настроены в особой конфигурации "Конвертация данных, редакция 2".
Для выгрузки документов и записей независимых периодических регистров сведений требуется определить промежуток
- "Дату начала" и "Дату завершения". Результирующий файл с выгруженными данными имеет возможность быть сжат.
На панели "Правила выгрузки данных" допустимо указать те типы объектов, которые обязаны выгружаться, настроить отборы для выборки объектов, или определить узел обмена данными, для которого требуется выгружать данные.
На панели "Реквизиты выгрузки" допустимо определить добавочные реквизиты выгрузки данных.
На панели "Комментарий" допустимо написать произвольный текст-комментарий, включаемый в файл обмена.
Для осуществления загрузки данных требуется определить наименование файла, из которого будет происходить загрузка данных.
Есть возможность настроить загрузку данных в транзакции. Для этого требуется взвести флаг "Использовать транзакции" и определить количество элементов в одной транзакции при загрузке.
"Загружать данные в варианте обмена (ОбменДанными.Загрузка = Истина)" – если флажок выставлен, то загрузка объектов будет выполнятся с заданным признаком загрузки. Это значит, что при записи объектов в базу данных будут отключены все платформенные и прикладные проверки. Исключение составляют документы, которые фиксируются в варианте проведения либо отмены проведения. Проведение и отмена проведения документа производится всегда без назначения режима загрузки, т.е. проверки будут производиться.
Добавочные настройки
Панель предназначен для детальной настройки выгрузки и загрузки данных.
"Порядок отладки" – флажок для задания режима отладки обмена. Если данный флажок выставлен, то механизм обмена данными не будет остановлен при возникновении какой-или ошибки. Обмен завершится до конца с выводом отладочных сообщений в файл протокола обмена. Данный порядок советуется применять при отладке правил обмена.
"Вывод информационных сообщений в окно сообщений" – если флажок выставлен, то в окно сообщений будет отображаться протокол процесса обмена данными.
"Количество обработанных объектов для обновления статуса" – реквизит предназначен для вычисления количества обработанных элементов перед редактированием строчки состояние загрузки/выгрузки
"Настройки выгрузки данных" – разрешают назначить количество элементов обрабатываемых в одной транзакции при выгрузке данных, выгружать и обрабатывать лишь те объекты, на которые есть права доступа, настроить тип редактирования фиксации для выгруженных объектов через планы обмена.
"Использовать оптимизированный формат для обмена данными (V8 - V8, версия обработки не ниже 2.0.18)" – оптимизированный формат сообщения обмена предполагает наличие узла "ИнформацияОТипахДанных" в заголовке сообщения, в который выгружается информация о типах данных. Это разрешает ускорить механизм загрузки данных.
"Использовать транзакции при выгрузке для планов обмена" – флажок задает порядок применения транзакций при выгрузке данных при выборке корректировок на узлах планов обмена. Если флажок выставлен, то выгрузка данных будет производиться в транзакции.
"Количество элементов в транзакции" – задает максимальное число элементов данных, которые помещаются в сообщение в границах одной транзакции базы данных. Если содержимое параметра идентично 0 (содержимое по умолчанию), то все данные помещаются в границах одной транзакции. Такой порядок есть рекомендуемым, так как гарантирует согласованность данных, помещаемых в сообщение. Однако при создании сообщения в многопользовательском варианте имеют возможность быть конфликты блокировок промеж транзакцией, в которой данные помещаются в сообщение, и транзакциями, выполняемыми иными пользователями. Для снижения вероятности появления подобных конфликтов допустимо определить содержимое этого параметра, отличное от значения по умолчанию. Чем меньше содержимое параметра, тем меньше вероятность конфликта блокировок, однако выше вероятность помещения в сообщение несогласованных данных.
"Выгружать объекты на которые есть права доступа" – если флажок выставлен, то выборка объектов информационной базы будет производиться учитывая прав доступа данного пользователя программы. Это предполагает применение литерала "РАЗРЕШЕННЫЕ" в тексте запроса для выборки данных.
"Автоматом удалять недопустимые символы из строчек для записи в XML" – если флажок выставлен, то при записи данных в сообщение обмена недопустимые символы будут удалены. Символы анализируются на соотношение рекомендации XML 1.0.
"Редактирования фиксации для узлов обмена после выгрузки" – поле задает порядок работы с регистрацией корректировок данных после завершения выгрузки данных. Допустимые значения:
* Не удалять регистрацию – после выгрузки данных фиксирование корректировок на узле удалена не будет.
* Целиком убрать регистрацию для узла обмена – после выгрузки данных фиксирование корректировок на узле будет целиком удалена.
* Убрать регистрацию лишь для выгруженных метаданных – после выгрузки данных фиксирование корректировок на узле будет удалена лишь для объектов метаданных, которые были заданы к выгрузке.
"Протокол обмена" – разрешает настроить вывод информационных сообщений в окно сообщений, ведение и запись в отдельный файл протокола обмена.
"Наименование файла, протокола обмена" – наименование файла для отображения протокола процесса обмена данными.
"Протокол загрузки (для COM - соединения)" – наименование файла для отображения протокола процесса обмена данными в базе-приемнике при обмене через COM-соединение. Обратите внимание: путь к файлу обязан быть доступен с компьютера, на котором определена база-приемник.
"Дописывать данные в протокол обмена" – если флажок выставлен, то содержимое файла протокола обмена сохраняется, если файл протокола уже имеется.
"Вывод в протокол информационных сообщений" – если флажок выставлен, то в протокол обмена будут отображаться сообщения информативного характера, кроме сообщений об ошибках обмена.
"Открывать файлы протоколов обмена после исполнения операций" – если флажок выставлен, то после исполнения обмена данными файлы протоколов обмена будут автоматом открыты для чтения.
Удаление данных
Панель нужна лишь для разработчиков правил обмена. Разрешает удалять из информационной базы любые объекты.
Отладка выгрузки и загрузки данных
Обработка разрешает совершать отладку обработчиков событий и генерировать модуль отладки из файла-правил либо файла-данных.
Включение режима отладки обработчиков выгрузки выполняется на панели "Выгрузка данных" установкой флага "Порядок отладки обработчиков выгрузки". Соответственно, на панели "Загрузка данных" включение режима отладки загрузки выполняется установкой флага "Порядок отладки обработчиков загрузки".
После назначения режима отладки обработчиков станет доступной кнопка настройки отладки. После нажатия на данную кнопку появится окно настройки.
Настройка отладки обработчиков производится в четыре шага:
Шаг 1: Выбор режима отладки алгоритмов
На первом шаге требуется определиться с режимом отладки алгоритмов:
* Без отладки алгоритмов
* Вызывать мехенизмы как процедуры
* Подставлять код алгоритмов по месту вызова
Первый порядок удобно применять, когда мы досконально знаем, что ошибка в обработчике не связана с кодом какого-или алгоритма. В данном варианте код алгоритмов не выгружается в модуль отладки. Мехенизмы делаются в контексте оператора "Выполнить()" и их код недоступен для отладки.
Второй порядок требуется применять в тех ситуациях, когда ошибка располагается в коде алгоритма. Во время задания этого режима мехенизмы будут выгружены как определенные процедуры. В миг вызова алгоритма из какого-или обработчика выполняется обращение к соотносящейся процедуре обработки. Данный порядок удобно применять, когда для передачи реквизитов в мехенизмы применяется глобальная переменная "Реквизиты". Ограничения применения этого режима в том, что при отладке в алгоритме недоступны локальные переменные обработчика, из которого он открывается.
Третий порядок отладки применяется, как и во втором случае, при отладке кода алгоритмов и в тех ситуациях, при которых второй порядок отладки не подходит. Во время задания этого режима мехенизмы будут выгружены как интегрированный код в обработчиках. Т.е. взамен оператора вызова алгоритма вставляется полный код алгоритма учитывая вложенных алгоритмов. В данном варианте нет ограничений на применение локальных переменных обработчика, при этом есть ограничение при отладке алгоритмов с рекурсивным вызовом.
Шаг 2: Создание модуля отладки
На втором шаге требуется сделать выгрузку обработчиков нажатием на кнопку "Сформировать модуль отладки выгрузки (загрузки)". Сформированные обработчики и мехенизмы будут отображены в отдельное окно для чтения. Содержимое модуля отладки требуется задублировать в буфер обмена нажатием на кнопку "Копировать в буфер обмена".
Шаг 3: Создание внешней обработки
На данном шаге требуется запустить конфигуратор и внести вновь созданную внешнюю обработку. В модуль обработки требуется вставить содержимое буфера обмена (модуль отладки) и сохранить обработку под любым именем.
Шаг 4: Подключение внешней обработки
На четвертом, завершающем шаге, надо определить наименование файла внешней обработки в поле ввода. В то же время 1с делает проверку по времени создания (обновления) файла обработки. Если обработка имеет более раннюю версию, чем версия файла модуля отладки, то будет выведено предупреждение и форма настройки закрыта не будет.
Примечание: Возможность отладки глобального обработчика конвертации "После загрузки правил обмена" не поддерживается.
Печать (Ctrl+P)
Подсистема «Обмен данными» библиотеки стандартных подсистем содержит 4 варианта (технологии) обмена информацией между различными информационными базами:
В этой статьи рассматривается технология обмена данными через универсальный формат EnterpriseData . Данная технология доступна в “Библиотеке стандартных подсистем”, начиная с версии 2.3.1.62. выпущенной в начале 2016 году. На текущий момент, последняя редакция БСП 2.3 (для использования с платформой “1С:Предприятие 8.3” не ниже версии 8.3.8.1652 с отключенным режимом совместимости) имеет релиз 2.3.6.17 .
Рис. 1 Последние релизы БСП 2.3
Среди файлов поставки прикладных решений 1С имеется текстовый файл “Версии библиотек”, где написана на базе какой версии БСП разработано приложение, например, на основе прикладного решения УТ 11.3.3.231 легло БСП 2.3.5.65.
Отметим, что для использования с платформой “1С:Предприятие 8.3” не ниже версии 8.3.10.2168 с отключенным режимом совместимости выпущена редакция БСП 2.4.
Это формат, позволяющий описать объект информационной базы (контрагента, накладную и т.п.) или сообщить о факте удаления этого объекта. Ожидается, что конфигурация, получившая файл в формате EnterpriseData, отреагирует соответствующим образом – создаст у себя новые объекты и удалит те, которые в файле помечены как удаленные. Он предназначен для обмена информацией между конфигурациями УТ, РТ, УНФ, БП. Также формат может использоваться для обмена информацией с любыми другими информационными системами: он не зависит от особенностей собственного программного обеспечения или структур информационных баз, которые участвуют в обмене и не содержит в себе явных ограничений использования.
Данные формата хранятся в XDTO – пакетах в ветки общие конфигурации базы данных, как показано на рис. 2
На рис. 2 видно, что существуют несколько XDTO – пакетов. Это разные версии формата. Номер версии формата состоит из X.Y.Z, где X.Y – версия, Z – это Minor версия. Minor версия увеличивается в случае исправления ошибок и прочих изменениях, при которых: сохраняется работоспособность логики конвертации данных, основанной на предыдущей версии формата (сохранение обратной совместимости текущих алгоритмов передачи данных через формат); поддержка новых возможностей формата для логики конвертации носит добровольный характер. Примером таких изменений может быть исправление ошибки, изменения свойств объектов формата, добавление свойств, использование которых при конвертации данных не является обязательным. В остальных случаях при изменении формата увеличивается Major версия: X – в случае глобальной реструктуризации, Y – в остальных случаях.
Формат описывает представление объектов (документов или элементов справочников) в виде XML-файлов. Версия 1.0.1 содержит описание 94-х объектов из различных областей (финансы, производство, закупки и продажи, складские операции). Названия типов, как правило, хорошо понятны и не нуждаются в дополнительных объяснениях: например, «Документ.АктВыполненныхРабот» или «Справочник.Контрагенты». Как можно заметить, описание типов документов начинается с префикса «Документ.», элемента справочника – с префикса «Справочник.». Подробнее описание формата можно посмотреть
Последняя версия 1.3, однако, чаще всего используется версия 1.0. Нет большой разницы между версиями. Формат EnterpriseDataExchange_1_0_1_1
используется при обмене через веб-сервис.
Отметим,
что вместе с пакетом формата данных EnterpriseData используется пакет ExchangeMessage
при создании правилах конвертации. Именно этот пакет содержит тип объект AdditionalInfo,
который может иметь любой тип значения и используется при при создании правила конвертации между объектами конфигураций. которые отсутствуют в формате данных. Именно, благодаря AdditionalInfo,
можно адаптировать и настраивать правила обмена без изменения данных формата в XDTO-пакетах.
Обмен данными в формате EnterpriseData с конфигурацией – это обмен файлами. В ответ на полученный от внешнего приложения файл конфигурация обработает его и создаст файл-ответ. Обмен файлами может происходить:
Примечание . Для двустороннего обмена данными между сторонним приложением и конфигурацией на стороне информационной базы должен быть сделан ряд настроек – стороннее приложение должно быть зарегистрировано в информационной базе, для него должен быть определен канал обмена (через файловый или FTP-каталог) и т.п. Но для случаев простой интеграции, когда достаточно только передавать информацию от стороннего приложения в информационную базу и обратной передачи данных из информационной базы в стороннее приложение не требуется (например, интеграция онлайн-магазина, передающего информацию о продажах в «1С:Бухгалтерию»), есть упрощенный вариант работы через веб-сервис, не требующий настроек на стороне.
При обмене с использованием планов обмена конфигурации в ходе синхронизации передают только информацию об изменениях, произошедших со времени последней синхронизации (чтобы минимизировать объем передаваемой информации). При первой синхронизации конфигурация выгрузит все объекты в формате EnterpriseData в XML-файл (поскольку все они являются «новыми» для стороннего приложения).
Следующий шаг за сторонним приложением – оно должно обработать информацию из XML-файла и при следующем сеансе синхронизации поместить в секцию
После получения сообщения-квитанции конфигурация помечает все изменения, переданные в предыдущем сообщении, как успешно синхронизированные. Лишь несинхронизированные изменения в объектах (создание новых, изменение и удаление существующих) будут отправлены во внешнее приложение при следующем сеансе синхронизации.
При передаче данных от внешнего приложения в конфигурацию картина меняется на обратную. Приложение должно заполнить секцию
Конфигурация после обработки файла сформирует XML-файл, который будет содержать сообщение-квитанцию и новые данные для синхронизации со стороны конфигурации (если такие есть со времени последнего сеанса синхронизации).
Более подробно об обмен данными с прикладными решениями на платформе «1С:Предприятие» в формате EnterpriseData можно посмотреть
Процедуры и функции, полностью описывающие правила выгрузки данных из информационной базы в формат обмена и правила загрузки данных из формата обмена в информационную базу, разрабатываются в общем модуле – модуле менеджера обмена через универсальный формат.
Модуль создается автоматически с помощью конфигурации «Конвертация данных», редакция 3.0, на основе настроенных правил обмена либо вручную в конфигураторе.
Модуль состоит из нескольких крупных разделов, каждый из которых содержит свою группу процедур и функций.
Ниже описаны параметры процедур и функций, которые используются в нескольких видах процедур модуля менеджера.
КомпонентыОбмена. Тип – Структура . Содержит параметры и правила обмена, инициализированные в рамках выполнения сеанса обмена.
НаправлениеОбмена. Тип – Строка . Либо «Отправка», либо «Получение».
ДанныеИБ. Тип – СправочникОбъект либо ДокументОбъект .
Процедуры, связанные с событиями конвертации
Предусмотрены три предопределенные процедуры, которые вызываются в процессе конвертации:
Процедуры ПОД
ЗаполнитьПравилаОбработкиДанных. Экспортная процедура, в которой располагается логика заполнения правил обработки данных. Содержит вызовы других процедур, которые добавляют в таблицу правил правило обработки конкретного объекта (см. ниже процедуры ДобавитьПОД ). Параметры: НаправлениеОбмена , ПравилаОбработкиДанных
ДобавитьПОД_<ИмяПОД>. Набор процедур, которые наполняют таблицу ПОД правилами для конкретных объектов. Количество таких процедур соответствует количеству ПОД, предусмотренных для данной конвертации в программе «Конвертация данных», редакция 3.0. Параметры: ПравилаОбработкиДанных (таблица значений, инициализированная в рамках выполнения сеанса обмена).
ПОД_<ИмяПОД>_ПриОбработке. Процедура содержит текст обработчика ПриОбработке для конкретного ПОД. Обработчик предназначен для реализации логики конвертации на уровне объектов. Например, назначить конкретному объекту определенное ПКО в зависимости от содержимого объекта. Параметры:
ПОД_<ИмяПОД>_ВыборкаДанных. Функция содержит текст обработчика ПриВыгрузке . Обработчик предназначен для реализации произвольного алгоритма выборки объектов, подлежащих выгрузке. Возвращаемое значение: массив объектов, подлежащих выгрузке. В массиве могут содержаться как ссылки на объекты информационной базы, так и структура с данными для выгрузки. Параметры: КомпонентыОбмена .
Процедуры ПКО
ЗаполнитьПравилаКонвертацииОбъектов. Экспортная процедура, в которой располагается логика заполнения правил конвертации объектов. Содержит вызовы других процедур, которые добавляют в таблицу правил правило конвертации конкретного объекта (см. ниже процедуры ДобавитьПКО ). Параметры: НаправлениеОбмена , ПравилаКонвертации (таблица значений, инициализированная в рамках выполнения сеанса обмена).
ДобавитьПКО_<ИмяПКО>. Набор процедур, которые наполняют таблицу ПКО правилами для конкретных объектов. Количество таких процедур соответствует количеству ПКО, предусмотренных для данной конвертации в программе «Конвертация данных», редакция 3.0. Параметры: ПравилаКонвертации (таблица значений, инициализированная в рамках выполнения сеанса обмена).
ПКО_<ИмяПКО>_ПриОтправкеДанных. Процедура содержит текст обработчика ПриОтправке для конкретного ПКО. Обработчик используется при выгрузке данных. Предназначен для реализации логики конвертации данных, содержащихся в объекте информационной базы, в описание объекта XDTO. Параметры:
ПКО_<ИмяПКО>_ПриКонвертацииДанныхXDTO. Процедура содержит текст обработчика ПриКонвертацииДанныхXDTO для конкретного ПКО. Обработчик используется при загрузке данных. Предназначен для реализации произвольной логики конвертации данных XDTO. Параметры:
ПКО_<ИмяПКО>_ПередЗаписьюПолученныхДанных. Процедура содержит текст обработчика ПередЗаписьюПолученныхДанных для конкретного ПКО. Обработчик используется при загрузке данных. Предназначена для реализации дополнительной логики, которую необходимо выполнить перед записью объекта в информационную базу. Например, нужно ли загрузить изменения в существующие данные ИБ либо следует загрузить их как новые данные. Параметры:
Записывается в случае, если эти данные являются для информационной базы новыми (параметр ДанныеИБ содержит значение Неопределено ).
В противном случае ПолученныеДанные замещают собой ДанныеИБ (все свойства из ПолученныеДанные переносятся в ДанныеИБ ).
Если стандартное замещение данных ИБ полученными данными не требуется, следует прописать свою логику переноса, после чего установить параметру ПолученныеДанные значение Неопределено :
Процедуры ПКПД
ЗаполнитьПравилаКонвертацииПредопределенныхДанных . Экспортная процедура, в которой располагается логика заполнения правил конвертации предопределенных данных. Параметры: НаправлениеОбмена , ПравилаКонвертации (таблица значений, инициализированная в рамках выполнения сеанса обмена).
Алгоритмы
В программе «Конвертация данных», редакция 3.0 есть возможность создавать произвольные алгоритмы, которые вызываются из обработчиков ПОД и ПКПД. Наименование, параметры и содержимое алгоритмов определяются при разработке правил.
Параметры
ЗаполнитьПараметрыКонвертации. Экспортная процедура, в которой происходит заполнение структуры с параметрами конвертации. Параметры: ПараметрыКонвертации (тип – Структура ).
Процедуры и функции общего назначения
ВыполнитьПроцедуруМодуляМенеджера. Параметры: ИмяПроцедуры (строка), Параметры (структура). Экспортная процедура, которая предназначена для вызова неэкспортной процедуры модуля, имя и параметры которой получены на вход. Позволяет выполнить вызов процедуры или функции по строке без использования метода Выполнить .
ВыполнитьФункциюМодуляМенеджера. Параметры: ИмяПроцедуры (строка), Параметры (структура). Функция, назначение аналогично ВыполнитьПроцедуруМодуляМенеджера . Отличие в том, что она вызывает функцию и возвращает ее значение.
Последние изменение: 01.09.2015
Выберите уточнение:
Универсальный обмен данными предназначен для загрузки и выгрузки данных в файл в формате XML между разными конфигурациями 1С по настроенным правилам обмена.
Номенклатура, штрихкоды, основные средства и т.д. будут загружаться из стандартных конфигураций 1С в базу Клеверенс: Учет имущества, и наоборот, из базы Клеверенс: Учет имущества в рабочую базу клиентов будет выгружаться инвентаризация, номенклатура, подразделения и т.д.
Обработка имеет два режима работы:
На клиенте. При использовании этого режима файлы правил и загружаемых данных передаются с клиента на сервер, а файл выгружаемых данных передается с сервера на клиент. Пути к этим файлам, находящимся на клиенте, необходимо указывать в диалоговом окне непосредственно перед выполнением действия.
На сервере. В этом режиме файлы не передаются на клиент и пути к ним необходимо указывать на сервере.
Файл внешней обработки и файлы протоколов обмена всегда должны находиться на сервере вне зависимости от режима работы.
Порядок выгрузки данных:
Выгрузка в файл обмена.
Указываем имя файла, в который будет осуществляться выгрузка данных. Результирующий файл с выгруженными данными может быть сжат.
Подключение и выгрузка данных в ИБ приемник.
Выбираем тип информационной базы:
Выбираем платформу 1С и каталог информационной базы для подключения.
На закладке «Выгружаемые данные» можно выбрать те типы объектов, которые должны выгружаться, настроить отборы для выборки объектов, либо указать узел обмена данными, для которого нужно выгружать данные.
На закладке «Параметры выгрузки» можно указать дополнительные параметры выгрузки данных.
На закладке «Комментарий» можно написать произвольный текст-комментарий, включаемый в файл обмена.
Для осуществления загрузки данных необходимо указать имя файла, из которого будет осуществляться загрузка данных, если при выгрузке вводился пароль для сжатия, то нужно указать его для распаковки.
«Режим отладки обработчиков загрузки» рекомендуется использовать только разработчикам !
Закладка служит для детальной настройки выгрузки и загрузки данных.
Закладка нужна только для разработчиков правил обмена. Позволяет удалять из информационной базы произвольные объекты.
Обработка "Универсальный обмен данными в формате XML" назначена для загрузки и выгрузки данных в файл из произвольный конфигурации, реализованной на платформе 1С:Предприятие 8.
Порядок работы
При применении управляемой формы обработка имеет два порядок работы:
1. На клиенте. При применении этого режима файлы правил и загружаемых данных будут переданы с клиента на сервер, а файл выгружаемых данных передается с сервера на клиент. Пути к этим файлам, находящимся на клиенте, требуется задавать в открывающемся окне прямо перед исполнением действия.
2. На сервере. В данном варианте файлы не будут переданы на клиент и пути к ним требуется задавать на сервере.
Примечание: Файл внешней обработки и файлы протоколов обмена всегда обязаны находиться на сервере вне зависимости от режима работы.
Обработка имеет четыре закладки
Выгрузка данных
Для осуществления выгрузки данных требуется определить наименование файла, в который будет происходить выгрузка данных и указать файл правил обмена. Правила обмена для любых конфигураций имеют возможность быть настроены в особой конфигурации "Конвертация данных, редакция 2".
Для выгрузки документов и записей независимых периодических регистров сведений требуется определить промежуток
- "Дату начала" и "Дату завершения". Результирующий файл с выгруженными данными имеет возможность быть сжат.
На панели "Правила выгрузки данных" допустимо указать те типы объектов, которые обязаны выгружаться, настроить отборы для выборки объектов, или определить узел обмена данными, для которого требуется выгружать данные.
На панели "Реквизиты выгрузки" допустимо определить добавочные реквизиты выгрузки данных.
На панели "Комментарий" допустимо написать произвольный текст-комментарий, включаемый в файл обмена.
Для осуществления загрузки данных требуется определить наименование файла, из которого будет происходить загрузка данных.
Есть возможность настроить загрузку данных в транзакции. Для этого требуется взвести флаг "Использовать транзакции" и определить количество элементов в одной транзакции при загрузке.
"Загружать данные в варианте обмена (ОбменДанными.Загрузка = Истина)" – если флажок выставлен, то загрузка объектов будет выполнятся с заданным признаком загрузки. Это значит, что при записи объектов в базу данных будут отключены все платформенные и прикладные проверки. Исключение составляют документы, которые фиксируются в варианте проведения либо отмены проведения. Проведение и отмена проведения документа производится всегда без назначения режима загрузки, т.е. проверки будут производиться.
Добавочные настройки
Панель предназначен для детальной настройки выгрузки и загрузки данных.
"Порядок отладки" – флажок для задания режима отладки обмена. Если данный флажок выставлен, то механизм обмена данными не будет остановлен при возникновении какой-или ошибки. Обмен завершится до конца с выводом отладочных сообщений в файл протокола обмена. Данный порядок советуется применять при отладке правил обмена.
"Вывод информационных сообщений в окно сообщений" – если флажок выставлен, то в окно сообщений будет отображаться протокол процесса обмена данными.
"Количество обработанных объектов для обновления статуса" – реквизит предназначен для вычисления количества обработанных элементов перед редактированием строчки состояние загрузки/выгрузки
"Настройки выгрузки данных" – разрешают назначить количество элементов обрабатываемых в одной транзакции при выгрузке данных, выгружать и обрабатывать лишь те объекты, на которые есть права доступа, настроить тип редактирования фиксации для выгруженных объектов через планы обмена.
"Использовать оптимизированный формат для обмена данными (V8 - V8, версия обработки не ниже 2.0.18)" – оптимизированный формат сообщения обмена предполагает наличие узла "ИнформацияОТипахДанных" в заголовке сообщения, в который выгружается информация о типах данных. Это разрешает ускорить механизм загрузки данных.
"Использовать транзакции при выгрузке для планов обмена" – флажок задает порядок применения транзакций при выгрузке данных при выборке корректировок на узлах планов обмена. Если флажок выставлен, то выгрузка данных будет производиться в транзакции.
"Количество элементов в транзакции" – задает максимальное число элементов данных, которые помещаются в сообщение в границах одной транзакции базы данных. Если содержимое параметра идентично 0 (содержимое по умолчанию), то все данные помещаются в границах одной транзакции. Такой порядок есть рекомендуемым, так как гарантирует согласованность данных, помещаемых в сообщение. Однако при создании сообщения в многопользовательском варианте имеют возможность быть конфликты блокировок промеж транзакцией, в которой данные помещаются в сообщение, и транзакциями, выполняемыми иными пользователями. Для снижения вероятности появления подобных конфликтов допустимо определить содержимое этого параметра, отличное от значения по умолчанию. Чем меньше содержимое параметра, тем меньше вероятность конфликта блокировок, однако выше вероятность помещения в сообщение несогласованных данных.
"Выгружать объекты на которые есть права доступа" – если флажок выставлен, то выборка объектов информационной базы будет производиться учитывая прав доступа данного пользователя программы. Это предполагает применение литерала "РАЗРЕШЕННЫЕ" в тексте запроса для выборки данных.
"Автоматом удалять недопустимые символы из строчек для записи в XML" – если флажок выставлен, то при записи данных в сообщение обмена недопустимые символы будут удалены. Символы анализируются на соотношение рекомендации XML 1.0.
"Редактирования фиксации для узлов обмена после выгрузки" – поле задает порядок работы с регистрацией корректировок данных после завершения выгрузки данных. Допустимые значения:
* Не удалять регистрацию – после выгрузки данных фиксирование корректировок на узле удалена не будет.
* Целиком убрать регистрацию для узла обмена – после выгрузки данных фиксирование корректировок на узле будет целиком удалена.
* Убрать регистрацию лишь для выгруженных метаданных – после выгрузки данных фиксирование корректировок на узле будет удалена лишь для объектов метаданных, которые были заданы к выгрузке.
"Протокол обмена" – разрешает настроить вывод информационных сообщений в окно сообщений, ведение и запись в отдельный файл протокола обмена.
"Наименование файла, протокола обмена" – наименование файла для отображения протокола процесса обмена данными.
"Протокол загрузки (для COM - соединения)" – наименование файла для отображения протокола процесса обмена данными в базе-приемнике при обмене через COM-соединение. Обратите внимание: путь к файлу обязан быть доступен с компьютера, на котором определена база-приемник.
"Дописывать данные в протокол обмена" – если флажок выставлен, то содержимое файла протокола обмена сохраняется, если файл протокола уже имеется.
"Вывод в протокол информационных сообщений" – если флажок выставлен, то в протокол обмена будут отображаться сообщения информативного характера, кроме сообщений об ошибках обмена.
"Открывать файлы протоколов обмена после исполнения операций" – если флажок выставлен, то после исполнения обмена данными файлы протоколов обмена будут автоматом открыты для чтения.
Удаление данных
Панель нужна лишь для разработчиков правил обмена. Разрешает удалять из информационной базы любые объекты.
Отладка выгрузки и загрузки данных
Обработка разрешает совершать отладку обработчиков событий и генерировать модуль отладки из файла-правил либо файла-данных.
Включение режима отладки обработчиков выгрузки выполняется на панели "Выгрузка данных" установкой флага "Порядок отладки обработчиков выгрузки". Соответственно, на панели "Загрузка данных" включение режима отладки загрузки выполняется установкой флага "Порядок отладки обработчиков загрузки".
После назначения режима отладки обработчиков станет доступной кнопка настройки отладки. После нажатия на данную кнопку появится окно настройки.
Настройка отладки обработчиков производится в четыре шага:
Шаг 1: Выбор режима отладки алгоритмов
На первом шаге требуется определиться с режимом отладки алгоритмов:
* Без отладки алгоритмов
* Вызывать мехенизмы как процедуры
* Подставлять код алгоритмов по месту вызова
Первый порядок удобно применять, когда мы досконально знаем, что ошибка в обработчике не связана с кодом какого-или алгоритма. В данном варианте код алгоритмов не выгружается в модуль отладки. Мехенизмы делаются в контексте оператора "Выполнить()" и их код недоступен для отладки.
Второй порядок требуется применять в тех ситуациях, когда ошибка располагается в коде алгоритма. Во время задания этого режима мехенизмы будут выгружены как определенные процедуры. В миг вызова алгоритма из какого-или обработчика выполняется обращение к соотносящейся процедуре обработки. Данный порядок удобно применять, когда для передачи реквизитов в мехенизмы применяется глобальная переменная "Реквизиты". Ограничения применения этого режима в том, что при отладке в алгоритме недоступны локальные переменные обработчика, из которого он открывается.
Третий порядок отладки применяется, как и во втором случае, при отладке кода алгоритмов и в тех ситуациях, при которых второй порядок отладки не подходит. Во время задания этого режима мехенизмы будут выгружены как интегрированный код в обработчиках. Т.е. взамен оператора вызова алгоритма вставляется полный код алгоритма учитывая вложенных алгоритмов. В данном варианте нет ограничений на применение локальных переменных обработчика, при этом есть ограничение при отладке алгоритмов с рекурсивным вызовом.
Шаг 2: Создание модуля отладки
На втором шаге требуется сделать выгрузку обработчиков нажатием на кнопку "Сформировать модуль отладки выгрузки (загрузки)". Сформированные обработчики и мехенизмы будут отображены в отдельное окно для чтения. Содержимое модуля отладки требуется задублировать в буфер обмена нажатием на кнопку "Копировать в буфер обмена".
Шаг 3: Создание внешней обработки
На данном шаге требуется запустить конфигуратор и внести вновь созданную внешнюю обработку. В модуль обработки требуется вставить содержимое буфера обмена (модуль отладки) и сохранить обработку под любым именем.
Шаг 4: Подключение внешней обработки
На четвертом, завершающем шаге, надо определить наименование файла внешней обработки в поле ввода. В то же время 1с делает проверку по времени создания (обновления) файла обработки. Если обработка имеет более раннюю версию, чем версия файла модуля отладки, то будет выведено предупреждение и форма настройки закрыта не будет.
Примечание: Возможность отладки глобального обработчика конвертации "После загрузки правил обмена" не поддерживается.