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, on ohjeaiheessa Arkistonmuodostussuunnitelman tuonti- ja vientityökalun vianmääritys.
Rajoitukset
Arkistonmuodostussuunnitelman tuonti- ja vientityökalun avulla voit siirtää arkistonmuodostussuunnitelmia. Työkalu ei kuitenkaan tue seuraavia tilanteita:
- Tietomallien välinen vienti ja tuonti. Jos tuot esimerkiksi PRO-tietomallin objektisäilöstä, et voi tuoda DoD-tietomallin objektisäilöön.
- Asiakirjaobjektien, taltioiden, dokumenttiobjektien, suojaustietojen ja suojausmerkintöjen vienti tai tuonti.
- Muutosten peruutusmekanismi.
- Null-arvoisten ominaisuuksien vienti. Esimerkiksi sellaisen arkistostapoistoaikataulun vaiheen vienti, jossa ei ole säilytysaikaa. Arkistostapoistoaikataulun tuonti toiseen objektisäilöön ei myöskään päivitä säilytysaikaa null-arvoiseksi. Voit kuitenkin päivittää säilytysajan päivittämällä XML-tiedoston manuaalisesti. Lisätietoja on ohjeaiheessa Arkistonmuodostussuunnitelman tuonti- ja vientityökalun vianmääritys.
Mukautetut ominaisuudet, kuten valintaluettelot, ja luokat on ensin vietävä erilliseen XML-tiedostoon ja tuotava 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. Voit vaihtoehtoisesti aloittaa työkalun komentotiedostolla
FilePlanTool.bat tai
FilePlanTool.sh. Voit ajaa työkalun jossakin seuraavasta viidestä tilasta:
- Configure: avaa valintaikkunan, jossa määritetään pakolliset tiedot. Pakollisia tietoja ovat Content Platform Engine -palvelimen nimi, objektisäilön nimi, pääkäyttäjän käyttäjätunnus ja salasana ja tila (tuonti tai vienti).
- Export: luo täysin yhteensopivan ja sääntöjenmukaisen XML-tiedoston, jonka voit tuoda myöhemmin toiseen ympäristöön.
- Import/update: tuo määritetyn XML-tiedoston ympäristöön.
- Validate: tarkistaa yhteensopivuuden ja sääntöjenmukaisuuden lukemalla XML-tiedoston.
Vie arkistonmuodostussuunnitelma,
jos vietävä arkistonmuodostussuunnitelma sisältää jonkin seuraavista kohteista:
- mukautettuja luokkia tai ominaisuuksia
- yli 300 000 kansiota
- asiakirjaluokan, joka sisältää yli 15 000 kansiota.
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ää Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä. Tämä kenttä sijaitsee kokoonpanon määritysvalintaikkunassa. 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ää Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä. Tämä kenttä sijaitsee kokoonpanon määritysvalintaikkunassa. 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 kohteista:
- metadata: 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 Luokka03-nimisen asiakirjaluokan aliluokat, kirjoita seuraava komento. Luokka03 sisältyy Luokka02:een, joka puolestaan sisältyy Luokka01:een.
FilePlanTool.bat -mode export -scope includecategory
"/Luokka01/Luokka02/Luokka03" -o vientitiedosto.xml
- includecategories tiedosto 01:
Tämän parametrin avulla voit viedä vain asiakirjaluokat ja niiden aliluokat, jotka on määritetty tiedosto 01 -tiedostossa. Parametrin includecategories avulla voit viedä useita asiakirjaluokkia samaan tiedostoon määrittämättä kunkin asiakirjaluokan nimeä komentorivillä. Voit käyttää tätä parametria kirjoittamalla seuraavan komennon:
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.
- excludecategory "pois jätetyn asiakirjaluokan nimi": Tämän parametrin avulla voit jättää pois tietyn asiakirjaluokan sekä sen aliluokat. Jos esimerkiksi pois jätetyn asiakirjaluokan nimi on "Luokka01/Luokka02/SuuriLuokka", työkalu vie kaikki arkistonmuodostussuunnitelman asiakirjaluokat ja -kansiot yhtä poikkeusta lukuun ottamatta. Työkalu ei vie asiakirjaluokkia ja -kansioita, jotka sijaitsevat solmussa "Luokka01/Luokka02/SuuriLuokka". Tämä parametri toimii samalla tavalla kuin parametri includecategory.
- excludecategories tiedosto 02:
Tämän parametrin avulla voit jättää pois tiedosto 02 -tekstitiedostossa määritetyt päänimien alirakenteet. Tämä parametri toimii samalla tavalla kuin parametri includecategories.
Arkistonmuodostussuunnitelman tuonti tai päivitys
Jos haluat tuoda arkistonmuodostussuunnitelman tai sen segmentin, aja työkalu tuontitilassa. Määritä työkalun vientitilassa luoma XML-tiedosto. Jos arkistonmuodostussuunnitelmasi sisältää mukautettuja luokkia tai ominaisuuksia, tuontiprosessissa on kaksi vaihetta. Ensimmäinen vaihe tuo mukautetut luokat ja ominaisuudet arkistonmuodostussuunnitelmaan. Toinen vaihe tuo arkistonmuodostussuunnitelman loppuosan. Tuo ensin mukautetut luokat ja ominaisuudet. 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. Työkalu käyttää kokoonpanon määritysvalintaikkunan Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä, jos et määritä tiedostonimeä. 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 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 ajamalla työkalun päivitystilassa. Erota peräkkäiset päivitykset ensimmäisellä kerralla tuoduista XML-tiedostoista. 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 Information Center -sivuston Troubleshooting and Support -solmussa tai FileNet P8
Platformn käyttöohjeiden 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. Voit tarkistaa tiedoston arkistonmuodostussuunnitelman tuonti- ja vientityökalun avulla. 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. Työkalu käyttää kokoonpanon määritysvalintaikkunan Tulostustiedoston nimi -kentässä määritettyä oletustiedostonimeä, jos et määritä tiedostonimeä. 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 arkistonmuodostussuunnitelmassa. Uudelleentuontiasetuksella on kolme parametria:
- Ei mitään: Kun lisäät yksikön, työkalu kirjaa varoituksen poikkeuslokiin, jos yksikkö on järjestelmässä, ei lisää yksikköä ja jatkaa toimintaa.
- Ohita: Kun lisäät yksikön, työkalu ohittaa
aiemmin luodut yksiköt, jatkaa toimintaa ja kirjaa ohitustoiminnon toimintojen lokiin.
- Korvaa: Kun lisäät yksikön, työkalu korvaa aiemmin luodut yksiköt, jatkaa toimintaa ja kirjaa muutostoiminnon toimintojen lokiin.
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". Muuta näitä yksiköitä 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.