Руководство по конвертору HiDA4 XML - Госкаталог

Оглавление


Введение

Конвертер представляет собой программу для преобразования формата HiDA4-xml в формат импорта Госкаталога и импорта обработанных данных назад в HiDA4.

Таким образом для преобразования необходимо выполнить следущие шаги:

  • экспортировать необходимые данные из HiDA4 (при экспорт выгружаются только те данные, которые требуются для экспорта/обновления и т.д.)
  • запустить конвертер и преобразовать данные HiDA4-XML -> Госкаталог
  • импортировать полученные данные в систему Госкаталог
  • получить обработанные в Госкаталоге данные
  • импортировать обработанные данные назад в HiDA4

В данном руководстве описывается работа конвертера.

[pagebreak]


Конвертация данных HiDA4 -> Госкаталог


Запуск конвертера


Данные по организации

Приложение конвертера уже настроено на Вашу организацию и не требует каких-либо изменений. Эти данные будут присутствовать в подготовленных файла для ПО Госкаталога.


Входные данные HiDA4 XML

На данной странице конвертера указываются ранее экспортрованные данные из HiDA4, тип действия и тип представленных данных (записи или коллекции).

Программа Госкаталога поддерживает следущие типы действий:

  • регистрация
  • техническая коррекция
  • дополнение
  • изменение данных
  • исключение из МФ
  • коррекция/дополнение

Дополнительно о типах действия смотрите документацию к Госкаталогу.


Настройки выходных данных

На данной странице необходимо указать папку, в которую будет производиться экспорт данных для Госкаталога.
Если данная папка не существует - она будет создана автоматически.


Запуск преобразования

После того, как все необходимые данные были собраны, можно запускать конверсию.
Полученные данные будут экспортированы в указанную ранее папку.


Результаты первого этапа работы

Результатом работы является набор из 3-х файлов с именами файлов в формате:

  • utf8_{КОПУК}_{date}_{number}.zip - файл, содержащий данные, необходимые для ПО Госкаталог
  • utf8_{КОПУК}_{date}_{number}.hida.xml - исходные данные в формате HiDA XML
  • utf8_{КОПУК}_{date}_{number}.uuid.xml - промежуточные данные, необходимые для обратного импорта ПО Госкаталог -> HiDA4

где {КОПУК} - код организации,
{date} - текущая дата в формате YYYYMMDD,
{number} - порядковый номер набора на текущую дату

Пример выходного набора данных:
utf8_115859_20130807_010.zip, utf8_115859_20130807_010.hida.xml, utf8_115859_20130807_010.uuid.xml

Важно! Данные файлы будут необходимы на втором этапе.
Весь набор файлов необходимо сохранить, иначе импорт ПО Госкаталог -> HiDA4 будет невозможен.

Важно! Каждый набор выходных данных содержит по 100 HiDA документов. Если число входящих документов больше, то будет создано соответствующее количество наборов.
Соответственно, выходные файлы получатся типа:
utf8_115859_20130807_010.zip, utf8_115859_20130807_010.hida.xml, utf8_115859_20130807_010.uuid.xml
utf8_115859_20130807_011.zip, utf8_115859_20130807_011.hida.xml, utf8_115859_20130807_011.uuid.xml
utf8_115859_20130807_012.zip, utf8_115859_20130807_012.hida.xml, utf8_115859_20130807_012.uuid.xml

[pagebreak]

Конвертация данных Госкаталог -> HiDA4

Запуск конвертера

Данные по организации

Приложение конвертера уже настроено на Вашу организацию и не требует каких-либо изменений.

Входные данные ПО Госкаталог

Эти данные должны быть получены из Госкаталога.

Входные данные HiDA4 XML

Эти данные были получены нами на первом этапе.

Выбор поля HiDA4

Полученный номер Госкаталога необходимо вставить в HiDA4 документ.
И вставить его необходимо в определённое поле.
Имя этого поля необходимо ввести на данной странице.

Запуск преобразования

Результат работы

После запуска мастера рядом с исходным набором данных появится 4-й файл в формате:

  • utf8_{КОПУК}_{date}_{number}.hida+gk.xml
    Он содержит исходные данные в формате HiDA4 XML, в которые были вставлены поля с номерами, полученными из госкаталога.

    Всё,что остаётся - просто импортировать этот файл в базу данных.

    [pagebreak]

    Как это работает

    Принцип работы приложения-конвертера весьма прост.
    Всё, что он делает это подготавливает конфигурационные файлы для XSLT-преобразования HiDA4-XML -> Госкаталог.

    Дальнейшие обозначения:
    PROGRAM_DIR - папка, в которую был установлен конвертер, обычно это C:\Program Files\startext\HiDA4\GosCatalogWizard\bin\GosCatalogWizard.exe
    EXPORT_DIR - папка, указанная в конвертере для результата экспорта

    Последовательность действий следующая:

    • Конвертер ($PROGRAM_DIR/bin/GosCatalogWizard.exe) собирает данные и записывает конфигурационный файл ($EXPORT_DIR/config.xml) для программы запуска XSLT-преобразования
    • Стартует программа запуска XSLT-преобразования $PROGRAM_DIR/bin/XSLTConvert.exe с ранее подготовленным файлом конфигурации ($EXPORT_DIR/config.xml)
    • XSLT преобразование происходить с помощью xstl процессора saxon (именно для его работы требуется java) и все полученные файлы (в формате Госкаталога) складываются в папку $EXPORT_DIR/output

    Какие можно сделать важные заметки:

    • Так называемый конвертер - просто красивая оболочка для подготовки к реальной работе
    • Все введённые данные сохраняются в файле конфигурации, который можно потом использовать повторно, например запуская XSLT-преобразование вручную:
      $PROGRAM_DIR/bin/XSLTConvert.exe $EXPORT_DIR/config.xml
  • Tags ACL: