Обмен вики и 1с

Обновлено: 07.01.2025

Механизмы интеграции

Конфигурация "1С:Документооборот" редакции КОРП содержит несколько встроенных планов обмена с другими типовыми конфигурациями на платформе "1С:Предприятие".

Редакции ПРОФ и ДГУ не содержат таких планов обмена. Тем не менее, все редакции поддерживают обмен данными с помощью встроенной обработки УниверсальныйОбменДаннымиXML , использующей внешние правила обмена, загружаемые из файла. Собственные планы обмена можно добавить в любую из редакций.

Встроенные планы обмена предназначены для автоматической синхронизации данных в ходе совместного использования разных прикладных решений, но могут использоваться и для первоначального наполнения информационной базы.

Внешние правила обмена, поставляемые в составе дистрибутива, предназначены скорее для первоначального наполнения информационной базы, но могут использоваться и для последующей синхронизации данных. В последнем случае обмен нужно будет запускать регулярно вручную.

Встроенные планы обмена используют подсистему Обмен данными "Библиотеки стандартных подсистем" (далее БСП) редакции 2. Это значит, что в составе каждого плана обмена есть макет с правилами регистрации, а также макеты правил обмена и правил обмена конфигурации-корреспондента:

Правила регистрации используются в "1С:Документообороте" для определения необходимости регистрации записываемого объекта к выгрузке в конфигурацию-корреспондент.
- Типовые правила регистрации тривиальны (содержат только перечень регистрируемых объектов без дополнительных условий).
- Автоматическая регистрация изменений в планах обмена выключена, для регистрации используется стандартная механика БСП, анализирующая изменения в выгружаемых полях перед регистрацией.
При необходимости комплект правил может быть загружен из файла. Как правило, это делают:
- после обновления конфигурации-корреспондента. В этом случае свежий комплект правил находится в составе дистрибутива обновления, в папке "Синхронизация данных";
- во время отладки правил обмена, разрабатываемых на основе типовых правил, если они требуют доработки на конкретном внедрении.
После отладки доработанных правил обмена рекомендуется включить их в состав конфигурации, сняв с поддержки макеты, чтобы:
- получить возможность сравнивать доработанные правила с типовыми при обновлении конфигурации;
- избежать проблем, связанных с проверкой правил при обновлении информационной базы после изменения структуры метаданных.
Обратите внимание:
Правила, загруженные из файла и переставшие соответствовать новой структуре метаданных, не дадут довести до конца штатное обновление информационной базы.

Правила обмена разрабатываются с помощью конфигурации "Конвертация данных" редакции 2.1. Конфигурация бесплатна и доступна по линии ИТС. Рекомендуется использовать типовые правила как основу для разработки, сохранив их в файлы и загрузив в информационную базу "Конвертации данных".

"1С:Документооборот" не поддерживает обмен данными в формате EnterpriseData. Соответственно, для разработки правил обмена не следует использовать конфигурацию "Конвертация данных" редакции 3.

Расширение плана обмена

При включении новых объектов в существующий план обмена следует:

Добавление плана обмена

При разработке собственных планов обмена следует:
1. Создать новый план обмена на стороне обеих конфигураций. Имя плана обмена должно быть одинаковым в обеих конфигурациях. Состав обязательных процедур модуля менеджера плана обмена приведен в документации к подсистеме Обмен данными "Библиотеки стандартных подсистем" соответствующей версии.
2. Включить в состав планов обмена объекты, участвующие в обмене, а также регистр сведений СоответствиеОбъектовИнформационныхБаз , запретив авторегистрацию изменений. Использование собственного механизма регистрации БСП позволит избежать выгрузки объектов, изменившихся только в части не участвующих в обмене реквизитов.
3. Создать подписки на события, аналогичные описанным выше, и обработчики для них. Лучше создать для этого отдельный общий модуль, не снимая с поддержки общий модуль ОбменДаннымиСобытияДокументооборот .
4. Включить новый план обмена в тип параметра общих команд подсистемы Обмен данными . Проще всего найти нужные команды, выполнив в Конфигураторе поиск ссылок на типовой план обмена.
5. Включить новый план обмена в код процедуры ПолучитьПланыОбмена общего модуля ОбменДаннымиПереопределяемый .
6. При необходимости создать формы настройки плана обмена (см. документацию к "Библиотеке стандартных подсистем", а также примеры в планах обмена с конфигурациями "1С:Бухгалтерия" предприятия и "1С:Управление производственным предприятием").
7. Сохранить описания обновленных конфигураций в файлы с помощью обработки MD8<NNN>Exp.epf , входящей в состав дистрибутива конфигурации "Конвертация данных".
8. Загрузить описания конфигураций в информационную базу "Конвертации данных".
9. Разработать два набора правил обмена и два набора правил регистрации для каждой из сторон обмена.
10. Добавить оба набора правил обмена и по одному набору правил регистрации в каждую конфигурацию в качестве макетов плана обмена.
11. Настроить синхронизацию данных и отладить ее.
Обратите внимание:
Правила обмена, зачитанные из макетов в составе конфигурации, кэшируются в регистре сведений ПравилаДляОбменаДанными . При отладке рекомендуется использовать загрузку правил обмена из файла. Для обновления правил из макета следует изменить номер версии конфигурации или выполнить загрузку вручную по команде Загрузить правила… , выбрав вариант Из конфигурации .

Веб-сервисы

Типовая конфигурация "1С:Документооборот" содержит набор веб-сервисов.

Некоторые из них специализированы и служат, например, для обмена с мобильными устройствами или для синхронизации данных с другими информационными базами, разработанными с применением "Библиотеки стандартных подсистем".

Два веб-сервиса, однако, предназначены для интеграции с произвольными внешними программами, как разработанными на платформе "1С:Предприятие", так и любыми другими, способными обращаться к веб-сервисам. Речь идет о веб-сервисах:
- Files – простой сервис, поддерживающий работу с файлами и папками "1С:Документооборота" извне.
- DMService – поддерживает работу с основными объектами и функциями "1С:Документооборота". Перекрывает функционал веб-сервиса Files . Используется "Библиотекой интеграции 1С:Документооборота".
Данные веб-сервисы включены во все редакции "1С:Документооборота".

Работа с веб-сервисами из прикладных решений на платформе "1С:Предприятие", как правило, строится следующим образом:
1. Определяется способ хранения и редактирования настроек подключения к веб-сервису. Настройки состоят из:
  - Адреса веб-сервиса;
  - Имени пользователя и пароля (в текущих версиях платформы поддерживается только аутентификация "1С:Предприятия", поэтому следует либо предоставить пользователям интегрируемого прикладного решения возможность ввести имя пользователя и пароль, либо использовать для доступа служебную учетную запись, для которой запрещен интерактивный вход);
  - Таймаута при обращении к сервису (при низком качестве соединения, а также при первом обращении к сервису задержки могут быть значительными).
2. Определяется способ получения WSПрокси для обращения к веб-сервису. Операции создания WSОпределений и WSПрокси достаточно затратны, поэтому рекомендуется выносить получение реквизитов, в отдельный общий модуль с повторно возвращаемыми значениями.
3. Создаются процедуры и функции, являющиеся обертками для функционала веб-сервиса на стороне прикладного решения. Непосредственную работу с объектами 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С
- Категоризация статей - возможно иметь произвольное дерево категорий в Вики. Статья может принадлежать любому количеству категорий
- Автоматическое построение взаимосвязей
- Единообразие статей за счет использоавния шаблонов
- Описание объектов строятся на основании структуры метаданных конфигурации
- Ведение Документа
* Общее. Все изменяемые алгоритмы вынесены в выбираемые адаптеры. Возможность назначения используемых адаптеров.

- Общее. Требование использования модальных окон. Унификация вызовов диалогов по асинхронным вызовам, эмуляция асинхронных вызовов для платформы 8.2

+ Настройки. Выбор использования фильтра по подсистемам при выборе объекта метаданных.

+ Общее. Значительно уменьшено время записи страницы (примерно в 3.5 раза).

+ Общее. Добавлена типизация используемых семантических свойств.

- Администрирование. Удалена возможность очистки кэша - неизвестное время выполнения на больших количествах страниц. Необходимо использовать обновление ссылок.

- Ошибка получения обработки адаптера диалога в толстом клиенте обычном приложении.

- Ошибка трансляции содержания при наличии пустых форматированных строк.

- Удалено построение обратной связи (объект используется в) объектов. Связано с превышением допустимого размера страницы при наличии нескольких реквизитов составных типов в объекте.

- Ошибка ограничения доступа к обработке обновления

* Общее. Составные типы реквизитов при возможности сворачиваются до ссылок на категории объектов.

+ Общее. Возможность описания констант, планов счетов, планов обмена, планов видов характеристик.

- Ошибка получения описания реквизита при его переименовании в конфигурации.

В этой обработке не мало настроек, но в большинстве своем они или автоматические/полуавтоматические или не требуют от пользователя каких-то специфических знаний.

Главное окно обработки.

Открывается обработка стандартными средствами через меню "Файл-Открыть". Результат на фото ниже.

Окно настроек программы.

Открывается нажатием на кнопку "открыть настройки". Результат на фото.

Вкладка JWT токен.

Здесь необходимо заполнить значения
1. JWT Server. - строка имя вашего сайта - обычно имеет вид "ваш-сайт.ру".
2. JWT сервис подключения. - строка сервиса, который выдает JWT токен.
3. Имя пользователя и пароль пользователя WordPress. - С помощью этих данных получаем токен.
Публикация постов и страниц осуществляется с помощью токена.

"Текущий токен" содержит строку токена, с помощью которого осуществляется вся деятельность по публикации на сайте.

"Текущий токен действителен" - действительность токена в секундах с момента получения, обычно 24 часа * 60 часов * 60 секунд.

"Токен действителен до" - дата до которой действителен токен, после которой токен не действителен и необходимо получить новый.

Заголовки по умолчанию, типовые, не специфичные, которые можно использовать для публикации на сайте.

Вкладка настройки WordPress.

Эта вкладка используется для получения и создания категорий постов в WordPress. Близким аналогом категорий является "Группы" (папки) в справочниках 1С.

Здесь сначала необходимо нажать кнопку "получить с сайта и заполнить", чтобы получить с сайта те категории, которые уже есть. При необходимости можно изменить имеющиеся и добавит новые. В последствии посты из 1С можно будет публиковать в определенную категорию созданную здесь.

Кнопка "Сохранить категории постов" говорит сама за себя.

Настройки WooCommerce.

На вкладке настроек подключения к WooCommerce необходимо заполнить "Имя пользователя" и "Секретный код пользователя", которые необходимо создать на сайте. А также установить по какому принципу будет происходить авторизация на сайте.

Здесь, на мой взгляд, всё подробно расписано, проблем возникнуть не должно.

Читайте также: