Документация iSZN

Запись соответствия ключей для импорта XML-дампов людей/коллективов

Запись соответствия ключей устанавливает связь между объектом (например, человеком) в Системе, которая является источником данных, и объектом в Системе, которая является приёмником данных. Записи соответствия ключей используются для перекодировки идентификаторов при обмене данными в формате XML для объектов, которые относятся к районным данным. Например, запись соответствия может указывать на то, что населённому пункту «Новый Уренгой», имеющему идентификатор 1 в Системе-источнике, сопоставлен населённый пункт «Новый Уренгой», имеющий идентификатор 5 в Системе-приёмнике.

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

Характеристики записи соответствия ключей

  • Запись соответствия ключей идентифицируется уникальным региональным ключом. Идентификатор района, входящий в ключ, определяет район, в который импортируются данные.
  • Запись соответствия ключей всегда относится к одному из источников данных для импорта XML-дампов людей/коллективов. Район записи соответствия ключей совпадает с районом источника данных.
  • Записи соответствия ключей используются для следующих объектов Системы:
  • Запись соответствия ключей характеризуется обязательным идентификатором объекта в Системе, которая является источником данных. Этот идентификатор относится к району, определяемому свойством «Район исходных данных» источника данных, которому принадлежит запись соответствия.
  • Запись соответствия ключей характеризуется необязательным идентификатором объекта в Системе, которая является приёмником данных. Этот идентификатор относится к району, в котором зарегистрирована запись соответствия, и может быть не заполнен, если, например, алгоритму загрузки данных не удалось установить соответствие ключей (в этом случае его необходимо заполнить вручную с помощью справочника).
  • Запись соответствия ключей может иметь различные дополнительные свойства. Например, для человека это фамилия, имя и отчество; для коллектива — его класс.
  • Запись соответствия ключей может быть связана с классом реквизита. Такая связь позволяет уменьшить список записей соответствия, отфильтровав их по связям с классами реквизитов. Например, многие реквизиты персональных документов ссылаются на записи простых справочников. Во время загрузки XML-дампа человека/коллектива Система создаёт записи соответствия ключей для всех встречающихся в XML-дампе записей простых справочников, с указанием классов реквизитов, которые ссылаются на эти записи. Список всех записей соответствия ключей сущности «Запись простого справочника» может оказаться очень длинным (его можно посмотреть, выполнив команду «Соответствие ключей... для сущности «Запись простого справочника» на вкладке «Сущности» диалога свойств источника данных). Список записей соответствия ключей, связанных с конкретным классом реквизита, может оказаться намного короче и удобнее для использования (его можно посмотреть, выполнив команду «Соответствие ключей... для требуемого класса реквизита на вкладке «Реквизиты персональных документов» диалога свойств источника данных).

Работа с записями соответствия ключей

  • Для просмотра, создания, удаления и изменения записей соответствия ключей в Системе предусмотрен справочник источников данных для импорта.
  • Записи соответствия ключей могут создаваться автоматически процедурой загрузки данных. Если процедуре загрузке данных удаётся установить соответствие между объектом в Системе-источнике и Системе-приёмнике (например, выполнив поиск в Системе-приёмнике человека по фамилии, имени, отчеству и дате рождения), то она создаёт запись соответствия ключей (если такой записи ещё нет), заполняет внешний и внутренний идентификаторы объекта, а также создаёт связь с классом реквизита персонального документа, если запись соответствия ключей используется в персональном документе. Если соответствие объекта не удаётся установить, она создаёт запись соответствия ключей (если такой записи ещё нет) и заполняет внешний идентификатор объекта, а также создаёт связь с классом реквизита персонального документа, если запись соответствия ключей используется в персональном документе. В этом случае внутренний идентификатор объекта нужно указать вручную с помощью справочника источников данных для импорта.

См. также