IBM Enterprise Records verze 5.1.2    

Použití nástroje pro import a export plánu souborů

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

Konfigurace nástroje

Před spuštěním nástroje v režimu importu nebo exportu musíte nástroj konfigurovat. Chcete-li konfigurovat nástroj, postupujte takto:
  1. Přejděte do složky, ve které je nainstalován nástroj pro import a export plánu souborů.
  2. Z příkazového řádku spusťte jedno z následujících prostředí:
    Operační systém Příkaz
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux a Solaris FilePlanTool.sh -mode configure
    V dialogovém okně nástroje plánu souborů zadejte tyto informace:

Export plánu souborů

Pokud plán souborů, který chcete exportovat, obsahuje některou z následujících polož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

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.

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


Váš názor

Poslední aktualizace: Listopad 2013
fileplan_import_export.htm

© Copyright IBM Corp. 2013