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:
- 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í a import plánu odebrání do jiného úložiště
objektů neaktualizuje období uchování na hodnotu null. Můžete však ručně aktualizovat soubor XML tak, aby aktualizoval období uchování. Další informace
naleznete v příručce
ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
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ů:
- Configure (Konfigurovat) - otevře dialogové okno, ve kterém zadáte požadované informace, například název serveru
Content Engine (CE), 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 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
- includecategories soubor_01 - Tento parametr se používá, když chcete exportovat pouze kategorie záznamů a
jejich 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áznamů 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áznamů a složky záznamů v plánu souborů s výjimkou kategorií záznamů a složek záznamů obsažených 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 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:
- Žá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.
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ů.