För IBM® Enterprise
Records kan du använda verktyget för import/export till att importera externa arkiveringsplaner eller exportera en arkiveringsplan till en extern miljö. Verktyget använder en XML-fil för importen eller exporten.
Begränsningar
Verktyget för import/export av arkiveringsplaner gör det lättare att flytta arkiveringsplaner. Verktyget hanterar dock inte följande:
- Export/import mellan datamodeller. Om du exporterar från ett objektlager för en PRO-datamodell kan du till exempel inte importera till ett objektlager för en DoD-datamodell.
- Export/import av postobjekt, volymer, dokumentobjekt, säkerhetsinformation och säkerhetsmärkningar.
- Backningsmekanismen.
- Export av egenskaper med nullvärde. Exempel: Om du exporterar en fas för ett avvecklingsschema utan någon kvarhållningsperiod och importerar avvecklingsschemat till ett annat objektlager uppdateras inte kvarhållningsperioden till null. Du kan dock uppdatera XML-filen manuellt om du vill uppdatera kvarhållningsperioden. I ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf finns mer information.
Dessutom måste du först exportera och importera anpassade egenskaper (t.ex. urvalslistor) och klasser till en separat XML-fil innan du kan importera resten av arkiveringsplanen. När du importerar en arkiveringsplan gäller inte statusar som
Stängd eller
Klar för avveckling längre.
Köra verktyget
Du kan köra verktyget för import/export av arkiveringsplaner från en kommandorad som körbar Java-fil eller så kan du starta verktyget med kommandofilen
FilePlanTool.bat eller
FilePlanTool.sh.
Du kan köra verktyget i något av följande fem lägen:
- Konfigurera - öppnar en dialogruta där du anger den nödvändiga information, t.ex. Content Engine (CE)
servernamn, objektlagernamn, användarnamn och lösenord som administratör samt läge (import eller export).
- Exportera - skapar en helt kompatibel och giltig XML-fil så att du senare kan importera den till en annan miljö.
- Importera/uppdatera - importerar en angiven XML-fil till en miljö.
- Validera - läser en XML-fil för att verifiera att den är kompatibel och giltig.
Exportera en arkiveringsplan
Om den arkiveringsplan du vill exportera innehåller något av följande objekt:
- anpassade klasser eller egenskaper
- över 300 000 mappar
- en postkategori som innehåller över 15 000 mappar
Se
Exportera en arkiveringsplan med områdesalternativ.
När du har konfigurerat verktyget kan du använda det till export av en arkiveringsplan.
När du ska exportera en arkiveringsplan skriver du följande kommando:
FilePlanTool -mode export -fileplan file
plan name -o XML filename.xml där file
plan name är namnet på arkiveringsplanen som ska exporteras och måste anges. Om arkiveringsplansnamnet innehåller blanktecken eller specialtecken ska du skriva file plan name inom citattecken.
XML
filename är namnet på och sökvägen till den fil som skapas. Om du inte anger ett filnamn på kommandoraden används standardfilnamnet från fältet Utdatanamn i verktygets konfigurationsdialogruta. Mer information om standardnamn för XML-utdatafilen finns i Konfigurera verktyget.
Exportera en arkiveringsplan med områdesalternativ
När du exporterar en arkiveringsfilplan bör du använda områdesalternativet (scope) för stora arkiveringsplaner som innehåller anpassade klasser eller egenskaper. Exportera en arkiveringsplan med områdesalternativet skriver du följande kommando:
FilePlanTool -mode export -fileplan file
plan name -o XML filename.xml -scope parameter
där file
plan name är namnet på arkiveringsplanen som ska exporteras och måste anges. Om arkiveringsplansnamnet innehåller blanktecken eller specialtecken ska du skriva file plan name inom citattecken.
XML-filnamn är namnet på och sökvägen till den fil som du vill skapa.
Om du anger ett filnamn på kommandoraden använder verktyget standardfilnamnet som anges i Utdatafilnamn i verktygets konfigurationsdialogruta. När du använder verktyget med områdesalternativet skapar verktyget XML-filen för varje del av arkiveringsplanen.
Du måste ange ett annat XML-filnamn varje gång verktyget används i exportläge. Information om att ange XML-utfilnamnet finns i Konfigurera verktyget.
parameter kan vara något av följande:
- metadata - Om arkiveringsplanen innehåller anpassade klasser eller egenskaper är parametern nödvändig. Metadataparameteralternativet skapar en separat XML-fil för anpassade klasser och egenskaper. Om du skapar ett arkiveringsplan som innehåller anpassade klasser eller egenskaper består export- och importprocesserna av två steg vardera:
- ett steg för de anpassade klasserna och egenskaperna
- ett steg för resten av arkiveringsplanen. Om du inte använder metadataparametern exporterar verktyget arkiveringsplanen utan de anpassade egenskaperna.
- includecategory "record category
name" - Med den här parameter exporterar du en viss postkategori.
När du använder includecategory exporterar verktyget alla underkategorier inom den angivna postkategorin. record
category name måste innehålla den fullständiga sökvägen i IBM Enterprise
Records. Exempel: Om du vill exportera alla underordnade i postkategorin Cat03, som finns i Cat02, som i sin tur finns i Cat01, skriver du följande kommando:
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories file 01 -
Med den här parametern exporterar du enbart postkategorier och deras underordnade som anges i indatatextfilen file 01.
Med parametern includecategories exporterar du ett stort antal postkategorier till samma fil utan att ange postkategorinamnet på kommandoraden. Skriv följande kommando när du ska använda parametern:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt innehåller:
/categoryB
/CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
Kategorinamn representerar den fullständiga sökvägen och namnet till en postkategori per rad.
- excludecategory "excluded record
category name" - Med den här parametern utesluter du en viss postkategori och dess underordnade. Exempel: Om excluded
record category name är Cat01/Cat02/Catlarge exporterar verktyget alla postkategorier och postmappar i arkiveringsplanen utom postkategorier och postmappar i noden Cat01/Cat02/CatLarge. Parametern fungerar på liknande sätt som includecategory.
- excludecategories file 02 - Med den här parametern utesluter du underträden till rotnamn som anges i textfilen file 02. Parametern fungerar tillsammans med includecategories.
Importera/Uppdatera en arkiveringsplan
Importera en arkiveringsplan, eller en del av en plan, och kör verktyget i importläge och ange den XML-fil som verktyget skapade i exportläge.
Om arkiveringsplanen innehåller anpassade klasser eller egenskaper kräver importprocessen två steg. Ett steg importerar anpassade klasser och egenskaper i arkiveringsplanen och det andra steget importerar resten av arkiveringsplanen. Importera anpassade klasser och egenskaper först. Vänta sedan minst fem minuter innan du importerar arkiveringsplanen eftersom den cachade filen och egenskapsmetadata cachelagras i minnet. Cachelagringstiden (time-to-live, TTL) är fem minuter, därefter rensas cachen.
Skriv följande kommando när du ska importera/uppdatera en arkiveringsplan:
FilePlanTool -mode import -f XML
filename.xml -reimportoption option
FilePlanTool -mode update -f XML
filename.xml -reimportoption option
XML
filename är namnet på och sökvägen till den fil som du ska importera.
Om du inte anger ett filnamn på kommandoraden använder verktyget det standardfilnamn som angetts i fältet Utdatafilnamn i verktygets konfigurationsdialogruta. Information om att ange XML-utfilnamnet finns i Konfigurera verktyget.
Alternativet reimport bestämmer standardbeteendet för verktyget när du importerar en entitet som redan finns i arkiveringsplanen. Mer information om alternativet för reimport finns i Använda alternativet reimport.
I importläget använder verktyget områdesalternativet (scope) utan söker efter ett alternativt XML-märkord för att avgöra vad som ska importeras. Du måste ange ett annat XML-filnamn för metadata (anpassade klasser och egenskaper) och arkiveringsplanen.
Obs: Märkordet ClassificationScheme i XML-filen anger namnet på arkiveringsplanen.
Du kan köra verktyget i uppdateringsläge om du vill göra smärre ändringar efter den första importen av en arkiveringsplan, och sedan kan du särskilja efterföljande uppdateringar från de ursprungligen importerade XML-filerna. Ange update som InputMode-attribut för FilePlan-märkordet i XML-filen. Du kan inte ändra en anpassad egenskap (t.ex. en urvalslista) genom att använda uppdateringsläget.
Se IBM FileNet P8 Troubleshooting Guide om du får ett felmeddelande eller så stoppar importen. I det flesta fall stoppar importprocessen när ett fel påträffas utan att något felmeddelande visas.
Kör spärravsökningen om du vill tillämpa spärrarna på entiteter efter det att verktyget importerat villkorliga spärrar. Se Begränsningar.
Validera arkiveringsplan
När du har skapat en XML-fil bör verifiera att den inte innehåller fel eller ogiltig kod genom att validera den i verktyget för import/export. Skriv följande kommando om du vill köra verktyget för import/export i valideringsläge:
FilePlanTool -mode validate -f XML
filename.xml
XML filename är namnet och sökvägen till de fil du ska validera. Om du inte anger ett filnamn på kommandoraden, använder verktyget det standardfilnamn som angetts i fältet Utdatanamn i verktygets konfigurationsdialogruta. Information om att ange XML-utfilnamnet finns i Konfigurera verktyget.
Använda alternativet reimport
Med alternativet reimport bestämmer du verktygets standardbeteende när en entitet importeras som redan finns i en arkiveringsplan. Alternativet reimport har tre parametrar:
- Ingen - Vid tillägg av entiteter skickar verktyget en varning till undantagsloggen om en entitet redan finns, lägger inte till den och fortsätter sedan.
- Hoppa över - Vid tillägg av entiteter hoppar verktyget över alla entiteter som redan finns, fortsätter och rapporterar till aktivitetsloggen att entiteterna hoppats över.
- Ersätt - Vid tillägg av entiteter ersätter verktyget alla entiteter som redan finns, fortsätter och rapporterar ändringarna till aktivitetsloggen.
Använd alternativet Hoppa över efter att en import av en stor arkiveringsplan misslyckats.
Under det andra försöket att importera samma arkiveringsplan undviker du med det här alternativet att importera entiteter på nytt som redan har importerats.
Om det andra försöket att importera kräver smärre ändringar av entiteter som redan importerades första gången ska du dock använda alternativet Ersätt. Under följande importer av smärre ändringar av ett litet antal entiteter rekommenderar vi att du anger Action="Modify" (i avsnittet RMEntityObjectType i XML-filen) för entiteterna, i stället för att göra ändringarna i den ursprungliga XML-filen. Du kan också använda uppdateringsläget för att enklare särskilja efterföljande uppdateringar från fullständiga inledande importer. Se
Importera/Uppdatera en arkiveringsplan.