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:
- Exportação/importação de modelo de dados cruzados. Por exemplo, se você exportar de um armazenamento de objetos de modelo de dados PRO, não poderá importá-lo em armazenamento de objetos do modelo de dados DoD.
- Exportação ou importação de objetos de registro, volumes, objetos de documento, informações de segurança e marcações de segurança.
- Mecanismo de retorno.
- Exportação de propriedades com um valor nulo. Por exemplo, a exportação de uma
fase de um planejamento da disposição sem período de retenção. Além disso, a
importação do planejamento da disposição em outro armazenamento de objeto não
atualiza o período de retenção para nulo. No entanto, você pode atualizar manualmente o arquivo XML para atualizar o período de retenção. Para obter mais informações, veja a Resolução de Problemas de Importação e Exportação de
Plano de Arquivos.
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: abre um diálogo no qual você especifica
informações necessárias. Essas informações necessárias são o nome do servidor
Content Platform Engine, o nome do armazenamento de
objeto, o nome e a senha do usuário administrador e o modo (importação ou
exportação).
- Exportar: cria um arquivo XML totalmente compatível e
conforme que pode ser importado futuramente para outro ambiente.
- Importar/Atualizar: importa um arquivo XML especificado em
um ambiente.
- Validar: lê um arquivo XML para verificar compatibilidade e
conformidade.
Exportar um plano de arquivo
Se um plano de arquivo que você deseja exportar contiver qualquer um dos itens a seguir:
- Classes ou propriedades customizadas
- Mais de 300.000 pastas
- Uma categoria de registro que inclua mais de 15.000 pastas
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
- includecategories file 01: Use este
parâmetro para exportar apenas as categorias de registro e seus filhos especificados
no arquivo de texto de entrada file 01. Use o parâmetro includecategories para exportar várias
categorias de registro para o mesmo arquivo sem especificar o nome de cada categoria
de registro na linha de comandos. Para usar este parâmetro, digite o seguinte na linha de comando:
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.
- excludecategory "nome da categoria de registro
excluído": Use este parâmetro para excluir uma categoria de registro
específica e seu filho. Por exemplo, se excluded record category
name for "Cat01/Cat02/Catlarge", a ferramenta exportará todas as
categorias de registro e pastas de registro no planejamento de arquivos, mas com uma
exceção. A exceção é as categorias de registro e as pastas de registro contidas no nó
"Cat01/Cat02/CatLarge". Este parâmetro opera
de maneira semelhante a includecategory.
- excludecategories file 02: Use este
parâmetro para excluir as subárvores de nomes raiz especificados no arquivo de texto
file 02. Este parâmetro opera
de maneira semelhante a includecategories.
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:
- Nenhum: Quando você inclui uma entidade, a ferramenta
relata um aviso no log de exceções se uma entidade existir, não inclui a entidade e
continua.
- Ignorar: Quando você inclui uma entidade, a ferramenta
ignora quaisquer entidades existentes, continua e relata a ação ignorar no log de
atividades.
- Substituir: Quando você inclui uma entidade, a ferramenta
substitui quaisquer entidades existentes, continua e relata a ação modificar no log
de atividades.
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.