Para implementações do IBM® Enterprise
Records,
é possível usar a Ferramenta de Importação e Exportação de Planos de Arquivos
para importar um plano de arquivos externo ou exportar um plano 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 modificação de
um arquivo XML exportado para incluir herança de planejamento, retenções
alternativas, acionadores de descarte e suspensões dinâmicas (suspensões
condicionais), consulte a seção Ferramenta de Importação e Exportação de
Planos de Arquivos localizada em
http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.
Limitações
A ferramenta Exportação e importação de plano de arquivo facilita a migração de planos de arquivo. No entanto, a ferramenta não suporta o seguinte:
- 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, exportar uma fase de um planejamento da disposição sem nenhum período de retenção, e importar a agenda de disposição para outro armazenamento de objetos, 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, consulte
ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
Além disso, primeiro você precisa exportar e importar propriedades personalizadas (como listas de escolhas) e classes em um arquivo XML separado, antes de importar o resto do plano de arquivo. 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
de Importação e Exportação de Planos de Arquivos a partir do executável Java
da linha de comandos ou é possível iniciar a ferramenta com o arquivo de
comandos,
FilePlanTool.bat ou
FilePlanTool.sh.
Você pode executar a ferramenta usando um destes cinco modos:
- Configurar - abre um diálogo no qual você especifica
informações necessárias, tais como o nome do servidor Content Engine (CE), nome
do armazenamento de objetos, nome do usuário do administrador
e senha e modo (importação ou exportação).
- Exportar - cria um arquivo XML totalmente compatível e em conformidade, que mais tarde você pode importar em outro ambiente.
- Importar/atualizar - importa um arquivo XML especificado em um ambiente.
- Validar - lê um arquivo XML para verificar a compatibilidade e a 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 personalizadas
- mais de 300.000 pastas
- uma categoria de registro que contém mais do que 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 onde o nome do plano de arquivo é o nome do plano de arquivo a ser exportado e é requerido. Se o nome do plano de arquivo contiver espaços ou caracteres especiais, coloque nome do plano de arquivo 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 comando, a ferramenta irá usar o nome padrão de arquivo especificado pelo campo Nome do arquivo de saída na caixa de diálogo de configuração da ferramenta. Para obter detalhes sobre a especificação do 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
onde o nome do plano de arquivo é o nome do plano de arquivo a ser exportado e é requerido. Se o nome do plano de arquivo contiver espaços ou caracteres especiais, coloque nome do plano de arquivo 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 comando, a ferramenta irá usar o nome padrão de arquivo especificado pelo campo Nome do arquivo de saída na caixa de diálogo de configuração da ferramenta. 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ê precisa especificar um nome diferente de arquivo XML cada vez que usar a ferramenta no modo de exportação. Para obter informações sobre especificar o nome do arquivo de saída XML padrão, consulte Configurar a ferramenta.
parâmetro pode ser qualquer um dos seguintes:
- metadados - Se seu plano de arquivo contém classes ou propriedades personalizadas, este parâmetro é requerido. 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 classes e propriedades personalizadas
- uma etapa para o restante do plano de arquivo. Se você não usar o parâmetro metadados, a ferramenta exportará o plano de arquivo sem as propriedades personalizadas.
- includecategory "record category
name" - 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 denominada "Cat03," que
está contida em "Cat02" e que por sua vez está contida em "Cat01," digite
o comando a seguir:
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 um grande
número de categorias de registro para o mesmo arquivo sem especificar cada nome
de 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 "excluded record
category name" - Use este parâmetro para excluir uma categoria
de registro específica e seus filhos. Por exemplo, se o nome
da categoria de registro excluída for "Cat01/Cat02/Catlarge",
a ferramenta exportará todas as categorias de registro e pastas de
registro no plano de arquivos, exceto as categorias de registro e pastas
de registro contidas no nó "Cat01/Cat02/CatLarge." Este parâmetro opera
de maneira semelhante a includecategory.
- excludecategories arquivo 02 - Utilize este parâmetro para excluir as subárvores dos nomes de raiz especificados no arquivo de texto arquivo 02. Este parâmetro opera
de maneira semelhante a includecategories.
Importar/Atualizar um plano de arquivo
Para importar um plano de arquivo ou um segmento do mesmo, execute a ferramenta no modo de importação e 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. Uma etapa importa as classes e propriedades personalizadas no plano de arquivo e a segunda etapa importa o remanescente do plano de arquivo. Importe primeiro as classes e propriedades personalizadas, e aguarde ao menos cinco minutos antes de importar o plano de arquivo, já que os metadados da classe e propriedade personalizados são mantidos no cache da memória. O tempo de vida do cache (TTL) é de cinco minutos, após o cache é 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.
Se você não fornecer um nome de arquivo na linha de comando, a ferramenta irá usar o nome padrão de arquivo especificado pelo campo Nome do arquivo de saída na caixa de diálogo de configuração da ferramenta. Para obter informações sobre especificar o nome do arquivo de saída XML padrão, consulte Configurar a ferramenta.
A opção de reimportação determina o comportamento padrão da ferramenta ao importar uma entidade que já existe em um plano de arquivo. 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ê precisa fornecer um nome diferente de arquivo XML para metadados (classes e propriedades personalizadas) e o plano de arquivo.
Atenção: A tag ClassificationScheme no arquivo
XML especifica o nome do plano de arquivos.
Você pode executar a ferramenta no modo Atualizar para efetuar modificações secundárias após a importação inicial de um plano de arquivo e pode distinguir atualizações subsequentes dos arquivos XML inicialmente importados. 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 IBM FileNet P8 Troubleshooting Guide se você receber uma
mensagem de erro ou 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 você criar manualmente um arquivo XML, verifique se o arquivo XML não contém erros ou questões de não conformidade, ao validá-lo através da ferramenta Exportação e importação de plano de arquivo. Para executar a ferramenta Exportação e importaçã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. Se você não fornecer um nome de arquivo na linha de comando, a ferramenta irá usar o nome padrão de arquivo especificado pelo campo Nome do arquivo de saída na caixa de diálogo de configuração da ferramenta. Para obter informações sobre 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 de reimportação para determinar o comportamento padrão da ferramenta ao importar uma entidade que já exista em um plano de arquivo. A opção de reimportação tem três parâmetros:
- Nenhum - Ao adicionar uma entidade, a ferramenta reporta um aviso no registro de exceção se uma entidade já existe, não adiciona a entidade e continua.
- Ignorar - Ao adicionar uma entidade, a ferramenta ignora quaisquer entidades existentes, continua e reporta a ação de ignorar no registro de atividades.
- Substituir - Ao adicionar uma entidade, a ferramenta substitui quaisquer entidades existentes, continua e reporta a ação de modificação no registro de atividades.
Use a opção Ignorar após a falha na importação de um plano grande de arquivo.
Durante a segunda tentativa de importar o mesmo plano de arquivo, a opção Ignorar evita reimportar as entidades que tenham sido importadas com êxito.
No entanto, se a segunda tentativa de importação requer modificações secundárias em entidades que tenham sido importadas com êxito na primeira vez, use a opção Substituir. Durante as importações subsequentes de pequenas modificações em um pequeno número de entidades, especifique
Action="Modify" (na seção RMEntityObjectType do arquivo XML) para as entidades, ao invés de
fazer mudanças no arquivo XML original. Também use o modo Atualizar para identificar com mais facilidade atualizações subsequentes de importações completas iniciais. Consulte o
Importar/Atualizar um plano de arquivo.