Per als desplegaments de l'IBM® Enterprise
Records,
podeu utilitzar 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
per incloure l'herència de planificacions, retencions alternatives, activadors de disposició i
retencions dinàmiques (retencions condicionals), consulteu l'apartat sobre l'Eina
d'importació i exportació de plans de fitxers que hi ha a
http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.
Limitacions
L'Eina d'importació i exportació de plans de fitxers
facilita la migració dels plans de fitxers. Tot i això, l'eina no admet el següent:
- 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ó i 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-ne més informació, consulteu ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
A més a més, cal que exporteu i importeu en primer lloc les propietats personalitzades (com ara
llistes d'opcions) i les classes en un fitxer XML independent abans d'importa 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'un executable Java de línia d'ordres o podeu iniciar l'eina amb el fitxer d'ordres
FilePlanTool.bat o
FilePlanTool.sh.
Podeu executar l'eina d'una d'aquestes cinc maneres:
- Configure: s'obre un diàleg on s'especifica la informació
necessària, com ara el nom del servidor del Content Engine (CE),
el nom del magatzem d'objectes, el nom d'usuari i la contrasenya de l'administrador i el mode
(importació o exportació).
- Export: es crea un fitxer XML totalment compatible que es pot importar més endavant
en un altre entorn.
- Import/update: s'importa un fitxer XML especificat en un entorn.
- Validate: es llegeix un fitxer XML per verificar la compatibilitat.
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 de fitxer per defecte especificat al camp Nom de fitxer de sortida del quadre de diàleg
de configuració de l'eina. 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 de fitxer per defecte especificat al camp Nom de fitxer de sortida del quadre de diàleg
de configuració de l'eina. 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 següents:
- metadata: si el pla de fitxers conté classes o propietats personalitzades,
aquest paràmetre és obligatori. 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 les propietats personalitzades
- Un pas per a la res del pla de fitxers. Si no utilitzeu el paràmetre
metadata, l'eina exporta el pla de fitxers sense les propietats personalitzades.
- includecategory "nom categoria registres": utilitzeu aquest paràmetre
per exportar una categoria de registres concreta.
Quan s'utilitza includecategory, l'eina exporta totes les subcategories i les subcarpetes contingudes
dins la categoria de registres especificada. 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," que està continguda dins "Cat02" i que, per la seva banda, està continguda a "Cat01," escriviu
l'ordre següent:
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 registre i els seus elements fills
especificats en el fitxer de text d'entrada fitxer 01.
Utilitzeu el paràmetre includecategories per exportar un gran nombre de 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 categoria registres exclosa":
utilitzeu aquest paràmetre per excloure una categoria de registres específica i els seus fills. Per exemple, si
nom categoria registres exclosa és "Cat01/Cat02/Catlarge", l'eina exporta totes les categories de registres
i les carpetes de registres del pla de fitxers, tret de les categories de registres i les carpetes de registres contingudes
dins el node "Cat01/Cat02/CatLarge". Aquest paràmetre funciona de forma semblant a includecategory.
- excludecategories fitxer 02:
utilitzeu aquest paràmetre per excloure els subarbres dels noms 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
en mode d'importació i especifiqueu el fitxer XML que l'eina ha creat en mode d'exportació.
Si el pla de fitxers conté classes o propietats personalitzades, el procés d'importació
exigeix dos passos. Un pas importa les classes personalitzades i les propietats del pla de fitxers
i el segon pas importa la resta del pla de fitxers. Importeu les classes
i les propietats personalitzades en primer lloc i, tot seguit, espereu, com a mínim, cinc minuts
abans d'importar el pla de fitxers perquè les metadades de classes i propietats personalitzades s'emmagatzemen
a la memòria cau. El temps de vida (TTL) de la memòria cau és de cinc 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. Si no proporcioneu un nom de fitxer a la línia d'ordres,
l'eina utilitzarà el nom de fitxer per defecte especificat al camp Nom de fitxer de sortida del diàleg
de configuració de l'eina. 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 ja 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.
Podeu executar l'eina en mode d'actualització per fer petites modificacions després de la importació
inicial d'un pla de fitxers i podeu distingir les actualitzacions posteriors 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 la publicació IBM FileNet P8 Troubleshooting Guide 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 validant-lo
mitjançant l'Eina d'importació i exportació de plans de fitxers. Per executar l'eina d'importació i exportació
en 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. Si no proporcioneu un nom de fitxer a la línia d'ordres,
l'eina utilitzarà el nom de fitxer per defecte especificat al camp Nom de fitxer de sortida del diàleg
de configuració de l'eina. 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 ja existeix
en un pla de fitxers. L'opció per tornar a importar té tres paràmetres:
- None: 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.
- Skip: quan s'afegeix una entitat, l'eina omet les entitats existents,
continua i notifica l'acció d'omissió al registre d'activitats.
- Replace: 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ó Skip després d'una importació errònia d'un pla de fitxers gran.
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ó Replace.
Durant les importacions posteriors de modificacions menors a un nombre petit d'entitats, especifiqueu
Action="Modify" (a la secció RMEntityObjectType
del fitxer XML) per a les entitats, en lloc de fer canvis al 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.