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:
- 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. Por outro lado, 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 tópico Resolução de problemas da Ferramenta de importação e exportação do plano de ficheiros.
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:
- Configure: abre uma caixa de diálogo para especificar as
informações requeridas. Estas informações são o nome do servidor do
Content Platform Engine, o nome do armazenamento de
objectos, o nome de utilizador e palavra-passe de administrador, bem como o modo
(importação ou exportação).
- Export: cria um ficheiro XML totalmente compatível e
conforme que pode importar posteriormente 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 incluir qualquer um dos itens seguintes:
- Classes ou propriedades personalizadas
- Mais de 300.000 pastas
- Uma categoria de registo que inclui mais de 15.000 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 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
- 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 "excluded
record category name": Utilize este parâmetro para excluir uma categoria de registo específica, bem como os respectivos descendentes. Por exemplo, se nome
da categoria de registo excluída for "Cat01/Cat02/Catlarge", a ferramenta
irá exportar todas as categorias de registo e pastas de registo no plano de ficheiros,
excepto algumas. A excepção são as categorias de registo
e pastas de registos incluídas 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 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:
- 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 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.