Для внедрений IBM® Enterprise
Records используйте инструмент экспорта и импорта планов размещения, чтобы импортировать внешний план размещения или экспортировать план размещения во внешнюю среду. Для выполнения операций импорта и экспорта этот инструмент использует файл XML.
Обзор
Дополнительную информацию об изменении экспортированного файла
XML для включения наследования расписаний, альтернативных сроков хранения, триггеров утилизации и динамических удержаний смотрите в теме Поиск и устранение неисправностей в инструменте экспорта и импорта планов размещения.
Ограничения
Используйте инструмент экспорта и импорта планов размещения для перенастройки планов размещения. Однако этот инструмент не поддерживает следующие сценарии:
- Экспорт/импорт между различными моделями данных. Например, если вы выполнили экспорт со склада объектов модели данных PRO, нельзя импортировать эти данные на склад объектов модели данных DoD.
- Экспорт или импорт объектов записей, томов, объектов документов, информации защиты и пометок защиты.
- Механизм отката.
- Экспорт свойств с пустым значением. Например, экспорт фазы расписания утилизации без заданного срока хранения. При импорте расписания утилизации на другой склад объектов значение срока хранения не изменяется на пустое. Однако файл XML можно изменить вручную, чтобы определить другое значение срока хранения. Дополнительную информацию смотрите в теме Поиск и устранение неисправностей в инструменте экспорта и импорта планов размещения.
Сначала экспортируйте и импортируйте пользовательские свойства, такие как списки выбора и классы, в отдельном файле XML, а уже затем остальной план размещения. Кроме этого, после импорта плана размещения такие состояния объектов, как
Закрыто или
Готово для утилизации, окажутся недействительными.
Работа с инструментом
Инструмент экспорта и импорта планов размещения можно запустить в исполняемой программе Java командной строки. Этот инструмент можно запустить также с помощью командного файла:
FilePlanTool.bat или
FilePlanTool.sh. Этот инструмент можно запустить в одном из следующих пяти режимов:
- Конфигурирование: открывает диалоговое окно, в котором задается необходимая информация. К этой информации относится имя сервера Content Platform Engine, имя склада объектов, имя и пароль пользователя с правами администратора и режим (импорт или экспорт).
- Экспорт: создает полностью совместимый и соответствующий всем требованиям файл XML, который позже можно импортировать в другую среду.
- Импорт/изменение: импортирует заданный файл XML в среду.
- Проверка: читает файл XML для проверки совместимости и соответствия требованиям.
Экспорт плана файла
Если план размещения, который вы хотите экспортировать, содержит любой из следующих элементов:
- Пользовательские классы или свойства
- Более 300000 папок
- Категория записей, включающая в себя более 15000 папок
Смотрите раздел
Экспорт плана размещения с опцией 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
- includecategories файл 01:
Используйте этот параметр для экспорта только категорий записей и их дочерних элементов, заданных во входном текстовом файле файл 01. Используйте параметр includecategories для экспорта нескольких категорий записей в один файл без указания каждого имени категории записей в командной строке. Чтобы использовать этот параметр, введите
следующую команду:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt содержит:
/categoryB
/CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
Имя категории представлено именем полного пути и одной категорией записи на строку.
- excludecategory "имя исключенной категории записей": Используйте этот параметр, чтобы исключить конкретную категорию записей и ее дочерние элементы. Например, если имя исключенной категории записей - это "Cat01/Cat02/Catlarge", инструмент экспортирует все категории записей и папки записей в плане размещения с исключением. Это исключение - категории записей и папки записей, содержащиеся в узле "Cat01/Cat02/CatLarge". Этот параметр действует подобно параметру includecategory.
- excludecategories файл 02:
Используйте этот параметр для исключения поддеревьев корневых имен, заданных в текстовом файле файл 02. Этот параметр действует подобно параметру includecategories.
Импорт/обновление плана файла
Для импорта плана размещения или сегмента плана размещения запустите инструмент в режиме импорта. Укажите файл 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 (Изменение) для упрощения определения последующих изменений по сравнению с первоначальным импортом. Смотрите раздел
Импорт/обновление плана файла.