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
- Descripció de l'informe
- Entrada d'ajuda de l'informe
- Nom de la taula de base de dades de l'informe
- Nom de la plantilla de l'informe
- Paràmetres de l'informe
- Consultes 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:
- A <object key="reportDefinition">, definiu <list
key="report parameters">, si cal.
- 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.
- 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ó.
- 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:
- 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:
- TipusEntitat és CategoriaRegistre, CarpetaRegistre,
Volum, o Registre. Podeu incloure els tres tipus d'entitat, però cal que en tanqueu cadascun dins d'etiquetes
<object key="value"> independents.
- n és el número que heu identificat anteriorment.
- Entitat és una categoria de registres, una carpeta de registres,
un volum o un registre.
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:
- A <object key="reportDefinition">, definiu <list
key="report queries">.
- A la clau de llista de les consultes de l'informe, definiu la consulta, segons calgui,
per als criteris de l'informe.
- 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.
- 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>