IBM Enterprise Records, versio 5.1.2    

Raportin lisäys tiedostoon ReportDefinitions.xml

Ennen kuin lisäät ReportDefintions.xml-tiedostoon raportin, luo raporttimalli Crystal Reports Designer -ohjelmassa.

Toimintaohjeet

Voit lisätä ReportDefinitions.xml-tiedostoon raportin seuraavasti:

  1. Avaa ReportDefinitions.xml-tiedosto XML-muokkausohjelmassa. Tiedosto on polussa <ier_asennuspolku>\Config.
  2. 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.
  3. Lisää 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.
  4. 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:
    1. Kopioi XML-tiedostossa oleva aiemmin luodun raportin koko reportDefinition-objektiavain.
    2. Liitä kopioitu objektiavain XML-tiedoston toiseen kohtaan.
  5. 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">raportin nimi</setting>, jossa raportin nimi on IBM Enterprise Records -ohjelman näkyviin tuoman raportin otsikko.

    <setting key="desc" localizationKey="server.report_desc.n">kuvaus</setting>, jossa kuvaus 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">tiedoston nimi.rpt</setting>, jossa tiedoston nimi 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.

  6. 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 sisällytetä. Lisäämällä tämän arvon tunnisteita voit jättää raportin sisällyttämättä useisiin arkistonmuodostussuunnitelman objektisäilöihin.

  7. Lisää raportin ehdot, kuten arkistonmuodostussuunnitelman objektisäilöjen sijainnit, toiminnot, tapahtumat, aikataulut ja päivämäärät.
    1. Lisää kohtaan <object key="reportDefinition"> tarvittaessa merkintä <list key="properties">. Jos kopioit reportDefinition-objektiavaimen aiemmin luodusta raportista, merkintä <list key="properties:> on jo valmiina.
    2. Lisää ominaisuusluetteloavaimeen symbolisen nimen asetusavain tai muokkaa sitä kunkin raporttiehdon edellyttämällä tavalla. Jos loit 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ä käyttäjän täytyy tehdä valinta tai antaa arvo.

      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.
    • raportin_tyyppi - Määrää, että IBM Enterprise Records -ohjelma aktivoi 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. Arvot näkyvät valikossa, josta voi valita haluamansa arvon.
  8. Jos raportti käyttää ehtoina yksikön tyyppejä, toimi seuraavasti:
    1. Lisää ominaisuusluetteloavaimeen symbolinen nimi yksikön_tyyppi ja sen perään required-asetusavain (1 = pakollinen, 0 = ei pakollinen). Esimerkki:
      <object key="property">
      		<setting key="symbolicname">yksikön_tyyppi</setting>
        	<setting key="required">1</setting>
    2. 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">Yksikön_tyyppi</setting>
           <setting key="value" localizationKey=serve.report_n.Yksikön_tyyppi">Yksikkö</setting>
         </object>

      jossa

      • Yksikön_tyyppi 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.
      • Yksikkö 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ää seuraavan esimerkin kaltaiselta:

      <object key="property">   
      		<setting key="symbolicname">yksikön_tyyppi</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>
  9. 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">Luokitustoiminto</setting>      
    			<setting key="value" localizationKey=serve.report_n.Luokitustoiminto">Luokitustoiminto</setting>    
    		</object> 
    jossa
    • Luokitustoiminto 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 poistotoimintojen tilastotietoja, XML-tiedoston tämä jakso näyttää seuraavan esimerkin kaltaiselta:

    <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>
  10. Kun olet antanut kaikki raportin ehdot, toimi seuraavasti:
    1. Päätä merkintä <list key="properties"> tunnisteella </list>.
    2. Päätä merkintä <object key="reportDefinition"> tunnisteella </object>.
    3. Tallenna XML-tiedosto.
  11. Käynnistä uudelleen Web-sovelluspalvelin, jossa IBM Enterprise Records on ajossa, jotta muutokset tulevat voimaan.

Tulokset

Kun olet saanut muokkaukset valmiiksi, reportDefinition-objektiavaimen jakson tulisi näyttää seuraavan esimerkin kaltaiselta:

<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">raportin_tyyppi</setting>
  			<setting key="required">0</setting>     
		</object>      
		<object key="property">   
			<setting key="symbolicname">yksikön_tyyppi</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>


Palaute

Päivitetty viimeksi: Marraskuu 2013
add_report_definition.htm

© Copyright IBM Corp. 2013