IBM Enterprise Records, versio 5.1.2    

Tapahtumankäsittelijät

IBM Enterprise Records -ohjelma sisältää seuraavat esimerkkitapahtumat Base-, DoD- ja PRO-tietomallia varten.

Esimerkkejä voi mukauttaa tarpeen mukaan. Lisätietoja on ohjelmistopakkauksen Events-kansiossa olevassa Readme-tiedostossa.

Taulukko 1. Tapahtumat ja kuvaukset
Tapahtumat Kuvaus
RMAutoDeclare

Määrittää asiakirjojen automaattisen asiakirjoiksi vahvistuksen. Kun käyttäjä kohdistaa toiminnon (sisäänkuittauksen tai arkistoinnin kansioon) dokumenttiin, joka on asiakirjojen objektisäilössä (ROS), IBM Enterprise Records luo automaattisesti vastaavan asiakirjan määritettyyn arkistonmuodostussuunnitelman objektisäilöön (FPOS). Voit myös määrittää tämän esimerkkitapahtuman siten, että jokainen tiettyyn dokumenttiluokkaan kuuluva dokumentti vahvistetaan asiakirjaksi, kun käyttäjä kuittaa dokumentin sisään.

Tämä esimerkkitapahtuma tukee vain sähköisten asiakirjojen luokittelematonta asiakirjoiksi vahvistusta. Tämä tapahtuma on määritettävä käyttämään asynkronisia tapahtumia EIKÄ synkronisia tapahtumia.

RMAutoSynchronizeProperties

Synkronoi asiakirjojen ja niihin liittyvien dokumenttien ominaisuudet. Jos käyttäjä päivittää esimerkiksi asiakirjan ominaisuuden arvoa, IBM Enterprise Records päivittää myös asiakirjaan liittyvien dokumenttien vastaavan ominaisuuden arvon.

Tämä esimerkkitapahtuma toimii, jos ominaisuuksissa on käytössä sama symbolinen nimi. Synkronoinnin suuntana voi olla dokumentista asiakirjaan tai asiakirjasta dokumenttiin mutta ei molempiin suuntiin. Jos käytät synkronointia asiakirjasta dokumenttiin, IBM Enterprise Records päivittää dokumentin, kun asiakirjan vastaava ominaisuus päivitetään.

Tämä tapahtuma synkronoi myös ominaisuuksien valenimet objektisäilöjen välillä joko asiakirjasta dokumenttiin tai dokumentista asiakirjaan mutta ei molempiin suuntiin.

RMUpdateDateDeclared

RMLastRetrievalOfRecord

Näitä esimerkkitapahtumia käytetään yhdessä sen selvittämiseen, milloin säilö tulee poistaa arkistosta. Esimerkkitapahtumat varmistavat myös, ettei arkistostapoistoaikataulu poista säilöä, johon on äskettäin vahvistettu asiakirjoja tai josta on äskettäin noudettu asiakirjoja.

IBM Enterprise Records käyttää tätä esimerkkitapahtumaa taltio- ja laatikkoluokissa ja määrittää pääkansion Viimeksi vahvistettu asiakirjaksi (pvm) -arvon, kun käyttäjä vahvistaa asiakirjan.

PRO-tietomallissa IBM Enterprise Records tilaa RMUpdateDateDeclared-tapahtuman automaattisesti Taltio- tai Laatikko-luokkaan ja tapahtuma tarvitsee vain ottaa käyttöön. Muita tietomalleja varten on ajettava tuonnin komentosarja, joka luo RMUpdateDateDeclared-tapahtuman. Tämän lisäksi on määritettävä taltio- tai laatikkoluokan tilaus.

RMLastRetrievalOfRecord määrittää asiakirjan sisällön edellisen arvioinnin päivämäärän asiakirjakansion LastRetrievalofRecord-ominaisuuteen.

RMSecurityPropagation

(Vain PRO-tietomalli) Käytettäessä vain PRO-tietomalleissa tämä esimerkkitapahtuma määrittää asiakirjan, taltion ja asiakirjakansion (mutta ei asiakirjaluokan) Suojausluokka-ominaisuuden merkinnän arvon sen perusteella, mikä on siihen liittyvän yksikön ylin taso.

Jos välityssuunta on esimerkiksi asiakirjasta kansioon, IBM Enterprise Records päivittää pääkansion suojauksen, jos asiakirjan suojaustaso on ylempi kuin asiakirjan pääkansion suojaus. Tämä ei vaikuta muihin kansioihin, joihin asiakirja arkistoidaan.

Jos välityssuuntana on kansiosta asiakirjaan, IBM Enterprise Records päivittää asiakirjojen suojauksen alemmalle tasolle kuin niiden pääkansioiden ylin suojaustaso.

PRO-tietomallin FPOS-säilöä koskeva järjestelmän kokoonpanoasetus ohjaa sitä, miten suojaus välittyy. Vaihtoehdot ovat kansiosta asiakirjaan, asiakirjasta kansioon, molempiin suuntiin tai välitys estetty.

RMSendEmailOnSupercede

Tämä esimerkkitapahtuma liipaisee sähköpostiviestin lähetyksen aina, kun asiakirja korvataan uudella versiolla. Sähköpostiviestissä on tiedot korvaavan asiakirjan kuvauksesta, päivämäärästä ja korvausajankohdasta. Järjestelmä lähettää sähköpostiviestin, jos säilöön on määritetty arkistostapoistoaikataulu, johon on määritetty korvaustapahtumaan perustuva liipaisin.

Rajoitus: Tämä tapahtuma ei ole käytettävissä JBoss- ja WebLogic-sovelluksissa.

IBM Enterprise Records -esimerkkitapahtumankäsittelijöiden JAR-tiedostot on tallennettu koodimoduuleina kohdeobjektisäilöön. Tästä on se etu, että tapahtumankäsittelijän voi lisätä tai päivittää kuittaamalla sisään uuden version ilman sovelluspalvelimen uudelleenkäynnistystä. Voit määrittää IBM Enterprise Records -ohjelman esimerkkitapahtumat seuraavasti:

Tapahtumatoimintojen luonti

Varmista ennen näiden toimien aloitusta, että sen objektisäilön pääkansiossa on CodeModules-niminen kansio, johon olet aikeissa luoda tapahtumatoimintoja. Jos kansiota ei ole, luo se IBM FileNet P8 Platform Installation and Upgrade Guide -julkaisussa olevien ohjeiden mukaan.

Voit luoda tapahtumatoimintoja seuraavasti:
  1. Kopioi kansio CD-kantahakemistoon ~CDRoot\RecordsManager.<ympäristö>\Events siihen palvelimeen, jossa IBM Administration Console for Content Platform Engine on ajossa. Kansiossa ovat tuonnin komentosarjat, JAR-tiedostot ja kokoonpanotiedostot.
  2. Aja käyttöön otettavia tapahtumatoimintoja vastaavat tuonnin komentosarjat.
    1. Napsauta IBM Enterprise Records -kohdeobjektisäilöä hiiren kakkospainikkeella.
    2. Valitse Import All -vaihtoehto.
    3. Siirry Import Helper -valintaikkunan Import Options -välilehden Import Manifest -kentässä edellä kopioituun kansioon. Valitse haluamasi tapahtuman tuonnin komentosarja. Kukin tiedosto on nimetty tapahtuman mukaan. Esimerkiksi RMAutoDeclare-tapahtuman tuontitiedoston nimi on RMAutoDeclareImport.xml.
    4. Siirry External Content Path -kentässä kansioon ~\Events\lib.
    5. Napsauta Tuo-vaihtoehtoa.

    Tuonnin valmistuttua näkyviin tulee Import Success -sanoma. Tapahtumatoiminnon voi luoda objektisäilön Event Action -kansioon. Koodimoduulit luodaan Code Module -kansioon.

Kokoonpanotiedostojen mukautus

RMAutoDeclare- ja RMSendEmailOnSupercede-tapahtumalla on omat kokoonpanotiedostonsa. Tuonnin komentosarja luo objektisäilöön seuraavat tiedostot:

Kuittaa kokoonpanotiedosto ulos joko Workplace- tai Workplace XT -komponentissa tai IBM Administration Console for Content Platform Engine -ohjelmassa. Kuittaa se muokkauksen jälkeen sisään. Lisätietoja on asiakirjojen automaattista esittelyä käsittelevässä ohjeaiheessa. RMSendEmailOnSupercede-tiedostossa on muokattavien rivien edellä kommentit, joiden merkitys on itsestään selvä: SMTP host (SMTP-pääkone), port number (portin numero), sender and receiver email addresses (lähettäjän ja vastaanottajan sähköpostiosoitteet).

Tilausten luonti

Kukin tapahtuma tarvitsee yhden tai useamman luokan tilauksen.

RMAutoDeclare-tapahtuman tilaus

Voit luoda tilauksen seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/ROS/Dokumenttiluokka-luokkaan tai aliluokkaan, johon haluat luoda tilauksen.
  2. Napsauta luokkaa hiiren kakkospainikkeella ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä Check In -tapahtuman liipaisin.
  6. Valitse Specify Event Action -näytössä tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Synchronous -valintaruudun valinta. Valitse Include Subclasses -valintaruutu tai poista sen valinta kunkin tapahtuman tarpeen mukaan. Tee sitten ohjattu toiminto loppuun.
Voit tilata kansioluokan tai -aliluokan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/ROS/Kansioluokka-luokkaan tai aliluokkaan, johon haluat luoda tilauksen.
  2. Napsauta luokkaa hiiren kakkospainikkeella ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä File-tapahtuman liipaisin.
  6. Poista Synchronous-valintaruudun valinta. Valitse Include Subclasses -valintaruutu tai poista sen valinta tarpeen mukaan. Tee sitten ohjattu toiminto loppuun.
Voit tilata ROS-säilön tietyn kansion seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa kansioon, johon haluat luoda tilauksen.
  2. Napsauta kansiota hiiren kakkospainikkeella ja valitse New Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Hyväksy oletusarvo.
  5. Valitse File-tapahtuman liipaisin.
  6. Valitse Specify Event Action -näytössä RMAutoDeclare-tapahtuma.
  7. Poista Specify Additional Properties -näytössä Synchronous -valintaruudun valinta. Hyväksy lopuille asetuksille oletusarvot ja tee ohjattu toiminto loppuun.

RMAutoSynchronizeProperties-tapahtuman tilaus

RMAutoSynchronizeProperties- tapahtuman tilaus synkronoi ominaisuudet lähdedokumentista sitä vastaavaan asiakirjaan tai asiakirjasta sitä vastaavaan lähdedokumenttiin.

Älä yritä käyttää synkronointia molempiin suuntiin. Tämä tapahtuma tulee määrittää käyttämään synkronisia tapahtumia.

Synkronointi lähdedokumentista sitä vastaavaan asiakirjaan
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/ROS/Dokumenttiluokka-luokkaan tai aliluokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä Update-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Valitse Specify Additional Properties -näytössä Synchronous-valintaruutu, mutta poista Include Subclasses -valintaruudun valinta. Tee sitten ohjattu toiminto loppuun.
Voit synkronoida asiakirjasta sitä vastaavaan lähdedokumenttiin seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/ROS/Dokumenttiluokka-luokkaan tai aliluokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä Update-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Valitse Specify Additional Properties -näytössä Synchronous-valintaruutu, mutta poista Include Subclasses -valintaruudun valinta. Tee sitten ohjattu toiminto loppuun.

RMLastRetrievalOfRecord-tapahtuman tilaus

Voit tilata RMLastRetrievalOfRecord-tapahtuman seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/FPOS/Other Classes/CustomObject/RM System class-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä Creation-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Include Subclasses -valintaruudun valinta, mutta valitse Synchronous-valintaruutu. Tee sitten ohjattu toiminto loppuun.

RMSecurityPropagation-tapahtuman tilaus (vain PRO-tietomalli)

Voit luoda tämän tapahtuman tilauksen asiakirjakansio-, taltio- tai asiakirjaluokkaan.

Voit tilata tapahtuman asiakirjakansioluokkaan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/PRO-FPOS/Other Classes/Folder/RM Folder/Record Folder class-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä File- ja Update-tapahtuman liipaisimet.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Include Subclasses -valintaruudun valinta ja tee ohjattu toiminto loppuun.
Voit tilata tapahtuman taltioluokkaan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/PRO FPOS/Other Classes/Folder/RM Folder/Volume class-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä File- ja Update-tapahtuman liipaisimet.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Include Subclasses -valintaruudun valinta ja tee ohjattu toiminto loppuun.
Voit tilata tapahtuman asiakirjaluokkaan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/PRO-FPOS/Document Class/Record class-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä Update-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Valitse Specify Additional Properties -näytössä Include Subclasses -valintaruutu ja tee ohjattu toiminto loppuun.

RMSendEmailOnSupercede-tapahtuman tilaus

Voit tilata RMSendEmailOnSupercede-tapahtuman seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/FPOS/Document Class/Record class-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä Update- ja Checkin-tapahtuman liipaisimet.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Valitse Specify Additional Properties -näytössä Include Subclasses -valintaruutu ja tee ohjattu toiminto loppuun.

RMUpdateDateDeclared-tapahtuman tilaus

PRO-tietomallia käytettäessä aiemmin määritetty tapahtuma on otettava käyttöön. Voit tehdä sen seuraavasti:
  • Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/FPOS/Events/Event Action-kansioon.
  • Napsauta hiiren kakkospainikkeella UpdateDateDeclared-tapahtumaa.
  • Valitse Enable-vaihtoehto.

DoD- ja Base-tietomallia käytettäessä asiakirjaluokka-, taltio- ja laatikkoluokan tilaus määritetään, kun tapahtuma on ensin luotu.

Voit tilata tapahtuman asiakirjaluokkaan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record Category-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä File-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Include Subclasses -valintaruudun valinta ja tee ohjattu toiminto loppuun.
Voit tilata tapahtuman taltioluokkaan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/FPOS/Other Classes/Folder/RM Folder/Volume-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä File-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Include Subclasses -valintaruudun valinta ja tee ohjattu toiminto loppuun.
Voit tilata tapahtuman laatikkoluokkaan seuraavasti:
  1. Siirry IBM Administration Console for Content Platform Engine -ohjelmassa Object Stores/FPOS/Other Classes/Folder/RM Folder/Physical Container/Box-luokkaan.
  2. Napsauta hiiren kakkospainiketta ja valitse Add Subscription -vaihtoehto.
  3. Anna tilaukselle yksilöllinen nimi sekä kuvaus.
  4. Valitse Applies to all instances -valintanappi.
  5. Valitse Specify Triggers -näytössä File-tapahtuman liipaisin.
  6. Valitse tuomasi tapahtumatoiminto.
  7. Poista Specify Additional Properties -näytössä Include Subclasses -valintaruudun valinta ja tee ohjattu toiminto loppuun.

Lisätietoja tapahtumien mukautuksesta on FileNet P8 -ohjelmistopakkauksessa.



Palaute

Päivitetty viimeksi: Marraskuu 2013
work_with_event_handlers.htm

© Copyright IBM Corp. 2013