Per als desplegaments de l'IBM® Enterprise
Records,
utilitzeu l'Eina d'importació i exportació de plans de fitxers per importar un pla de fitxers extern
o exportar un pla de fitxers a un entorn extern. L'eina utilitza un fitxer XML per completar els processos d'importació
i exportació.
Visió general
Per obtenir informació detallada sobre la modificació d'un fitxer XML
exportat per incloure l'herència de planificació, les retencions alternatives, els
activadors de disposició i les retencions dinàmiques, consulteu el tema Resolució de
problemes amb l'eina d'importació i exportació de plans de fitxers.
Limitacions
Utilitzeu l'eina d'importació i exportació de
plans de fitxers per migrar plans de fitxers. Tot i això, l'eina no admet
les situacions següents:
- L'exportació/importació d'un model de dades creuat. Per exemple, si realitzeu una exportació
d'un magatzem d'objectes de dades PRO, no podeu importar en un magatzem d'objectes de model
de dades DoD.
- L'exportació o la importació d'objectes de registre, volums, objectes de document, informació
de seguretat i marques de seguretat.
- Un mecanisme de retrotracció.
- L'exportació de propietats amb un valor nul. Per exemple, l'exportació d'una fase
de planificació de disposició sense període de retenció. A més, la importació de la planificació
de disposició en un altre magatzem d'objectes, no actualitza el període de retenció a
un valor nul. Podeu actualitzar manualment, però, el fitxer XML per actualitzar
el període de retenció. Per obtenir més informació, consulteu el tema sobre Resolució de
problemes amb l'eina d'importació i exportació de plans de fitxers.
Primer exporteu i importeu les propietats personalitzades, com llistes d'opcions i classes en un fitxer XML independent abans d'importar la resta
del pla de fitxers. També, després d'importa un pla de fitxers, els estats d'entitat com ara
Tancat o
Preparat per a disposició deixen de tenir efecte.
Execució de l'eina
Podeu executar l'eina d'importació
i exportació de plans de fitxers des d'una línia d'ordres d'un programa executable Java. O
inicieu l'eina amb un fitxer d'ordres:
FilePlanTool.bat or
FilePlanTool.sh.
Podeu executar l'eina d'una d'aquestes cinc maneres:
- Configura: obre un diàleg en el qual especifiqueu
la informació necessària. Aquesta informació necessària és el nom del servidor de Content Platform Engine, el nom del magatzem d'objectes, el nom d'usuari i la contrasenya de l'administrador, i
el mode(importació o exportació).
- Exporta: crea un fitxer XML totalment compatible i adaptat
que podeu importar més endavant a un altre entorn.
- Importa/actualitza: importa un fitxer XML especificat
a un entorn.
- Valida: llegeix un fitxer XML per verificar la compatibilitat i adaptabilitat.
Exportació d'un pla de fitxers
Si el pla de fitxers que voleu exportar conté cap dels elements següents:
- Classes o propietats personalitzades
- Més de 300.000 carpetes
- Una categoria de registres que inclou més de 15.000 carpetes
Consulteu
Exportació d'un pla de fitxers amb l'opció scope.
Després de configurar l'eina,
podeu utilitzar-la per exportar un pla de fitxers.
Per exportar un pla de fitxers, escriviu l'ordre següent:
FilePlanTool -mode export -fileplan nom
pla fitxers -o nom fitxer XML.xml On nom pla
fitxers és el nom del pla de fitxers que s'exportarà i és obligatori.
Si el nom del pla de fitxers conté espais o caràcters especials, especifiqueu
nom pla fitxers entre cometes.
nom fitxer XML
és el nom i el camí d'accés del fitxer que cal crear. Si no
proporcioneu un nom de fitxer a la línia d'ordres, l'eina utilitza
el nom per defecte especificat al camp Nom de fitxer de sortida.
Aquest camp es troba al quadre de diàleg de configuració. Per obtenir informació detallada sobre l'especificació del nom de fitxer de sortida XML per defecte,
consulteu Configuració de l'eina.
Exportació d'un pla de fitxers amb l'opció scope
Quan exporteu un pla de fitxers, utilitzeu l'opció scope per als plans de fitxers de mida gran o per als
plans de fitxers que continguin classes o propietats personalitzades. Per exportar un pla de fitxers
amb l'opció scope, escriviu l'ordre següent:
FilePlanTool -mode export -fileplan nom
pla fitxers -o nom fitxer XML.xml -scope paràmetre
On nom pla
fitxers és el nom del pla de fitxers que s'exportarà i és obligatori.
Si el nom del pla de fitxers conté espais o caràcters especials, especifiqueu
nom pla fitxers entre cometes.
nom fitxer XML
és el nom i el camí d'accés del fitxer que voleu crear. Si no
proporcioneu un nom de fitxer a la línia d'ordres, l'eina utilitza
el nom per defecte especificat al camp Nom de fitxer de sortida.
Aquest camp es troba al quadre de diàleg de configuració. Quan s'utilitza l'eina amb l'opció scope, l'eina crea un fitxer XML
per a cada part del pla de fitxers.
Per tant, cal que especifiqueu un nom de fitxer XML diferent cada vegada que utilitzeu l'eina
en mode d'exportació. Per obtenir informació sobre l'especificació del nom de fitxer de sortida XML per defecte,
consulteu Configuració de l'eina.
paràmetre pot ser
qualsevol dels elements següents:
- metadades: si el pla de fitxers conté classes o propietats
personalitzades, es necessita aquest paràmetre. L'opció de paràmetre metadata crea un fitxer XML independent
per a classes i propietats personalitzades. Per tant, quan un pla de fitxers conté classes o propietats
personalitzades, els processos d'exportació i importació consten, cadascun, de dos passos:
- Un pas per a les classes i propietats personalitzades
- Un pas per al recordatori de pla de fitxers. Si no utilitzeu el paràmetre
metadata, l'eina exporta el pla de fitxers sense les propietats personalitzades.
- includecategory "nom de categoria de
registre": utilitzeu aquest paràmetre per exportar una categoria de
registre específica. Quan utilitzeu includecategory, l'eina exporta
totes les subcategories i subcarpetes contingudes dins la categoria de registres
especificades. El nom categories registres
ha d'incloure el camí d'accés complet a l'IBM Enterprise
Records.
Per exemple, per exportar tots els elements fills de la categoria de registres anomenada
"Cat03", escriviu
l'ordre següent. La categoria Cat03 es troba dins la Cat02
que alhora es troba dins la Cat01.
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories fitxer 01:
utilitzeu aquest paràmetre per exportar només les categories de registres i els fills
especificats al fitxer de text d'entrada fitxer 01.
Utilitzeu el paràmetre includecategories per exportar
moltes categories de registres al mateix fitxer sense especificar cada nom
de categoria de registres a la línia d'ordres. Per utilitzar aquest paràmetre,
escriviu l'ordre següent:
FilePlanTool.bat -mode export -scope includecategories fitxer01.txt -o export01.xml
Fitxer01.txt conté:
/categoriaB
/CategoriaC/SubcategoriaC2 /CatogoriaA/SubcategoriaA1
El nom de la categoria es representa mitjançant el nom de camí d'accés
complet i una categoria de registres per línia.
- excludecategory "nom de categoria de registre
exclosa": utilitzeu aquest paràmetre per excloure una categoria de
registres específica i els seus fills. Per exemple, si el nom de
la categoria de registres exclosa és "Cat01/Cat02/Catlarge," l'eina
exporta totes les categories de registres i les carpetes de registres del pla de fitxers
amb una excepció. L'excepció és les categories de registres i les carpetes de registres
que es troben al node "Cat01/Cat02/CatLarge". Aquest paràmetre funciona de forma semblant a includecategory.
- excludecategories fitxer 02:
utilitzeu aquest paràmetre per excloure els subarbres de noms d'arrel especificats
al fitxer de text fitxer 02. Aquest paràmetre funciona de forma semblant a includecategories.
Importació/Actualització d'un pla de fitxers
Per
importar un pla de fitxers o un segment d'un pla de fitxers, executeu l'eina amb el mode
importa. Especifiqueu el fitxer XML que l'eina ha creat al mode exporta. Si el pla de fitxers conté classes o propietats personalitzades, el procés d'importació
exigeix dos passos. En el primer pas s'exporten les classes personalitzades i les
propietats de pla de fitxers. Al segon pas s'importa el recordatori
del pla de fitxers. En primer lloc, importeu les propietats i classes personalitzades.
Espereu al menys 5 minuts abans d'importar el pla de fitxers perquè
la classe personalitzada i les metadades de propietats s'emmagatzemen a la memòria cau. El temps de vida (TTL) de la memòria cau és de 5 minuts, transcorreguts els quals la memòria cau
s'esborra.
Per importar/actualitzar un pla de fitxers, escriviu l'ordre següent:
FilePlanTool -mode import -f nom
fitxer XML.xml -reimportoption opció
FilePlanTool -mode update -f nom
fitxer XML.xml -reimportoption opció
nom fitxer XML
és el nom i el camí d'accés del fitxer que voleu importar. L'eina utilitza el nom de fitxer per defecte especificat pel camp de Nom de fitxer de sortida al diàleg de configuració si no proporcioneu
un nom de fitxer. Per obtenir informació sobre l'especificació del nom de fitxer de sortida XML per defecte,
consulteu Configuració de l'eina.
L'opció reimport
determina el comportament predeterminat de l'eina en importar una entitat que existeix en un pla de fitxers. Per obtenir informació detallada sobre l'opció reimport, consulteu
Utilització de l'opció per tornar a importar.
Al mode d'importació,
l'eina no utilitza l'opció scope, sinó que cerca a l'etiqueta XML per determinar
que cal importar. Cal que proporcioneu un nom de fitxer XML diferent per a les metadades
(classes i propietats personalitzades) i el pla de fitxers.
Atenció: L'etiqueta ClassificationScheme del fitxer XML especifica el nom del pla de fitxers.
Executeu l'eina en mode d'actualització per fer petites modificacions després de la importació
inicial d'un pla de fitxers. Distingiu actualitzacions subseqüents dels fitxers
XML importats inicialment. Especifiqueu update com a atribut
InputMode de l'etiqueta FilePlan al fitxer XML. No podeu modificar una propietat personalitzada
(com una llista d'opcions) utilitzant la modalitat d'actualització.
Consulteu
el node de resolució de problemes i suport de l'Information center o el IBM FileNet P8 Troubleshooting Guide
a la documentació del producte per a la pàgina de FileNet P8
Platform
si rebeu un missatge d'error o el procés d'importació s'atura. En la majoria dels casos, el procés d'importació s'atura després de trobar un error
i no mostra cap missatge.
Si cal, executeu un escombratge de retenció per aplicar retencions condicionals
a les entitats després de la importació perquè l'eina no importa les retencions condicionals. Consulteu
Limitacions.
Validació d'un pla de fitxers
Després de crear manualment
un fitxer XML, verifiqueu que el fitxer XML no contingui cap error o problemes de compatibilitat. Podeu validar
el fitxer a través de l'eina d'importació i exportació de pla de fitxers. Per executar l'eina d'importació i
exportació en un mode de validació, escriviu l'ordre següent:
FilePlanTool -mode validate -f XML
nom fitxer.xml
nom fitxer XML
és el nom i el camí d'accés del fitxer que voleu validar. L'eina utilitza el nom de fitxer per defecte especificat pel camp de Nom de fitxer de sortida al diàleg de configuració si no proporcioneu
un nom de fitxer. Per obtenir informació sobre l'especificació del nom de fitxer de sortida XML per defecte,
consulteu Configuració de l'eina.
Utilització de l'opció per tornar a importar
Utilitzeu l'opció
per tornar a importar per determinar el comportament predeterminat de l'eina en importar una entitat que existeix
en un pla de fitxers. L'opció per tornar a importar té tres paràmetres:
- Cap: quan s'afegeix una entitat, l'eina notifica un avís
al registre d'excepcions si ja existeix una entitat, no afegeix l'entitat i continua.
- Omet: quan s'afegeix una entitat, l'eina omet les entitats existents,
continua i notifica l'acció d'omissió al registre d'activitats.
- Reemplaça: quan s'afegeix una entitat, l'eina reemplaça les entitats existents,
continua i notifica l'acció de modificació al registre d'activitats.
Utilitzeu l'opció
Omet després que una importació d'un pla de fitxers gran hagi fallat. Durant el segon intent d'importació del mateix pla de fitxers, l'opció Skip
impedeix la reimportació d'entitats que s'han importat correctament.
Tot i això, si el segon intent d'importació exigeix petites modificacions a les entitats
que s'han importat correctament la primera vegada, utilitzeu
l'opció
Reemplaça. Durant importacions posteriors de modificacions menors a un petit
nombre d'entitats, especifiqueu
Action="Modify" (a la secció
RMEntityObjectType del fitxer XML) per a les entitats. Canvieu totes les entitats en lloc de canviar el fitxer XML original. A més a més, utilitzeu
el mode d'actualització per identificar més fàcilment les actualitzacions posteriors de les importacions completes inicials. Consulteu
Importació/Actualització d'un pla de fitxers.