En los despliegues de IBM® Enterprise
Records,
puede utilizar la
herramienta para importar y exportar planes de archivos para importar un plan de archivos
externo, o bien exportar un plan de archivos a un entorno externo. La herramienta utiliza un archivo XML para completar los procesos de importación y exportación.
Introducción
Para obtener detalles sobre cómo modificar un archivo XML exportado para que incluya
herencia de programación, retenciones alternativas, activaciones de eliminación y
retenciones dinámicas (retenciones condicionales), consulte la sección relativa a la herramienta para importar y exportar
planes de archivos) que encontrará en
http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.
Limitaciones
La herramienta para importar y exportar planes de archivos facilita la migración de planes de archivos. Sin embargo, la herramienta no admite lo siguiente:
- Importación o exportación de modelos de datos cruzados. Por ejemplo, si la exportación es desde un almacén de objetos del modelo de datos PRO, no es posible la importación al almacén de objetos del modelo de datos DoD.
- Exportación o importación de objetos de registros, volúmenes, objetos de documentos, información de seguridad y marcas de seguridad.
- Mecanismo de rollback.
- Exportación de propiedades con un valor nulo. Por ejemplo, la exportación de una fase de un programa de disposición sin período de retención y la posterior importación hacia otro almacén de objetos no actualiza el período de retención a nulo. Sin embargo, puede actualizar manualmente el archivo XML para actualizar el período de retención. Para obtener más información, consulte ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
Asimismo, en primer lugar debe exportar e importar propiedades personalizadas (como listas de opciones) y clases en un archivo XML aparte antes de importar el resto del plan de archivos. Además, después de importar un plan de archivos, los estados de las entidades como
Cerrado o
Preparado para disposición ya no se aplican.
Ejecutar la herramienta
Puede ejecutar la herramienta para importar y exportar planes de archivos desde una línea de comandos Java ejecutable, o bien puede iniciar la herramienta con el archivo de comandos,
FilePlanTool.bat o
FilePlanTool.sh. Puede ejecutar la herramienta en uno de estos cinco modos:
- Configure - Abre un cuadro de diálogo donde puede especificar la información necesaria como el nombre del servidor de Content Engine (CE)
el nombre del almacén de objetos, el nombre del usuario administrador y la contraseña, así como el modo (importación o exportación).
- Exportar Crea un archivo XML totalmente compatible que puede importar posteriormente a otro entorno.
- Importar/actualizar Importa un archivo XML especificado a un entorno.
- Validar Lee un archivo XML para verificar la compatibilidad y el cumplimiento.
Exportar un plan de archivos
Si el plan de archivos que desea exportar contiene uno de los elementos siguientes:
- clases o propiedades personalizadas
- más de 300.000 carpetas
- una categoría de registro que incluye más de 15.000 carpetas
Consulte
Exportar un plan de archivos con la opción de ámbito.
Después de configurar la herramienta puede utilizarla para exportar un plan de archivos. Para exportar un plan de archivos, escriba el comando siguiente:
FilePlanTool -mode export -fileplan nombre
de plan de archivos -o nombre de archivo XML.xml donde nombre_plan_archivos es el nombre del plan de archivos que exportar y que es necesario. Si el nombre del plan de archivos contiene espacios o caracteres especiales, escriba nombre del plan de archivos entre comillas.
archivo_XML es el nombre y la ruta del archivo que desea crear. Si no proporciona un nombre de archivo en la línea de comandos, la herramienta utilizará el nombre de archivo predeterminado especificado por el campo Archivo de salida en el cuadro de diálogo de configuración de la herramienta. Si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado, consulte Configurar la herramienta.
Exportar un plan de archivos con la opción de ámbito
Si exporta un plan de archivos, utilice la opción de ámbito para planes de archivos grandes, o bien para planes de archivos que contienen determinadas clases o propiedades. Para exportar un plan de archivos mediante la opción de ámbito, escriba el comando siguiente:
FilePlanTool -mode export -fileplan nombre de
plan de archivos -o nombre de archivo XML.xml -scope parámetro
donde nombre_plan_archivos es el nombre del plan de archivos que exportar y que es necesario. Si el nombre del plan de archivos contiene espacios o caracteres especiales, escriba nombre del plan de archivos entre comillas.
archivo_XML es el nombre y la ruta del archivo que desea crear. Si no ofrece un nombre de archivo en la línea de comandos, la herramienta utilizará el nombre de archivo predeterminado especificado por el campo Archivo de salida en el cuadro de diálogo de configuración de la herramienta. Si utiliza la herramienta con la opción de ámbito, se crea un archivo XML para cada parte del plan de archivos. Por ello, debe especificar un archivo XML diferente cada vez que utilice la herramienta en el modo de exportación. Si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado, consulte Configurar la herramienta.
parámetro puede ser:
- metadata Este parámetro es necesario si el plan de archivos contiene clases o propiedades personalizadas. La opción de parámetro de metadatos crea un archivo XML aparte para las propiedades y las clases personalizadas. Por ello, si un plan de archivos contiene clases o propiedades personalizadas, los procesos de importación y exportación se componen de dos pasos:
- un primer paso para las clases y las propiedades personalizadas
- un segundo paso para el resto del plan de archivos. Si no utiliza el parámetro de metadatos, la herramienta exporta el plan de archivos sin propiedades personalizadas.
- includecategory "nombre de categoría de
registro" - Use este parámetro para exportar una categoría de registro específica.
Si utiliza includecategory, la herramienta exporta todas las subcategorías y subcarpetas incluidas en la categoría de registro especificada. el nombre de categoría de registro debe incluir la ruta completa en IBM Enterprise
Records. Por ejemplo, para exportar todos los elementos secundarios de la categoría de registro llamada "Cat03," que se encuentra incluida en "Cat02" y que a su vez está incluida en "Cat01," escriba el comando siguiente:
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories archivo 01 -
Use este parámetro para exportar solamente las categorías de registros y sus secundarios especificados en el archivo de texto de entrada archivo 01.
Use el parámetro includecategories para exportar un gran número
de categorías de registro al mismo archivo sin especificar el nombre de cada categoría de registro en la línea de comando. Para utilizar este parámetro, escriba el comando siguiente:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt contiene:
/categoryB
/CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
El nombre de la categoría se representa mediante la ruta completa y una categoría de registro por línea.
- excludecategory "nombre de categoría de
registro excluida" - Use este parámetro para excluir una categoría de registro específica y
sus secundarios. Por ejemplo, si nombre de categoría de
registro excluida es "Cat01/Cat02/Catlarge," la herramienta exporta
todas las categorías y las carpetas de registros del plan de archivos excepto las categorías y las carpetas de registros incluidas en el nodo "Cat01/Cat02/CatLarge." Este parámetro funciona de forma similar a includecategory.
- excludecategories archivo 02 Use este parámetro para excluir los subárboles de nombres raíz especificados en el archivo de texto archivo 02. Este parámetro funciona de forma similar a includecategories.
Importar o actualizar un plan de archivos
Para importar un plan de archivos o un segmento, ejecute la herramienta en el modo de importación y especifique el archivo XML que la herramienta creó en el modo de exportación. Si el plan de archivos contiene clases o propiedades personalizadas, el proceso de importación necesita dos pasos. Un paso importa las propiedades y las clases personalizadas del plan de archivo y el segundo paso importa el resto del plan de archivos. Importe las propiedades y las clases personalizadas en primer lugar. Después espere al menos cinco minutos ante de importar el plan de archivos porque los metadatos de propiedades y clases personalizadas se almacenan en la memoria caché. El tiempo de vida (TTL) de la memoria caché es de cinco minutos, después de los cuales se borra. Para importar o actualizar un plan de archivos, escriba el comando siguiente:
FilePlanTool -mode import -f nombre de archivo XML.xml -reimportoption opción
FilePlanTool -mode update -f nombre de archivo XML.xml -reimportoption opción
archivo_XML es el nombre y la ruta del archivo que desea importar. Si no ofrece un nombre de archivo en la línea de comandos, la herramienta utilizará el nombre de archivo predeterminado especificado por el campo Archivo de salida en el cuadro de diálogo de configuración de la herramienta. Si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado, consulte Configurar la herramienta.
La opción de reimportación determina el comportamiento predeterminado de la
herramienta al importar una entidad que ya existe en un plan de archivos. Para obtener detalles acerca de la opción de reimportación, consulte Utilizar la opción de reimportación.
En el modo de importación, la herramienta no utiliza la opción de ámbito, sino que mira a una etiqueta XML para determinar qué se debe importar. Debe proporcionar un archivo XML diferente para los metadatos (propiedades y clases personalizadas) y el plan de archivos.
Atención: La etiqueta ClassificationScheme del archivo XML
especifica el nombre del plan de archivos.
Puede ejecutar la herramienta en el modo de actualización para realizar pequeñas modificaciones después de la importación inicial de un plan de archivos y puede distinguir las actualizaciones posteriores desde los archivos XML importados inicialmente. Especifique update como atributo de InputMode de la etiqueta FilePlan en el archivo XML. No puede modificar una propiedad personalizada (como una lista de opciones) mediante el modo de actualización.
Consulte el documento IBM FileNet P8 Troubleshooting Guide si recibe un mensaje de error o si el proceso de importación se detiene. En la mayoría de los casos, el proceso de importación se detiene después de encontrar un error y no muestra ningún mensaje.
Si fuera necesario, ejecute un barrido de retenciones para aplicar entidades o retenciones condicionales después de la importación porque la herramienta no importa retenciones condicionales. Consulte Limitaciones.
Validar un plan de archivos
Después de crear manualmente un archivo XML, compruebe que éste no contenga errores ni problemas por falta de cumplimiento. Valídelo mediante la herramienta para importar y exportar planes de archivos.Con el fin de ejecutar la herramienta para importar y exportar en el modo de validación, escriba el comando siguiente:
FilePlanTool -mode validate -f nombre de archivo
XML.xml
archivo_XML es el nombre y la ruta del archivo que desea validar. Si no ofrece un nombre de archivo en la línea de comandos, la herramienta utilizará el nombre de archivo predeterminado especificado por el campo Archivo de salida en el cuadro de diálogo de configuración de la herramienta. Si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado, consulte Configurar la herramienta.
Utilizar la opción de reimportación
Use la opción de reimportación para determinar el comportamiento predeterminado de la
herramienta al importar una entidad que ya existe en un plan de archivos. La opción de reimportación tiene tres parámetros:
- None Cuando se agrega una entidad, la herramienta informa mediante una advertencia en el registro de excepciones si ya existe una entidad, no la agrega y continúa.
- Skip Al agregar una entidad, la herramienta omite cualquier otra entidad, continúa e informa de la omisión en el registro de actividades.
- Replace Al agregar una entidad, la herramienta sustituye cualquier otra entidad, continúa e informa de la modificación en el registro de actividades.
Utilice la opción Saltar tras la importación fallida de un plan de archivos grande. Durante el segundo intento de importación del mismo plan de archivos, la opción Saltar evita la reimportación de entidades que se han importado satisfactoriamente. Sin embargo, si el segundo intento de importación necesita modificaciones de poca importancia en las entidades que se importaron satisfactoriamente la primera vez, utilice la opción Reemplazar. En las importaciones posteriores de modificaciones de poca importancia a un número
pequeño de entidades, especifique Action="Modify" (en la sección
RMEntityObjectType del archivo XML) para las entidades, en lugar de hacer cambios en el
archivo XML original. Asimismo, puede utilizar el modo de actualización para facilitar la identificación posterior de actualizaciones desde importaciones completas iniciales. Consulte
Importar o actualizar un plan de archivos.