IBM Enterprise Records, Versió 5.1.2    

Crea una definició de l'informe

Podeu crear una definició de l'informe o utilitzar un dels sis arxius de definició lliurats amb IBM® Enterprise Records i desats en un magatzem d'objectes de pla de fitxers.

IBM Enterprise Records inclou sis definicions d'informes que proporcionen una vista estadística de les activitats d'usuaris diferents. Aquestes definicions s'afegeixen al magatzem d'objectes de pla de fitxers (FPOS) mitjançant un complement instal·lat amb el programari. Els fitxers es troben a Gestió de registres/Definicions d'informes, però només si s'han configurat de forma manual. Per obtenir més informació sobre la configuració, consulteu el tema sobre la configuració de les definicions d'informes a IBM Enterprise Records Installation and Upgrade Guide. Cada definició d'informe és un document XML i defineix les metadades següents de l'informe:

Títol de l'informe

El títol de l'informe és el títol de l'informe que IBM Enterprise Records mostra.

<setting key="title" localizationKey="server.report_title.n">títol de l'informe</setting>

Descripció de l'informe

La descripció és el text que IBM Enterprise Records mostra, on es descriu breument l'objectiu de l'informe. Per exemple, Aquest informe només mostra les accions que es van completar després que activéssiu l'auditoria a una categoria de registres, carpeta, volum o registre.

<setting key="desc" localizationKey="server.report_desc.n">descripció</setting>

L'ajuda d'entrada de l'informe

L'ajuda d'entrada és el text que IBM Enterprise Records mostra a l'entrada d'ajuda del registre. Per exemple, "L'informe generat només llista les accions que es van completar després que activéssiu l'auditoria".

<setting key="entryhelp" localizationKey="server.entryhelp.n">ajuda d'entrada</setting>

Nom de la taula de base de dades de l'informe

El nom de la taula és un nom de taula de base de dades que el motor d'informe de IBM Enterprise Records utilitza per recuperar els resultats del dipòsit IBM Enterprise Records. Aquest nom també s'utilitza per produir els resultats a una taula de base de dades intermediària que poden fer servir les aplicacions de l'informe. Per exemple, ActionPerformed.

<setting key="db_table_name">nom de la taula</setting>

Nom de la plantilla de l'informe

El nom de l'informe és el nom d'una plantilla d'informe creada en una aplicació de registres.

<setting key="reportName" localizationKey="server.report_name.n">nom de l'informe</setting>

Paràmetres de l'informe

es defineixen els paràmetres de l'informe, com ara ubicacions de plans de fitxers, accions, incidències, planificacions, dates i tipus d'entitats, i quan són obligatoris. Per definir paràmetres d'informes:
  1. A <object key="reportDefinition">, definiu <list key="report parameters">, si cal.
  2. A la clau de llista de paràmetres de l'informe, definiu la clau del paràmetre de nom simbòlic, segons calgui, per a cada un dels criteris d'informe.
  3. Seguiu cada clau de paràmetre de nom simbòlic amb aquesta etiqueta: <setting key="required"> 0 o 1 </setting>, per indicar si cal un valor. 0 indica que l'usuari no ha de fer cap selecció ni introduir cap valor. 1 indica que l'usuari ha de fer una selecció.
  4. Tanqueu cada parell de noms simbòlics i claus de paràmetre necessàries dins l'etiqueta següent: <object key="property"></object>.
Per exemple:
<object key="property"> <setting key="symbolicname">nom simbòlic</setting>
		<setting key="required">1</setting> </object>
on nom simbòlic son els criteris nous que heu creat o qualsevol de les claus de paràmetre següents:
  • fileplan_browse: indica a l'IBM Enterprise Records que permeti l'usuari explorar una ubicació al magatzem d'objectes de pla de fitxers.
  • fileplan_name: un pla de fitxers al magatzem d'objectes de pla de fitxers (FPOS).
  • ros_name: un nom de magatzem d'objectes de registres (ROS).
  • user_name: el nom d'usuari que ha completat les activitats.
  • start_date: la data d'inici dels criteris de l'informe.
  • end_date: la data de finalització dels criteris de l'informe.
  • disposal_schedule: la planificació de disposició associada a l'entitat.
  • hold_name: la contenció de registres associada a una entitat.
Un informe també utilitza els tipus d'entitat com a criteris. Per utilitzar tipus d'entitats:
  1. A la clau de llista de propietats, afegiu el nom simbòlic entity_type, seguit de la clau de paràmetre required (necessari) (1=necessari, 0=no necessari). Per exemple:
<object key="property">
    <setting key="symbolicname">entity_type</setting>
    <setting key="required">1</setting>
Afegiu <list key="values"> on introduïu els tipus d'entitat que un usuari pot seleccionar per incloure'ls a l'informe. Per exemple:
    <list key="values">
       <object key="value">
           			<setting key="id">TipusEntitat</setting>
           <setting key="value" localizationKey=serve.report_n.TipusEntitat">Entitat</setting>
       </object>
On: Els entorns localitzats exigeixen localizationKey. Per exemple, si l'informe inclou estadístiques sobre categories de registres i carpetes de registres, aquesta secció del fitxer XML ha de ser semblant a l'exemple següent:
<object key="property">
  <setting key="symbolicName">rm_entity_type</setting>
  <setting key="required">1</setting>
  <list key="values'>
    <object key="value">
      <setting key="id">RecordCategory</setting> 
      <setting key="value" localization Key="server.report_1.RecordCategory">Record Category</setting>
    </object>
    <object key="value">
       <setting key="id">RecordFolder</setting> 
       <setting key="value" localization Key="server.report_1.RecordFolder">Record Folder</setting>
    </object>
  </list>
</object>

Consultes de l'informe

A cada registre lliurat amb IBM Enterprise Records es defineix una o més consultes per consultar diferents tipus d'entitats com ara categories de registres, carpetes de registres, volum o registre. Per definir una consulta d'informe:
  1. A <object key="reportDefinition">, definiu <list key="report queries">.
  2. A la clau de llista de les consultes de l'informe, definiu la consulta, segons calgui, per als criteris de l'informe.
  3. Seguiu cada clau de paràmetre de consulta, definiu un paràmetre per a rm_entity_type per indicar que la consulta és per a un tipus d'entitat específica, CategoriaRegistre, CarpetaRegistre, Volum o Registre. La rm_entity_type és opcional si la consulta és per a tots els tipus d'entitats.
  4. Tanqueu cada consulta i claus de paràmetres de tipus d'entitats dins l'etiqueta següent: <object key="query"></object>.
Per exemple:
<list key="report queries">
   <object key="query">
     <setting key="sql">SELECT EV.LastModifier, EV.DateCreated, EV.ClassDescription, EV.AuditActionType,RC.RecordCategoryName AS EntityName, RMF.PathName, RC.Aggregation FROM (Event EV INNER JOIN RecordCategory RC ON EV.SourceObjectID = RC.ID)INNER JOIN RMFOLDER RMF on RC.parent=RMF.This WHERE EV.DateCreated >= {?start_date} AND EV.DateCreated <= {?end_date} AND EV.LastModifier = '{?user_name}' AND RC.this INSUBFOLDER '/{?fileplan_name}'</setting>
     <setting key="my_entity_type">RecordCatagory</setting>
   </object>
   <object key="query">
      <setting key="sql">SELECT EV.LastModifier, EV.DateCreated, EV.ClassDescription, EV.AuditActionType,RF.RecordFolderName AS EntityName,RMF.PathName, RF.Aggregation FROM (Event EV INNER JOIN RecordFolder RF ON EV.SourceObjectID = RF.ID)INNER JOIN RMFOLDER RMF on RF.parent=RMF.This WHERE EV.DateCreated >= {?start_date} AND EV.DateCreated <= {?end_date} AND EV.LastModifier = '{?user_name}' AND RF.this INSUBFOLDER '/{?fileplan_name}'</setting>
     <setting key="my_entity_type">RecordFolder</setting>
   </object>
<list>


Comentaris

Darrera actualització: Novembre de 2013
use_report_definitions.htm

© Copyright IBM Corp. 2013