IBM Enterprise Records, 5.1.2-es változat    

Fájlterv importálás és exportálás eszköz használata

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

Az eszköz konfigurálása

Az eszköz import vagy export módban történő futtatása előtt konfigurálnia kell az eszközt. Az eszköz konfigurálásához:
  1. Lépjen abba a mappába, ahol a Fájlterv importálás exportálás eszköz telepítve van.
  2. A parancssorból futtassa az alábbiak egyikét:
    Operációs rendszer Parancs
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux és Solaris FilePlanTool.sh -mode configure
    A fájlterv eszköz párbeszédablakában adja meg a következő információkat:

Fájlterv exportálása

Ha az exportálni kívánt fájlterv az alábbiak közül bármelyiket tartalmazza: 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

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.

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


Visszajelzés

Legutóbbi frissítés: 2013 november
fileplan_import_export.htm

© Copyright IBM 2013