IBM Enterprise Records, verzia 5.1.2    

Používanie nástroja na importovanie a exportovanie plánu súborov

Pre nasadenia IBM® Enterprise Records použite nástroj na importovanie a exportovanie plánu súborov, ktorým importujete externý plán súborov alebo exportujete plán súborov do externého prostredia. Tento nástroj používa na dokončenie procesov importovania a exportovania súbor XML.

Prehľad

Podrobnosti o úprave exportovaného súboru XML tak, aby zahrňoval dedenie plánu, alternatívne uchovávanie, spúšťače dostupnosti a dynamické pozastavenia, nájdete v téme Troubleshooting File Plan Import and Export tool.

Obmedzenia

Pomocou nástroja na importovanie a exportovanie plánu súborov migrujte plány súborov. Tento nástroj však nepodporuje tieto scenáre: Najprv exportujte a importujte vlastné vlastnosti, napríklad zoznamy možností a triedy v osobitnom súbore XML a následne importujte zvyšok plánu súborov. Potom ako importujete plán súborov nebudú platné stavy entít ako Closed alebo Ready for Disposition.

Spustenie nástroja

Nástroj na importovanie a exportovanie plánu súborov môžete spustiť zo spustiteľného programu Java príkazového riadka. Nástroj môžete spustiť aj pomocou príkazového súboru FilePlanTool.bat alebo FilePlanTool.sh. Nástroj môžete spustiť v jednom z týchto piatich režimov:

Konfigurácia nástroja

Nástroj musíte pred jeho spustením v režime importovania alebo exportovania konfigurovať. Konfigurácia nástroja:
  1. Prejdite do priečinka, kde je nainštalovaný nástroj na importovanie a exportovanie plánu súborov.
  2. V príkazovom riadku spustite jednu z nasledujúcich možností:
    Operačný systém Príkaz
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux a Solaris FilePlanTool.sh -mode configure
    Do dialógového okna nástroja plánu súborov zadajte tieto informácie:

Export plánu súborov

Ak plán súborov, ktorý chcete exportovať, obsahuje ľubovoľnú z týchto položiek: Pozrite si Plán súborov exportujte s voľbou rozsahu.

Po konfigurácii nástroja ním môžete exportovať plán súborov. Ak chcete exportovať plán súborov, zadajte tento príkaz:

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml

Kde file plan name je názov plánu súborov, ktorý má byť exportovaný a je vyžadovaný. Ak názov plánu súborov obsahuje medzery alebo špeciálne znaky, pred a za file plan name dajte úvodzovky.

XML filename je názov a cesta súboru, ktorý sa má vytvoriť. Ak v príkazovom riadku nezadáte názov súboru, nástroj použije predvolený názov súboru zadaný v poli Output File Name. Toto pole sa nachádza v dialógovom okne konfigurácie. Podrobnosti týkajúce sa zadania predvoleného názvu výstupného súboru XML nájdete v Konfigurácia nástroja.

Plán súborov exportujte s voľbou rozsahu

Keď exportujete plán súborov, voľbu rozsahu použite pre plány súborov alebo pre plány súborov, ktoré obsahujú vlastné triedy alebo vlastnosti. Ak chcete exportovať plán súborov pomocou voľby rozsahu, zadajte tento príkaz:

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml -scope parameter

Kde file plan name je názov plánu súborov, ktorý má byť exportovaný a je vyžadovaný. Ak názov plánu súborov obsahuje medzery alebo špeciálne znaky, pred a za file plan name dajte úvodzovky.

XML filename je názov a cesta súboru, ktorý chcete vytvoriť. Ak v príkazovom riadku nezadáte názov súboru, nástroj použije predvolený názov súboru zadaný v poli Output File Name. Toto pole sa nachádza v dialógovom okne konfigurácie. Keď nástroj použijete s voľbou rozsahu, nástroj vytvorí súbor XML pre každú časť plánu súborov. Preto vždy keď nástroj použijete v režime exportovania musíte zadať iný názov súboru XML. Informácie o určení predvoleného názvu výstupného súboru XML nájdete v téme Konfigurácia nástroja.

parameter môže byť ľubovoľná z nasledujúcich položiek:
  • metadata: Ak váš plán súborov obsahuje vlastné triedy alebo vlastnosti, tento parameter je vyžadovaný. Voľba parametra metaúdajov vytvorí osobitný súbor XML pre vlastné triedy a vlastnosti. Preto keď plán súborov obsahuje vlastné triedy alebo vlastnosti, proces exportovania aj proces importovania sa skladá z dvoch krokov:
    • jeden krok pre vlastné triedy a vlastnosti,
    • jeden krok pre zvyšok plánu súborov. Ak nepoužijete parameter metaúdajov, nástroj exportuje plán súborov bez vlastných vlastností.
  • includecategory "record category name": Tento parameter použite na export konkrétnej kategórie záznamov. Keď použijete includecategory nástroj exportuje všetky podkategórie a podpriečinky obsiahnuté v rámci určenej kategórie záznamov. record category name musí zahŕňať úplnú cestu v IBM Enterprise Records. Ak chcete napríklad exportovať všetkých potomkov v kategórii záznamov s názvom Cat03, zadajte nasledovný príkaz. Cat03 je obsiahnutý v Cat02, ktorý je obsiahnutý v Cat01.

FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o expfile.xml

FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml

File01.txt obsahuje:

/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1

Názov kategórie reprezentuje názov úplnej cesty a jedna kategória záznamov na riadok.

Import / Aktualizácia plánu súborov

Ak chcete importovať plán súborov alebo segment plánu súborov, nástroj spustite v režime importovania. Zadajte súbor XML, ktorý nástroj vytvoril v režime exportovania. Ak váš plán súborov obsahuje vlastné triedy alebo vlastnosti, proces importovania vyžaduje dva kroky. Prvý krok importuje vlastné triedy a vlastnosti v pláne súborov. Druhý krok importuje zvyšok plánu súborov. Najprv importujte vlastné triedy a vlastnosti. Čakajte najmenej 5 minút a až potom importujte plán súborov, pretože metaúdaje vlastných tried a vlastností sa ukladajú do pamäte cache. Doba životnosti (TTL) pamäte cache je 5 minút. Po jej uplynutí sa pamäť cache vyčistí. Ak chcete importovať/aktualizovať plán súborov, zadajte tento príkaz:

FilePlanTool -mode import -f XML filename.xml -reimportoption option

FilePlanTool -mode update -f XML filename.xml -reimportoption option

XML filename je názov a cesta súboru, ktorý chcete importovať. Pokiaľ nezadáte názov súboru, nástroj použije predvolený názov súboru zadaný v poli Output File Name v dialógovom okne konfigurácie. Informácie o určení predvoleného názvu výstupného súboru XML nájdete v téme Konfigurácia nástroja.

Voľba opakovaného importu stanovuje predvolené správanie nástroja pri importe entity, ktorá existuje v pláne súborov. Podrobnosti o voľbe opakovaného importovania nájdete v Používanie voľby opakovaného importovania.

Nástroj v režime importovania nepoužíva voľbu rozsahu, ale pozrie sa na značku XML, aby stanovil, čo sa má importovať. Pre metaúdaje (vlastné triedy a vlastnosti) a plán súborov musíte poskytnúť iný názov súboru XML.

Varovanie: Značka ClassificationScheme v súbore XML určuje názov plánu súborov.

Nástroj spustite v režime aktualizácie, aby ste mohli vykonať menšie úpravy po úvodom importovaní plánu súborov. Neskoršie aktualizácie odlíšte od pôvodne importovaných súborov XML. Zadajte update ako atribút InputMode značky FilePlan v súbore XML. Vlastnú vlastnosť (napr. zoznam možností) nie je možné upraviť v režime aktualizácie.

Ak dostane chybovú správu alebo ak sa proces importovania zastaví, pozrite si uzol Riešenie problémov and Podpora v informačnom centre alebo IBM FileNet P8 Troubleshooting Guide v produktovej dokumentácii pre stránku FileNet P8 Platform. Vo väčšine prípadov sa proces importovania po zaznamenaní chyby zastaví a nezobrazí žiadnu správu.

V prípade potreby spustite čistenie pozastavení, aby sa po importovaní aplikovali na entity podmienené pozastavenia, pretože nástroj neimportuje podmienené pozastavenia. Pozrite si Obmedzenia.

Overenie platnosti plánu súborov

Po manuálnom vytvorení súboru XML skontrolujte, či neobsahuje chyby alebo problémy s nesúladom. Platnosť súboru možno overiť prostredníctvom nástroja na importovanie a exportovanie plánu súborov. Ak chcete spustiť nástroj na importovanie a exportovanie, zadajte tento príkaz:

FilePlanTool -mode validate -f XML filename.xml

XML filename je názov a cesta súboru, ktorého platnosť chcete overiť. Pokiaľ nezadáte názov súboru, nástroj použije predvolený názov súboru zadaný v poli Output File Name v dialógovom okne konfigurácie. Informácie o určení predvoleného názvu výstupného súboru XML nájdete v téme Konfigurácia nástroja.

Používanie voľby opakovaného importovania

Pomocou voľby opakovaného importovania stanovte predvolené správanie nástroja pri importovaní entity, ktorá existuje v pláne súborov. Voľba reimport má tri parametre: Voľbu Skip použite po zlyhanom importe veľkého plánu súborov. Pri druhom pokuse importovať rovnaký plán súborov, sa voľba Skip vyhne opakovanému importu entít, ktoré sú úspešne importované. Ak však druhý pokus importovať vyžaduje menšie modifikácie entít, ktoré sú úspešne importované po prvý raz, použite voľbu Replace. Počas následných importov menších modifikácií malého počtu entít zadajte pre tieto entity Action="Modify" (v časti RMEntityObjectType súboru XML). Zmeňte tieto entity, nie pôvodný súbor XML. Režim aktualizácie vám umožní ľahšie identifikovať následné aktualizácie z pôvodných úplných importov. Pozrite si Import / Aktualizácia plánu súborov.


Spätná väzba

Posledná aktualizácia: November 2013
fileplan_import_export.htm

© Copyright IBM Corp. 2013