IBM Enterprise Records, Versión 5.1.2    

Utilizar la herramienta para importar y exportar el plan de archivos

Para los despliegues de IBM® Enterprise Records, utilice la herramienta para importar y exportar el plan de archivos en un plan de archivos externo, o exporte 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 información sobre cómo modificar un archivo XML exportado para que incluya la herencia del programa, retenciones alternativas, activaciones de disposición y retenciones dinámicas, consulte el tema "Solución de problemas de la herramienta para importar y exportar el plan de archivos".

Limitaciones

Utilice la herramienta para importar y exportar el plan de archivos para migrar los planes de archivos. Sin embargo, la herramienta no admite los siguientes escenarios: Primero exporte e importe las propiedades personalizadas, como las listas de opciones y clases en un archivo XML separado 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 el plan de archivos desde un programa ejecutable de Java de la línea de comandos. O 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 en donde está instalada la herramienta para importar y exportar el plan de archivos.
  2. Ejecute una de las siguientes líneas de comando:
    Sistema operativo Comando
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux y Solaris FilePlanTool.sh -mode configure
    Escriba la siguiente información en el cuadro de diálogo de la herramienta del plan 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 del plan de archivos es el nombre del plan de archivos a exportar y que es necesario. Si el nombre del plan de archivos contiene espacios o caracteres especiales, coloque 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 utiliza el nombre de archivo predeterminado que especifica el campo Nombre de archivo de salida. Este campo se encuentra en el cuadro de diálogo de configuración. Para obtener detalles sobre especificar el nombre del archivo de salida XML predeterminado, consulteConfigurar 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 del plan de archivos es el nombre del plan de archivos a exportar y que es necesario. Si el nombre del plan de archivos contiene espacios o caracteres especiales, coloque 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 utiliza el nombre de archivo predeterminado que especifica el campo Nombre de archivo de salida. Este campo se encuentra en el cuadro de diálogo de configuración. Si utiliza la herramienta con la opción de ámbito, se crea un archivo XML para cada parte del plan de archivos. Por lo tanto, debe especificar un nombre de archivo XML diferente cada vez que utiliza la herramienta en el modo de exportación. Para obtener información sobre cómo especificar el nombre de archivo de salida XML predeterminado, consulte Configurar la herramienta.

parámetro puede ser cualquiera de los siguientes elementos:
  • metadatos: si su plan de archivos contiene clases o propiedades personalizadas, se requiere este parámetro. 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 paso para las clases y propiedades personalizadas
    • Un 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": utilice este parámetro para exportar una categoría de registros específica. Cuando utiliza includecategory, la herramienta exporta todas las subcategorías y subcarpetas incluidas dentro de 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 hijos en la categoría de registro llamada Cat03, escriba el siguiente comando. Cat03 está incluido dentro de Cat02 que a su vez está incluido en 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 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 de un plan de archivos, ejecute la herramienta en el modo importación. Especifique el archivo XML que creó la herramienta en el modo de exportación. Si el plan de archivos contiene clases o propiedades personalizadas, el proceso de importación necesita dos pasos. El primer paso importa las clases y propiedades personalizadas en el plan de archivos. El segundo paso importa el resto del plan de archivos. Importe las clases y propiedades personalizadas primero. Luego, espere al menos 5 minutos antes de importar el plan de archivos porque los metadatos de la propiedad y clase personalizada se almacenan en la memoria caché. El tiempo de vida (TTL) de la memoria caché es 5 minutos, después de los cuales se borra la memoria caché. 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. La herramienta utiliza el nombre de archivo predeterminado especificado por el campo Nombre de archivo de salida en el diálogo de configuración si no proporciona un nombre de archivo. Para obtener información sobre cómo especificar el nombre de archivo de salida XML predeterminado, consulte Configurar la herramienta.

La opción de reimportación determina el comportamiento predeterminado de la herramienta al importar una entidad que 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 nombre de archivo XML diferente para los metadatos (clases y propiedades personalizadas) y el plan de archivos.

Atención: La etiqueta ClassificationScheme del archivo XML especifica el nombre del plan de archivos.

Ejecute la herramienta en el modo Actualizar para hacer modificaciones menores después de la importación inicial de un plan de archivos. Distinguir actualizaciones posteriores de 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 nodo de Solución de problemas y soporte en el centro de información o elIBM FileNet P8 Troubleshooting Guide en la Documentación del producto para la página FileNet P8 Platform si recibe un mensaje de error o 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, verifique que el archivo XML no contiene ningún error o problemas de no conformidad. Puede validar el archivo mediante la herramienta para importar y exportar el plan de archivos. Para ejecutar la herramienta para importar y exportar en el modo de validación, escriba el siguiente comando:

FilePlanTool -mode validate -f nombre de archivo XML.xml

archivo_XML es el nombre y la ruta del archivo que desea validar. La herramienta utiliza el nombre de archivo predeterminado especificado por el campo Nombre de archivo de salida en el diálogo de configuración si no proporciona un nombre de archivo. Para obtener información sobre cómo especificar el nombre de archivo de salida XML predeterminado, consulte Configurar la herramienta.

Utilizar la opción de reimportación

Utilice la opción reimportar para determinar el comportamiento predeterminado de la herramienta al importar una entidad que existe en un plan de archivos. La opción de reimportación tiene tres parámetros: Utilice la opción Omitir después de la importación fallida de un plan de archivos grande. Durante el segundo intento para importar el mismo plan de archivos, la opción Omitir evita volver a importar las entidades que se importan exitosamente. Sin embargo, si el segundo intento para importar requiere menores modificaciones a las entidades que se importan exitosamente la primera vez, utilice la opción Reemplazar. Durante importaciones posteriores de modificaciones menores a unas cuantas entidades, especifique Action="Modify" (en la sección RMEntityObjectType del archivo XML) para las entidades. Cambie estas entidades en vez de cambiar 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.


Comentarios

Última actualización: Noviembre 2013
fileplan_import_export.htm

© Copyright IBM Corp. 2013