Para las implantaciones de IBM InfoSphere 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. Para obtener información sobre el esquema XML y sus elementos, consulte Esquema XML de plan de archivos.
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 File Plan Import and Export Tool (Utilizar la herramienta para importar y exportar planes de archivos) que encontrará en Documentación del producto para FileNet P8 Platform.
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.
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:
Antes de que ejecute la herramienta en el modo de importación o exportación, debe configurarla.
Para configurar la herramienta
En Windows:
FilePlanTool -mode configure
En UNIX:
./FilePlanTool.sh -mode configure
Nota Si utiliza una conexión, debe desactivar la capa de sockets segura (SSL). Para desactivar la SSL, consulte Desactivar la capa de sockets segura.
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 XMLxml>
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. Consulte Configurar la herramienta, si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado.
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 XMLxml> -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. Consulte Configurar la herramienta, si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado.
parámetro puede ser:
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/SubcategoryA1El nombre de la categoría se representa mediante la ruta completa y una categoría de registro por línea.
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 XMLxml> -reimportoption <opción>
FilePlanTool -mode update -f <nombre de archivo XMLxml> -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. Consulte Configurar la herramienta, si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado.
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 información sobre la opción de reimportación, consulte Utilizar la opción Reimportar.
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.
NOTA 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 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.
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 XMLxml>
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. Consulte Configurar la herramienta, si desea información sobre cómo especificar el nombre de archivo XML de salida predeterminado.
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.