IBM Enterprise Records, Versão 5.1.+            

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 modificar um ficheiro XML exportado para incluir a herança de agenda, retenções alternativas, activadores de eliminação e retenções dinâmicas (retenções condicionais), consulte a secção File Plan Import and Export Tool em http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.

Limitações

A ferramenta de importação e exportação do plano de ficheiros facilita a migração dos planos de ficheiros. Contudo, a ferramenta não suporta o seguinte: Adicionalmente, 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 executável Java em linha de comandos, ou pode iniciar 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
    UNIX 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 contém 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 utiliza o nome de ficheiro predefinido, especificado pelo campo Nome do ficheiro de saída na caixa de diálogo de configuração da ferramenta. Para obter mais informações sobre 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 utiliza o nome de ficheiro predefinido, especificado pelo campo Nome do ficheiro de saída na caixa de diálogo de configuração da ferramenta. 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 especificar o nome predefinido do ficheiro XML de saída, consulte o tópico Configurar a ferramenta.

O valor de parâmetro pode ser qualquer um dos seguintes:
  • metadata - Se o plano de ficheiros contém 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 plano de ficheiros restante. Se não utilizar o parâmetro de metadados, a ferramenta exporta o plano de ficheiros sem as propriedades personalizadas.
  • includecategory "nome da categoria do registo" - Utilize este parâmetro para exportar uma categoria de registo específica. Quando utiliza 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 descendentes na categoria de registo denominada "Cat03," que está incluída em "Cat02", que por sua vez, está incluída em "Cat01", introduza o comando seguinte:

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 um segmento do mesmo, execute a ferramenta no modo de importação e especifique o ficheiro XML que a ferramenta criou no modo de exportação. Se o plano de ficheiros incluir classes ou propriedades personalizadas, o processo de importação requer dois passos. Um passo importa as classes e propriedades personalizadas no plano de ficheiros e o segundo passo importa o restante plano de ficheiros. Comece por importar as classes e as propriedades personalizadas primeiro e, em seguida, aguarde, pelo menos, cinco 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 cinco 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. Se não indicar um nome de ficheiro na linha de comandos, 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 da ferramenta. Para obter informações sobre 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á existe no 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.

Pode executar a ferramenta no modo de actualização para efectuar pequenas alterações, após a importação inicial de um plano de ficheiros, e pode distinguir s actualizações subsequentes dos ficheiros XML importados inicialmente. 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 opção) utilizando o modo de actualização.

Consulte o tópico IBM FileNet P8 Troubleshooting Guide se receber uma mensagem de erro, ou se 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 que o ficheiro XML não contém erros ou problemas de conformidade, validando o mesmo na ferramenta de exportação e importaçã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. Se não indicar um nome de ficheiro na linha de comandos, 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 da ferramenta. Para obter informações sobre 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 já existe no plano de ficheiros. A Opção para voltar a importar inclui três parâmetros: Utilize a funçã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 de 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 já foram correctamente importadas na primeira importação, utilize a opção de substituição. Durante as importações subsequentes de pequenas modificações a um pequeno número de entidades, especifique Action="Modify" (na secção RMEntityObjectType do ficheiro XML) para as entidades, em vez de efectuar alterações ao 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: Agosto de 2011


© Copyright IBM Corp. 2011.
Este Information Center é baseado na tecnologia Eclipse. (http://www.eclipse.org)