IBM Enterprise Records, Versió 5.1.2    

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

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

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 s'ha instal·lat 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
    AIX, HP-UX, Linux i Solaris FilePlanTool.sh -mode configure
    Introduïu la informació següent al quadre de diàleg de l'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 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

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


Comentaris

Darrera actualització: Novembre de 2013
fileplan_import_export.htm

© Copyright IBM Corp. 2013