IBM Enterprise Records, Version 5.1.+            

Använda verktyget för import/export av arkiveringsplaner

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.

Översikt

I avsnittet om verktyget för import/export av arkiveringsplaner, som finns på http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422 finns mer information om att ändra en exporterad XML-fil för att ta med schemaarv, alternativ kvarhållning, avvecklingsutlösare och dynamiska spärrar (villkorliga) spärrar.

Begränsningar

Verktyget för import/export av arkiveringsplaner gör det lättare att flytta arkiveringsplaner. Verktyget hanterar dock inte följande: 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 verktyget

Innan du kör verktyget i import- eller exportläge måste du konfigurera det. Konfigurera verktyget:
  1. Navigera till mappen där verktyget för import/export av arkiveringsplaner är installerat.
  2. Kör något av följande från kommandoraden:
    Operativsystem Kommando
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    Ange följande information i dialogrutan för arkiveringsplansverktyget:

Exportera en arkiveringsplan

Om den arkiveringsplan du vill exportera innehåller något av följande objekt: 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

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.

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


Feedback

Senast uppdaterat: Augusti 2011


© Copyright IBM Corp 2011.
Detta Informationscenter bygger på Eclipse-teknik. (http://www.eclipse.org)