Antes de agregar un informe a ReportDefintions.xml,
cree una plantilla de informes en el Crystal Reports Designer.
Procedimiento
Para agregar un informe a ReportDefinitions.xml:
- Use un editor XML para abrir ReportDefinitions.xml,
en <ier_install_path>\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 (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 es el número que escribió en el paso 3 anterior.
<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>
en donde fpos es
el nombre del FPOS donde se excluye el nuevo 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, sucesos,
programas y fechas.
- En <object key="reportDefinition">, añada <list
key="properties">, en caso necesario. Si copió la clave de objeto reportDefinition
de un informe existene, entonces <list key="properties:>
existe.
- 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 creó
cualquier criterio, añada las claves de configuración del nombre simbólico
para los nuevos criterios 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 no
es necesario que el usuario haga una selección o que introduzca un valor. 1 indica
que se requiere que el usuario haga una selección o introduzca un valor.
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 active los botones
de selección Resumen o Detallado.
- disposal_trigger - El suceso que desencadena la disposición de una
entidad, como una fecha, el cierre de un contenedor o un suceso
externo.
Para 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 el tiempo de ejecución. Los ve en un menú
donde 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 que se identifica en el paso 3 anterior.
- Entity es Record Category, Record Folder, o Record.
Los entornos localizados requieren "localizationKey."
Por
ejemplo, si su informe incluye estadísticas sobre Categorías de registro
y Carpetas de registro, esta sección del archivo XML es similar al siguiente
ejemplo:
<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">classification_action</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 su informe incluye estadísticas sobre las acciones de degradación y desclasificación, esta sección del archivo XML es similar al siguiente
ejemplo:
<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 escribir 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.
Resultados
Cuando haya finalizado con las modificaciones, la sección de clave de objeto reportDefinition
se ve como el siguiente ejemplo:
<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>