IBM Enterprise Records, version 5.1.2    

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

Information om att ändra en exporterad XML-fil för att inkludera schemaförekomster, alternativa kvarhållningar, avvecklingsutlösare och dynamiska spärrar finns i ämnet Felsöka verktyget för import/export av arkiveringsplaner.

Begränsningar

Använd verktyget för import/export av arkiveringsplaner till att migrera arkiveringsplaner. Verktyget hanterar dock inte följande: Först måste du exportera och importera anpassade egenskaper, som urvalslistor och klasser i en separat XML-fil innan du importerar 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 ett Java-program som kan köras från kommandoraden. Du kan också starta verktyget med kommandofilen: FilePlanTool.bat eller FilePlanTool.sh. Du kan köra verktyget i något av dessa fem lägen:

Konfigurera verktyget

Innan du kör verktyget i import- eller exportläge måste du konfigurera det. Konfigurera verktyget:
  1. Gå till den mapp där verktyget för import/export av arkiveringsplaner är installerat.
  2. Kör något av följande på kommandoraden:
    Operativsystem Kommando
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux och Solaris 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å den arkiveringsplan 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 anger ett filnamn på kommandoraden använder verktyget standardfilnamnet som anges i fältetUtdatafilnamn. Fältet finns i konfigureringsdialogrutan. Information om att ange 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å den arkiveringsplan 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 fältetUtdatafilnamn. Fältet finns i konfigureringsdialogrutan. 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 standardnamn för XML-utdatafilen finns i Konfigurera verktyget.

parameter kan vara något av följande:
  • metadata: Om arkiveringsplanen innehåller anpassade klasser eller egenskaper krävs den här parametern. 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 anpassade klasser och egenskaper
    • 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 parametern exporterar du en viss postkategori. När du använder includecategory exporterar verktyget alla underkategorier och undermappar 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 skriver du följande kommando. Cat03 ingår i Cat02, som i sin tur ingår i Cat01.

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

Om du ska importera en arkiveringsplan eller ett segment av en arkiveringsplan kör du verktyget i importläge. Ange den XML-fil som verktyget skapade i exportläge. Om arkiveringsplanen innehåller anpassade klasser eller egenskaper kräver importprocessen två steg. I det första steget importeras anpassade klasser och egenskaper i arkiveringsplanen. I det andra steget importeras resten av arkiveringsplanen. Importera anpassade klasser och egenskaper först. Vänta sedan i minst fem minuter innan du importerar arkiveringsplanen eftersom den anpassade klassen och egenskapsmetadata cachas 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änds standardfilnamnet från fältet Utdatanamn i verktygets konfigureringsdialogruta. Information om att ange standardnamn för XML-utdatafilen finns i Konfigurera verktyget.

Alternativet reimport bestämmer standardbeteendet för verktyget när du importerar en entitet som 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.

Kör verktyget i uppdateringsläge om du ska göra smärre ändringar efter den första importen av en arkiveringsplan. Håll isär följande uppdateringar från de först 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.

Gå till noden om felsökning och support i informationscentret eller till IBM FileNet P8 Troubleshooting Guide i produktdokumentationen för FileNet P8 Platform-sidan om du får ett felmeddelande eller om importprocessen stoppar. 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. Du kan validera filen 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änds standardfilnamnet från fältet Utdatanamn i verktygets konfigureringsdialogruta. Information om att ange standardnamn för XML-utdatafilen finns i Konfigurera verktyget.

Använda alternativet reimport

Med alternativet reimport bestämmer du verktygets standardbeteende när en entitet importeras som finns i en arkiveringsplan. Alternativet reimport har tre parametrar: Använd alternativet Hoppa över efter en misslyckad import av en stor arkiveringsplan. 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 gör att de entiteter som du lyckades importera vid första försöket måste importeras på nytt kanske du vill använda alternativet Ersätt i stället. 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. Ändra dessa entiteter 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: November 2013
fileplan_import_export.htm

© Copyright IBM Corp 2013