Az IBM® Enterprise
Records telepítések esetén
külső fájlterv importálásához vagy fájlterv külső környezetbe történő exportálásához
használja a Fájlterv importálás exportálás eszközt. Az eszköz XML fájl
segítségével hajtja végre az importálási és exportálási folyamatot.
Áttekintés
Az exportált XML fájlok módosításáról
ütemezés öröklés, alternatív megtartás, selejtezési aktiválók és dinamikus
felfüggesztések tartalmazása érdekében tanulmányozza a Fájlterv importálás és exportálás
eszköz hibaelhárítása témakört.
Korlátozások
A Fájlterv importálás
exportálás eszközzel vigye át a fájlterveket. Az alábbi szituációkat azonban
nem támogatja az eszköz:
- Adatmodellek közötti export/import. Például ha PRO adatmodellel rendelkező objektumtárolóból
exportál, akkor nem importálhat DoD adatmodellel rendelkező objektumtárolóba.
- Rekord objektumok, kötetek, dokumentum objektumok, biztonsági információk és biztonsági jelölések exportálása vagy importálása.
- Visszagörgetési mechanizmus.
- Nullértékű tulajdonságok exportálása. Például egy selejtezési ütemezés fázis exportálása
megtartási időtartam nélkül. Hasonlóképp a selejtezési ütemezés importálása
másik objektumtárolóba nem frissíti a megtartási időtartamot
nullértékre. Saját kezűleg viszont frissítheti az XML fájlt
a megtartási időtartam frissítéséhez. További információkért tanulmányozza
a Fájlterv importálás és exportálás témakört.
Először az egyéni tulajdonságokat,
például választéklistákat és osztályokat exportálja és importálja különálló XML fájlba, a fájlterv
többi részének importálása előtt. Ezen felül fájlterv importálása után az egyedek
Lezárt vagy
Selejtezésre kész állapota
már nem érvényesülnek.
Az eszköz futtatása
A Fájlterv importálás exportálás eszköz futtatható
parancssori Java végrehajtható programból. Vagy elindíthatja az eszközt a
FilePlanTool.bat vagy
FilePlanTool.sh parancsfájllal. Az eszköz az alábbi öt módszer bármelyikével futtatható:
- Configure: megnyit egy párbeszédpanelt, melyben megadhatja
a szükséges információkat. Ezek az adatok a Content Platform Engine kiszolgáló neve, objektumtároló
neve, adminisztrátor felhasználói neve és jelszava, valamint a mód (import vagy export).
- Export: létrehoz egy teljesen kompatibilis és szabványos
XML fájlt, ami később importálható másik környezetbe.
- Import/update: megadott XML fájlt importál egy környezetbe.
- Validate: beolvas egy XML fájlt a kompatibilitás és szabványnak megfelelés vizsgálatához.
Fájlterv exportálása
Ha az exportálni kívánt fájlterv az alábbiak közül bármelyiket tartalmazza:
- Egyéni osztályok vagy tulajdonságok
- Több, mint 300,000 mappa
- Több, mint 15,000 mappát tartalmazó rekordkategória
Lásd:
Fájlterv exportálása a scope paraméterrel.
Az
eszközt a konfigurálása után használhatja fájlterv exportálásához. Fájlterv exportálásához írja be a következő parancsot:
FilePlanTool -mode export -fileplan fájlterv
neve -o XML fájlnév.xml Ahol fájlterv
neve az exportálandó fájlterv neve, és
kötelező. Ha a fájlterv neve szóközöket vagy különleges karaktereket tartalmaz, akkor tegye a
fájlterv nevét idézőjelek közé.
XML
fájlnév a létrehozandó XML fájl neve és elérési útja. Ha a parancssorban nem ad meg
fájlnevet, akkor az eszköz a Kimeneti fájl neve mező által meghatározott alapértelmezett fájlnevet használja. Ez a mező a konfigurációs párbeszédpanelen található. Az alapértelmezett kimeneti XML fájl nevének megadásához
lásd: Az eszköz konfigurálása.
Fájlterv exportálása a scope paraméterrel
Fájlterv exportálása során használja a
scope paramétert nagy fájltervekhez, vagy egyéni osztályokat vagy tulajdonságokat tartalmazó
fájltervekhez. Fájltervnek a scope paraméterrel történő exportálásához írja be a következő parancsot:
FilePlanTool -mode export -fileplan fájlterv neve -o XML fájlnév.xml -scope parameter
Ahol fájlterv
neve az exportálandó fájlterv neve, és
kötelező. Ha a fájlterv neve szóközöket vagy különleges karaktereket tartalmaz, akkor tegye a
fájlterv nevét idézőjelek közé.
XML
fájlnév a létrehozni kívánt XML fájl neve és elérési útja. Ha a parancssorban nem ad meg
fájlnevet, akkor az eszköz a Kimeneti fájl neve mező által meghatározott alapértelmezett fájlnevet használja. Ez a mező a konfigurációs párbeszédpanelen található. Ha az eszközt a
scope paraméterrel használja, akkor az eszköz a fájlterv minden részéhez létrehoz egy
XML fájlt. Ezért az eszköz minden egyes export módú használatakor különböző
XML fájlnevet kell megadnia. Az alapértelmezett kimeneti XML fájl nevének megadásához
lásd: Az eszköz konfigurálása.
A
paraméter az alábbi
elemek bármelyike lehet:
- metadata: Ha a fájlterv egyéni osztályokat vagy tulajdonságokat
tartalmaz, akkor ez a paraméter kötelező. A metadata paraméter
különálló XML fájlt hoz létre az egyéni osztályok és tulajdonságok számára.
Ezért ha egy fájlterv egyéni osztályokat vagy tulajdonságokat tartalmaz,
akkor az exportálási és az importálási folyamat két-két lépésből áll:
- Egy lépés az egyéni osztályok és tulajdonságok számára
- Egy lépés a fájlterv maradék részéhez. Ha nem használja a
metadata paramétert, akkor az eszköz a fájltervet az egyéni tulajdonságok nélkül exportálja.
- includecategory "rekordkategória
neve": Adott rekordkategória exportálásához használja ezt a paramétert. Az includecategory használatakor az eszköz a megadott
rekordkategória összes alkategóriáját és almappáját
exportálja. A rekordkategória nevének tartalmaznia kell a
teljes IBM Enterprise
Records elérési útvonalat. Például a Cat03 rekordkategória összes utódjának az exportálásához
a következő parancsot használja. A Cat03 a Cat02 kategórián belül található, ami
viszont a Cat01 kategóriában van.
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories fájl 01:
Ezzel a paraméterrel csak a fájl 01 szövegfájlban megadott rekordkategóriák és azok utódjai kerülnek exportálásra. Az includecategories paraméterrel sok rekordkategória
exportálható ugyanabba a fájlba anélkül, hogy meg kellene adnia a
rekordkategória neveket a parancssorban. A paraméter használatához
adja meg a következő parancsot:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
A File01.txt tartalma:
/categoryB
/CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
A kategórianevet a teljes elérési út és soronként egy rekordkategória név képviseli.
- excludecategory "kizárt rekordkategória
neve": Adott rekordkategória és utódjai kizárásához használja ezt a paramétert. Például ha a kizárt rekordkategória neve "Cat01/Cat02/Catlarge", akkor az eszköz
a fájlterv összes rekordkategóriáját és rekordmappáját exportálja, egy
kivétellel. A kivétel a "Cat01/Cat02/CatLarge" csomóponton belül található
rekordkategóriák és rekordmappák. Ez a paraméter az includecategory paraméterhez hasonló módon működik.
- excludecategories fájl 02:
Ezzel a paraméterrel zárhatja ki a file 02 szöveges fájlban megadott gyökérnevek részfáit. Ez a paraméter az includecategories paraméterhez hasonló módon működik.
Fájlterv importálása/frissítése
Egy fájlterv vagy
fájlterv egy részének az importálásához futtassa import módban az
eszközt. Adja meg az eszköz által export módban létrehozott XML fájlt. Ha a fájlterv
egyéni osztályokat vagy tulajdonságokat tartalmaz, akkor az importálási folyamat
két lépést igényel. Az első lépés importálja a fájltervben lévő egyéni osztályokat és
tulajdonságokat. A második lépés a fájlterv maradék részét
importálja. Először az egyéni osztályokat és tulajdonságokat importálja. Azután várjon legalább 5 percet a fájlterv importálása előtt, mert az
egyéni osztályok és tulajdonságok a memóriában vannak gyorsítótárazva.
A gyorsítótár
élettartama (TTL) 5 perc, azután a gyorsítótár kiürítésre kerül. Fájlterv importálásához/exportálásához írja be a következő parancsot:
FilePlanTool -mode import -f XML
fájlnév.xml -reimportoption paraméter
FilePlanTool -mode update -f XML
fájlnév.xml -reimportoption paraméter
XML
fájlnév az importálni kívánt XML fájl neve és elérési útja. Az eszköz a konfigurációs párbeszédpanel Kimeneti
fájl neve mező által megadott alapértelmezett fájlnevet használja, ha
nem ad meg fájlnevet. Az alapértelmezett kimeneti XML fájl nevének megadásához
lásd: Az eszköz konfigurálása.
A reimport
paraméter az eszköz alapértelmezett viselkedését határozza meg arra az esetre, ha a fájltervben meglévő
egyedet importál. A reimport paraméterről részletekért
lásd: A reimport paraméter használata.
Import módban
az eszköz nem használja a scope paramétert, viszont egy XML címkét keres,
hogy megállapítsa, mit kell importálnia. Eltérő XML fájlnevet kell megadnia
a metaadatok (egyéni osztályok és tulajdonságok) és a fájlterv
számára.
Figyelem: A ClassificationScheme címke az
XML fájlban megadja a fájlterv nevét.
Ha egy fájlterv kezdeti
importálása után kis módosításokat kíván végrehajtani, akkor futtassa Frissítés módban
az eszközt. Az ezt követő frissítéseket a kezdetben importált XML fájlokból
lehet megállapítani. Az XML fájlban a FilePlan címke InputMode attribútumaként az update
adja meg.
Egyéni tulajdonság (például egy választéklista) nem módosítható
a Frissítés mód használatával.
Ha hibaüzenetet kap, vagy az importálási
folyamat leáll, akkor tanulmányozza a FileNet P8
Platform
termékleírásának információs központjában vagy IBM FileNet P8 Troubleshooting Guide részében
a Hibaelhárítás és támogatás témakört.
A legtöbb esetben az importálási folyamat leáll hiba
észlelésekor, és nem jelenít meg üzenetet.
Szükség esetén az importálás után futtasson Felfüggesztés előkészítő folyamatot a feltételes felfüggesztések
egyedekre történő alkalmazásához, mert az eszköz nem importál feltételes
felfüggesztéseket. Lásd: Korlátozások.
Fájlterv érvényesítése
Az XML fájl saját kezű létrehozása után
ellenőrizze, hogy a fájl nem tartalmaz-e hibákat vagy nemmegfelelési
problémákat. A fájlt a Fájlterv importálás exportálás eszköz segítségével
érvényesítheti. Az Importálás Exportálás eszköz érvényesítési
módú futtatásához adja meg a következő parancsot:
FilePlanTool -mode validate -f XML
fájlnév.xml
XML
fájlnév az érvényesíteni kívánt XML fájl neve és elérési útja. Az eszköz a konfigurációs párbeszédpanel Kimeneti
fájl neve mező által megadott alapértelmezett fájlnevet használja, ha
nem ad meg fájlnevet. Az alapértelmezett kimeneti XML fájl nevének megadásához
lásd: Az eszköz konfigurálása.
A reimport paraméter használata
A reimport
paramétert használja az eszköz alapértelmezett viselkedésének meghatározásához arra az esetre, ha a fájltervben meglévő
egyedet importál. Az újraimportálás három paraméterrel rendelkezik:
- Nincs: Egyed hozzáadása során ha egy egyed létezik, akkor az eszköz figyelmeztetést
jelent a kivételnaplóban, nem adja hozzá az egyedet, majd folytatja a futását.
- Kihagyás: Egyed hozzáadása során az eszköz
kihagyja a meglévő egyedeket, folytatódik, és a kihagyásról jelentést jegyez be a tevékenységnaplóba.
- Felülírás: Egyed hozzáadása során az eszköz
felülírja a meglévő egyedeket, folytatódik, és a módosításról jelentést jegyez be
a tevékenységnaplóba.
Nagy fájlterv meghiúsult importja után használja a
Kihagyás
lehetőséget. Ugyanazon fájlterv importálásának második kísérlete során a Kihagyás beállítás
megelőzi a sikeresen importált egyedek újraimportálását. Viszont ha az
importálás második kísérlete kisebb módosításokat igényel az első alkalommal sikeresen
importált egyedeken, akkor használja a
Felülírás beállítást. A néhány
egyeden elvégzett kisebb módosítások ezt követő importálása során adja meg az
Action="Modify"
beállítást (az XML fájl RMEntityObjectType részében) az egyedekre. Az eredeti XML fájl módosítása helyett módosítsa ezeket az egyedeket. Ezen felül használja a Frissítés módot, mely lehetővé teszi további
frissítések egyszerűbb azonosítását a kezdeti teljes importálásból. Lásd:
Fájlterv importálása/frissítése.