Ennen kuin lisäät ReportDefintions.xml-tiedostoon uuden raportin,
luo uusi raporttimalli Crystal Reports Designer -ohjelmassa.
Voit lisätä ReportDefinitions.xml-tiedostoon uuden raportin seuraavasti:
- Avaa ReportDefinitions.xml-tiedosto XML-muokkausohjelmassa.
Tiedosto on polussa <ier_asennuspolku>\Config.
- Paikanna arkistonmuodostussuunnitelman objektisäilössä (FPOS) käytettävän tietomallin matriisi. XML-tiedostossa on
DoD-raporttien, luokiteltujen DoD-raporttien, PRO-raporttien ja BASE-raporttien matriisi.
- Lisää uusi arvon tunniste (esimerkiksi <value>42</value>).
Arvo on kokonaisluku, joka yksilöi
Crystal Reports Designer -ohjelmassa luodun raportin. Kunkin raportin arvo on yksilöllinen. Arvo muodostetaan lisäämällä jo luotujen raporttien
määrään luku 1.
- Lisää kohtaan <List key="ReportDefinitions"> uutta raporttia varten merkintä <object
key="reportDefinition">. Jos tiedostossa on jo ennestään
luodun raportin kanssa samankaltainen raportti, toimi seuraavasti:
- Kopioi XML-tiedostossa oleva aiemmin luodun raportin koko reportDefinition-objektiavain.
- Liitä kopioitu objektiavain XML-tiedoston toiseen
kohtaan.
- Muokkaa reportDefinition-objektiavain uudelle raportille soveltuvaksi
muuttamalla tai lisäämällä seuraavien tunnisteiden arvoja tarpeen mukaan.
n on edellä vaiheessa 3 annettu luku.
<setting
key="id">n</setting>.
<setting key="title"
localizationKey="server.report_title.n">report
name</setting>, jossa report name on IBM Enterprise Records -ohjelman näkyviin tuoman
raportin otsikko.
<setting
key="desc" localizationKey="server.report_desc.n">description</setting>,
jossa description on IBM Enterprise Records -ohjelman näkyviin tuoma, raportin tarkoitusta lyhyesti kuvaava teksti. Esimerkki: "Tässä raportissa on luettelo taltioista,
jotka on avattu tai suljettu tietyn ajanjakson aikana."
<setting
key="reportName" localizationKey="server.report_name.n">filename.rpt</setting>,
jossafilename on Crystal Reports Designer -ohjelmassa luodun raporttimallin nimi.
<setting key="img">kuvatiedoston
suhteellinen polku</setting> Tämä on valinnainen arvo, jonka avulla voidaan
lisätä kuva. Esimerkki: images/action/report.gif.
- Jos haluat jättää uuden raportin sisällyttämättä tiettyyn arkistonmuodostussuunnitelman objektisäilöön (FPOS), anna seuraavat tunnisteet:
<array key="excludedObjectStores">
<value>fpos</value> </array>
jossa fpos on
sen arkistonmuodostussuunnitelman objektisäilön nimi, johon uutta raporttia ei tule sisällyttää. Lisäämällä tämän arvon tunnisteita
voit jättää raportin sisällyttämättä useisiin arkistonmuodostussuunnitelman objektisäilöihin.
- Lisää raportin ehdot, kuten arkistonmuodostussuunnitelman objektisäilöjen sijainnit, toiminnot, tapahtumat,
aikataulut ja päivämäärät.
- Lisää kohtaan <object key="reportDefinition"> tarvittaessa merkintä <list
key="properties">. Jos kopioit reportDefinition-objektiavaimen
aiemmin luodusta raportista, merkintä <list key="properties:>
on jo valmiina.
- Lisää ominaisuusluetteloavaimeen symbolisen
nimen asetusavain tai muokkaa sitä kunkin raporttiehdon edellyttämällä tavalla. Jos
loit uusia ehtoja, lisää myös symbolisen nimen asetusavain kutakin uutta ehtoa varten.
Lisää kunkin symbolisen nimen asetusavaimen perään seuraava tunniste: <setting key="required"> 0 tai 1 </setting>.
Tämä osoittaa, onko arvo pakollinen. 0 ilmaisee, että
käyttäjän ei tarvitse tehdä valintaa tai antaa arvoa. 1 puolestaan ilmaisee, että
toimi on käyttäjälle pakollinen.
Sulje kukin symbolisen nimen ja
tarvittavien asetusavainten merkintäpari seuraavan tunnisteen sisään: <object key="property"> </object>.
Esimerkiksi:
<object key="property"> <setting
key="symbolicname">symbolinen nimi</setting>
<setting key="required">1</setting> </object>
jossa symbolinen
nimi on luomasi uusi ehto tai mikä tahansa seuraavista
asetusavaimista:
- fileplan_browse - Määrää, että IBM Enterprise Records -ohjelma sallii käyttäjän selata
arkistonmuodostussuunnitelman objektisäilössä olevaan sijaintiin.
- ros_browse - Määrää, että IBM Enterprise Records -ohjelma sallii käyttäjän selata
asiakirjojen objektisäilössä olevaan sijaintiin.
- start_date - Raporttiehtojen aloituspäivämäärä.
- end_date - Raporttiehtojen lopetuspäivämäärä.
- application_type - Ehtoina käytettävät asiakirjalajit,
esimerkiksi PDF, DOC ja XLS.
- security_category - Suojausmerkintä, tietomallin mukaan esimerkiksi luokiteltu,
salainen ja luottamuksellinen.
- review_decision - Arvioinnin päätös, muun muassa Hyväksy tai Hylkää.
- action - Yksikköön kohdistettava toiminto, esimerkiksi avaus tai sulkeminen.
- disposal_schedule - Yksikköön liitetty arkistostapoistoaikataulu.
- disposal_action - Yksikköön kohdistettava poistotoiminto, esimerkiksi
siirto, arviointi, väliaikainen siirto tai tuhoaminen.
- disposal_action_export - Yksikköön viennin jälkeen kohdistettava poistotoiminto.
- report_type - Määrää, että IBM Enterprise Records -ohjelma tuo näkyviin yhteenvedon tai
tarkkojen tietojen valintanapit.
- disposal_trigger - Tapahtuma, joka liipaisee yksikön arkistosta poiston,
esimerkiksi päivämäärä, säilön sulkeminen tai ulkoinen
tapahtuma.
Asetusavaimille ros_browse, security_category, disposal_action, disposal_action_export,
review_decision ja disposal trigger IBM Enterprise Records noutaa oletusarvot
ajonaikaisesti Content Engine -komponentista ja tuo ne näkyviin
valikkoon, josta arvon voi valita.
- Jos raportti käyttää ehtoina yksikön tyyppejä, toimi seuraavasti:
- Lisää ominaisuusluetteloavaimeen symbolinen
nimi entity_type ja sen perään
required-asetusavain (1 = pakollinen, 0 = ei pakollinen).
Esimerkki:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
- Lisää merkintä <list key="values">. Siinä annat yksikön lajit,
jotka käyttäjä voi valita sisällytettäviksi tähän raporttiin. Esimerkki:
<list key="values">
<object key="value">
<setting key="id">EntityType</setting>
<setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
</object>
jossa
- EntityType on RecordCategory, RecordFolder tai Record.
Voit halutessasi lisätä kaikki kolme yksikön tyyppiä, mutta kukin on merkittävä erillisiin <object key="value">-tunnisteisiin.
- n on edellä vaiheessa 3 annettu luku.
- Entity on asiakirjaluokka, asiakirjakansio tai asiakirja.
Lokalisoiduissa ympäristöissä tulee käyttää avainta localizationKey.
Jos raportti sisältää
esimerkiksi asiakirjaluokkien ja asiakirjakansioiden tilastotietoja, XML-tiedoston tämä jakso näyttää
seuraavankaltaiselta:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Record Category</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
</list>
</object>
- Jos raportissa on käytössä luokitustoimintoja, toimi seuraavasti:
Lisää ominaisuusluetteloavaimeen symbolinen
nimi classification_action ja sen perään
required-asetusavain (1 = pakollinen, 0 = ei pakollinen).
Esimerkiksi:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
Lisää merkintä <list key="values">. Siinä annat luokitustoiminnot,
jotka käyttäjä voi valita sisällytettäviksi tähän raporttiin. Esimerkiksi:
<list key="values">
<object key="value">
<setting key="id">ClassificationAction</setting>
<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>
</object>
jossa
- ClassificationAction on Upgrading, Downgrading tai
Declassification. Voit halutessasi lisätä kaikki kolme luokitustoimintoa, mutta kukin on merkittävä erillisiin <object key="value">-tunnisteisiin.
- n on tämän raportin id-arvo tietomallin matriisissa.
Lokalisoiduissa ympäristöissä tulee käyttää avainta localizationKey.
Jos raportti sisältää
esimerkiksi luokituksen lasku- tai luokituksen poistotoimintojen
tilastotietoja, XML-tiedoston tämä jakso näyttää
seuraavankaltaiselta:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
</object>
</list>
</object>
- Kun olet antanut kaikki raportin ehdot, toimi seuraavasti:
- Päätä merkintä <list key="properties"> tunnisteella </list>.
- Päätä merkintä <object key="reportDefinition"> tunnisteella </object>.
- Tallenna XML-tiedosto.
- Käynnistä uudelleen Web-sovelluspalvelin, jossa IBM Enterprise Records on ajossa, jotta muutokset
tulevat voimaan.
Kun olet saanut muokkaukset päätökseen, reportDefinition-objektiavaimen jakson tulisi näyttää
seuraavankaltaiselta:
<object key="reportDefinition">
<setting key="id">22</setting>
<setting key="title" localizationKey="server.report_title.42">Records
Manager Classification Update Report</setting>
<setting key="desc" localizationKey="server.report_desc.42">This report lists entities
that have changed classification within a specific period.</setting>
<setting key="url">RMViewReport.jsp</setting>
<setting key="img">images/action/report.gif</setting>
<setting key="reportName" localizationKey="server.report_name.42">Classification Update.rpt</setting>
<list key="properties">
<object key="property">
<setting key="symbolicName">fileplan_browse</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicName">start_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">end_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">report_type</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Record
Category</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
</object>
</list>
</object>
</list>
</object>
</list>
</object>