IBM Enterprise Records, Versão 5.1.2    

Utilizar a ferramenta de importação e exportação do plano de ficheiros

Nas implementações do IBM® Enterprise Records, pode utilizar a ferramenta de importação e exportação do plano de ficheiros para importar um plano de ficheiros externo, ou para exportar um plano de ficheiros para um ambiente externo. A ferramenta utiliza um ficheiro XML para concluir os processos de importação e exportação.

Descrição geral

Para obter mais informações sobre como modificar um ficheiro XML exportado para incluir a herança de agenda, retenções alternativas, activadores de eliminação e retenções dinâmicas, consulte o tópico Resolução de problemas da Ferramenta de importação e exportação do plano de ficheiros.

Limitações

Utilize a Ferramenta de importação e exportação do plano de ficheiros para migrar os planos de ficheiros. No entanto, a ferramenta não suporta os seguintes cenários: Primeiro tem de exportar e importar as propriedades personalizadas como por exemplo, listas de opção e classes, num ficheiro XML, separado antes de importar o plano de ficheiros restante. Depois de importar um plano de ficheiros, os estados das entidades como Fechado ou Pronto para a eliminação deixam de estar activos.

Executar a ferramenta

Pode executar a Ferramenta de importação e exportação do plano de ficheiros a partir de um programa executável Java de linha de comandos. Em alternativa, inicie a ferramenta com o ficheiro de comandos: FilePlanTool.bat ou FilePlanTool.sh. Pode executar a ferramenta num dos cinco modos seguintes:

Configurar a ferramenta

Antes de executar a ferramenta no modo de importação e exportação, tem de configurar a ferramenta. Para configurar a ferramenta:
  1. Aceda à pasta em que a ferramenta de importação e exportação do plano de ficheiros está instalada.
  2. Execute um dos comandos seguintes na linha de comandos:
    Sistema operativo Comando
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux e Solaris FilePlanTool.sh -mode configure
    Introduza a informação seguinte na caixa de diálogo da ferramenta do plano de ficheiros:

Exportar um plano de ficheiros

Se o plano de ficheiros que pretende exportar incluir qualquer um dos itens seguintes: Consulte o tópico Exportar um plano de ficheiros com a opção de âmbito.

Após configurar a ferramenta, pode utilizar a mesma para exportar um plano de ficheiros. Para exportar um plano de ficheiros, introduza o comando seguinte:

FilePlanTool -mode export -fileplan nome do plano de ficheiros -o nome do ficheiro XML.xml

Em que nome do plano de ficheiros é o nome do plano de ficheiros para exportar e é requerido. Se o nome do plano de ficheiros incluir espaços ou caracteres especiais, coloque o nome do plano de ficheiros entre aspas.

O nome do Ficheiro XML é o nome e caminho do ficheiro a criar. Se não indicar um nome de ficheiro na linha de comandos, a ferramenta irá utilizar o nome de ficheiro predefinido especificado pelo campo Nome do ficheiro de saída. Este campo está localizado na caixa de diálogo Configuração. Para obter mais informações sobre como especificar o nome predefinido do ficheiro XML de saída, consulte o tópico Configurar a ferramenta.

Exportar um plano de ficheiros com a opção de âmbito

Quando exporta um plano de ficheiros, pode utilizar a opção de âmbito para planos de ficheiros de grandes dimensões ou para planos de ficheiro que incluem classes ou propriedades personalizadas. Para exportar um plano de ficheiros utilizando a opção de âmbito, introduza o comando seguinte:

FilePlanTool -mode export -fileplan nome do plano de ficheiros -o nome do ficheiro XML.xml -scope parâmetro

Em que nome do plano de ficheiros é o nome do plano de ficheiros para exportar e é requerido. Se o nome do plano de ficheiros incluir espaços ou caracteres especiais, coloque o nome do plano de ficheiros entre aspas.

O nome do ficheiro XML é o nome e caminho do ficheiro que pretende criar. Se não indicar um nome de ficheiro na linha de comandos, a ferramenta irá utilizar o nome de ficheiro predefinido especificado pelo campo Nome do ficheiro de saída. Este campo está localizado na caixa de diálogo Configuração. Quando utiliza a ferramenta com a opção de âmbito, a ferramenta cria um ficheiro XML para cada parte do plano de ficheiros. Assim, tem de especificar um nome de ficheiro XML diferente sempre que pretender utilizar a ferramenta no modo de exportação. Para obter informações sobre como especificar o nome predefinido do ficheiro XML de saída, consulte o tópico Configurar a ferramenta.

parâmetro pode ser qualquer um dos seguintes itens:
  • metadata: Se o plano de ficheiros incluir classes ou propriedades personalizadas, este parâmetro é requerido. A opção do parâmetro de metadados cria um ficheiro XML separado para as classes e propriedades personalizadas. Por isso, quando um plano de ficheiros inclui classes ou propriedades personalizadas, o processo de exportação e importação é constituído por dois passos:
    • Um passo para as classes e propriedades personalizadas
    • Um passo para o resto do plano de ficheiros. Se não utilizar o parâmetro de metadados, a ferramenta exporta o plano de ficheiros sem as propriedades personalizadas.
  • includecategory "record category name": Utilize este parâmetro para exportar uma categoria de registo específica. Quando utilizar includecategory, a ferramenta exporta todas as subcategorias e subpastas incluídas na categoria de registo especificada. O nome da categoria de registo tem de incluir o caminho completo no IBM Enterprise Records. Por exemplo, para exportar todos os elementos descendentes na categoria de registo designada por "Cat03", introduza o seguinte comando. Cat03 está incluído em Cat02 que, por sua vez, está incluído em Cat01.

FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o ficheiroexp.xml

FilePlanTool.bat -mode export -scope includecategories ficheiro01.txt -o export01.xml

File01.txt contém:

/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1

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

Importar/actualizar um plano de ficheiros

Para importar um plano de ficheiros ou segmento do plano de ficheiros, execute a ferramenta no modo de importação. Especifique o ficheiro XML criado pela ferramenta no modo de exportação. Se o plano de ficheiros incluir classes ou propriedades personalizadas, o processo de importação requer dois passos. No primeiro passo, são importadas as classes e propriedades personalizadas do plano de ficheiros. No segundo passo, é importado o resto do plano de ficheiros. Importe as classes e propriedades personalizadas em primeiro lugar. Em seguida, aguarde pelo menos 5 minutos antes de importar o plano de ficheiros, uma vez que os metadados das classes e propriedades personalizadas estão na memória cache. O tempo de TTL (time-to-live) da memória cache é de 5 minutos, período após o qual a memória cache é limpa. Para importar/actualizar um plano de ficheiros, introduza o comando seguinte:

FilePlanTool -mode import -f nome do ficheiro XML.xml-reimportoption opção

FilePlanTool -mode update -f nome do ficheiro XML -reimportoption opção

O nome do ficheiro XML é o nome e caminho do ficheiro que pretende importar. A ferramenta utiliza o nome de ficheiro predefinido especificado pelo campo Nome do ficheiro de saída na caixa de diálogo de configuração, caso o utilizador não indique um nome de ficheiro. Para obter informações sobre como especificar o nome predefinido do ficheiro XML de saída, consulte o tópico Configurar a ferramenta.

A opção para voltar a importar determina o comportamento predefinido da ferramenta ao importar uma entidade que já exista num plano de ficheiros. Para obter mais informações sobre a opção para voltar a importar, consulte o tópico Utilizar a opção de voltar a importar.

No modo de Importação, a ferramenta não utiliza a opção de âmbito, mas procura um controlo XML para determinar o que importar. Tem de indicar um nome de ficheiro XML diferente para metadados (classes e propriedades personalizadas) e para o plano de ficheiros.

Atenção: O controlo ClassificationScheme no ficheiro XML especifica o nome do plano de ficheiros.

Execute a ferramenta no modo de actualização para efectuar pequenas alterações após a importação inicial de um plano de ficheiros. Efectue a distinção entre os ficheiros XML importados inicialmente e as actualizações subsequentes. Especifique update como o atributo de InputMode do controlo FilePlan no ficheiro XML. Não pode modificar uma propriedade personalizada (como por exemplo, uma lista de selecção) utilizando o modo de actualização.

Consulte o nó de resolução de problemas e suporte do Information Center ou o IBM FileNet P8 Troubleshooting Guide na Documentação do produto da página do FileNet P8 Platform, se for apresentada uma mensagem de erro ou o processo de importação parar. Na maioria dos casos, o processo de importação pára após ocorrer um erro e não é apresentada nenhuma mensagem.

Se necessário, execute o varrimento de retenção para aplicar retenções condicionais a entidades após a importação, uma vez que a ferramenta não importa retenções condicionais. Consulte o tópico Limitações.

Validar um plano de ficheiros

Após criar manualmente um ficheiro XML, verifique se o ficheiro XML contém erros ou problemas de não conformidade. Pode validar o ficheiro através da Ferramenta de importação e exportação do plano de ficheiros. Para executar a Ferramenta de exportação e importação no modo de validação, introduza o comando seguinte:

FilePlanTool -mode validate -f nome do ficheiro XML.xml

O nome do ficheiro XML é o nome e caminho do ficheiro que pretende validar. A ferramenta utiliza o nome de ficheiro predefinido especificado pelo campo Nome do ficheiro de saída na caixa de diálogo de configuração, caso o utilizador não indique um nome de ficheiro. Para obter informações sobre como especificar o nome predefinido do ficheiro XML de saída, consulte o tópico Configurar a ferramenta.

Utilizar a opção de voltar a importar

Utilize a opção de voltar a importar para determinar o comportamento predefinido da ferramenta ao importar uma entidade que exista no plano de ficheiros. A Opção para voltar a importar inclui três parâmetros: Utilize a opção Ignorar após uma importação falhada de um plano de ficheiros de grande dimensão. Durante a segunda tentativa de importar o mesmo plano de ficheiros, a opção Ignorar evita a reimportação das entidades que foram correctamente importadas. Contudo, se a segunda tentativa de importação requerer pequenas modificações nas entidades que foram importadas correctamente na primeira importação, utilize a opção Substituir. Durante as importações subsequentes de pequenas modificações a algumas entidades, especifique Action="Modify" (na secção RMEntityObjectType do ficheiro XML) para as entidades. Altere estas entidades em vez de alterar o ficheiro XML original. Utilize também o modo actualizar para mais facilmente distinguir as actualizações subsequentes das importações completas iniciais. Consulte o tópico Importar/actualizar um plano de ficheiros.


Comentários

Última actualização: Novembro de 2013
fileplan_import_export.htm

© Copyright IBM Corp. 2013