IBM Enterprise Records, Versio 5.1.+            

Arkistonmuodostussuunnitelman tuonti- ja vientityökalun käyttö

IBM Enterprise Records -käyttöönotoissa voit tuoda ulkoisen arkistonmuodostussuunnitelman tai viedä arkistonmuodostussuunnitelman ulkoiseen ympäristöön käyttämällä arkistonmuodostussuunnitelman tuonti- ja vientityökalua. Työkalu viimeistelee tuonti- ja vientiprosessit XML-tiedoston avulla.

Yleiskuvaus

Lisätietoja viedyn XML-tiedoston muokkaamisesta siten, että se sisältää aikataulun periytymisen, vaihtoehtoiset säilytykset, poistoliipaisimet ja dynaamiset pidot (ehdolliset pidot), on arkistonmuodostussuunnitelman tuonti- ja vientityökalua käsittelevässä osassa sivustossa http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.

Rajoitukset

Arkistonmuodostussuunnitelman tuonti- ja vientityökalun avulla voit siirtää arkistonmuodostussuunnitelmia. Työkalu ei kuitenkaan tue seuraavia toimia: Lisäksi mukautetut ominaisuudet (kuten valintaluettelot) ja luokat on ensin vietävä erilliseen XML-tiedostoon ja tuotava ne XML-tiedostosta takaisin, ennen kuin voit tuoda arkistonmuodostussuunnitelman loppuosan. Vastaavasti, kun olet tuonut arkistonmuodostussuunnitelman, yksiköiden tilat, kuten Suljettu tai Valmis poistettavaksi arkistosta eivät ole enää voimassa.

Työkalun ajo

Voit ajaa arkistonmuodostussuunnitelman tuonti- ja vientityökalun komentorivin Java-ohjelmatiedostosta tai voit aloittaa työkalun komentotiedostolla FilePlanTool.bat tai FilePlanTool.sh. Voit suorittaa työkalun jossakin seuraavasta viidestä tilasta:

Työkalun kokoonpanon määritys

Ennen kuin voit ajaa työkalun tuonti- tai vientitilassa, työkalun kokoonpano on määritettävä. Voit määrittää työkalun kokoonpanon seuraavasti:
  1. Siirry kansioon, johon arkistonmuodostussuunnitelman tuonti- ja vientityökalu on asennettu.
  2. Toteuta komentorivillä jokin seuraavista komennoista:
    Käyttöjärjestelmä Komento
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    Kirjoita seuraavat tiedot arkistonmuodostussuunnitelman työkalun valintaikkunaan:

Vie arkistonmuodostussuunnitelma,

jos vietävä arkistonmuodostussuunnitelma sisältää jonkin seuraavista kohteista: Lisätietoja on kohdassa Arkistonmuodostussuunnitelman vienti alueasetuksen kanssa.

Kun työkalun kokoonpano on määritetty, voit viedä arkistonmuodostussuunnitelman työkalun avulla. Voit viedä arkistonmuodostussuunnitelman kirjoittamalla seuraavan komennon:

FilePlanTool -mode export -fileplan arkistonmuodostussuunnitelman nimi -o XML-tiedostonimi.xml

jossa arkistonmuodostussuunnitelman nimi on vietävän arkistonmuodostussuunnitelman nimi. Tämä tieto on pakollinen. Jos arkistonmuodostussuunnitelman nimi sisältää välilyöntejä tai erikoismerkkejä, lisää lainausmerkit arkistonmuodostussuunnitelman nimen ympärille.

XML-tiedostonimi on luotavan tiedoston nimi ja polku. Jos et määritä tiedostonimeä komentorivillä, työkalu käyttää sen kokoonpanon määritysvalintaikkunan Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä. Lisätietoja XML-tulostustiedoston oletusnimen määrityksestä on kohdassa Työkalun kokoonpanon määritys.

Arkistonmuodostussuunnitelman vienti alueasetuksen kanssa

Kun viet arkistonmuodostussuunnitelman, käytä suurille arkistonmuodostussuunnitelmille tai mukautettuja luokkia tai ominaisuuksia sisältäville arkistonmuodostussuunnitelmille tarkoitettua alueasetusta. Voit viedä arkistonmuodostussuunnitelman alueasetusta käyttämällä kirjoittamalla seuraavan komennon:

FilePlanTool -mode export -fileplan arkistonmuodostussuunnitelman nimi -o XML-tiedostonimi.xml -scope parametri

jossa arkistonmuodostussuunnitelman nimi on vietävän arkistonmuodostussuunnitelman nimi. Tämä tieto on pakollinen. Jos arkistonmuodostussuunnitelman nimi sisältää välilyöntejä tai erikoismerkkejä, lisää lainausmerkit arkistonmuodostussuunnitelman nimen ympärille.

XML-tiedostonimi on luotavan tiedoston nimi ja polku. Jos et määritä tiedostonimeä komentorivillä, työkalu käyttää sen kokoonpanon määritysvalintaikkunan Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä. Kun käytät työkalua alueasetuksen kanssa, työkalu luo XML-tiedoston kullekin arkistonmuodostussuunnitelman osalle. Siksi sinun on määritettävä toinen XML-tiedostonimi aina, kun käytät työkalua vientitilassa. Lisätietoja XML-tulostustiedoston oletusnimen määrityksestä on kohdassa Työkalun kokoonpanon määritys.

Parametri voi olla jokin seuraavista:
  • metadata (metatiedot) - Jos arkistonmuodostussuunnitelmasi sisältää mukautettuja luokkia tai ominaisuuksia, tämä parametri on pakollinen. Metatieto-parametriasetus luo erillisen XML-tiedoston mukautettuja luokkia ja ominaisuuksia varten. Tästä syystä, kun arkistonmuodostussuunnitelma sisältää mukautettuja luokkia tai ominaisuuksia, sekä vienti- että tuontiprosessi koostuu kahdesta vaiheesta:
    • yksi vaihe mukautettuja luokkia ja ominaisuuksia varten
    • ja toinen arkistonmuodostussuunnitelman loppuosaa varten. Jos et käytä metadata-parametria, työkalu vie arkistonmuodostussuunnitelman ilman mukautettuja ominaisuuksia.
  • includecategory "asiakirjaluokan nimi" - Tämän parametrin avulla voit viedä tietyn asiakirjaluokan. Kun käytät includecategory-parametria, työkalu vie kaikki määritetyn asiakirjaluokan sisältämät aliluokat ja -kansiot. IBM Enterprise Records -ohjelman muuttujan asiakirjaluokan nimi täytyy sisältää koko polku. Jos haluat viedä esimerkiksi kaikki sen Luokka03-nimisen asiakirjaluokan aliluokat, joka sisältyy Luokka02-asiakirjaluokkaan ja joka puolestaan sisältyy Luokka01-asiakirjaluokkaan, kirjoita seuraava komento:

FilePlanTool.bat -mode export -scope includecategory "/Luokka01/Luokka02/Luokka03" -o vientitiedosto.xml

FilePlanTool.bat -mode export -scope includecategories tiedosto01.txt -o vienti01.xml

Tiedosto01.txt sisältää seuraavaa:

/LuokkaB /LuokkaC/AliluokkaC2 /LuokkaA/AliluokkaA1

Luokkanimen esityksessä käytetään koko polkunimeä ja yhtä asiakirjaluokkaa riviä kohti.

Arkistonmuodostussuunnitelman tuonti tai päivitys

Jos haluat tuoda arkistonmuodostussuunnitelman tai sen segmentin, suorita työkalu tuontitilassa ja määritä työkalun vientitilassa luoma XML-tiedosto. Jos arkistonmuodostussuunnitelmasi sisältää mukautettuja luokkia tai ominaisuuksia, tuontiprosessissa on kaksi vaihetta. Yksi vaihe tuo mukautetut luokat ja ominaisuudet arkistonmuodostussuunnitelmaan ja toinen vaihe tuo arkistonmuodostussuunnitelman loppuosan. Tuo mukautetut luokat ja ominaisuudet ensin ja odota sen jälkeen vähintään viisi minuuttia, ennen kuin tuot arkistonmuodostussuunnitelman, koska mukautetun luokan ja ominaisuuden metatiedot tallennetaan välimuistiin. Välimuistin säilytysaika (TTL) on viisi minuuttia, jonka jälkeen välimuisti tyhjentyy. Voit tuoda tai päivittää arkistonmuodostussuunnitelman kirjoittamalla seuraavan komennon:

FilePlanTool -mode import -f XML-tiedostonimi.xml -reimportoption asetus

FilePlanTool -mode update -f XML-tiedostonimi.xml -reimportoption asetus

XML-tiedostonimi on tuotavan tiedoston nimi ja polku. Jos et määritä tiedostonimeä komentorivillä, työkalu käyttää sen kokoonpanon määritysvalintaikkunan Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä. Lisätietoja XML-tulostustiedoston oletusnimen määrityksestä on kohdassa Työkalun kokoonpanon määritys.

Uudelleentuontiasetus määrittää työkalun oletustoimintatavan, kun tuot yksikköä, joka on jo arkistonmuodostussuunnitelmassa. Lisätietoja uudelleentuontiasetuksesta on kohdassa Uudelleentuontiasetuksen käyttö.

Työkalu ei käytä tuontitilassa alueasetusta, vaan määrittää tuotavat kohteet etsimällä XML-tunnistetta. Metatietoja (mukautettuja luokkia ja ominaisuuksia) ja arkistonmuodostussuunnitelmaa varten on määritettävä toinen XML-tiedostonimi.

Huomautus: XML-tiedoston ClassificationScheme-tunniste määrittää arkistonmuodostussuunnitelman nimen.

Voit tehdä pieniä muutoksia arkistonmuodostussuunnitelman alkuperäisen tuonnin jälkeen ja erottaa peräkkäiset päivitykset ensimmäisellä kerralla tuoduista XML-tiedostoista ajamalla työkalun päivitystilassa. Määritä XML-tiedoston FilePlan-tunnisteen InputMode-määritteeksi update. Mukautettua ominaisuutta (kuten valintaluetteloa) ei voi muokata käyttämällä päivitystilaa.

Jos saat virhesanoman tai tuontiprosessi keskeytyy, lisätietoja on kohdassa IBM FileNet P8 Troubleshooting Guide. Useimmissa tapauksissa tuontiprosessi keskeytyy, kun virhe havaitaan, eikä näkyviin tule yhtään sanomaa.

Aja tarvittaessa pidon tarkistus tuonnin jälkeen, jos haluat käyttää yksiköissä ehdollisia pitoja, koska työkalu ei tuo ehdollisia pitoja. Lisätietoja on kohdassa Rajoitukset.

Arkistonmuodostussuunnitelman tarkistus

Kun XML-tiedosto on luotu manuaalisesti, tarkista, ettei XML-tiedosto sisällä virheitä tai standardin noudattamiseen liittyviä ongelmia, ajamalla XML-tiedosto arkistonmuodostussuunnitelman tuonti- ja vientityökalun tarkistustilassa. Voit ajaa tuonti- ja vientityökalun tarkistustilassa kirjoittamalla seuraavan komennon:

FilePlanTool -mode validate -f XML-tiedostonimi.xml

XML-tiedostonimi on tarkistettavan tiedoston nimi ja polku. Jos et määritä tiedostonimeä komentorivillä, työkalu käyttää sen kokoonpanon määritysvalintaikkunan Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä. Lisätietoja XML-tulostustiedoston oletusnimen määrityksestä on kohdassa Työkalun kokoonpanon määritys.

Uudelleentuontiasetuksen käyttö

Uudelleentuontiasetuksen avulla voit määrittää työkalun oletustoimintatavan, kun tuot yksikköä, joka on jo arkistonmuodostussuunnitelmassa. Uudelleentuontiasetuksella on kolme parametria: Käytä Ohita-vaihtoehtoa, kun suuren arkistonmuodostussuunnitelman tuonti on epäonnistunut. Saman arkistonmuodostussuunnitelman toisen tuontiyrityksen aikana voit välttää jo tuotujen yksiköiden uudelleentuonnin käyttämällä Ohita-vaihtoehtoa. Jos toinen tuontiyritys edellyttää kuitenkin ensimmäisellä kerralla jo tuotujen yksiköiden vähäistä muokkausta, käytä Korvaa-vaihtoehtoa. Kun tuot peräkkäin muutamien yksiköiden vähäisiä muutoksia, määritä yksiköille (XML-tiedoston RMEntityObjectType-osaan) asetus Action="Modify" alkuperäisen XML-tiedoston muokkauksen sijasta. Käyttämällä Päivitä-tilaa voit myös tunnistaa helpommin peräkkäiset päivitykset ensimmäisten täysien tuontien joukosta. Lisätietoja on kohdassa Arkistonmuodostussuunnitelman tuonti tai päivitys.


Palaute

Päivitetty viimeksi: Elokuu 2011


© Copyright IBM Corp. 2011.
Tämä Information Center -sivusto perustuu Eclipse-tekniikkaan. (http://www.eclipse.org).