We wdrożeniach IBM® Enterprise Records można korzystać z narzędzia do importowania i
eksportowania planu umieszczania w folderach w celu zaimportowania zewnętrznego planu albo w celu wyeksportowania planu
umieszczania w folderach do środowiska zewnętrznego. Narzędzie wykorzystuje plik XML w celu realizowania procesów importowania i
eksportowania.
Przegląd
Szczegółowe informacje na temat modyfikowania eksportowanego pliku XML w celu uwzględnienia
dziedziczenia harmonogramów, alternatywnych czasów przechowywania, wyzwalaczy rozporządzania i wstrzymań dynamicznych
(wstrzymań warunkowych) zawiera sekcja dotycząca narzędzia do eksportowania i importowania planu umieszczania w folderach w
dokumentacji
http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.
Ograniczenia
Narzędzie do importowania i eksportowania planu umieszczania w folderach
ułatwia migrowanie planów umieszczania w folderach. Jednak nie obsługuje:
- Eksportowania/importowania między modelami danych. Na przykład: w przypadku eksportowania ze składnicy obiektów modelu danych
PRO nie można zaimportować do składnicy obiektów modelu danych DoD.
- Eksportowania ani importowania obiektów akt, woluminów, obiektów dokumentów, informacji o zabezpieczeniach ani oznaczeń
zabezpieczeń.
- Mechanizmu wycofywania zmian.
- Eksportowania właściwości o wartości null. Na przykład: wyeksportowanie fazy harmonogramu rozporządzenia bez okresu
przechowywania oraz zaimportowanie tego harmonogramu rozporządzenia do innej składnicy obiektów nie spowoduje zmiany okresu
przechowywania na null. Jednak możliwe jest ręczne zaktualizowanie pliki XML w celu zaktualizowania okresu przechowywania. Więcej
informacji zawiera dokumentacja ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
Ponadto najpierw należy wyeksportować i zaimportować właściwości niestandardowe (takie jak listy opcji) oraz klasy w osobnym
pliku XML, a dopiero potem można zaimportować pozostałą część planu umieszczania w folderach. Ponadto po zaimportowaniu planu
umieszczania w folderach stany obiektów, takie jak
Zamknięte i
Gotowe do
rozporządzenia przestają obowiązywać.
Uruchamianie narzędzia
Narzędzie importowania i eksportowania planu umieszczania w folderach można
uruchomić za pomocą kodu wykonywalnego Java z wiersza komend lub można uruchomić narzędzie za pomocą pliku komend, takiego jak
FilePlanTool.bat lub
FilePlanTool.sh.
Z narzędzia można korzystać w jednym z pięciu trybów:
- Skonfiguruj - w tym trybie otwierane jest okno dialogowe, w którym można określić wymagane informacje,
takie jak nazwa serwera Content Engine (CE), nazwa składnicy obiektów, nazwa i hasło
administratora, a także tryb (import lub eksport).
- Eksport - tworzy w pełni kompatybilny i zgodny plik XML, który można następnie zaimportować do innego
środowiska.
- Import/aktualizacja - importuje określony plik XML do środowiska.
- Sprawdzanie poprawności - odczytuje plik XML w celu sprawdzenia zgodności i kompatybilności.
Eksportowanie planu umieszczania w folderach
Jeśli plan umieszczania w folderach przeznaczony do
wyeksportowania zawiera dowolne z poniższych elementów:
- klasy lub właściwości niestandardowe
- więcej niż niż 300000 folderów
- kategorię akt, która zawiera więcej niż 15000 folderów
Informacje zawiera sekcja
Eksportowanie planu umieszczania w folderach z opcją zasięgu.
Po skonfigurowaniu narzędzia można go użyć w celu
wyeksportowania planu umieszczania w folderach.
Aby wyeksportować plan umieszczania w folderach, wpisz poniższą komendę:
FilePlanTool -mode
export -fileplan nazwa planu umieszczania w folderach
-o nazwa_pliku_XML.xml gdzie nazwa planu umieszczania w folderach jest
nazwą planu umieszczania w folderach do eksportowania i jest ona wymagana. Jeśli nazwa planu umieszczania w folderach zawiera
spacje lub znaki specjalne, wówczas należy umieścić nazwę planu umieszczania w folderach w cudzysłowach.
nazwa_pliku_XML to nazwa i ścieżka pliku do utworzenia. Jeśli w
wierszu komend nie zostanie określona nazwa pliku, wówczas narzędzie użyje domyślnej nazwy pliku określonej przez pole Nazwa
pliku wyjściowego w oknie dialogowym konfiguracji narzędzia. Szczegółowe informacje na temat określania domyślnej nazwy pliku
wyjściowego XML zawiera sekcja Konfigurowanie narzędzia.
Eksportowanie planu umieszczania w folderach z opcją zasięgu
W przypadku
eksportowania planu umieszczania w folderach należy użyć opcji zasięgu dla dużych planów umieszczania w folderach lub dla planów,
które zawierają niestandardowe klasy albo właściwości. Aby wyeksportować plan umieszczania w folderach za pomocą opcji zasięgu,
wpisz poniższą komendę:
FilePlanTool -mode export -fileplan
nazwa planu umieszczania w folderach -o nazwa_pliku_XML.xml
-scope parametr
gdzie nazwa planu umieszczania w folderach jest
nazwą planu umieszczania w folderach do eksportowania i jest ona wymagana. Jeśli nazwa planu umieszczania w folderach zawiera
spacje lub znaki specjalne, wówczas należy umieścić nazwę planu umieszczania w folderach w cudzysłowach.
nazwa_pliku_XML to nazwa i ścieżka pliku do utworzenia.
Jeśli w wierszu komend nie zostanie określona nazwa
pliku, wówczas narzędzie użyje domyślnej nazwy pliku określonej przez pole Nazwa pliku wyjściowego w oknie dialogowym
konfiguracji narzędzia. Jeśli narzędzie jest używane z opcją zasięgu, wówczas narzędzie tworzy plik XML dla każdej części planu
umieszczania w folderach.
Dlatego należy określać inną nazwę pliku XML przy każdej okazji używania narzędzia w trybie eksportu. Informacje na
temat określania domyślnej nazwy pliku wyjściowego XML zawiera sekcja Konfigurowanie narzędzia.
parametr
może być jednym z poniższych:
- metadata - jeśli plan umieszczania w folderach zawiera niestandardowe klasy lub właściwości, ten parametr jest wymagany. Opcja
parametru metadata utworzy osobny plik XML dla niestandardowych klas i właściwości. Dlatego jeśli plan umieszczania w folderach
zawiera niestandardowe klasy lub właściwości, wówczas procesy eksportowania i importowania obejmują dwa kroki:
- jeden krok dla niestandardowych klas i właściwości
- jeden krok dla pozostałej części planu umieszczania w folderach. Jeśli parametr metadata nie jest stosowany, wówczas
narzędzie wyeksportuje plan umieszczania w folderach bez właściwości niestandardowych.
- includecategory "nazwa kategorii akt" - za pomocą tego parametru można wyeksportować
konkretną kategorię akt.
W przypadku użycia parametru includecategory narzędzie eksportuje wszystkie podkategorie i podfoldery zawarte w określonej
kategorii akt. nazwa kategorii akt musi obejmować pełną ścieżkę w IBM Enterprise Records. Na
przykład: aby wyeksportować wszystkie obiekty podrzędne z kategorii akt "Cat03", która jest zawarta w kategorii "Cat02" i która
jest zawarta w "Cat01", wówczas należy wpisać poniższą komendę:
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories plik 01 -
za pomocą tego parametru można wyeksportować tylko kategorie akt i ich elementy podrzędne określone w wejściowym pliku tekstowym
plik 01.
Za pomocą parametru includecategories można wyeksportować dużą liczbę kategorii akt do tego samego pliku bez
konieczności określania nazw poszczególnych kategorii w wierszu komend. W celu użycia tego parametru należy wpisać poniższą
komendę:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
Plik File01.txt zawiera:
/categoryB
/CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
Nazwa kategorii jest reprezentowana przez pełną nazwę ścieżki i jedną kategorię akt na wiersz.
- excludecategory "nazwa wykluczonej kategorii akt" - za pomocą tego parametru można
wykluczyć konkretną kategorię akt i jej elementy podrzędne. Na przykład: jeśli nazwa wykluczonej kategorii akt
ma wartość "Cat01/Cat02/Catlarge", wówczas narzędzie eksportuje wszystkie kategorie akt i foldery akt z planu umieszczania w
folderach z wyjątkiem kategorii akt i folderów akt zawartych w węźle "Cat01/Cat02/CatLarge". Ten parametr działa podobnie do
parametru includecategory.
- excludecategories plik 02 - za pomocą tego parametru można wykluczyć drzewa podrzędne
nazw głównych określonych w pliku tekstowym plik 02. Ten parametr działa podobnie do parametru
includecategories.
Import/aktualizacja planu umieszczania w folderach
W celu zaimportowania planu
umieszczania w folderach albo jego segmentu należy uruchomić narzędzie w trybie importu oraz określić plik XML utworzony przez
narzędzie w trybie eksportu.
Jeśli plan umieszczania w folderach zawiera niestandardowe klasy lub właściwości, wówczas proces importu wymaga wykonania dwóch
kroków. Jeden krok importuje klasy niestandardowe i właściwości w planie umieszczania w folderach, a drugi krok importuje
pozostałą część planu umieszczania w folderach. Najpierw należy zaimportować niestandardowe klasy i właściwości, a następnie
należy poczekać co najmniej pięć minut przed zaimportowaniem planu umieszczania w folderach, ponieważ niestandardowa klasa i
metadane właściwości są zbuforowane w pamięci podręcznej. Trwałość pamięci podręcznej wynosi pięć minut, a następnie pamięć
podręczna jest kasowana.
Aby zaimportować/zaktualizować plan umieszczania w folderach, wpisz poniższą komendę:
FilePlanTool
-mode import -f nazwa_pliku_XML.xml -reimportoption option
FilePlanTool -mode update -f
nazwa_pliku_XML.xml -reimportoption option
nazwa_pliku_XML to nazwa i ścieżka pliku do zaimportowania.
Jeśli w wierszu komend nie zostanie określona
nazwa pliku, wówczas narzędzie użyje domyślnej nazwy pliku określonej przez pole Nazwa pliku wyjściowego w oknie dialogowym
konfiguracji narzędzia. Informacje na temat określania domyślnej nazwy pliku wyjściowego XML zawiera sekcja
Konfigurowanie narzędzia.
Opcja ponownego importu określa domyślne zachowanie narzędzia
podczas importowania obiektu, który już istnieje w planie umieszczania w folderach. Szczegółowe informacje nt. opcji ponownego
importowania zawiera sekcja Korzystanie z opcji ponownego importu.
W trybie importu narzędzie nie
korzysta z opcji zasięgu, ale sprawdza znaczniki XML w celu określenia treści do importowania. Należy określić inną nazwę pliku
XML dla metadanych (niestandardowe klasy i właściwości) oraz dla planu umieszczania w folderach.
Ostrzeżenie: Znacznik
ClassificationScheme w pliku XML określa nazwę planu umieszczania w folderach.
Narzędzie można uruchomić w trybie
aktualizacji w celu wprowadzenia niewielkich zmian po początkowym imporcie planu umieszczania w folderach, a ponadto można
wyróżnić kolejne aktualizacje z początkowo zaimportowanych plików XML. Określ update jako atrybut InputMode
znacznika FilePlan w pliku XML. Za pomocą trybu aktualizacji nie można zaktualizować właściwości niestandardowej (takiej jak
lista opcji).
W przypadku błędów lub w przypadku zatrzymania procesu importu należy zapoznać się z dokumentacją
IBM FileNet P8 Troubleshooting Guide. W większości przypadków proces importowania zatrzymuje się po
napotkaniu błędu i nie pojawia się wówczas żaden komunikat.
W razie potrzeby należy uruchomić przeglądanie ze wstrzymywaniem, aby zastosować wstrzymania warunkowe dla obiektów po
imporcie, ponieważ narzędzie nie importuje wstrzymań warunkowych. Informacje zawiera sekcja
Ograniczenia.
Sprawdzanie poprawności planu umieszczania w folderach
Po ręcznym utworzeniu pliku
XML należy sprawdzić, czy ten plik XML nie zawiera żadnych błędów oraz czy nie występują problemy ze zgodnością - poprawność
należy sprawdzić za pomocą narzędzia do importowania i eksportowania planu umieszczania w folderach. Aby uruchomić narzędzie do
importowania i eksportowania w trybie sprawdzania poprawności, należy wpisać następującą komendę:
FilePlanTool
-mode validate -f nazwa_pliku_XML.xml
nazwa_pliku_XML to nazwa i ścieżka pliku do sprawdzenia. Jeśli w wierszu komend nie zostanie określona nazwa
pliku, wówczas narzędzie użyje domyślnej nazwy pliku określonej przez pole Nazwa pliku wyjściowego w oknie dialogowym
konfiguracji narzędzia. Informacje na temat określania domyślnej nazwy pliku wyjściowego XML zawiera sekcja
Konfigurowanie narzędzia.
Korzystanie z opcji ponownego importu
Opcja ponownego importu określa domyślne
zachowanie narzędzia podczas importowania obiektu, który już istnieje w planie umieszczania w folderach. Opcja ponownego importu
ma trzy parametry:
- Brak - podczas dodawania obiektu narzędzie zgłasza ostrzeżenie w dzienniku wyjątki, jeśli obiekt już
istnieje, nie dodaje obiektu, a następnie kontynuuje działanie.
- Pomiń - podczas dodawania obiektu narzędzie pomija istniejące obiekty, kontynuuje działanie i zgłasza
czynność pomijania w dzienniku działań.
- Zastąp - podczas dodawania obiektu narzędzie zastępuje istniejące obiekty, kontynuuje działanie i zgłasza
czynność modyfikacji w dzienniku działań.
Opcję Pomiń należy użyć po niepomyślnym imporcie dużego planu umieszczania w
folderach.
Podczas drugiej próby zaimportowania tego samego planu umieszczania w folderach opcja Pomiń nie dopuszcza do ponownego
importowania obiektów, które zostały już pomyślnie zaimportowane.
Jeśli jednak druga próba importowania wymaga mniejszych modyfikacji obiektów, które zostały pomyślnie zaimportowane po raz
pierwszy, wówczas należy użyć opcji Zastąp. W przypadku kolejnych operacji importu mniejszych modyfikacji do niewielkiej liczby
obiektów należy określić ustawienie Action="Modify" (w sekcji RMEntityObjectType
pliku XML) dla obiektów zamiast wprowadzania zmian do pierwotnego pliku XML. Ponadto tryb Aktualizuj umożliwia łatwiejsze
identyfikowanie kolejnych aktualizacji z początkowych raportów pełnych. Informacje zawiera sekcja
Import/aktualizacja planu umieszczania w folderach.