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:
- 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: Exportera en fas för ett avvecklingsschema utan någon kvarhållningsperiod. Om du 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. Mer information finns i ämnet Felsöka verktyget för import/export av arkiveringsplaner.
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: Öppnar en dialogruta där du anger den information som krävs. Den informationen är Content Platform Engine-servernamn, objektlagernamn, administratörens användarnamn och lösenord samt läge (import eller export).
- Export: Skapar en helt kompatibel och giltig
XML-fil som du senare kan importera en annan miljö.
- Importera/uppdatera: Importerar en angiven XML-fil till en miljö.
- Validera: Läser en XML-fil för att verifiera kompatibilitet och giltighet.
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å 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
- 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 många 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 med ett undantag. Det undantaget är 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
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:
- Ingen: Vid tillägg av entiteter skickar verktyget en varning till undantagsloggen om en entitet finns, lägger inte till den och fortsätter sedan.
- Hoppa över: Vid tillägg av entiteter hoppar verktyget över alla entiteter som finns, fortsätter och rapporterar till aktivitetsloggen att entiteterna hoppats över.
- Ersätt: Vid tillägg av entiteter ersätter verktyget alla entiteter som finns, fortsätter och rapporterar ändringarna till aktivitetsloggen.
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.