Při implementacích produktu IBM® Enterprise
Records použijte k importu externího souboru nebo k exportu plánu souborů
do externího prostředí Nástroj pro import a export plánu souborů. Nástroj k dokončení procesů importu a exportu využívá soubor XML.
Přehled
Další podrobnosti o úpravách exportovaného souboru XML, které mohou začlenit dědičnost plánu, alternativní uchování,
spouštěče odebrání a dynamická zadržení naleznete v tématu řešení problémů s nástrojem pro import a export plánu souborů.
Omezení
Nástroj pro import a export plánu souborů můžete použít k migraci plánů souborů. Nástroj však nepodporuje tyto scénáře:
- Export/import mezi datovými modely. Pokud například exportujete z úložiště objektů datového modelu PRO, nemůžete importovat do úložiště objektů
datového modelu DoD.
- Export nebo import objektů záznamů, svazků, objektů dokumentů, informací o zabezpečení a značení zabezpečení.
- Mechanismus odvolání.
- Export vlastností s hodnotou null. Například export fáze plánu odebrání bez stanoveného období uchování. Import plánu odebrání do jiného úložiště
objektů také neaktualizuje období uchování na hodnotu null. Můžete však ručně aktualizovat soubor XML tak, aby aktualizoval období uchování. Další informace najdete v tématu řešení problémů s nástrojem pro import a export plánu souborů.
Před importem zbývající části plánu souborů nejprve exportujte a importujte uživatelské vlastnosti, například seznam voleb, a
třídy v samostatném souboru XML. Rovněž nezapomeňte, že po provedení importu plánu souborů již nejsou v platnosti stavy entit, např.
Zavřený nebo
Připravený pro odebrání.
Spuštění nástroje
Nástroj pro import a export plánu souborů můžete spustit ze spustitelného souboru Java pomocí příkazového řádku. Lze jej spustit také příkazovým souborem
FilePlanTool.bat nebo
FilePlanTool.sh. Nástroj můžete spustit v jednom z pěti režimů:
- Configure (Konfigurace): zobrazí dialogové okno, ve kterém zadáte vyžadované informace. Tyto vyžadované informace jsou název serveru Content Platform Engine, název úložiště objektů, uživatelské jméno a heslo administrátora a režim (import nebo export).
- Export: vytvoří plně kompatibilní a vyhovující soubor XML, který můžete později importovat do jiného prostředí.
- Import/update (Import/aktualizace): importuje určený soubor XML do daného prostředí.
- Validate (Ověření): přečte soubor XML a ověří kompatibilitu a shodu se standardem XML.
Export plánu souborů
Pokud plán souborů, který chcete exportovat, obsahuje některou z následujících položek:
- Uživatelské třídy nebo vlastnosti
- Více než 300 000 složek
- Kategorii záznamu, která obsahuje více než 15 000 složek
Viz
Export plánu souborů s volbou rozsahu.
Jakmile
provedete konfiguraci nástroje, můžete nástroj použít k exportu plánu souborů. Chcete-li exportovat plán souborů, zadejte tento příkaz:
FilePlanTool -mode export
-fileplan název_plánu_souborů -o název_souboru_XML.xml kde
název_plánu_souborů je název plánu souborů pro export, který je povinný. Pokud název plánu souborů obsahuje mezery nebo speciální znaky, uzavřete
název_plánu_souborů do uvozovek.
název_souboru_XML je název a cesta k souboru, který chcete
vytvořit. Pokud na příkazovém řádku nezadáte název souboru, nástroj použije výchozí název souboru určený polem ONázev výstupního souboru. Toto pole se nachází v dialogovém okně konfigurace. Podrobnosti o určení výchozího názvu výstupního souboru XML naleznete v části Konfigurace nástroje.
Export plánu souborů s volbou rozsahu
Při exportu plánu souborů je možné použít volbu rozsahu pro velké
plány souborů nebo pro plány souborů obsahující uživatelské třídy nebo vlastnosti. Chcete-li exportovat plán souborů s použitím volby rozsahu, zadejte tento
příkaz:
FilePlanTool -mode export -fileplan název_plánu_souborů
-o název_souboru_XML.xml -scope parametr
kde
název_plánu_souborů je název plánu souborů pro export, který je povinný. Pokud název plánu souborů obsahuje mezery nebo speciální znaky, uzavřete
název_plánu_souborů do uvozovek.
název_souboru_XML je název a cesta k souboru, který chcete vytvořit. Pokud na příkazovém řádku nezadáte název souboru, nástroj použije výchozí název souboru určený polem ONázev výstupního souboru. Toto pole se nachází v dialogovém okně konfigurace. Pokud používáte nástroj s volbou rozsahu, nástroj vytvoří soubor XML pro každou část plánu souborů. Proto je nutné při každém použití nástroje v režimu exportu zadat odlišný název souboru XML. Informace o určení výchozího názvu výstupního souboru XML naleznete v části Konfigurace nástroje.
parametr může obsahovat libovolnou z následujících
položek:
- metadata: Pokud váš plán souborů obsahuje uživatelské třídy nebo vlastnosti, je tento parametr povinný. Volba parametru metadat vytvoří oddělený soubor
XML pro uživatelské třídy a vlastnosti.
Proto platí, že pokud plán souborů obsahuje uživatelské třídy nebo vlastnosti, procesy exportu a importu
sestávají ze dvou kroků:
- Jeden krok pro uživatelské třídy a vlastnosti
- Jeden krok pro zbývající část plánu souborů. Pokud nepoužijete parametr metadat, nástroj exportuje plán souborů bez uživatelských vlastností.
- includecategory "název kategorie záznamu": Tento parametr můžete použít pro export specifické kategorie
záznamu. Při použití parametru includecategory nástroj exportuje všechny podkategorie a podsložky obsažené v určené kategorii záznamu. název kategorie záznamu v produktu IBM Enterprise
Records musí zahrnovat úplnou cestu. Pokud chcete
například exportovat všechny podřízené entity v kategorii záznamu s názvem "Kat03", zadejte následující příkaz. Kategorie Kat03 je obsažena v Kat02, která je dále obsažena v Kat01.
FilePlanTool.bat -mode export -scope
includecategory "/Kat01/Kat02/Kat03" -o expfile.xml
- includecategories soubor_01: Tento parametr se používá, když chcete exportovat pouze kategorie záznamu a příslušné podřízené entity určené ve vstupním textovém souboru soubor_01. Parametr includecategories se používá při exportu velkého počtu kategorií záznamu do stejného souboru bez určování názvu každé kategorie na příkazovém řádku. Chcete-li použít tento parametr, zadejte tento příkaz:
FilePlanTool.bat -mode export
-scope includecategories soubor01.txt -o
export01.xml
soubor01.txt obsahuje:
/kategorieB /KategorieC/PodkategorieC2 /KategorieA/PodkategorieA1
Název kategorie je vyjádřen úplnou cestou a jednou kategorií záznamu na každém řádku.
- excludecategory "název vyloučené kategorie záznamu": Tento parametr můžete použít pro vyloučení specifické
kategorie záznamu a jejích podřízených entit. Pokud například název vyloučené kategorie záznamu je "Kat01/Kat02/Kat_vetsi", nástroj exportuje všechny kategorie záznamu a složky záznamů v plánu souborů s určitou výjimkou. Tou jsou kategorie záznamu a složky záznamů obsažené uvnitř uzlu "Kat01/Kat02/Kat_vetsi". Tento parametr má podobné použití jako includecategory.
- excludecategories soubor_02: Tento parametr se používá k vyloučení podstromů názvů kořenů určených v textovém
souboru soubor_02. Tento parametr má podobné použití jako includecategories.
Import/aktualizace plánu souborů
Chcete-li importovat plán souborů nebo jeho úsek, spusťte nástroj v režimu
importu. Určete soubor XML, který nástroj vytvořil v režimu exportu. Pokud váš plán souborů obsahuje uživatelské třídy nebo vlastnosti, proces importu vyžaduje dva kroky. První krok importuje uživatelské třídy a vlastnosti
v plánu souborů. Druhý krok importuje zbývající část plánu souborů. Importujte vlastní třídy a vlastnosti jako první. Potom před importem plánu souborů
počkejte alespoň pět minut, protože metadata uživatelské třídy a vlastnosti se ukládají do mezipaměti.
Hodnota životnosti mezipaměti TTL (time-to-live) je
pět minut, po této době se mezipaměť vymaže. Chcete-li importovat/aktualizovat plán souborů, zadejte tento příkaz:
FilePlanTool -mode import
-f název_souboru_XML.xml -reimportoption volba
FilePlanTool -mode update -f název_souboru_XML.xml-reimportoption volba
název_souboru_XML je název a cesta k souboru,
který chcete importovat. Pokud nezadáte název souboru, nástroj použije výchozí název souboru určený polem Název výstupního souboru v dialogovém okně
konfigurace. Informace o určení výchozího názvu výstupního souboru XML naleznete v části Konfigurace nástroje.
Volba
opětovného importování určuje výchozí chování nástroje v případě, že importuje entitu, která v plánu souborů existuje. Podrobné informace o opětovném
importování naleznete v části Použití volby opětovného importování.
V režimu importu nástroj nepoužívá volbu rozsahu, ale
analyzuje značku XML a podle ní určí, co se má importovat. Je nutné zadat jiný název souboru XML pro metadata (uživatelské třídy a vlastnosti) a pro plán
souborů.
Upozornění: Značka ClassificationScheme v souboru XML určuje název plánu souborů.
Po prvním importu plánu souborů můžete spustit
nástroj v režimu aktualizace za účelem provedení menších úprav. Odlišujte pozdější aktualizace od původně importovaných souborů XML. Jako atribut InputMode značky FilePlan v souboru XML určete update.
S použitím režimu aktualizace nelze měnit uživatelskou vlastnost
(například seznam voleb).
Pokud obdržíte chybovou zprávu nebo se zastaví proces importu, prostudujte si uzel řešení problémů a podpory v Informačním centru nebo IBM FileNet P8 Troubleshooting Guide v dokumentaci produktu pro FileNet P8
Platform.
Ve většině případů se proces importu po zjištění chyby zastaví a nezobrazuje žádnou zprávu.
V případě potřeby po provedení importu spusťte zadržení procesu uzavření objektu, které na entity uplatní podmíněné zadržení, protože nástroj
podmíněná zadržení neimportuje. Viz Omezení.
Ověření plánu souborů
Po ručním vytvoření souboru XML ověřte, že tento soubor XML neobsahuje žádné chyby nebo prvky nevyhovující standardu XML. Soubor lze ověřit pomocí nástroje pro import a export plánu souborů. Chcete-li spustit nástroj pro import a export v
režimu ověřování, zadejte tento příkaz:
FilePlanTool -mode validate -f
název_souboru_XML.xml
název_souboru_XML je název a cesta k souboru, který chcete ověřit. Pokud nezadáte název souboru, nástroj použije výchozí název souboru určený polem Název výstupního souboru v dialogovém okně
konfigurace. Informace o určení výchozího názvu výstupního souboru XML naleznete v části Konfigurace nástroje.
Použití volby opětovného importování
Pomocí možnosti opětovného importování můžete určit výchozí chování
nástroje při importu entity, která v plánu souborů existuje. Volba opětovného importování má tři parametry:
- Žádný: Pokud při přidávání entity taková entita již existuje, nástroj ohlásí v protokolu výjimek varování, nepřidá entitu a
pokračuje.
- Přeskočit: Při přidávání entity nástroj přeskočí jakékoli existující entity, pokračuje a ohlásí v protokolu aktivit akci
přeskočení.
- Nahradit: Při přidávání entity nástroj přeskočí jakékoli existující entity, pokračuje a ohlásí v protokolu aktivit akci změny.
Možnost
Přeskočit použijte po nezdařeném importu velkého plánu souborů. Během druhého pokusu o import téhož plánu souborů možnost Přeskočit zabrání opětovnému importování entit, které již byly úspěšně importovány. Pokud však druhý pokus o importování vyžaduje menší úpravy entit, které byly při prvním pokusu úspěšně importovány, použijte možnost
Nahradit. Při následných importech menších úprav malého počtu entit určete pro tyto entity
Action="Modify" (v části
RMEntityObjectType souboru XML). Změňte tyto entity místo změny původního souboru XML. Rovněž použijte režim Aktualizace pro snadnější odlišení následných aktualizací od počátečních plných importů. Viz
Import/aktualizace plánu souborů.