IBM Enterprise Records, wersja 5.1.+            

Korzystanie z narzędzia do importowania i eksportowania planu umieszczania w folderach

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

Konfigurowanie narzędzia

Przed uruchomieniem narzędzia w trybie importu lub eksportu należy skonfigurować to narzędzie. Aby skonfigurować narzędzie:
  1. Przejdź do folderu, w którym zainstalowane jest narzędzie do eksportowania i importowania planu umieszczania w folderach.
  2. Uruchom jedną z poniższych komend w wierszu komend:
    System operacyjny Komenda
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    Wprowadź następujące informacje do okna dialogowego narzędzia planu umieszczania w folderach:

Eksportowanie planu umieszczania w folderach

Jeśli plan umieszczania w folderach przeznaczony do wyeksportowania zawiera dowolne z poniższych elementó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

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.

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


Opinia

Ostatnia aktualizacja: sierpień 2011


© Copyright IBM Corp. 2011.
To Centrum informacyjne jest oparte na technologii Eclipse. (http://www.eclipse.org)