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:
- Exportar/importar entre modelos de dados. Por exemplo, se exportar de um
armazenamento de objectos de modelo de dados PRO, não pode importar para um
armazenamento de objectos de modelo de dados DoD.
- Exportar ou importar objectos, volumes, objectos de documentos, informação de
segurança e marcações de segurança de registos.
- Mecanismo de remoção de alterações.
- Exportar propriedades com valores nulos. Por exemplo, exportar uma fase de uma agenda
de eliminação sem um período de retenção e importar a agenda de eliminação para outro
armazenamento de objectos, não actualiza o período de retenção para um valor nulo. Contudo, pode actualizar manualmente o ficheiro XML para actualizar o período de
retenção. Para obter mais informações, consulte o
ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
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:
- Configure - abre uma caixa de diálogo onde pode
especificar as informações requeridas, como por exemplo, o nome do servidor do
Content Engine (CE), nome do armazenamento de
objectos, nome de utilizador e palavra-passe de administrador, e modo (importação ou
exportação).
- Export - cria um ficheiro XML totalmente compatível e conforme
que posteriormente pode importar para outro ambiente.
- Import/update - importa um ficheiro XML especificado
para um ambiente.
- Validate - lê um ficheiro XML para verificar a compatibilidade e
a conformidade.
Exportar um plano de ficheiros
Se o plano de ficheiros que
pretende exportar contém qualquer um dos itens seguintes:
- classes ou propriedades personalizadas
- mais de 300 mil pastas
- uma categoria de registo que inclui mais de 15 mil pastas
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
- includecategories ficheiro 01 - Utilize este
parâmetro para exportar apenas as categorias de registo e os respectivos descendentes
especificados no ficheiro de texto de entrada ficheiro 01.
Utilize o parâmetro includecategories para exportar um grande número
de categorias de registo para o mesmo ficheiro, sem especificar o nome de cada categoria
de registo na linha de comandos. Para utilizar este parâmetro, introduza o comando
seguinte:
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.
- excludecategory "nome de categoria de registo
excluído" - Utilize este parâmetro para excluir uma categoria de registo
especifica, bem como os respectivos descendentes. Por exemplo, se nome de
categoria de registo excluído for "Cat01/Cat02/Catlarge," a ferramenta exporta
todas as categorias de registo e as pastas de registo no plano de ficheiros, excepto as
categorias de registo e as pastas de registo no nó "Cat01/Cat02/CatLarge." Este
parâmetro funciona de modo semelhante a includecategory.
- excludecategories ficheiro 02 - Utilize este
parâmetro para excluir as sub-árvores dos nomes de raiz especificados no ficheiro de
texto ficheiro 02. Este parâmetro funciona da modo semelhante a
includecategories.
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:
- None - Ao adicionar uma entidade, a ferramenta reporta um
aviso no registo de excepções se uma entidade já existir, esta não é adicionada e o
processo continua.
- Skip - Ao adicionar uma entidade, a ferramenta ignora quaisquer
entidades existentes, continua o processo e reporta a acção de ignorar no registo de
actividades.
- Replace - Ao adicionar uma entidade, a ferramenta substitui
quaisquer entidades existentes, prossegue e reporta a acção de modificação no registo
de actividades.
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.