IBM Enterprise Records, Versión 5.1.+            

Utilizar la herramienta para importar y exportar planes de archivos

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: 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:

Configurar la herramienta

Antes de que ejecute la herramienta en el modo de importación o exportación, debe configurarla.Para configurar la herramienta:
  1. Vaya a la carpeta donde esté instalada la herramienta para importar y exportar planes de archivos.
  2. Ejecute una de las opciones siguientes en la línea de comandos:
    Sistema operativo Comando
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    Introduzca la información siguiente en el cuadro de diálogo de la herramienta de planes de archivos:

Exportar un plan de archivos

Si el plan de archivos que desea exportar contiene uno de los elementos siguientes: 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

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.

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: 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.


Feedback

Última actualización: Agosto de 2011


© Copyright IBM Corp. 2011.
Este centro de información se basa en la tecnología Eclipse. (http://www.eclipse.org)