IBM Enterprise Records, Versió 5.1.+            

Utilització de l'Eina d'importació i exportació de plans de fitxers

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: 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:

Configuració de l'eina

Abans d'executar l'eina en mode d'importació o exportació, cal que la configureu. Per configurar-la:
  1. Aneu a la carpeta on hi ha instal·lada l'Eina d'importació i exportació de plans de fitxers.
  2. Executeu una de les ordres següents a la línia d'ordres:
    Sistema operatiu Ordre
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    Introduïu la informació següent al quadre de diàleg Eina de plans de fitxers:

Exportació d'un pla de fitxers

Si el pla de fitxers que voleu exportar conté cap dels elements següents: 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

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.

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: 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.


Comentaris

Darrera actualització: Agost de 2011


© Copyright IBM Corp. 2011.
Aquest Information Center està basat en tecnologia Eclipse. (http://www.eclipse.org)