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:
- Krížový export/import dátového modelu. Ak napríklad exportujete
zo skladu objektov dátového modelu PRO, nemôžete importovať do skladu
objektov dátového modelu DoD.
- Exportovanie alebo importovanie objektov záznamov, zväzkov, objektov
dokumentov, bezpečnostných informácií a bezpečnostných označení.
- Mechanizmy operácie rollback.
- Exportovanie vlastností s nulovou hodnotou. Napríklad exportovanie
fázy plánu dostupnosti bez doby uchovávania. Ani importovanie plánu
dostupnosti do iného skladu objektov neaktualizuje dobu uchovávania
na null. Môžete však manuálne aktualizovať súbor XML a tým aktualizovať
dobu uchovávania. Bližšie informácie nájdete v téme Troubleshooting File Plan Import and Export tool.
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:
- Configure: Otvorí dialógové okno, v ktorom zadávate
vyžadované informácie. Tieto vyžadované informácie sú názov servera Content Platform Engine, názov skladu objektov,
meno a heslo administrátora a režim (import alebo export).
- Export: Vytvorí plne kompatibilný súbor
XML, ktorý môžete neskôr importovať do iného prostredia.
- Import/update: Importuje určený súbor XML
do prostredia.
- Validate: Prečíta súbor XML na overenie
kompatibility a súladu.
Export plánu súborov
Ak plán súborov, ktorý
chcete exportovať, obsahuje ľubovoľnú z týchto položiek:
- Vlastné triedy alebo vlastnosti
- Viac ako 300 000 priečinkov
- Kategóriu záznamov, ktorá zahŕňa viac ako 15 000 priečinkov
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
- includecategories file 01:
Pomocou tohto parametra exportujte len kategórie záznamov a ich
potomkov určených vo vstupnom textovom súbore file 01. Pomocou parametra includecategories exportujte veľa
kategórií záznamov do jedného súboru bez toho, aby ste zadali každý názov
kategórie záznamov do príkazového riadka. Ak chcete použiť tento parameter,
zadajte tento príkaz:
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.
- excludecategory "excluded record category name": Tento parameter použite na vylúčenie konkrétnej kategórie záznamov a jej potomkov. Ak napríklad excluded
record category name je "Cat01/Cat02/Catlarge," nástroj
exportuje všetky kategórie záznamov a priečinky záznamov v pláne
súborov s výnimkou. Výnimkou sú kategórie záznamov a priečinky záznamov, obsiahnuté v uzle "Cat01/Cat02/CatLarge". Tento parameter
funguje podobne ako includecategory.
- excludecategories file 02:
Pomocou tohto parametra vyraďte podstromy koreňových názvov určených
v textovom súbore file 02. Tento parameter funguje
podobne ako includecategories.
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:
- None: Nástroj pri pridávaní entity nahlási
varovanie v protokole výnimiek, ak existuje entita, nepridá entitu
a pokračuje.
- Skip: Nástroj pri pridávaní entity vynechá
všetky existujúce entity, pokračuje a do protokolu aktivity nahlási
akciu vynechania.
- Replace: Nástroj pri pridávaní entity nahradí
všetky existujúce entity, pokračuje a nahlási akciu úpravy v protokole
aktivity.
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.