Antes de añadir un informe nuevo a ReportDefintions.xml,
cree una plantilla de informe en Crystal Reports Designer.
Para añadir un informe nuevo a ReportDefinitions.xml:
- Utilice un editor XML para abrir ReportDefinitions.xml,
ubicado en <ruta_instalación_ier>\Config.
- Localice la matriz del modelo de datos que utilice en su
almacén de objetos de plan de archivos (FPOS). El archivo xml contiene una matriz de informes
DoD, informes clasificados DoD, informes PRO e informes BASE.
- Añada una etiqueta de valor nueva (por ejemplo, <value>42</value>).
Este valor es un número entero que identifica el informe que cree en
Crystal Reports Designer, y es exclusivo de cada informe. Este número es
igual al número de informes existentes más 1.
- En <List key="ReportDefinitions">, añada <object
key="reportDefinition">, al nuevo informe. Si existe un informe que sea similar al informe que ha creado:
- Copie entera la clave de objeto reportDefinition del informe
existente en el archivo XML.
- Pegue la clave de objeto copiada en otra ubicación del
archivo XML.
- Modifique la clave de objeto reportDefinition del nuevo informe cambiando o añadiendo
valores a las siguientes etiquetas, según resulte necesario.
n representa el número que ha especificado en el paso 3 más arriba.
<setting
key="id">n</setting>.
<setting key="title"
localizationKey="server.report_title.n">nombre de
informe</setting>, donde nombre de informe es el título del
informe que muestra IBM® Enterprise
Records.
<setting
key="desc" localizationKey="server.report_desc.n">descripción</setting>,
donde descripción representa el texto que muestra IBM Enterprise
Records y que describe de forma
concisa la finalidad del informe. Por ejemplo, "Este informe incluye los volúmenes que se han
abierto/cerrado durante un periodo de tiempo concreto."
<setting
key="reportName" localizationKey="server.report_name.n">filename.rpt</setting>,
donde filename representa el nombre de la plantilla de informe creada
en Crystal Reports Designer.
<setting key="img">vía de acceso relativa
a archivo de imagen</setting> Este es un valor opcional para
insertar un gráfico. Por ejemplo, images/action/report.gif.
- Para excluir un informe nuevo de un almacén de objetos de plan de archivos
(FPOS) específico, especifique las siguientes etiquetas:
<array key="excludedObjectStores">
<value>fpos</value> </array>
donde fpos es el nombre del FPOS
de donde se debe excluir el informe. Puede añadir etiquetas de valor
adicionales para excluir el informe de varios FPOS.
- Añada criterios de informe, como ubicaciones de FPOS, acciones, eventos,
programas y fechas.
- En <object key="reportDefinition">, añada <list
key="properties">, en caso necesario. Si ha copiado la clave de objeto reportDefinition
de un informe existente, ya existirá <list key="properties:>.
- En la clave de lista de propiedades, añada o modifique la clave de configuración del nombre simbólico,
según lo requieran los criterios de cada informe. Si ha creado
algún criterio, añada las claves de configuración del nombre simbólico del
nuevo criterio aquí también.
Coloque detrás de cada clave de configuración de
nombre simbólico esta etiqueta: <setting key="required"> 0 o 1 </setting>,
para indicar si se requiere un valor. 0 indica que el usuario no
necesita realizar una selección o especificar un valor, en tanto que 1 indica que
el usuario tiene que hacerlo.
Incluya cada par de nombres simbólicos
y claves de valor necesarias en esta etiqueta: <object key="property"> </object>.
Por ejemplo:
<object key="property"> <setting
key="symbolicname">nombre simbólico</setting>
<setting key="required">1</setting> </object>
donde nombre
simbólico representa el nuevo criterio creado, o algunas de las siguientes
claves de valor:
- fileplan_browse - Indica a IBM Enterprise
Records que permita al usuario examinar
una ubicación en el almacén de objetos de plan de archivos.
- ros_browse - Indica a IBM Enterprise
Records que permita al usuario examinar
una ubicación en el almacén de objetos de registros.
- start_date - La fecha de inicio de los criterios del informe.
- end_date - La fecha final de los criterios del informe.
- application_type - El tipo de registro para utilizar como criterio,
como PDF, DOC, XLS, y otros.
- security_category - La marca de seguridad, como clasificado, secreto,
confidencial y otros, en función del modelo de datos.
- review_decision - La decisión de una revisión, como Aprobar o Rechazar.
- action - La acción respecto a una entidad, como abrir o cerrar.
- disposal_schedule - El programa de disposición asociado con una entidad.
- disposal_action - La acción de disposición respecto a una entidad,
como transferir, revisar, transferir provisionalmente o destruir.
- disposal_action_export - La acción de disposición respecto a una entidad
después de una exportación.
- report_type - Indica a IBM Enterprise
Records que muestre los botones
de selección Resumen o Detalle.
- disposal_trigger - El evento que desencadena la disposición de una
entidad, como una fecha, el cierre de un contenedor o un evento
externo.
En el caso de ros_browse, security_category, disposal_action, disposal_action_export,
review_decision, y activación de disposición, IBM Enterprise
Records recupera los valores predeterminados
de Content Engine en tiempo de ejecución y los muestra en un menú
en el que se puede seleccionar un valor.
- Si el informe utiliza tipos de entidad como criterios:
- En la clave de lista de propiedades, añada el nombre simbólico entity_type,
seguido de la clave de valor "required" (1=required, 0=not required).
Por ejemplo:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
- Añada <list key="values"> donde debe especificar los tipos de
entidad que un usuario puede seleccionar para incluir en el informe. Por ejemplo:
<list key="values">
<object key="value">
<setting key="id">EntityType</setting>
<setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
</object>
donde
- EntityType es RecordCategory, RecordFolder, o Record.
Puede incluir los tres tipos de entidad, pero debe hacerlo en
etiquetas <object key="value"> independientes.
- n es el número identificado en el paso 3 anterior.
- Entity es Record Category, Record Folder, o Record.
Los entornos localizados requieren "localizationKey."
Por
ejemplo, si el informe incluye estadísticas sobre categorías de registro y
carpetas de registro, esta sección del archivo XML será similar a
esta:
<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>
- Si el informe utiliza acciones de clasificación:
En la clave de lista de propiedades, añada el nombre simbólico classification_action,
seguido de la clave de valor "required" (1=required, 0=not required).
Por ejemplo:
<object key="property">
<setting key="symbolicname">acción_clasificación</setting>
<setting key="required">1</setting>
Añada <list key="values"> donde debe especificar las acciones
de clasificación que un usuario puede seleccionar para incluir en un informe. Por ejemplo:
<list key="values">
<object key="value">
<setting key="id">ClassificationAction</setting>
<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>
</object>
donde:
- ClassificationAction es Upgrading, Downgrading,
o Declassification. Puede incluir las tres acciones de clasificación, pero debe hacerlo en
etiquetas <object key="value"> independientes.
- n es el valor "id" de este informe en la matriz del
modelo de datos.
Los entornos localizados requieren "localizationKey."
Por
ejemplo, si el informe incluye estadísticas sobre la degradación y
la desclasificación, esta sección del archivo XML será similar a
esta:
<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>
- Después de haber especificado todos los criterios del informe:
- Cierre <list key="properties"> con </list>.
- Cierre <object key="reportDefinition"> con </object>
- Guarde el archivo XML.
- Reinicie el servidor de aplicaciones web donde IBM Enterprise
Records se ejecuta para que se
apliquen los cambios.
Cuando haya finalizado las modificaciones, la sección de clave de objeto reportDefinition
debería ser similar a esta:
<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>