Интеграция Directum RX с несколькими базами 1С на реальном примере

Среди требований заказчика при внедрении Directum RX часто бывает интеграция с системой 1С. А что делать, если таких систем не одна, а 2, 3…36 экземпляров. На первый взгляд такая ситуация кажется трудной, даже пугающей. Но это только на первый взгляд, на самом деле все немного проще.

В статье приведен пример работы с таким кейсом. Но для начала опишем общую схему работы интеграции Directum RX и 1С

Механизм синхронизации данных реализован в утилите DrxUtil. Утилита обеспечивает обмен данными с сервером приложений Directum RX через интернет, а с системой 1С через COM-соединение с помощью обработки «Универсальный обмен данными в формате XML». На изображении видно, что в рамках одной локальной сети обмен данными может проводится с несколькими базами 1С. Для каждой базы должен быть настроен файл _settings.xml, разработаны правила интеграции, которые используются утилитой DrxUtil, о чем будет написано ниже.

Кейс заказчика N по интеграции Directum RX с базами 1С

Основным и одновременно пугающим требованием заказчика N была интеграция 36 баз 1С с одним экземпляром Directum RX. Такое количество баз обусловлено тем, что каждая база – это самостоятельное юр. лицо. Во всех экземплярах 1С была установлена стандартная конфигурация 1С «Бухгалтерия предприятия», которая могла бы как-то повлиять на синхронизацию. Это позволило использовать стандартные правила коннектора 1С, который входит в набор утилит DrxUtil. Для каждого экземпляра 1С требовалось синхронизировать следующие типы сущностей:

• Наши организации;
• Контрагенты;
• Банковские счета:
• Банки;
• Договоры;
• Валюты.

Выполнялась односторонняя интеграция из 1С в RX.

Реализация интеграции Directum RX и 1С

Настройка инфраструктуры

Первым делом необходимо определиться на каком сервере будет проходит синхронизация между системами 1C и Directum RX. На этом сервере должны находится: платформа 1С, включая конфигуратор с подключенными для настройки базами 1С, утилита DrxUtil, а так же произведены настройки для COM – соединения между утилитой и 1С. Важно понимать, что независимо от количества баз 1С в синхронизации участвует один экземпляр DrxUtil, потому что параллельный запуск утилит может привести к ошибкам, т.к. утилиты могут одновременно работать с одними и теми же данными.

Разработка правил для утилиты DrxUtil

Далее реализовываем правила для синхронизации сущностей. Правила определяют логику выполнения переноса данных из одной системы в другую и выполняются при вызове сеанса интеграции. В них описан процесс импорта данных, поиска дублей, фильтрации и т.д. Более подробно можно почитать здесь. Правила находятся в папке Rules утилиты DrxUtil. Так как конфигурация для всех баз была идентичная, и требованиям заказчика по синхронизации удовлетворяли базовые правила, то в нашем случае оставалось только определить конструктор, в котором нужно прописать свойства конфигурации 1С. Пример правила для импорта контрагентов:

  /// <summary>
  /// Правило импорта контрагентов из 1С: Бухгалтерия предприятия 3.0 в DirectumRX.
  /// </summary>
  [Export(typeof(Rule))]
  class CustomCompanyImport : CompanyImport
  {
    public CustomCompanyImport() : base()
    {
      this.Name = "CustomCompanyImport";
      this.MinConfigurationVersion = "3.0.0.0";
      this.MaxConfigurationVersion = "3.1.0.0";
      this.ConfigurationTypes = new List<string> { "БухгалтерияПредприятия" };
      this.SourceType1C = "Контрагенты";
      this.TargetTypesRX = new List<Type>() { EntityTypesRXMetadata.CompanyType };
    }
  }

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

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

Собираем решение, добавляем библиотеку с кастомными правилами в папку Rules утилиты DrxUtil. На этом настройку правил можно считать законченной.

Настройка конфигураций 1С для интеграции

Следуем всем рекомендациям, указанным в справке о подготовке 1С к интеграции и настраиваем все конфигурации баз, которые участвуют в синхронизации. Но на одном моменте стоит обратить внимание – Идентификатор системы 1С. Для каждой конфигурации он должен быть уникальным! Это необходимо для того, чтобы сопоставлять созданные сущности в RX с записями определенной базы 1С.

Работа с конфигурационными файлами

Конфигурационный файл _configSettings.xml настраивается согласно рекомендациям. Настройку _settings.xml рассмотрим подробнее.

Для каждой интегрируемой базы должен быть свой файл _settings<Id_1C>.xml. Для удобства создадим в папке DrxUtil папку, которая будет хранить в себе настройки для каждой базы 1С. Важный момент в конфигурационном файле:

Секция параметров соединения с базой - Instance1C:

Узел systemId – в нем прописываем идентификатор системы 1С, для интеграции с которой используется текущий файл _settings<Id_1C>.xml Т.е. двух конфигурационных файлов с одним и тем же значением для этого узла не должно быть.

Запуск синхронизации Directum RX и 1С

После настройки конфигурационных файлов для всех баз 1С создадим .bat файл, в котором опишем все необходимые запуски DrxUtil. Пример: 

На изображении видно, что один экземпляр DrxUtil запускает процесс синхронизации, используя для каждой базы свой файл настроек. Данные процессы запускаются последовательно, т.е. пока не завершится текущий следующий процесс не начнется. Данный bat-файл можно запускать вручную, а можно создать в планировщике Windows задание для автоматического запуска интеграции с базами 1С, указав в запускаемом файле наш bat-файл. При первом переносе данных мы запускали файл вручную для отслеживания результатов, о которых будет написано ниже. Синхронизация продолжалась довольно долго, так как в базах находилось достаточно записей для синхронизации.

Проблемы, которые возникли в результате синхронизации

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

Так же ярким примером служат банковские счета. Из 1С они передаются в связке с банком, но банки расценивались при импорте как дубли, т.к. в RX уже существовали банки из других баз, поэтому не для всех контрагентов импортировались счета.

Необходимо учитывать подобные моменты при синхронизации. Если дописать правила, то такие моменты можно максимально нивелировать. Но все же лучше устранять дубли в базах 1С, синхронизировать их между собой. Сделать это позволяет внутренний функционал 1С, поэтому перед синхронизацией с внешней системой, желательно предложить заказчику «навести порядок» в его базах. 

Подводя итог, можно сказать, что синхронизация Directum RX с несколькими базами 1С вполне возможна - мы это доказали, но к этому нужно хорошо подготовится. Спасибо за внимание, надеюсь статься была интересная.