1с настройка синхронизации документооборот
В статье описан порядок действий для подключения типовых документов к механизму «Синхронизация данных через универсальный формат» (технология КД 3.0).
Термин «типовой» здесь имеет два значения:
1) документ, который входит в состав типовой конфигурации 1С 8.3
2) документ описан в одном из типовых XDTO-пакетов (важно в контексте статьи).
Например, есть две типовые конфигурации 1С 8.3: 1С:ERP Управление предприятием 2 и 1С:Бухгалтерия 3.0 (конкретные номера релизов значения не имеют). Между этими конфигурациями посредством механизма «Синхронизация данных через универсальный формат» организована передача документа «Счет-фактура полученный» в 1С 8.3 из ERP в Бухгалтерию. А нужна передача данного документа в обратную сторону, из Бухгалтерии в ERP (в типовых такой возможности нет).
1. Подключаем документ в состав плана обмена 1С 8.3 в базе 1С:Бухгалтерия
В исходной типовой базе 1С:Бухгалтерия такого вида документа в списке регистрации изменений нет:
Чтобы его туда добавить, достаточно в конфигураторе этот документ включить в состав плана обмена 1С 8.3 «СинхронизацияДанныхЧерезУниверсальныйФормат».
Если вы отключаете «Авторегистрацию» изменений документа в плане обмена, тогда данный документ необходимо дополнительно включить в состав «Источник» подписок на событие:
Можно программную регистрацию изменений документа организовать самостоятельно.
Если подключение произведено верно, то «Счет-фактура полученный» в 1С 8.3 отобразится на форме регистрации изменений.
2. Настраиваем правила обмена для документа
«ПОД» - это правило обработки данных.
Все правильно: никаких «правил» мы еще не настраивали.
«Универсальный формат» подразумевает наличие двух комплектов правил:
· Из базы-источника в универсальный формат
· Из универсального формата в базу-приемник
В нашем случае типовая конфигурация ERP уже содержит в себе правила для приемки документа «Счет-фактура полученный» в 1С 8.3 из универсального формата. Поэтому нам достаточно настроить эти правила только в конфигурации Бухгалтерия 3.0 для отправки документа (в общем случае пришлось бы настраивать правила и для приемки документа в ERP).
Настроить правила обмена через универсальный формат можно:
· вручную, внося изменения в общий модуль МенеджерОбменаЧерезУниверсальныйФормат13
· с использованием конфигурации «Конвертация данных 3.0» (КД 3) и последующим переносом результатов настройки в общий модуль МенеджерОбменаЧерезУниверсальныйФормат13
В сети есть много информации о том, как выполнить настройку правил обмена КД 3.0, поэтому останавливаться на этом не будем.
Отмечу также, что настройку правил можно производить не в общем модуле, а во внешней обработке, которая подключается к механизму синхронизации. Описаний того, как это сделать в сети так же предостаточно.
Одним из признаков успешности настройки правил является присутствие нашего документа на ветке «AvailableObjectTypes» файла обмена:
Для сравнения посмотрите на документ «СчетФактураВыданный». В типовой конфигурации 1С 8.3 Бухгалтерия 3.0 его выгрузка также изначально не предусмотрена, и ветка «Sending» для него – пустая.
Если типовой документ описан в XDTO-пакете, то для его включения в обмен через механизм «Синхронизация данных через универсальный формат» необходимо выполнить две процедуры:
1. В конфигурации-источнике подключить документ в состав плана обмена «СинхронизацияДанныхЧерезУниверсальныйФормат» и настроить механизм регистрации изменений документа в этом плане обмена.
2. Настроить правила обмена (КД 3.0):
a. либо в общем модуле «МенеджерОбменаЧерезУниверсальныйФормат» (название модуля в разных конфигурациях может различаться – нужно уточнять),
b. либо во внешней обработке, которая подключается к механизму синхронизации.
Данный способ универсален и пригоден для любых конфигураций и любых видов объектов (Документов, Справочников и т.п.).
Специалист компании ООО «Кодерлайн»
Вас могут заинтересовать следующие статьи:
94 [PROP_CODE] => TAGS2 [TITLE] => Вас могут заинтересовать следующие семинары: ) --> 95 [PROP_CODE] => TAGS [TITLE] => Вас могут заинтересовать следующие вебинары: ) -->
Вас могут заинтересовать следующие вебинары:
Приветствую всех. Сегодня пойдет речь о том, как на одной крупной компании внедряли 1С:Документооборот 2.1 в связке с КА 2.4. Вроде бы системы типовые, мы практически не добавляли ничего в них, но проблем было столько, что я решил изложить их в статье. Может, кому-то пригодится это в дальнейшем, и не придется тратить кучу времени на поиск решений.
КА -комплексная автоматизация, ДО - документооборот.
Итак, базы развернуты, опубликованы, можем начинать. А начнем с синхронизации.
Этап 1: Синхронизация
Настраиваем типовую синхронизацию, далее первый запуск и. ничего не работает. Идем в журнал регистрации и видим странную ошибку.
Что ж, делать нечего. Идем в отладку. И что мы там наблюдаем? Довольно интересную картину.
По какой-то причине у нас две колонки с одним наименованием.
Идем в правила конвертации и видим, что в тч контактной информации две строки с конвертацией реквизита ДействуетС, удаляем лишнюю строку, заменяем правила - и о чудо, все работает.
Больше с синхронизацией проблем не было (только доработки, связанные со спецификой внедрения). Переходим к бесшовной интеграции.
з.ы. ошибка эта была в нескольких релизах подряд, на последнем релизе не проверял, но при необходимости могу посмотреть.
Этап 2.Интеграция (бесшовка).
Историю о настройке бесшовной интеграции начну с небольшого описания работы самого механизма.
На стороне КА имеются следующие объекты:
При изменении объекта, участвующего в интеграции, этот объект регистрируется на узле плана обмена. Далее фоновое задание вызывает процедуру модуля, в котором соответственно выполняются последовательно три процедуры:
ИнтеграцияС1СДокументооборотОбмен.ПодготовитьДанныеДляОтправки();
ИнтеграцияС1СДокументооборотОбмен.ПолучитьДанные();
Минус этого метода - все пакеты обрабатываются в одной конструкции Попытка-Исключение. Если хотя бы один пакет с ошибкой, все остальные пакеты уже не обрабатываются.
Также была переделана - каждый пакет обрабатывается в отдельной попытке.
ПолучитьДанные() - в цикле с уловием, пока есть необработанные пакеты на стороне ДО формируется запрос, который передает на сторону ДО номер последнего успешно обработанного пакета и возвращает в КА новый пакет, после чего данный пакет обрабатывается на стороне ДО. В типовом варианте также при возникновении ошибки загрузка останавливается. (Также была доработана).
План обмена ИнтегрированныеСистемы
Фоновое задание формирует пакет xml и в виде двоичных данных записывает его в справочник.
Далее на стороне КА вызывается процедура ПолучитьДанные()
при успешном получении элемент справочника помечается на удаление.
2.1 Выгрузка из ДО в КА (не те правила подставляются)
В этой процедуре для объекта производится поиск подходящего правила. Ниже представлен скриншот функции, получающей правило интеграции для объекта.
Как видно из текста запроса, выбирается первое попавшееся правило, у которого тип исходного и конечного объекта совпадают с условием. В нашем случае для договоров было 3 правила, отличающихся заполнением реквизитов и видом внутреннего документа. В итоге при выгрузке выбиралось некорректное правило и дальше весь обмен стопорился с ошибками (набор заполняемых полей во всех 3 правилах был разным). Указано, что функция эта устарела, но при этом даже в самых последних релизах до сих пор используется.
Заменяем на функцию, указанную в рекомендациях (заодно делаем для себя дополнительную запись в Журнал регистрации.
Теперь правило определяются корректно и большая часть ошибок уже решена. Едем дальше.
2.2 Обмен заявками на расходование ДС по физ лицам
После создания правила для Заявки на расходование ДС - Внутренний документ (Заявка на расходование ДС) с частью заявок появились проблемы. А именно, у заявки вид хоз. операции "Выдача подотчетнику" банковский счет с владельцем физ. лицо. В правиле для банковского счета стоит флаг Обновлять. В ДО у банковского счета во владельцах справочника Физ. лица нет в принципе. При обмене из-за этого возникает ошибка "ОбщийМодуль.ИнтеграцияС1СДокументооборот.Модуль(467) Значение не является значением объектного типа (name)". - по отладке это как раз момент заполнения владельца у банковского счета. Сейчас пока выключили обновление у банковского счета, но это решение временное. параллельно написали в ТП 1с.
Таких заявок оказалось крайне мало, но по мне, это недоработка документооборота.
2.3 Обмен статусами документов
В КА помимо статуса в объекте есть регистр сведений СостоянияСогласованияВДокументообороте. В процедуре получения данных из ДО в этот регистр записываются данные по статусу, если они есть в пакете. После записи в регистр вызывается процедура ИнтеграцияС1СДокументооборотПереопределяемый.ПриИзмененииСостоянияСогласования в которой на текущий момент ничего нет (процедура пустая). Я предполагаю, что данный регистр в дальнейшем нужно обрабатывать, получая статус и объект по идентификатору и далее изменять статус в самом объекте. Но мы идем немного другим путем и прописываем соответствия статусов непосредственно в правилах интеграции.
Перечь статусов в КА и ДО не соответствует, поэтому их нужно синхронизировать с помощью выражений.
Также столкнулись с такой проблемой: в КА заявку перевели в статус "К оплате", через некоторое время из ДО прилетает статус "Согласовано". Пришлось на стороне КА делать проверку, если статус "К оплате", то обмен его уже изменить не может. Такие заявки контролируются ответственным пользователем.
3. Меняем логику работы обмена.
После обсуждений с заказчиком было принято решение о том, что текущую логику работы обмена нужно поменять. А именно:
-сделать проверку на количество итераций по ошибочным пакетам при загрузке из ДО в КА;
-если ошибочный пакет грузится повторно, присваиваем ему статус обработанного с занесением ошибки в ЖР (в дальнейшем планируется отдельный регистр + рассылка ошибок по ответственным);
-под каждый объект делаем свой пакет, т.е если в очереди будет ошибочный объект, то он не повлияет на остальные пакеты в очереди;
Недавно возникла задача по настройке интеграции программы 1С:Управление торговлей 8 Редакция 11 и 1С:Документооборот. Хорошего материала по настройке, где все было бы популярно расписано найти не удалось. Поэтому в процессе настройки я решил подготовить небольшую инструкцию.
Необходимо настроить интеграцию «1С:Управление торговлей 8 Редакция 11», далее УТ11 и «1С:Документооборот», далее ДО. На основании данных справочника «Договоры контрагентов», в программе УТ11, формировать в ДО входящий документ с заполнением основных реквизитов.
Используемые версии конфигураций и дополнительное ПО:
«1С:Управление торговлей 8 Редакция 11», версия 11.0.7.21
«1С:Документооборот ПРОФ», версия 1.2.2.7
Веб-сервер Apache, версия 2.2.22
В качестве настраиваемых баз были взяты демонстрационные конфигурации, с заполненными данными.
Настройка веб-сервера Apache 2.2
Следует заполнить поля:
Network Domain – localhost
Server Name – localhost
Administrator’s Email Address – можно указать произвольный e-mail, этот адрес будет показан пользователю в случае ошибки на сервере при открытии страницы.
Переключатель следует оставить по умолчанию for All Users, on Port 80, as a Service
Тип установки оставляем Typical (типовой)
В качестве папки для установки веб-сервера рекомендуется использовать либо папку в корне диска D, либо диска C, если установлена Windows 7 в папку C:\Users\Public\WEBSERVER\
Настройка программы ДО
Настройки в программе следует выполнять под учетной записью пользователя с полными правами, правами администрирования. В программе ДО необходимо открыть конфигуратор. В главном меню выбрать Администрирование -> Публикация на веб-сервере…
В открывшемся окне следует указать:
- Указать Имя DocMng
- Убедиться, что выбран Веб-сервер Apache 2.2
- Установить флаг ПубликоватьWeb-сервисы
- Установить флаги напротив DMService
- Нажать кнопку Опубликовать.
В открывшемся окне Публикация веб-клиента нажмите кнопку Да.
Настройка программы УТ11
Настройки в программе следует выполнять под учетной записью пользователя с полными правами, правами администрирования. В программе УТ11 необходимо открыть панель Администрирование, выбрать Настройка параметров учета.
В открывшемся окне необходимо перейти на вкладку Интеграция с 1С:Документооборот и выполнить следующие действия:
Настройка подключения к ДО. На панели Администрирование в группе Настройки необходимо открыть пункт Персональные настройки.
В открывшемся окне необходимо перейти на вкладку Интеграция с 1С:Документооборот и нажать кнопку Настроить параметры авторизации в 1С:Документооборот.
В открывшемся окне необходимо указать имя пользователя и пароль учетной записи ДО. У данной учетной записи должна быть установлена роль Полные права.
На панели Администрирование, слева, в панели навигации необходимо выбрать пункт Настройки заполнения объектов 1С:Документооборота.
В открывшемся окне следует добавить новую настройку заполнения, нажав кнопку Создать.
В качестве примера рассмотрим создание документов в программе ДО на основании договоров контрагентов в программе УТ11.
В открывшейся форме следует заполнить значения, аналогично, приведенным на рисунке:
Для проверки соответствия документов ДО и договоров контрагентов можно открыть карточку справочника Партнеры. Для того, чтобы открыть справочник Партнеры можно перейти на панель Нормативно-справочная информация, слева, в панели навигации выбрать пункт Партнеры.
В карточке партнера следует открыть список договоров, нажав пункт Договоры по партнеру.
Примечание! В момент создания входящего документа будет произведена попытка подключения к программе ДО через веб-сервер. Поэтому необходимо, чтобы веб-сервер был запущен, база ДО была опубликована на данном веб-сервере и доступна для подключения по учетной записи, указанной в персональных настройках УТ11.
В открывшейся форме входящего документа будут заполнены все реквизиты, которым ранее в форме настроек заполнения объектов 1С:Документооборота было сопоставлено соответствие. В данном примере соответствие было выставлено для реквизитов:
Механизмы интеграции
Конфигурация "1С:Документооборот" редакции КОРП содержит несколько встроенных планов обмена с другими типовыми конфигурациями на платформе "1С:Предприятие".
Редакции ПРОФ и ДГУ не содержат таких планов обмена. Тем не менее, все редакции поддерживают обмен данными с помощью встроенной обработки УниверсальныйОбменДаннымиXML , использующей внешние правила обмена, загружаемые из файла. Собственные планы обмена можно добавить в любую из редакций.
Встроенные планы обмена предназначены для автоматической синхронизации данных в ходе совместного использования разных прикладных решений, но могут использоваться и для первоначального наполнения информационной базы.
Внешние правила обмена, поставляемые в составе дистрибутива, предназначены скорее для первоначального наполнения информационной базы, но могут использоваться и для последующей синхронизации данных. В последнем случае обмен нужно будет запускать регулярно вручную.
Встроенные планы обмена используют подсистему Обмен данными "Библиотеки стандартных подсистем" (далее БСП) редакции 2. Это значит, что в составе каждого плана обмена есть макет с правилами регистрации, а также макеты правил обмена и правил обмена конфигурации-корреспондента:
- Правила регистрации используются в "1С:Документообороте" для определения необходимости регистрации записываемого объекта к выгрузке в конфигурацию-корреспондент.
- Типовые правила регистрации тривиальны (содержат только перечень регистрируемых объектов без дополнительных условий).
- Автоматическая регистрация изменений в планах обмена выключена, для регистрации используется стандартная механика БСП, анализирующая изменения в выгружаемых полях перед регистрацией.
При необходимости комплект правил может быть загружен из файла. Как правило, это делают:
- после обновления конфигурации-корреспондента. В этом случае свежий комплект правил находится в составе дистрибутива обновления, в папке "Синхронизация данных";
- во время отладки правил обмена, разрабатываемых на основе типовых правил, если они требуют доработки на конкретном внедрении.
После отладки доработанных правил обмена рекомендуется включить их в состав конфигурации, сняв с поддержки макеты, чтобы:
- получить возможность сравнивать доработанные правила с типовыми при обновлении конфигурации;
- избежать проблем, связанных с проверкой правил при обновлении информационной базы после изменения структуры метаданных.
Обратите внимание:
Правила, загруженные из файла и переставшие соответствовать новой структуре метаданных, не дадут довести до конца штатное обновление информационной базы.Правила обмена разрабатываются с помощью конфигурации "Конвертация данных" редакции 2.1. Конфигурация бесплатна и доступна по линии ИТС. Рекомендуется использовать типовые правила как основу для разработки, сохранив их в файлы и загрузив в информационную базу "Конвертации данных".
"1С:Документооборот" не поддерживает обмен данными в формате EnterpriseData. Соответственно, для разработки правил обмена не следует использовать конфигурацию "Конвертация данных" редакции 3.
Расширение плана обмена
При включении новых объектов в существующий план обмена следует:
Добавление плана обмена
При разработке собственных планов обмена следует:
- Создать новый план обмена на стороне обеих конфигураций. Имя плана обмена должно быть одинаковым в обеих конфигурациях. Состав обязательных процедур модуля менеджера плана обмена приведен в документации к подсистеме Обмен данными "Библиотеки стандартных подсистем" соответствующей версии.
- Включить в состав планов обмена объекты, участвующие в обмене, а также регистр сведений СоответствиеОбъектовИнформационныхБаз , запретив авторегистрацию изменений. Использование собственного механизма регистрации БСП позволит избежать выгрузки объектов, изменившихся только в части не участвующих в обмене реквизитов.
- Создать подписки на события, аналогичные описанным выше, и обработчики для них. Лучше создать для этого отдельный общий модуль, не снимая с поддержки общий модуль ОбменДаннымиСобытияДокументооборот .
- Включить новый план обмена в тип параметра общих команд подсистемы Обмен данными . Проще всего найти нужные команды, выполнив в Конфигураторе поиск ссылок на типовой план обмена.
- Включить новый план обмена в код процедуры ПолучитьПланыОбмена общего модуля ОбменДаннымиПереопределяемый .
- При необходимости создать формы настройки плана обмена (см. документацию к "Библиотеке стандартных подсистем", а также примеры в планах обмена с конфигурациями "1С:Бухгалтерия" предприятия и "1С:Управление производственным предприятием").
- Сохранить описания обновленных конфигураций в файлы с помощью обработки MD8Exp.epf , входящей в состав дистрибутива конфигурации "Конвертация данных".
- Загрузить описания конфигураций в информационную базу "Конвертации данных".
- Разработать два набора правил обмена и два набора правил регистрации для каждой из сторон обмена.
- Добавить оба набора правил обмена и по одному набору правил регистрации в каждую конфигурацию в качестве макетов плана обмена.
- Настроить синхронизацию данных и отладить ее.
Обратите внимание:
Правила обмена, зачитанные из макетов в составе конфигурации, кэшируются в регистре сведений ПравилаДляОбменаДанными . При отладке рекомендуется использовать загрузку правил обмена из файла. Для обновления правил из макета следует изменить номер версии конфигурации или выполнить загрузку вручную по команде Загрузить правила… , выбрав вариант Из конфигурации .Веб-сервисы
Типовая конфигурация "1С:Документооборот" содержит набор веб-сервисов.
Некоторые из них специализированы и служат, например, для обмена с мобильными устройствами или для синхронизации данных с другими информационными базами, разработанными с применением "Библиотеки стандартных подсистем".
Два веб-сервиса, однако, предназначены для интеграции с произвольными внешними программами, как разработанными на платформе "1С:Предприятие", так и любыми другими, способными обращаться к веб-сервисам. Речь идет о веб-сервисах:
- Files – простой сервис, поддерживающий работу с файлами и папками "1С:Документооборота" извне.
- DMService – поддерживает работу с основными объектами и функциями "1С:Документооборота". Перекрывает функционал веб-сервиса Files . Используется "Библиотекой интеграции 1С:Документооборота".
Данные веб-сервисы включены во все редакции "1С:Документооборота".
Работа с веб-сервисами из прикладных решений на платформе "1С:Предприятие", как правило, строится следующим образом:
- Определяется способ хранения и редактирования настроек подключения к веб-сервису. Настройки состоят из:
- Адреса веб-сервиса;
- Имени пользователя и пароля (в текущих версиях платформы поддерживается только аутентификация "1С:Предприятия", поэтому следует либо предоставить пользователям интегрируемого прикладного решения возможность ввести имя пользователя и пароль, либо использовать для доступа служебную учетную запись, для которой запрещен интерактивный вход);
- Таймаута при обращении к сервису (при низком качестве соединения, а также при первом обращении к сервису задержки могут быть значительными).
- Определяется способ получения WSПрокси для обращения к веб-сервису. Операции создания WSОпределений и WSПрокси достаточно затратны, поэтому рекомендуется выносить получение реквизитов, в отдельный общий модуль с повторно возвращаемыми значениями.
- Создаются процедуры и функции, являющиеся обертками для функционала веб-сервиса на стороне прикладного решения. Непосредственную работу с объектами XDTO рекомендуется инкапсулировать в них, чтобы облегчить доработки при изменении функционала сервиса.
Примеры использования веб-сервисов можно увидеть в "Библиотеке интеграции 1С:Документооборота", поставляемой в составе дистрибутива "1С:Документооборота".
Веб-сервис Files
Веб-сервис использует всего четыре типа объектов:
- File – файл в папке.
- Folder – папка файлов.
- ShortFileInfo – сведения о файле, возвращаемые сервисом после его создания.
- FileList – список файлов, отобранных по условиям.
- GetFileList – получает список файлов в указанной папке.
- GetFile – получает файл по указанному коду файла.
- AddFile – добавляет файл в указанную папку.
- DeleteFile – помечает файл на удаление.
- FindFolder – находит папку по наименованию в указанной родительской папке.
- AddFolder – создает новую папку в указанной родительской папке.
Все действия, выполняемые этим веб-сервисом, можно выполнить с помощью веб-сервиса DMService. Работа с файлами документов поддерживается только DMService.
Веб-сервис DMService
Сервис использует XDTO-пакет DM. Пакет содержит несколько десятков прикладных объектов, являющихся представлениями таких объектов "1С:Документооборота", как файлы, документы, процессы, задачи и так далее. Все они - потомки абстрактного DMObject и имеют общие свойства objectId и externalObject .
Свойство objectId представляет собой ссылку на объект "1С:Документооборота" и содержит его представление, идентификатор и тип.
Свойство externalObject представляет собой ссылку на объект интегрируемой программы и так же содержит его представление, идентификатор и тип. Свойство заполняется сервисом автоматически, если объект "1С:Документооборота" был ранее связан с объектом интегрируемой конфигурации, например, при создании или записи с заполненным свойством externalObject .
Сервис поддерживает всего одну операцию, execute . В качестве параметра передается объект-потомок DMRequest . Требуемая операция и ее параметры определяются типом переданного объекта и его свойствами. Например, запрос DMGetObjectListRequest получает список объектов типа, указанного в свойстве type по условиям, указанным в свойстве query .
Результат операции возвращается в объекте-потомке DMResponse . В простейших случаях это объект DMOK . В случае ошибки возвращается DMError , содержащий краткое ( subject ) и полное ( description ) описание ошибки.
Для большинства запросов существуют парные им объекты-ответы, содержащие результат выполненной операции. Например, список объектов, полученный вызовом DMGetObjectListRequest , возвращается в объекте DMGetObjectListResponse .
Приведем простейший пример работы с веб-сервисом на встроенном языке платформы "1С:Предприятие". Начнем с получения определений и прокси веб-сервиса (подразумевается, что адрес публикации, имя пользователя и пароль уже получены):
Cоздадим запрос на получение списка внутренних документов:
Определим условие запроса (поиск по наименованию):
Выполним запрос, проверив результат на предмет ошибки:
Разберем ответ, заполнив таблицу названиями и идентификаторами найденных документов:
Подробное описание объектов и операций сервиса дается в составе дистрибутива "1С:Документооборота" (файл "Описание веб-сервисов.html" в каталоге шаблонов). Это описание доступно также из интерфейса демонстрационной конфигурации "Библиотека интеграции с 1С:Документооборотом", которая содержит также более сложные и полезные примеры использования сервиса.
При выпуске новых версий "1С:Документооборота" сервис расширяется и дополняется новыми объектами и свойствами так, чтобы не затронуть работу клиентских приложений, не знающих об этих изменениях. Этого же принципа следует придерживаться при самостоятельном изменении функционала сервиса: например, добавляя новые свойства, устанавливать минимальное количество в 0.
Обработка запросов к сервису сосредоточена в общих модулях:
- ОбработкаЗапросовXDTO – общий вход для всех вызовов
- ОбработкаЗапросовXDTOБизнесПроцессыИЗадачи
- ОбработкаЗапросовXDTOДокументы
- ОбработкаЗапросовXDTOФайлы
Присутствуют только в редакции КОРП:
- ОбработкаЗапросовXDTOКорп
- ОбработкаЗапросовXDTOОбмен
- ОбработкаЗапросовXDTOПочта
- ОбработкаЗапросовXDTOУчетВремени
Перед использованием сервиса следует получать его версию и редакцию запросом DMGetVersionRequest и не пользоваться возможностями, которые не поддерживает сервис. Попытка использовать отсутствующие возможности, например, попытка создать исходящее письмо в редакции ПРОФ, приведет к ошибке (возврату DMError ).
Доработки рекомендуется вносить в модуль ОбработкаЗапросовXDTO Переопределяемый . Его процедуры и функции позволяют провести дополнительное изменение объектов XDTO при их создании по объектам "1С:Документооборота" и наоборот.
Библиотека интеграции 1С:Документооборота
"Библиотека интеграции 1С:Документооборота" (далее БИД) не является самостоятельным прикладным решением, хотя и содержит некоторые демонстрационные объекты, и предназначена для встраивания в прикладные решения на платформе "1С:Предприятие".
БИД может использоваться с любыми версиями "1С:Документооборота", начиная с редакции 1.2.
БИД публикуется в составе дистрибутива "1С:Документооборота" и предназначена для работы с "Библиотекой стандартных подсистем" версии, последней на момент публикации. Однако адаптация БИД к конфигурациям, содержащим более ранние версии БСП, не составляет большого труда, поскольку БИД использует функционал БСП в небольшом объеме.
Более подробное описание "Библиотеки интеграции 1С:Документооборота" и порядка ее встраивания содержится в документации, поставляемой в составе дистрибутива (папка DocDMIL ).
В наши дни программа 1С:Документооборот является важным инструментом и помощником в организациях любых уровней. Помимо самодостаточного функционала она наделена способностью интегрироваться с большинством систем на базе 1С. К самым распространенным схемам взаимодействия можно отнести «Бесшовную интеграцию» и «Синхронизацию данных».
Бесспорно, лучшим видом интеграции является «Бесшовная интеграция». При таком способе взаимодействия «1С:Документооборот» настолько сильно «вживляется» в «1С:ERP», что управление всеми процессами происходит уже из интерфейса системы.
В мельчайших подробностях о настройках такого вида интеграции написано в статьях:
Вариант интеграции «Синхронизация данных» обладает более скромными возможностями и позволяет выполнить обмен только справочной информацией. Перечень регистров сведений и справочников можно просмотреть в файле из комплекта поставки «1c\Enterprise20\2_4_5_86\AddFiles\Переходы с других конфигураций\Синхронизация данных\Документооборот КОРП,ред.2.1\Совместное использование.html».
Перед началом настройки обмена, необходимо правильно выбрать базу-источник, опираясь на следующие правила:
1. Если одна из баз практически пуста, то обмен быстрее произойдет именно в ней, так как меньше времени займет выгрузка данных.
2. Если при обмене используется прямое подключение, то выгрузка данных происходит из базы, к которой выполнено подключение (База 2), и загрузка данных в базу, в которой настраивается подключение (База 1). Т.е. приоритетнее будут данные из Базы 2.
3. Если обмен выполняется через файлы, то данные базы, в которой производится настройка и выгрузка, будут приоритетными.
4. Приоритетными считаются данные, к состоянию которых будет приведена информация в обеих базах.
5. Если существует необходимость принять не все данные из источника, то во время первичного обмена можно загрузить только необходимые данные, воспользовавшись механизмом интерактивной загрузки. Все остальное будет синхронизировано позже.
2. Настройка и администрирование в программе 1С:Документооборот
Исходя из вышеописанного, следует начать настройку в программе 1С:Документооборот.
Для этого под пользователем «Администратор» необходимо создать пользователя, который будет выполнять обмен. Это можно сделать в разделе «Настройка и администрирование».
Выбрать пункт «Пользователи». В появившемся окне нажать кнопку «Создать».
Можно задать произвольное имя пользователя, но нагляднее и понятнее имя «Обмен».
Не стоит забывать про важность установки сложных паролей для такого рода пользователей. Механизм установки паролей откроет кнопка «Установить пароль».
В появившемся окне, можно как придумать сочетание символов самому, так и довериться системе, нажав кнопку «Создать пароль».
Пользователь «Обмен» должен быть включен в группу доступа «Администраторы».
Для перехода к следующему шагу нужно в разделе «Настройка и администрирование» выбрать пункт «Настройка программы»:
На появившейся панели выбрать пункт «Обмен данными».
Проверить настройки обмена на наличие флага «Использовать синхронизацию данных», а также указать префикс информационной базы.
В разделе «Настройка и администрирование» (пункт «Синхронизация данных») можно получить доступ к настройкам обмена.
Если синхронизация настраивается впервые, то программа сразу запустит помощника настроек синхронизации, который пошагово предложит выбрать нужные параметры. На первом шаге по кнопке «Настроить синхронизацию данных» появится выпадающий список для выбора системы обмена.
Далее механизм предложит возможность выбрать способ настройки синхронизации. Но перед тем как продолжить настройку, нужно позаботиться о безопасности данных.
3. Резервное копирование базы данных
Для этого необходимо выполнить резервное копирование базы данных.
В появившемся окне выбрать каталог и нажать кнопку «Сохранить резервную копию».
После удачной операции резервирования данных можно продолжить настройку, выбрав флажок «Указать настройки вручную»:
Если в программе 1С: 8 ERP уже были произведены все нужные настройки, и они сохранены в файл, то готовый пресет можно загрузить в этой программе и пропустить все дальнейшие шаги.В данном случае никаких настроек заранее выполнено не было.
Нажатие на кнопку «Далее» позволит перейти к следующему шагу помощника настройки, который предлагает выбрать вариант подключения к другой программе.
Пункт «Прямое подключение к программе на этом компьютере или в локальной сети» предложит указать расположение другой программы и способ аутентификации.
Если программа находится в другой сети и при этом доступна для подключения через интернет, то необходимо выбрать вариант «Прямое подключение через Интернет».
В случае если к 1С 8 ERP нет возможности прямого подключения по локальной сети или через Интернет, рекомендуется использовать другие каналы связи: сетевой каталог, FTP-ресурс или электронную почту. При этом программы, между которыми настроена синхронизация данных, могут работать полностью автономно друг от друга и в разное время. Такой вариант подключения подходит для синхронизации данных между программами, расположенными не только в других сетях, но и для программ в одной сети.
В данном случае более интересен третий вариант.
Но и он предлагает ряд вариантов для обмена данными.
Можно производить обмен через каталог на ftp сервере.
Можно передавать данные по электронной почте.
Возможно обмениваться данными и через общий каталог на компьютере.
Для наглядности примера был выбран третий вариант и подготовлен каталог обмена
«Обмены» в корневой директории диска «C:» и подкаталог «do-erp».
По кнопке «Далее» потребуется указать наименование и префикс другой базы.
По окончании настройки, произойдет проверка обмена.
Выполнив проверку, программа предложит сохранить настройки и выполнить отправку данных в 1С:ERP 2.0.
Если будет установлен флажок «Выполнить отправку данных», то программа автоматически произведет выгрузку всех необходимых данных в указанный каталог.
В папке обмена будут созданы два файла в формате xml.
Следующим шагом нужно произвести настройку синхронизации на стороне 1С 8 ERP.
Для этого необходимо войт в программу под пользователем «Администратор» и в разделе «НСИ и администрирование» выбрать «Синхронизация данных».
Установив флажок «Синхронизация данных» и задав префикс информационный базы, можно приступать к настройке, нажав кнопку «Настройки синхронизации данных».
На следующем шаге из выпадающего списка нужно выбрать «Документооборот, редакция 2».
Далее нужно выбрать вариант загрузки файла, созданного ранее, и указать к нему путь. Помощник настроек заботится о дальнейшем хорошем настроении пользователей и предлагает сделать резервную копию информационной базы. В данном случае стоит выполнить его рекомендации.
После создания копии нужно подтвердить каталог обмена.
Также будут предложены варианты обмена с помощью ftp и электронной почты.
Но в данном случае выбор уже сделан.
После выполнения настроек программа еще раз уточнит способ подключения.
По нажатию на кнопку «Готово», программа приступит к анализу, выгрузке и загрузке данных.
По окончании процесса появится окно с результатами.
Сразу же появляется возможность настроить расписание синхронизации. Для этого нужно нажать на кнопку «Настроить» и в появившемся окне заполнить расписание выполнения обменов.
После нажатия на любую из кнопок «Подробно» откроется Журнал регистрации с результатами выполнения обмена.
Для начала нужно посмотреть данные успешной отправки.
Все необходимые объекты выгрузились в файл. Пришел черед изучения результатов неудавшегося получения данных.
Для детализации ошибки нужно дважды щелкнуть по строке.
Из результатов видно, что что-то не так с правилами обмена.
На стороне «Документооборота» следует выполнить проверку актуальности правил обмена. Для этого в разделе «Настройки и администрирование» нужно открыть синхронизацию данных.
Если используется несколько синхронизаций данных, то необходимо в списке выбрать синхронизацию данных, для которой требуется изменить правила, и в командной панели нажать кнопку «Загрузить правила». Если настроена и используется одна синхронизация данных, то следует нажать кнопку «Загрузить правила» на закладке «Настройки синхронизации данных». В появившемся окне нужно изучить информацию о комплекте правил. Т.е. сравнить версии конфигураций обменивающихся баз с указанными в комплекте правил. Если имеются расхождения, тогда, установив флажок «Из файла на компьютере», нажать кнопку «Загрузить».
Появится окно выбора файла с правилами обмена.
Файл можно найти в комплекте поставки в каталоге «1c\Enterprise20 \2_4_5_86\AddFiles\Переходы с других конфигураций\Синхронизация данных\Документооборот КОРП,ред.2.1\»
После указания файла и нажатия кнопки «Применить», загруженные правила будут применены немедленно.
Для проверки работы новых правил обмена, следует повторить выгрузку данных на стороне «Документооборота». И запустить синхронизацию на стороне ERP.
И как результат, произойдет полноценный обмен с «Документооборотом».
Очень важно обратить внимание на предупреждения.
Выяснив причину, следует открыть элемент справочника.
Нужно ввести недостающую информацию и сохранить изменения.
Устранив ошибки в 1С:ERP, нужно произвести аналогичную работу над ошибками и в 1С:Документооборот.
Следует знать, что произвести настройку любых доступных параметров обмена (даже таких как состав синхронизируемых данных), можно в любой момент времени.
Для этого в меню синхронизации нужно нажать кнопку «Настроить» и открыть выпадающий список «Параметры синхронизации».
В списке присутствует очень интересный пункт «Состав отправляемых данных».
Его можно также вызвать, нажав на кнопку «Состав отправляемых данных» в меню синхронизации.
Раздел «Состав отправляемых данных» позволяет просматривать и редактировать состав отправляемых данных для будущего обмена.
Устранив причины конфликтов и настроив состав данных, можно приступать к полноценной работе.
Специалист компании ООО «Кодерлайн»
Вас могут заинтересовать следующие статьи:
94 [PROP_CODE] => TAGS2 [TITLE] => Вас могут заинтересовать следующие семинары: ) --> 95 [PROP_CODE] => TAGS [TITLE] => Вас могут заинтересовать следующие вебинары: ) -->
Вас могут заинтересовать следующие вебинары:
Читайте также: