1с программа корреспондент это
О том, что "Конвертация данных" - это удобный инструмент и прочую нужную информацию о ней, вы можете найти в справке самой конфигурации. Я же хочу поделиться своим кратким пояснением как ею пользоваться. Речь пойдет о версии 2.1. Если кому-то пригодится, одной из лучших благодарностей будет ваш лайк.
Когда требуется из одной системы выгружать данные в другую систему, то как правило настраивается план обмена, который автоматически (по расписанию) выгружает/загружает данные по неким правилам. Эти самые правила обмена удобно написать в конфигурации 1С "Конвертация данных" 2.1 (КД 2.1).
Обменивающиеся системы могут быть совершенно разными или идентичными, ограничений нет.
Другим применением КД 2.1 может быть написание правил для "ручной" выгрузки/загрузки данных с помощью обработки "Универсальный обмен данными XML", которая есть в любой типовой конфигурации. (Если в вашей системе вы не находите эту обработку, скачайте её и воспользуйтесь как внешней).
Если между системами настроен план обмена, то объект регистрируется к выгрузке, в случае его записи или проведении, и выполнении условий регистрации для данного объекта (ниже будет подробнее).
Эти условия регистрации для объекта могут быть прописаны в самой системе непосредственно в коде с помощью режима Конфигуратор, или в правилах обмена, в файле "RegistrationRules.xml" в типовых конфигурациях на УФ.
В качестве примера рассмотрим типовой обмен на управляемых формах (УФ) между ЗУП 3.1 и БУХ 3.0.
В ЗУП 3.1 в плане обмена "ОбменЗарплата3Бухгалтерия3" в реквизитах и табличных частях можно указать условия обмена, например, выгружаем только по определенным Организациям и не выгружаем персональные данные сотрудников. А в макетах плана обмена прописаны типовые правила (от разработчиков 1С), выделила для наглядности квадратом в Рис. 1.
Пример формы плана обмена в режиме предприятия показан на Рис. 3.
Откройте Администрирование - Синхронизация данных Рис. 2:
Учить настраивать обмен не буду, как это сделать легко найти в официальной документации.
На форме Плана обмена указано, что выгружаем только по конкретной организации и сводно по сотрудникам, другими словами персональные данные не выгружаем.
Рис. 3
Правила обмена могут быть типовыми (из конфигурации) или внешними (из файла на компьютере).
Правила из конфигурации удобно сохранить в файл, который выгружается архивом, распаковать архив и загрузить в Конвертацию данных для модификации.
Для этого нажмите "Загрузить комплект правил":
Правилами выгрузки является файл "ExchangeRules.xml", после его модификации, упаковываем три файла назад в архив и загружаем. Как загрузить "ExchangeRules.xml" в конвертацию данных показано на Рис. 19.
Так же изменять можно и правила регистрации "RegistrationRules.xml", например, если нужно выгрузить документ, не взирая на условие Плана обмена. Например, одно условие действует на 4 вида документов, но нам требуется всё же один документ выгрузить. Условие по этому документу можно просто закомментировать Рис. 8.
В моём примере по документу "ВедомостьНаВыплатуЗарплатыПеречислением" игнорируется условие "НеВыгружатьПерсональныеДанныеФизическихЛиц".
Открыть "RegistrationRules.xml" в конвертации данных не получится.
Файл "CorrespondentExchangeRules.xml" является правилами выгрузки базы корреспондента. То есть правила "CorrespondentExchangeRules.xml" и "ExchangeRules.xml" базы корреспондента (в моём примере это БУХ 3.0) должны совпадать.
Далее информация по самой конвертации данных.
Регистрировать для выгрузки все справочники, связанные с документом, и прописывать по ним ПВД не нужно. По ним сформируем ПКО при конвертации свойств (реквизитов объекта и реквизитов табличных частей объекта) (возможно станет яснее, посмотрев на Рис. 11).
Стандартная выборка (стрелка 2 Рис. 9) содержит в себе все реквизиты объекта, включая табличные части.
В ПВД указано Правило конвертации объекта (ПКО) (стрелка 3 Рис. 9), в данном примере ПКО называется "НачислениеОценочныхОбязательствПоОтпускам", все ПКО располагаются на первой закладке формы настроек правил обмена.
С левой стороны имеются обработчики: "Перед обработкой", "Перед выгрузкой", "После выгрузки", "После обработки" (стрелка 4 Рис. 9). В каждом из этих обработчиков при вызове "Информации по обработчикам" (стрелка 5 Рис. 9) можно получить сведения о выполняемых в нём действиях и возможных параметрах (в каждом обработчике список параметров немного различается).
Например, обработчик "Перед обработкой":
В Информации по тексту ниже указан вот такой пример:
Можно написать своё условие: например, если реквизит "Флаг" установлен в Истину, тогда такой объект нужно выгрузить по другому ПКО:
В случае, если при выгрузке вы пользуетесь произвольным алгоритмом, вам необходимо инициировать параметр ВыборкаДанных (стрелка 6 Рис. 10).
В рис. 11 указала связь всех правил. ПВД является ключевым триггером для выгрузки объекта по правилам конвертации, поэтому начинаем с него.
ПКО
Теперь перейдем к ПКО "НачислениеОценочныхОбязательствПоОтпускам" (стрелка 7 Рис. 12), состоящему из правил конвертации свойств (ПКС):
Ссылочные свойства выгружаются по указанным ПКО (стрелка 8 Рис. 12). То есть при выгрузке реквизитов "Организация" и "Ответственный" они будут выгружены согласно правилам ПКО с названиями "Организации" и "Пользователи".
В ПКО можно указать правила поиска объекта:
Признак (Стрелка 10 Рис. 13) не задан, следовательно, в случае, если объект не найден, то он будет создан.
Дополнения:
Обратите внимание, на Рис. 11 я обозначила раздел "Важно" стрелкой 6, так вот стрелка 11 - это тот самый признак, который необходимо установить, если вы используете произвольный алгоритм для ПВД.
Не забывайте пользоваться информацией по обработчикам (стрелка 12).
Если вы решили выгружать все изменения справочников и документов, то обратите внимание в ПВД на закладку "Дополнительно", там задан "Порядок выполнения".
По ссылкам ниже вы можете почерпнуть дополнительную информацию:
Создание с нуля (кратко)
У нас есть конфигурация источник и конфигурация приемник (они могут быть идентичными).
В случае, если конфигурации различаются, в каждой из конфигураций нужно запустить обработку "MD82Exp.epf" или "MD83Exp.epf", в зависимости от версии платформы.
Как-то по особому называть файлик выгрузки не нужно. При загрузке система сама определит наименование конфигурации.
Далее выгруженную структуру (структуры) загружаем в конвертацию.
Далее выбираем на рабочем столе конвертации пиктограмму "Правила обмена данными", нажимаем "Добавить" и в открывшемся окне выбираем конфигурации.
При появлении картинки ниже, жмите или "Закрыть" или "Создать новое правило обмена данными".
Загрузка имеющихся правил (кратко)
Если структура конфигурации была загружена только правилами, то в ней может не быть многих объектов.
Чтобы объекты добавить, вам нужно выгрузить структуру метаданных (описано в пункте "Создание с нуля" немного выше).
И далее загрузить эту структуру в имеющуюся конфигурацию.
Специальные предложения
подчеркнул много интересного) но много где и туман после прочтения статьи) некоторые вещи непонятны) видимо надо ознакомиться с Быстрым освоением КД в самой конфигурации и перечитать вашу статью)
(1) Кирилл, старалась вспомнить с чем у самой возникали трудности, но работаю с конфигурацией довольно давно и многие вещи уже кажутся очевидными.
Напишите мне в личку все вопросы, я расширю статью :)
Конвертация данных - это инструмент создания переноса для ленивых. Умея пользоваться этим инструментом можно быстренько набросать правила и перекинуть из одной базы 1С в другую базу, не обязательно в 1С. Но для реально сложных и постоянных обменов я бы его не рекомендовал. У меня были случаи когда вреда от использования КД было намного больше, чем если бы, долго но качественно, написал свою выгрузку-загрузку через dbf или txt с разделителями.
1) Например обработками из состава КД не контролируется дата запрета редактирования, и можно легко завалить базу в закрытом периоде. Когда данные потащатся по ссылкам.
Найдут эту ошибку через несколько недель, когда будет поздно откатывать из архива. Потом трудозатратное восстановление затертых данных.
2) Отладиться и поймать ошибку в коде, можно, но нужно обладать опытом и сноровкой.
3) Обработки универсального обмена громоздки с плохо читаемым кодом.
4) Файл обмена громоздкий, т.к. содержит текст правил обмена. Структура файла не очень понятна простому смертному. Например Нпп - это номер по порядку и т.д.
5) В случае изменения структуры хотя бы одного реквизита приемника или источника, весь обмен перестает работать, пока заного не перегрузишь конфигурации. Это сильно напрягает, когда конфигурация громоздкая, и постоянно ведется ее доработка или обновления. Например если изменили тип реквизита "строка 100 символов" на "строка неограниченной длины", будет ошибка несоответстия типов, хотя это никак не влияет на обмен.
6) Свой самописный обмен, проще отлаживать, понятная логика и структура файла, надежнее в использовании, файл меньше размером, не нужно гонять правила в файле. Но разрабатывать дольше по времени.
Каждый выбирает свое.
(4)
1. для этого предусмотрены события вызываемые перед загрузкой объектов в целевую БД, вот там та и нужно проверять закрыт период или нет
2. ну есть сложности, однако если правила не автоматически создаются, то ошибки легко находятся, так как все своими золотыми ручками делалось
3. а где легко?
4. ну так пишите правила, которые не будут тянуть за собой все данные из базы, а только те что действительно нужны. файл на выходе не предназначен для конечного юзера, да как и для программиста, это уже из разряда хакерства туда лезть ну или с точки зрения прогера контроль результата
5. ну к слову сказать, в некоторых ситуациях выгружать конфигурацию свежую не имеет смысла, так как к реквизитам объектов можно обращаться не только, если они явно есть в структуре конфигурации, у вас же под рукой язык программирования с поздним связыванием, к реквизиту можно из кода событий обращаться
6. сталкивался я с вручную написанными обменами, ничего хорошего, люди могут еще более странным образом так на извращаться, что мама не горюй
ikalmykia; kyrasol; Алексей Воробьев; Irwin; mib7; Dementor; sys1c; red80; jif; DarkAn; Новиков; MenZurKa; perepetulichka; sergelemon; mythos; + 15 – Ответить
Я не имею права судить Ваши проф качества, но комментарий больше походит на "Я так привык, а другие делают не правильно!"
(6) Раз 20 писал правила на КД разной сложности, и несколько сотен раз свои механизмы обмена, это личной опыт, использования этого инструмента.
Про контроль даты запрета, понятно, что после того как на грабли наступишь, будешь уже втыкать проверки во все возможные обработчики. ТС написал статью для новичков, моя задача их предупредить о всех подводных камнях.
Ни слова не писал, что я так привык а другие делают не правильно, старался объективно написать все приемущества и недостатки данного инструмента, с которыми столкнутся новички.
Свой обмен - это ни какие не правила, нет там вообще правил, забудьте про термины навязываемые фирмой 1С.
По личному опыту, написал свой обмен и забыл на долгие долгие годы.
А правила обмена, постоянно требуют вмешательства, практически после каждого обновления.
А во времена медленного интернета и дорогово траффика, когда обмен работает по расписанию с интервалом 15 минут, от них больше вреда было чем пользы. Самих данных с гулькин нос, зато правила тащим туда-сюда.
Конвертация - это универсальный механизм. А за универсальность всегда приходится платить.
LuxVeritatis; Forest; AZel84; red80; jif; user761890; ice-net; DarkAn; Новиков; kild; IvanovAV; + 11 – Ответить
6) Свой самописный обмен, проще отлаживать, понятная логика и структура файла, надежнее в использовании, файл меньше размером, не нужно гонять правила в файле. Но разрабатывать дольше по времени.
Самый быстрый обмен - это прямая заливка на T-SQL из источника в приемник, без всяких промежуточных файлов и прочего. Но, чтобы напр., написать такой обмен, который бы как и КД тащил все по ссылке, предположим для какого-нибудь типового документа типа РТУ - вы потратите времени столько, сколько на разработку правил для всей конфигурации. Кроме того, в процессе оптимизации, вы придете к еще более сложному варианту когда хранимки хранятся на сервере, вьюшки имеют русские имена и их нужно актуализировать и еще много такой вот магии. Я этого говорю не на бла-бла-бла, а как чел, который ранее такие обмены и писал. Поверите ли на слово, но поддерживать такой обмен в актуальном состоянии и тем более баго-фиксить и трейсить - это задача не на, а в - В несколько раз сложнее чем на любой КД. Поэтому, в последствии, я все всем переписал на КД. Да медленнее, иногда значительно медленнее, но очень просто поддерживаемый и любые вопросы по нему, решаются относительно просто. Аналогичные вопросы на скулевом обмене решаются всегда на стороне скуля и надо обладать хорошими скилами не только в T-SQL как таковом, но и хорошем понимании "внутренней" кухни самой платформы. В итоге, я сейчас, с позиции именно практического опыта, не могу представить - когда я еще буду писать такие велосипедные обмены на скуле.
Этот документ является дополнением к документации по конфигурациям «Документооборот КОРП», «Документооборот ПРОФ», «Документооборот государственного учреждения» и содержит только описание отличий версии 2.0.8 от версии 2.0.7.
Документы и файлы
Повышение удобства работы с документами
Версии: ПРОФ, КОРП, ДГУ.
На основании ряда юзабилити-тестов в программу внесены изменения, повысившие удобство работы с документами. Рассмотрим эти изменения подробнее.
Отображение реквизитов документов
В новой версии программы незаполненные реквизиты Регистрационный номер и Дата регистрации не отображаются в карточке документа.
Отображение заполненных реквизитов Регистрационный номер и Дата регистрации не изменилось.
Для пользователей, исполняющих роль Делопроизводитель, поведение программы не изменилось.
Выделение быстрого отбора
Быстрый отбор, установленный в списках документов или других объектов, автоматически применяется при повторном открытии списка.
В новой версии программы заполненное поле быстрого отбора выделяется цветом. Это поможет пользователю не забыть об установленном отборе. После очистки поля выделение снимается.
Рис. 2. Выделение быстрого отбора цветом
Переключение в режим списка
Список внутренних документов по умолчанию выводится в режиме По папкам.
Раньше чтобы просмотреть список всех документов нужно было выполнить команду Еще – Просмотр – Списком.
Теперь для переключения в режим Списком достаточно кликнуть на корневую папку. При этом вы увидите список всех внутренних документов.
Рис. 3. Список всех внутренних документов
Переключение в режим списка аналогичным образом работает и для других режимов просмотра списка внутренних документов: по видам, по вопросам деятельности, по корреспондентам и других.
Выделение реквизита «Срок исполнения»
В новой версии программы не соблюденный срок исполнения документа выделяется красным цветом на закладке Обзор карточки документа, в списках входящих и внутренних документов.
Срок исполнения считается не соблюденным, если по его истечению документ все еще не исполнен.
Рис. 4. Не соблюденный срок исполнения документа
Колонка Срок исполнения в списке документов по умолчанию скрыта. Ее можно вывести при помощи команды Изменить форму в меню Еще.
ОГРН для корреспондентов
Версии: ПРОФ, КОРП, ДГУ.
В новой версии программы появилась возможность указывать Основной государственный регистрационный номер корреспондента.
Этот номер удобно использовать для идентификации корреспондентов и автозаполнения файлов.
Теперь в справочнике Корреспонденты можно указать:
- ОГРН – для юридического лица;
- ОГРНИП – для индивидуального предпринимателя;
- Регистрационный номер – для иностранной организации.
Рис. 5. Новые реквизиты справочника «Корреспонденты»
При добавлении нового корреспондента выполняется проверка на наличие аналогичного государственного номера в информационной базе.
В полях со ссылкой на корреспондента предусмотрен автоподбор по ОГРН. Например, в поле Отправитель входящего документа можно начать вводить ОГРН и программа найдет и подставит нужного корреспондента.
Индекс ответственного в регистрационном номере документа
Версии: ПРОФ, КОРП, ДГУ.
В новой версии программы в регистрационный номер документа можно добавить индекс ответственного сотрудника.
Как настроить
В карточке нумератора на закладке Формат номера выберите Индекс ответственного. Индекс может быть как суффиксом, так и префиксом номера.
Рис. 6. Настройка нумератора с индексом ответственного сотрудника
После добавления индекса в нумератор, в карточках пользователей станет доступно поле Индекс нумерации, в котором можно указать любые символы. Например, ФРО для сотрудника Фролова.
Если индексы необходимо создать для большого числа пользователей, рекомендуется делать это в списке Индексы нумерации раздела НСИ.
Рис. 7. Индексы нумерации для ответственных сотрудников
Настроенный нумератор нужно присвоить виду входящего, исходящего или внутреннего документа.
После этого необходимо создать документ данного вида, назначить ответственного сотрудника и зарегистрировать документ. В номере документа отобразится индекс ответственного.
Рис. 8. Индекс ответственного в регистрационном номере документа
История в листе согласования
Версии: ПРОФ, КОРП, ДГУ.
В новой версии программы в лист согласования попадают не только финальные визы согласующих, но и история согласования со всеми внесенными ранее комментариями.
Это позволит оперативно получать информацию о ходе согласования документа, комментариях согласующих лиц и сроках прохождения каждого этапа.
Рис. 9. Лист согласования с историей
Для печати истории согласования на закладке Визы карточки документа предусмотрена команда Печать – Лист согласования с историей.
Рис. 10. Печать листа согласования с историей
Совместная работа
Учет мероприятий, организованных корреспондентами
Версии: КОРП, ДГУ.
В новой версии программы появилась возможность вести учет мероприятий, организаторами которых являются корреспонденты. При этом необходимые реквизиты и связи будут устанавливаться автоматически.
Благодаря новым возможностям можно автоматизировать, например, следующие сценарии:
- организация получила письмо от регулирующего органа с предложением или указанием провести ряд выездных сессий или других мероприятий на местах;
- организация получила приглашение на отраслевой форум. Для принятия решения об участии на основании этого приглашения необходимо провести ряд совещаний и встреч.
Опишем новые возможности программы подробнее.
Указание организатора мероприятия
Раньше в качестве организатора мероприятия могли выступать только внутренние пользователи, теперь это могут быть корреспонденты и их контактные лица.
Рис. 11. Мероприятие, организатором которого является корреспондент
Права на изменение мероприятия
В новой версии программы права на изменение мероприятия может получить не только организатор, но и сотрудник, подготовивший мероприятие, и куратор.
Для этого в карточке мероприятия появились два новых реквизита: Подготовил и Куратор. Пользователи, указанные в данных полях, получают права на изменение мероприятия.
Рис. 12. Новые реквизиты в карточке мероприятия
Реквизит Подготовил есть у всех мероприятий. Это сотрудник, который ввел данные мероприятия в «1С:Документооборот».
Реквизит Куратор есть у мероприятий, для которых в настройках вида установлен флажок Ведет куратор. Куратор – это сотрудник, который отвечает за данное мероприятие от лица организации.
Рис. 13. Настройка вида мероприятия
Автоматическая установка связей
Теперь при создании мероприятия на основании входящего или исходящего документа между документами и мероприятием автоматически устанавливается связь Содержит переписку по предмету. Раньше такая связь была только у внутренних документов.
Рис. 14. Связь мероприятия с входящим и исходящим документами
При создании мероприятия на основании входящего документа автоматически заполняются следующие реквизиты: наименование, описание, гриф доступа, организация, проект, организатор и контактное лицо организатора.
При создании исходящего документа на основании мероприятия автоматически заполняются следующие реквизиты: заголовок, гриф доступа, организация, проект, получатели.
Процессы и задачи
Фоновое выполнение задач
Версии: КОРП, ДГУ.
В новой версии программы выполнение задач проходит в фоновом режиме, не блокируя работу пользователя.
Как это работает
Сразу после того, как пользователь нажимает кнопку выполнения задачи, эта задача помещается в очередь, которая обрабатывается новым регламентным заданием Фоновое выполнение задач. По умолчанию задание выполняется каждые 10 секунд.
Задачи, поставленные в такую очередь, не отображаются в списках Задачи мне, Задачи от меня и отчетах. В других списках такие задачи помечены иконкой .
Рис. 15. Задачи, поставленные в очередь для фонового выполнения
Как настроить
По умолчанию фоновое выполнение задач включено в клиент-серверном варианте работы. Отключить его можно настройкой Использовать фоновое выполнение задач (Настройка и администрирование – Настройка программы – Процессы и задачи).
В файловом варианте работы фоновое выполнение задач не предусмотрено.
Рис. 16. Настройка фонового выполнения задач
Процессы в распределенной информационной базе
Версии: КОРП, ДГУ.
Для корректной работы процессов с параллельным выполнением задач в РИБ изменена логика обработки процессов.
Теперь процесс продвигается по маршруту (выполняются задачи, маршрутизация комплексных процессов) только в том узле РИБ, в котором этот процесс стартовал. При этом выполнение задач проходит только в фоновом режиме. Отключение фонового выполнения задач не предусмотрено.
Конфликты при изменении процессов в разных узлах РИБ, обрабатываются особым образом: данные в дочерних узлах теперь не затираются данными из главного узла.
Информационная поддержка
Узнать больше об «1С:Документообороте»
Теперь вы можете узнать больше об «1С:Документообороте» прямо из главного меню. Мы собрали для вас ссылки на самые интересные источники.
Рис. 17. Где узнать больше об «1С:Документообороте»
Официальные группы в социальных сетях
Коллеги, приглашаем присоединиться к официальным группам программы "1С:Документооборот":
Это свободная площадка для живого общения всех, кто пользуется, изучает, администрирует, внедряет или просто интересуется «1С:Документооборотом».
Делитесь опытом, спрашивайте, советуйте, оставляйте отзывы, хвастайтесь, интересуйтесь — обсудим вместе с командой разработки и вашими коллегами.
В свою очередь, мы не оставим вас без свежих новостей «из первых уст», полезных «фишек», ссылок на познавательные материалы, приглашений на вебинары, учебные курсы и мастер-классы.
Рис. 18. Официальная группа «1С:Документооборота» в Facebook
Прочие изменения
Порядок обновления с предыдущих версий
После обновления с версий 1.4.4 – 1.4.12
После обновления на 2.0 для начального заполнения списка Мои документы необходимо запустить обработку ЗаполнениеСпискаМоиДокументы.
Обратите внимание: при большом количестве документов обновление информационной базы на версию 2.0.8 может занять продолжительное время.
После обновления с версий 2.0.3 – 2.0.6
Из-за ошибки, обнаруженной в версиях 2.0.3 – 2.0.6, пересчет прав некоторых объектов не проводился.
Для пересчета этих прав необходимо запустить внешнюю обработку Обработка нерассчитанных прав, которая включена в состав дистрибутива.
Обратите внимание: обработка запустит все операции по пересчету прав, которые могли быть пропущены. Это может занять продолжительное время.
К сожалению, у Вас недостаточно прав для дальнейшего просмотра.
Если Вы приобрели курс, но еще не активировали токен — пожалуйста, активируйте доступ по инструкциям, высланным на Ваш email после покупки.
Если Вы не залогинены на сайте — залогиньтесь, вернитесь на эту страницу и обновите ее.
Если Вы залогинены, у Вас активирован токен доступа, но Вы все равно видите эту запись — напишите нам на e-mail поддержки.
Комментарии / обсуждение (83):
Здравствуйте. Есть ли возможность выполнить ДЗ 4.16.1 на конфигурациях УТ 11.3.4.31 и БП 3.0.51.22. В УТ для БП 3.0 доступен только универсальный формат. Может стоить заменить ДЗ на более актуальные версии конфигураций?
…
(текст комментария доступен только участникам Мастер-группы)
А я думал КД 2 – это универсальный инструмент, а все остальное дополнение
…
(текст комментария доступен только участникам Мастер-группы)
Здравствуйте. Использую БП 3.0.48.22 и УТ 11.1.2.9 – не получается настроить обмен. Как я понял – в этой верии УТ нет универсального обмена данными. До какой версии можно использовать УТ 11.1 ?
…
(текст комментария доступен только участникам Мастер-группы)
Здравствуйте, как выгрузить правила обмена при синхронизации данных через универсальный формат?
в УТ 11.4.2.90 и БП 8.3.10.2667
вижу только сохранение в файл правил регистрации
…
(текст комментария доступен только участникам Мастер-группы)
Пользователю, указанному для подключения к другой программе, должны быть назначены роли “Администратор системы” и “Полные права”
Роль и полные права у пользователя установлены
В чем может быть причина?
…
(текст комментария доступен только участникам Мастер-группы)
Вроде все что возможно проставила
…
(текст комментария доступен только участникам Мастер-группы)
Подскажите, пожалуйста, какой релиз для тестов взять
…
(текст комментария доступен только участникам Мастер-группы)
При выполнении домашнего задания возникли вопросы. Использовал конфигурации УТ 11.1.10 и БП 3.0.43.
1. Выгруженные из УТ правила обмена хранятся в zip-файле и имеют два файла – CorrespondentExchangeRules, ExchangeRules. При загрузке этого файла загружался все время первый файл, потому что полученный обмен назывался “БП – УТ. Но мне нужно было доработать второй файл, так он как раз содержит правила “УТ – БП”.
Я решил проблему, вытащив файл ExchangeRules из архива, загрузив его в КД, доработав и вернув обратно в архив. Этот архив указал в настройках обмена в УТ как используемые правила.
Есть ли какой-то более правильный способ выполнить эти действия? Я видел в КД опцию “Выгружать правила корреспондента”. Это значит, что можно загрузить сразу оба правила в КД и потом выгрузить оба?
2. Загруженные мной правила имели наименование “УТ-БП (11.1.10.131, 3.0.42.1, v.5)”. Получилось, что версии конфигураций, которые я использовал и для которых предназначены правила различались. Возникла ситуация, что мои доработанные правила не сработали. Из журнала регистрации я понял, что в правилах выгрузки записана версия БП 2.0.43, а в правилах корреспондента версия 2.0.42. Это получилось потому, что я загружал метаданные БП и версия конфигурации в КД поменялась на ту, которую использовал я. Я отредактировал вручную правила выгрузки, вернув те версии, которые были изначально, и все заработало.
Как обходить эту ситуацию правильно, может я пропустил какой-то шаг? Мне только приходит в голову, что можно было правила корреспондента тоже загрузить в КД, выгрузить, и версии бы обновились и во вторых правилах.
…
(текст комментария доступен только участникам Мастер-группы)
Добрый день!
Появилось несколько вопросов.
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С:Зарплата и управление персоналом 3» (ЗУП) и «1С:Бухгалтерия предприятия 3» (БП). Отметим сразу, в данной задаче нам придется снять конфигурацию с поддержки. Данное потребуется по условию.
Живой пример потребности в доработке типовых правил обмена
Например, заказчик обратился к нам с такой проблемой: при синхронизации между ЗУП и БП нет возможности передать данные справочника «Регистрации в налоговом органе», которые необходимы для заполнения документа «Отражение зарплаты в бухучете». Сейчас табличная часть этого документа на стороне приемника БП содержит пустую «Регистрацию…» и пользователям приходится вручную создавать такие записи в справочнике. Согласитесь, это неудобно. Можем доработать этот момент.
Решение проблемы: доработаем пакет конвертации из плана обмена ОбменЗарплата3Бухгалтерия3. Добавим в типовые «Правила обмена 1С» новое «Правило конвертации объектов» (ПКО) для справочника «Регистрации в налоговом органе» и соответственно «Конвертацию свойств» этого справочника (ПКС). Обязательно доработаем типовые «Правила регистрации объектов», т.к. возникла необходимость зарегистрировать изменения справочника на узле обмена. И пересмотрим «Правила обмена 1С» базы корреспондента.
Где все это будем редактировать? для написания и изменения правил нам потребуется конфигурация «1С:Конвертация данных 2».
Доработка типовых правил конвертации из Плана обмена ЗУП – БП
Итак, доработку правил обмена 1С начнем с того, что в конфигураторе для плана обмена ОбменЗарплата3Бухгалтерия3 в состав добавим новый элемент – справочник РегистрацииВНалоговомОргане. Данное изменение сделаем в обоих конфигурациях «1С:Зарплата и управление предприятием 3» и «1С:Бухгалтерия предприятия 3».
Сохраним и обновим конфигурации.
В режиме предприятия для каждой базы выгрузим описание структуры метаданных с помощью обработки MD83Exp.epf для платформы «1С:Предприятие 8.3». Обработку можно найти в комплекте «1С:Конвертация данных».
На следующем этапе выгрузим пакет конвертации из ЗУП и БП. Пакет должен состоять из 3 файлов: ПравилаРегистрации, ПравилаОбмена, ПравилаОбменаКорреспондента.
В рамках данной статьи не будет описания как настраивается синхронизация данных, это можно прочитать на сайте компании «Кодерлайн» в разделе
Вот такой пакет после выгрузки должен у нас получиться.
Аналогичные действия выполним и для другой информационной базы «1С:Бухгалтерия предприятия».
В итоге все подготовительные работы для редактирования правил готовы. У нас есть:- описание структуры метаданных для загрузки в «1С:Конвертация данных 2» (для ЗУП и БП);
- пакет конвертации, который содержит правила обмена 1С и правила регистрации, необходимые для загрузки в «1С:Конвертация данных 2» (для ЗУП и БП).
Переходим в «1С:Конвертация данных 2» . Выполним следующие действия по порядку для обоих информационных баз:
- загружаем структуры метаданных наших конфигураций;
- создаем конвертации и загружаем правила обмена данными 1С из пакетов конвертации (файл правил называется ExchangeRules);
- создаем регистрации и загружаем правила регистрации из пакетов конвертации (файл правил называется RegistrationRules).
Переходим непосредственно к нашей доработке. В правила обмена 1С добавляем новое правило конвертации объектов (ПКО) – справочник «Регистрации в налоговом органе». Добавляем правило конвертации свойств (ПКС) для этого справочника и правило выгрузки данных (ПВД). Такого рода доработку необходимо выполнить как для правил из пакета ЗУП, так и для правил обмена из пакета БП. Выгружаем наши правила обмена в соответствующие файлы ExchangeRules.
Переходим к правилам регистрации нового элемента. Добавляем справочник «Регистрации в налоговом органе». Выгружаем правила регистрации в соответствующий файл из пакета RegistrationRules. Это действие также выполняем для обоих баз.Доработанные правила обмена и правила регистрации готовы. Теперь в правила корреспондента (CorrespondentExchangeRules) из пакета ЗУП копируем содержимое правил обмена (ExchangeRules) из пакета БП. В правила корреспондента (CorrespondentExchangeRules) из пакета БП копируем содержимое правил обмена (ExchangeRules) из пакета ЗУП.
В итоге должно получиться следующее:
На этом работа в «1С:Конвертация данных 2» завершена. Доработанные пакеты правил конвертации готовы, осталось загрузить их обратно в информационные базы и проверить синхронизацию.Архивируем файлы из пакетов в Архив ZIP и загружаем в ЗУП и БП свои пакеты конвертации.
Все готово. Осталось протестировать.
Вспомним условия задачи. Необходимо было зарегистрировать к выгрузке справочник «Регистрации в налоговом органе» и проверить, как заполняется ТЧ документа «Отражение зарплаты в бухучете» на стороне «1С:Бухгалтерия предприятия 3».
В источнике «1С:Зарплата и управление предприятием 3» регистрируем к выгрузке наш справочник. Выполняем синхронизацию. Переходим в базу приемник и тоже выполняем синхронизацию для получения данных. Обратим внимание, что теперь в плане обмена появился нужный справочник для регистрации изменений.
Проверяем на стороне «1С:Бухгалтерия предприятия 3»:
Подведем итог. Результат поставленной задачи выполнен успешно. Мы доработали план обмена ЗУП – БП, добавив новый элемент для регистрации изменений и дописали правила конвертации для синхронизации данных.Читайте также: