IBM Enterprise Records, Verze 5.1.+            

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

Při implementacích produktu IBM® Enterprise Records můžete k importu externího souboru nebo k exportu plánu souborů do externího prostředí použít 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í (podmíněná zadržení) naleznete v části o Nástroji pro import a export plánu souborů v příručce na stránkách http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.

Omezení

Nástroj pro import a export plánu souborů usnadňuje migraci plánů souborů. Nástroj však nepodporuje tyto funkce: Kromě toho musíte předtím, než importujete zbývající část plánu souborů, nejprve exportovat a importovat 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 z příkazového řádku spustitelného souboru Java, případně lze nástroj spustit 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 instalová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
    UNIX 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 Název výstupního souboru v dialogovém okně konfigurace nástroje. 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 Název výstupního souboru v dialogovém okně konfigurace nástroje. Pokud používáte nástroj s volbou rozsahu, nástroj vytvoří soubor XML pro každou část plánu souborů. Proto musíte 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," která je obsažena uvnitř "Kat02", která je následně obsažena v "Kat01," zadejte tento příkaz:

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 a 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. Jeden krok importuje uživatelské třídy a vlastnosti v plánu souborů a druhý krok importuje zbývající část plánu souborů. Nejprve importujte uživatelské třídy a vlastnosti, 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 na příkazovém řádku 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 nástroje. 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á již 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, což umožňuje odlišit 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 část IBM FileNet P8 Troubleshooting Guide. 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 spusťte Nástroj pro import a export plánu souborů a pomocí něj ověřte, že tento soubor XML neobsahuje žádné chyby nebo prvky nevyhovující standardu XML. 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 na příkazovém řádku 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 nástroje. 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í

Volba opětovného importování se používá k určení výchozího chování nástroje v případě, že importuje entitu, která již v plánu souborů existuje. Volba opětovného importování má tři parametry: Volba Přeskočit se používá po nezdařeném importu velkého plánu souborů. Během druhého pokusu o import téhož plánu souborů volba 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 volbu Nahradit. Při následných importech menších úprav malého počtu entit namísto provádění změn v původním souboru XML určete pro tyto entity Action="Modify" (v části RMEntityObjectType 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ů.


Zpětná vazba

Poslední aktualizace: Srpen 2011


© Copyright IBM Corp. 2011.
Toto Informační centrum využívá technologii Eclipse. (http://www.eclipse.org)