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:
- 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, exportar
una fase de un programa de disposición sin período de retención. También,
importar el programa de disposición a 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 el tema "Solución de problemas de la herramienta para importar y exportar el plan de archivos".
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: abre un diálogo en el cual especifica la
información requerida. Esta información requerida es el nombre del servidor Content Platform Engine, nombre del almacén
de objetos, nombre de usuario y contraseña del administrador y modo (importar o exportar)
- Exportar: crea un archivo XML que sea totalmente compatible y que cumpla,
el cual puede importar posteriormente a otro entorno.
- Importar/update: importa un archivo XML específico
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:
- Propiedades o clases 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 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
- includecategories archivo 01:
Utilice este parámetro para exportar solamente las categorías de registro y sus hijos especificados
en el archivo de texto de entrada archivo 01.
Utilice el parámetro includecategories para exportar varias categorías de registros al mismo archivo sin especificar cada nombre de la categoría de registro en la línea de comandos. 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 excluido": utilice este parámetro para excluir una categoría de registro específica y sus secundarios. Por ejemplo, si el nombre de la categoría de registro excluida es "Cat01/Cat02/Catlarge," la herramienta
exporta todas las categorías de registro y las carpetas de registro en el plan de archivos con una excepción. La excepción son las categorías de registro y las carpetas de registro incluidas en el nodo "Cat01/Cat02/CatLarge". Este parámetro funciona de forma similar a includecategory.
- excludecategories archivo 02:
Utilice este parámetro para excluir los subárboles de los 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 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:
- Ninguno: al añadir una entidad, la herramienta reporta
una advertencia en el registro de excepción si existe una entidad, no añade la
entidad y continúa.
- Omitir: al añadir una entidad, la herramienta omite
cualquier entidad existente, continúa y reporta la acción de omisión en el registro
de actividades.
- Reemplazar: al añadir la entidad, la herramienta
reemplaza cualquier entidad existente, continúa y reporta la acción de modificación
en el registro de actividades.
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.