IBM Enterprise Records, Versão 5.1.2    

Usando a Ferramenta Importação e Exportação de Planejamento de Arquivos

Para implementações do IBM® Enterprise Records, use a ferramenta Importação e Exportação de Planejamento de Arquivos para importar um planejamento de arquivos externo ou exportar um planejamento de arquivos para um ambiente externo. A ferramenta usa um arquivo XML para completar os processos de importação e exportação.

Visão Geral

Para obter detalhes sobre como modificar um arquivo XML exportado para incluir herança de planejamento, retenções alternativas, acionadores de descarte e suspensões dinâmicas, veja o tópico Resolução de Problemas de Importação e Exportação de Plano de Arquivo.

Limitações

Use a ferramenta Importação e Exportação de Planejamento de Arquivos para migrar planejamentos de arquivos. No entanto, a ferramenta não suporta os cenários a seguir: Primeiro exporte e importe propriedades customizadas, como listas de opções, e classes em um arquivo XML separado antes de importar o restante do planejamento de arquivos. Além disso, após importar um plano de arquivos, os estados da entidade como Fechado ou Pronto para Disposição não estão mais em efeito.

Executar a ferramenta

É possível executar a ferramenta Importação e Exportação de Planejamento de Arquivos a partir de um programa executável Java de linha de comandos. Ou é possível iniciar a ferramenta com a arquivo de comando: FilePlanTool.bat ou FilePlanTool.sh. É possível executar a ferramenta em um destes cinco modos:

Configurar a ferramenta

Antes de executar a ferramenta no modo de importação ou exportação, é preciso configurá-la. Para configurar a ferramenta:
  1. Acesse a pasta na qual a ferramenta Importação e Exportação de Planejamento de Arquivos está instalada.
  2. Execute uma das opções a seguir na linha de comandos:
    Sistema operacional Comando
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux e Solaris FilePlanTool.sh -mode configure
    Insira as informações a seguir na caixa de diálogo da ferramenta de planejamento de arquivos:

Exportar um plano de arquivo

Se um plano de arquivo que você deseja exportar contiver qualquer um dos itens a seguir: Consulte o Exportar um plano de arquivo com a opção de escopo.

Após configurar a ferramenta, você pode usá-la para exportar um plano de arquivo. Para exportar um plano de arquivo, digite o seguinte comando:

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml

Em que file plan name é o nome do planejamento de arquivos para exportar que é obrigatório. Se o nome do plano de arquivos contiver espaços ou caracteres especiais, coloque file plan name entre aspas.

Nome do arquivo XML é o nome e o caminho do arquivo que você deseja criar. Se você não fornecer um nome de arquivo na linha de comandos, a ferramenta usará o nome do arquivo padrão especifica do pelo campo Nome do Arquivo de Saída. Esse campo está localizado na caixa de diálogo de configuração. Para obter detalhes sobre como b o nome do arquivo de saída XML padrão, consulte Configurar a ferramenta.

Exportar um plano de arquivo com a opção de escopo

Quando você exporta um plano de arquivo, use a opção de escopo para planos grandes de arquivos ou para planos de arquivos que contenham classes ou propriedades personalizadas. Para exportar um plano de arquivo usando a opção de escopo, digite o seguinte comando:

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml -scope parameter

Em que file plan name é o nome do planejamento de arquivos para exportar que é obrigatório. Se o nome do plano de arquivos contiver espaços ou caracteres especiais, coloque file plan name entre aspas.

Nome do arquivo XML é o nome e o caminho do arquivo que você deseja criar. Se você não fornecer um nome de arquivo na linha de comandos, a ferramenta usará o nome do arquivo padrão especifica do pelo campo Nome do Arquivo de Saída. Esse campo está localizado na caixa de diálogo de configuração. Quando você usa a ferramenta com a opção de escopo, a ferramenta cria um arquivo XML para cada parte do plano de arquivo. Portanto, você deve especificar um nome de arquivo XML diferente cada vez que usar a ferramenta no modo de exportação. Para obter informações sobre como especificar o nome do arquivo de saída XML padrão, consulte Configurar a ferramenta.

parameter pode ser qualquer um dos itens a seguir:
  • metadata: Se seu planejamento de arquivos contiver propriedades ou classes customizadas, esse parâmetro será obrigatório. A opção do parâmetro metadados cria um arquivo XML separado para classes e propriedades personalizadas. Portanto, quando um plano de arquivo contém classes ou propriedades personalizadas, os processos de exportação e importação consistem em duas etapas cada um:
    • Uma etapa para as propriedades e classes customizadas
    • Uma etapa para o restante do planejamento de arquivos. Se você não usar o parâmetro metadados, a ferramenta exportará o plano de arquivo sem as propriedades personalizadas.
  • includecategory "nome da categoria do registro": Use este parâmetro para exportar uma categoria de registro específica. Quando você usa includecategory, a ferramenta exporta todas as subcategorias e subpastas contidas na categoria de registro especificada. O nome da categoria de registro deve incluir o caminho completo no IBM Enterprise Records. Por exemplo, para exportar todos os filhos na categoria de registro chamada Cat03, digite o seguinte comando. Cat03 está contida em Cat02, que por sua vez está contida em 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 contém:

/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1

O nome da categoria é representado pelo nome completo do caminho e uma categoria de registro por linha.

Importar/Atualizar um plano de arquivo

Para importar um planejamento de arquivos ou um segmento de planejamento de arquivos, execute a ferramenta no modo de importação. Especifique o arquivo XML que a ferramenta criou no modo de exportação. Se seu plano de arquivo contém classes ou propriedades personalizadas, o processo de importação requer duas etapas. A primeira etapa importa as propriedades e classes customizadas no planejamento de arquivos. A segunda etapa importa o restante do planejamento de arquivos. Importe as propriedades e classes customizadas primeiro. Espere pelo menos 5 minutos antes de importar o planejamento de arquivos, pois os metadados de classe customizada e propriedade são armazenados em cache na memória. O tempo de vida (TTL) do cache é de 5 minutos; depois disso ele é limpo. Para importar/atualizar um plano de arquivo, digite o seguinte comando:

FilePlanTool -mode import -f XML filename.xml -reimportoption option

FilePlanTool -mode update -f XML filename.xml -reimportoption option

Nome do arquivo XML é o nome e o caminho do arquivo que você deseja importar. A ferramenta usa o nome do arquivo padrão especificado pelo campo Nome do Arquivo de Saída no diálogo de configuração se você não fornecer um nome de arquivo. Para obter informações sobre como especificar o nome do arquivo de saída XML padrão, consulte Configurar a ferramenta.

A opção reimportar determina o comportamento padrão da ferramenta durante a importação de uma entidade existente em um planejamento de arquivos. Para obter detalhes sobre a opção de reimportação, consulte Usar a opção de reimportação.

No modo Importação, a ferramenta não usa a opção de escopo, mas verifica um marcador XML para determinar o que importar. Você deve fornecer um nome de arquivo XML diferente para metadados (classes customizadas e propriedades) e planejamento de arquivos.

Atenção: A tag ClassificationScheme no arquivo XML especifica o nome do plano de arquivos.

Execute a ferramenta no modo Atualizar para fazer algumas modificações após a importação inicial de um planejamento de arquivos. Distinga atualizações subsequentes dos arquivos XML importados inicialmente. Especifique update como o atributo InputMode do marcador FilePlan no arquivo XML. Você pode modificar uma propriedade personalizada (tal como uma lista de escolhas) ao usar o modo Atualizar.

Consulte o nó Resolução de Problemas de Suporte no centro de informações ou o IBM FileNet P8 Troubleshooting Guide na Documentação do Produto para a página do FileNet P8 Platform se você receber uma mensagem de erro ou se o processo de importação parar. Na maioria dos casos, o processo de importação para após encontrar um erro e não exibe nenhuma mensagem.

Se necessário, execute a Varredura de suspensão para aplicar suspensões condicionais nas entidades após a importação, já que a ferramenta não importa suspensões condicionais. Consulte o Limitações.

Validar um plano de arquivo

Após criar manualmente um arquivo XML, verifique se o arquivo XML não contém nenhum erro ou problema de falta de conformidade. É possível validar o arquivo por meio da ferramenta Importação e Exportação de Planejamento de Arquivos. Para executar a ferramenta Importação e Exportação no modo de validação, digite o seguinte comando:

FilePlanTool -mode validate -f XML filename.xml

Nome do arquivo XML é o nome e o caminho do arquivo que você deseja validar. A ferramenta usa o nome do arquivo padrão especificado pelo campo Nome do Arquivo de Saída no diálogo de configuração se você não fornecer um nome de arquivo. Para obter informações sobre como especificar o nome do arquivo de saída XML padrão, consulte Configurar a ferramenta.

Usar a opção de reimportação

Use a opção reimportar para determinar o comportamento padrão da ferramenta durante a importação de uma entidade em um planejamento de arquivos. A opção de reimportação tem três parâmetros: Use a opção Ignorar após uma importação com falha de um grande planejamento de arquivos. Durante a segunda tentativa de importação do mesmo planejamento de arquivos, a opção Ignorar evita a reimportação de entidades que foram importadas com sucesso. No entanto, se a segunda tentativa de importação requerer pequenas modificações nas entidades que são importadas com sucesso na primeira vez, use a opção Substituir. Durante importações subsequentes de modificações menores para algumas entidades, especifique Action="Modify" (na seção RMEntityObjectType do arquivo XML) para as entidades. Altere essas entidades em vez de alterar o arquivo XML original. Também use o modo Atualizar para identificar com mais facilidade atualizações subseqüentes de importações completas iniciais. Consulte o Importar/Atualizar um plano de arquivo.


Feedback

Última atualização: novembro de 2013
fileplan_import_export.htm

© Copyright IBM Corporation 2013