IBM Enterprise Records, Версия 5.1.2    

Использование инструмента экспорта и импорта планов размещения

Для внедрений IBM® Enterprise Records используйте инструмент экспорта и импорта планов размещения, чтобы импортировать внешний план размещения или экспортировать план размещения во внешнюю среду. Для выполнения операций импорта и экспорта этот инструмент использует файл XML.

Обзор

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

Ограничения

Используйте инструмент экспорта и импорта планов размещения для перенастройки планов размещения. Однако этот инструмент не поддерживает следующие сценарии: Сначала экспортируйте и импортируйте пользовательские свойства, такие как списки выбора и классы, в отдельном файле XML, а уже затем остальной план размещения. Кроме этого, после импорта плана размещения такие состояния объектов, как Закрыто или Готово для утилизации, окажутся недействительными.

Работа с инструментом

Инструмент экспорта и импорта планов размещения можно запустить в исполняемой программе Java командной строки. Этот инструмент можно запустить также с помощью командного файла: FilePlanTool.bat или FilePlanTool.sh. Этот инструмент можно запустить в одном из следующих пяти режимов:

Конфигурирование инструмента

Перед запуском инструмента в режиме экспорта или импорта его нужно сконфигурировать. Чтобы сконфигурировать инструмент, сделайте следующее:
  1. Перейдите в папку, где установлен инструмент экспорта и импорта планов размещения.
  2. Выполните в командной строке следующее:
    Операционная система Команда
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux и Solaris FilePlanTool.sh -mode configure
    Введите следующую информацию в диалоговом окне инструмента планов размещения:

Экспорт плана файла

Если план размещения, который вы хотите экспортировать, содержит любой из следующих элементов: Смотрите раздел Экспорт плана размещения с опцией scope.

После конфигурирования инструмента его можно использовать для экспорта плана размещения. Чтобы экспортировать план файла, введите следующую команду:

FilePlanTool -mode export -fileplan имя плана размещения -o XML filename.xml

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

Имя файла XML - это имя и путь создаваемого файла. Если не задать имя файла в командной строке, инструмент использует имя файла по умолчанию, определенное в поле Имя выходного файла. Это поле расположено в диалоговом окне конфигурирования. Подробности об указании имени выходного файла XML по умолчанию смотрите в Конфигурирование инструмента.

Экспорт плана размещения с опцией scope

При экспорте плана размещения используйте опцию scope для больших планов размещения или планы размещения, содержащие пользовательские классы или свойства. Для экспорта плана размещения с использованием опции scope введите следующую команду:

FilePlanTool -mode export -fileplan имя плана размещения -o XML filename.xml-scope параметр

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

Имя файла XML - это имя и путь файла, который вы хотите создать. Если не задать имя файла в командной строке, инструмент использует имя файла по умолчанию, определенное в поле Имя выходного файла. Это поле расположено в диалоговом окне конфигурирования. При использовании инструмента с опцией scope инструмент создает файл XML для каждой части плана размещения. Поэтому надо указывать новое имя файла XML при каждом использовании инструмента в режиме экспорта. Информацию об указании имени выходного файла XML по умолчанию смотрите в Конфигурирование инструмента.

параметр может представлять собой один из следующих элементов:
  • metadata: Это обязательный параметр, если ваш план размещения содержит пользовательские классы или свойства. При использовании опции с параметром metadata создается отдельный файл XML для пользовательских классов и свойств. Поэтому в том случае, когда план размещения содержит пользовательские классы или свойства, процессы экспорта и импорта состоят из двух шагов каждый:
    • Один шаг - для пользовательских классов и свойств
    • Еще один шаг - для остального плана размещения. Если вы не используете параметр metadata, инструмент экспортирует план размещения без пользовательских свойств.
  • includecategory "имя категории записи": Используйте этот параметр для экспорта конкретной категории записей. Когда используется параметр includecategory, инструмент экспортирует все подкатегории и подпапки, содержащиеся в заданной категории записей. имя категории записей должно включать полный путь в IBM Enterprise Records. Например, для экспорта всех дочерних элементов в категории записей с именем Cat03 введите следующую команду. Cat03 содержится в категории Cat02, которая в свою очередь содержится в Cat01.

FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o expfile.xml

FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml

File01.txt содержит:

/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1

Имя категории представлено именем полного пути и одной категорией записи на строку.

Импорт/обновление плана файла

Для импорта плана размещения или сегмента плана размещения запустите инструмент в режиме импорта. Укажите файл XML, созданный инструментом в режиме экспорта. Если ваш план размещения содержит пользовательские классы или свойства, процесс импорта требует двух шагов. На первом шаге импортируются пользовательские классы и свойства в плане размещения. На втором шаге импортируется остальной план размещения. Сначала импортируйте пользовательские классы и свойства. Подождите по крайней мере 5 минут перед импортом плана размещения, так как метаданные пользовательских классов и свойств кэшируются в памяти. Время жизни кэша (time-to-live, TTL) составляет 5 минут, после чего кэш очищается. Чтобы импортировать/обновить план файла, введите следующую команду:

FilePlanTool -mode import -f XML filename.xml -reimportoption опция

FilePlanTool -mode update -f XML filename.xml -reimportoption опция

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

Опция повторного импорта определяет поведение инструмента по умолчанию при импорте объекта, существующего в плане размещения. Подробности об опции повторного импорта смотрите в разделе Использование опции reimport (опция повторного импорта).

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

Внимание: Тег ClassificationScheme в файле XML задает имя плана размещения.

Запустите инструмент в режиме Изменение для внесения небольших изменений после первоначального импорта плана размещения. Отделите последовательные изменения от первоначально импортированных файлов XML. Укажите update как атрибут InputMode тега FilePlan в файле XML. В режиме Изменение нельзя изменять пользовательское свойство (например, список выбора).

Смотрите страницу FileNet P8 Platform в узле Поиск и устранение неисправностей и поддержка в информационном центре или в IBM FileNet P8 Troubleshooting Guide документации продукта, если вы получаете сообщение об ошибке или процесс импорта останавливается. В большинстве случаев процесс импорта останавливается из-за возникновения ошибки, но никакое сообщение об ошибке не выводится.

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

Проверка плана файла

После создания файла XML вручную проверьте, что в этом файле XML нет ошибок или проблем с совместимостью. Проверить этот файл можно с помощью инструмента экспорта и импорта планов размещения. Для запуска инструмента экспорта и импорта в режиме проверки введите следующую команду:

FilePlanTool -mode validate -f XML filename.xml

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

Использование опции reimport (опция повторного импорта)

Используйте опцию повторного импорта для определения поведения инструмента по умолчанию при импорте объекта, существующего в плане размещения. У опции reimport есть три параметра: Используйте опцию Пропуск после неудачного импорта большого плана размещения. Во время второй попытки импорта того же плана размещения опция пропуска Skip исключает повторный импорт объектов, которые были импортированы успешно. Однако если вторая попытка импорта требует небольших изменений объектов, которые уже были успешно импортированы ранее, используйте опцию Replace (Замена). Во время последующего импорта незначительных изменений нескольких объектов задайте для этих объектов Action="Modify" (в разделе RMEntityObjectType файла XML). Измените эти объекты вместо изменения исходного файла XML. Используйте также режим Update (Изменение) для упрощения определения последующих изменений по сравнению с первоначальным импортом. Смотрите раздел Импорт/обновление плана файла.


Отзыв

Последнее обновление: Ноябрь 2013 г.
fileplan_import_export.htm

© Copyright IBM Corp. 2013